Dlaczego połączenie WebSocket przez Nginx nie działa?

Question

IT Interview Practice · Accepted Answer

Najpierw rozróżnij nieudany handshake od połączenia, które otwiera się i później zamyka. Te objawy prowadzą do innych kontroli.

## Przekaż aplikacji żądanie zmiany protokołu

Dla osobnej trasy WebSocket umieść w `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` jawnie ustawia HTTP/1.1 w komunikacji z backendem. `Upgrade` przekazuje żądaną przez klienta zmianę protokołu. `Connection` informuje backend, że połączenie prosi o taką zmianę. Te nagłówki trzeba przekazać jawnie, ponieważ proxy nie przesyłają automatycznie wszystkich nagłówków dotyczących konkretnego połączenia.

## Odczytaj wynik

Udany handshake zwraca `101 Switching Protocols`. Przy 404 sprawdź ścieżkę backendu; przy błędzie uwierzytelniania zbadaj politykę aplikacji. Konfiguracja proxy nie zastępuje uwierzytelniania ani kontroli dozwolonych originów.

Jeśli połączenie otwiera się, ale zamyka po bezczynności, sprawdź timeouty bezczynności Nginx i innych proxy. Połącz ramki ping WebSocket wysyłane przez serwer, odpowiedni `proxy_read_timeout` i ponowne łączenie klienta. Samo zwiększenie timeoutu może dłużej utrzymywać martwe połączenia.

[Oficjalna dokumentacja](https://nginx.org/en/docs/http/websocket.html).

Przekaż aplikacji żądanie zmiany protokołu

Odczytaj wynik

Powiązane pytania