Waarom mislukt een WebSocket-verbinding via Nginx?

Question

IT Interview Practice · Accepted Answer

Maak eerst onderscheid tussen een mislukte handshake en een verbinding die opent en later sluit. De twee symptomen leiden tot verschillende controles.

## Laat de applicatie het upgradeverzoek ontvangen

Plaats voor een specifieke WebSocket-route dit binnen `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` gebruikt expliciet HTTP/1.1 richting de backend. `Upgrade` geeft de gevraagde protocolwijziging van de client door. `Connection` vertelt de backend dat deze verbinding die wijziging aanvraagt. Deze headers moeten expliciet worden doorgestuurd, omdat proxies niet automatisch iedere verbindingsspecifieke header doorgeven.

## Lees het resultaat

Een geslaagde handshake geeft `101 Switching Protocols` terug. Controleer bij een 404 het backendpad; onderzoek bij authenticatiefouten het applicatiebeleid. De proxyconfiguratie vervangt authenticatie of controles van toegestane origins niet.

Opent de verbinding maar sluit ze na inactiviteit, controleer dan de inactiviteitstime-outs in Nginx en andere proxies. Combineer door de server verstuurde WebSocket-pingframes en een passende `proxy_read_timeout` met reconnectgedrag van de client. Alleen de time-out verhogen kan dode verbindingen langer vasthouden.

[Officiële documentatie](https://nginx.org/en/docs/http/websocket.html).

Laat de applicatie het upgradeverzoek ontvangen

Lees het resultaat

Gerelateerde vragen