Perché una connessione WebSocket fallisce attraverso Nginx?

Question

IT Interview Practice · Accepted Answer

Distingui prima un handshake fallito da una connessione che si apre e poi si chiude. I due sintomi portano a controlli differenti.

## Fai arrivare all'applicazione la richiesta di upgrade

Per una rotta WebSocket dedicata, inserisci questo dentro `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` usa esplicitamente HTTP/1.1 verso il backend. `Upgrade` inoltra il cambio di protocollo richiesto dal client. `Connection` comunica al backend che questa connessione richiede quel cambio. Questi header richiedono inoltro esplicito perché i proxy non passano semplicemente ogni header specifico della connessione.

## Leggi il risultato

Un handshake riuscito restituisce `101 Switching Protocols`. Se ricevi 404, controlla il percorso backend; se l'autenticazione fallisce, esamina la policy applicativa. La configurazione proxy non sostituisce autenticazione o controlli sulle origini consentite.

Se la connessione si apre ma si chiude dopo inattività, esamina gli idle timeout di Nginx e degli altri proxy. Usa frame ping WebSocket inviati dal server e un `proxy_read_timeout` appropriato insieme alla riconnessione del client. Aumentare solo il timeout può mantenere più a lungo connessioni morte.

[Documentazione ufficiale](https://nginx.org/en/docs/http/websocket.html).

Fai arrivare all'applicazione la richiesta di upgrade

Leggi il risultato

Domande correlate