Nginx Reverse Proxy для Node.js и Next.js с WebSocket, HTTP/2 и SSL
Готовая конфигурация 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/{{domain}}.conf
upstream nextjs_upstream {
server 127.0.0.1:3000;
keepalive 64;
}
server {
listen 80;
server_name {{domain}} www.{{domain}};
return 301 https://{{domain}}$request_uri;
}
server {
listen 443 ssl http2;
server_name {{domain}};
ssl_certificate /etc/letsencrypt/live/{{domain}}/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/{{domain}}/privkey.pem;
client_max_body_size {{client_max_body}};
# Кэширование статических ассетов Next.js
location /_next/static {
alias /var/www/{{domain}}/.next/static;
expires 365d;
add_header Cache-Control "public, max-age=31536000, immutable";
access_log off;
}
# Статические файлы из папки public/
location /static {
alias /var/www/{{domain}}/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
Timeweb Cloud
2 CPU / 4 GB NVMe
Процессор:
2 vCPU
Память RAM:
4 GB RAM
Накопитель:
40 GB NVMe
Selectel
2 vCPU / 4 GB RAM
Процессор:
2 vCPU
Память RAM:
4 GB RAM
Накопитель:
40 GB NVMe
Beget
Turbo 4 GB
Процессор:
2 vCPU
Память RAM:
4 GB RAM
Накопитель:
40 GB NVMe
Онлайн-утилиты SysKit для проверки этого сервера
Протестируйте корректность применения конфигурации прямо сейчас в один клик.
Частые ошибки при настройке и их решение (FAQ)
Типовые проблемы вебмастеров и сисадминов при внедрении данной конфигурации.
Ошибка 502 Bad Gateway при обращении к Next.js
Node.js приложение не запущено или упало. Проверьте статус через `pm2 status` или `systemctl status nextjs`.
Рекомендуемые смежные конфигурации
Дополнительные рецепты и калькуляторы для полной оптимизации данного серверного стека.