Nginx Reverse Proxy для Node.js и Next.js с WebSocket, HTTP/2 и SSL

Обновлено: Сентябрь 2026 Стек: Nginx 1.26+ / 1.27++, Node.js 20/22 LTS, Next.js 14/15, PM2 Проверено: Production-Ready

Готовая конфигурация Nginx в качестве Reverse Proxy для приложений Node.js, Express, NestJS и Next.js SSR с кэшированием статики _next/static и WebSocket.

Интерактивный генератор под ваши параметры
Параметры подставляются в код в реальном времени
/etc/nginx/sites-available/app.example.com.conf
# /etc/nginx/sites-available/app.example.com.conf
upstream nextjs_upstream {
    server 127.0.0.1:3000;
    keepalive 64;
}

server {
    listen 80;
    server_name app.example.com www.app.example.com;
    return 301 https://app.example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name app.example.com;

    ssl_certificate /etc/letsencrypt/live/app.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/app.example.com/privkey.pem;

    client_max_body_size 32M;

    # Кэширование статических ассетов Next.js
    location /_next/static {
        alias /var/www/app.example.com/.next/static;
        expires 365d;
        add_header Cache-Control "public, max-age=31536000, immutable";
        access_log off;
    }

    # Статические файлы из папки public/
    location /static {
        alias /var/www/app.example.com/public;
        expires 30d;
        access_log off;
    }

    # Основное проксирование в Node.js / Next.js
    location / {
        proxy_pass http://nextjs_upstream;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
        proxy_read_timeout 60s;
    }
}

Разбор ключевых директив конфигурации

Техническое обоснование директив и их прямое влияние на процессор (CPU), оперативную память (RAM) и дисковый ввод-вывод (NVMe I/O).

Директива / Блок Рекомендуемое значение Зачем нужно и системное влияние (CPU / RAM / I-O)
location /_next/static alias /.next/static; Отдает неизменяемые JS/CSS бандлы Next.js напрямую через Nginx минуя Node.js event loop, снижая CPU на 70%.
proxy_set_header Connection 'upgrade'; WebSocket pass Обеспечивает работу Next.js Fast Refresh (HMR) в dev-режиме и Socket.IO / WebSockets в продакшене.
keepalive 64; Пул постоянных соединений Держит открытыми TCP-соединения между Nginx и Node.js процессом, ликвидируя оверхед на TCP Handshake.

Рекомендуемые системные требования VDS под этот стек

Расчет минимальной и оптимальной конфигурации виртуального сервера для стабильной работы без сбоев.

Оптимальный сайзинг: 2 vCPU, 4 GB RAM, 40 GB NVMe, Ubuntu 24.04
Расчетная нагрузка: Next.js SSR до 500 RPS
2 CPU / 4 GB NVMe
⚡

Timeweb Cloud

Рекомендуемые ресурсы
2 vCPU / 4 GB RAM / 40 GB NVMe
2 vCPU / 4 GB RAM
🔷

Selectel

Рекомендуемые ресурсы
2 vCPU / 4 GB RAM / 40 GB NVMe
Turbo 4 GB
🟠

Beget

Рекомендуемые ресурсы
2 vCPU / 4 GB RAM / 40 GB NVMe

Онлайн-утилиты SysKit для проверки этого сервера

Протестируйте корректность применения конфигурации прямо сейчас в один клик.

Частые ошибки при настройке и их решение (FAQ)

Типовые проблемы вебмастеров и сисадминов при внедрении данной конфигурации.

Ошибка 502 Bad Gateway при обращении к Next.js
Node.js приложение не запущено или упало. Проверьте статус через `pm2 status` или `systemctl status nextjs`.
Как проверить конфигурацию Nginx перед перезагрузкой?
Всегда выполняйте команду `nginx -t`. Если синтаксис верный, примените настройки командой `systemctl reload nginx` без остановки сайта.
Что делать при ошибке 413 Request Entity Too Large?
Увеличьте директиву `client_max_body_size 128M;` в блоке `http {}` или `server {}` и перезагрузите веб-сервер.