Почему WebSocket-соединение не работает через Nginx?

Question

IT Interview Practice · Accepted Answer

Сначала отличите неудачное рукопожатие от соединения, которое открывается и затем закрывается. Эти симптомы ведут к разным проверкам.

## Дайте приложению получить запрос обновления протокола

Для отдельного WebSocket-маршрута поместите это в `server`:

```nginx
location /socket/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}
```

`proxy_http_version` явно использует HTTP/1.1 к бэкенду. `Upgrade` передаёт запрошенную клиентом смену протокола. `Connection` сообщает бэкенду, что соединение запрашивает эту смену. Заголовки нужно пересылать явно: прокси не передают автоматически каждый заголовок, специфичный для соединения.

## Прочитайте результат

Успешное рукопожатие возвращает `101 Switching Protocols`. При 404 проверяйте путь бэкенда; при ошибке аутентификации — политику приложения. Конфигурация прокси не заменяет аутентификацию и проверки разрешённых origin.

Если соединение открывается, но закрывается после простоя, исследуйте тайм-ауты простоя в Nginx и других прокси. Используйте отправляемые сервером WebSocket ping-кадры и подходящий `proxy_read_timeout` вместе с переподключением клиента. Одно лишь увеличение тайм-аута может дольше удерживать мёртвые соединения.

[Официальная документация](https://nginx.org/en/docs/http/websocket.html).

Дайте приложению получить запрос обновления протокола

Прочитайте результат

Похожие вопросы