¿Por qué falla una conexión WebSocket a través de Nginx?

Question

IT Interview Practice · Accepted Answer

Primero distinga un handshake fallido de una conexión que se abre y se cierra más tarde. Los dos síntomas requieren comprobaciones distintas.

## Permita que la aplicación reciba la solicitud de upgrade

Para una ruta WebSocket dedicada, coloque esto dentro de `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 explícitamente HTTP/1.1 hacia el backend. `Upgrade` transmite el cambio de protocolo solicitado por el cliente. `Connection` indica al backend que esta conexión solicita ese cambio. Estas cabeceras requieren reenvío explícito porque los proxys no pasan sin más todas las cabeceras específicas de la conexión.

## Lea el resultado

Un handshake correcto devuelve `101 Switching Protocols`. Si recibe 404, compruebe la ruta del backend; si falla la autenticación, revise la política de la aplicación. La configuración proxy no sustituye la autenticación ni la comprobación de orígenes permitidos.

Si la conexión se abre pero se cierra tras inactividad, inspeccione los tiempos de inactividad en Nginx y otros proxys. Use tramas ping WebSocket enviadas por el servidor y un `proxy_read_timeout` adecuado, junto con reconexión del cliente. Aumentar solo el timeout puede mantener conexiones muertas durante más tiempo.

[Documentación oficial](https://nginx.org/en/docs/http/websocket.html).

Permita que la aplicación reciba la solicitud de upgrade

Lea el resultado

Preguntas relacionadas