v1.0
Шаблон nginx конфига

WebSocket + SSL

Конфигурация nginx для проксирования WebSocket (WSS) соединений с HTTPS. Корректная обработка заголовков Upgrade/Connection через map, большие таймауты для долгоживущих соединений, отключённая буферизация для real-time передачи.

Пример конфига
nginx.conf 
# WebSocket Upgrade маппинг
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

upstream websocket_backend {
    server 127.0.0.1:3000;
}

server {
    listen 80;
    listen [::]:80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    server_tokens off;
    client_max_body_size 10m;
    worker_connections 4096;  # WebSocket держит много долгих соединений

    access_log /var/log/nginx/websocket-access.log combined;
    error_log  /var/log/nginx/websocket-error.log warn;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;

    # WebSocket endpoint
    location /ws/ {
        proxy_pass http://websocket_backend;
        proxy_http_version 1.1;

        # Обязательные заголовки для WebSocket handshake
        proxy_set_header Upgrade    $http_upgrade;
        proxy_set_header Connection $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_read_timeout  3600s;
        proxy_send_timeout  3600s;
        proxy_connect_timeout 30s;

        # Буферизация отключена: данные идут сразу в обе стороны
        proxy_buffering off;
    }

    # HTTP API и статика
    location / {
        proxy_pass http://websocket_backend;
        proxy_http_version 1.1;
        proxy_set_header Upgrade    $http_upgrade;
        proxy_set_header Connection $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_read_timeout  3600s;
        proxy_buffering off;
    }

    location ~ /\. { deny all; }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html { root /usr/share/nginx/html; }
}
Как настроить
  1. Убедитесь что ваш WebSocket-сервер слушает на 127.0.0.1:3000
  2. Для Socket.IO добавьте поддержку HTTPS: io('https://example.com', { transports: ['websocket'] })
  3. В nginx важен блок map для $connection_upgrade — без него WSS не заработает
  4. Увеличьте worker_rlimit_nofile в nginx.conf до 65535 для большого числа соединений
  5. Получите SSL-сертификат через certbot и скопируйте конфиг в nginx
  6. Проверьте WSS соединение через websocat: websocat wss://example.com/ws/