Por que uma conexão WebSocket falha através do Nginx?

Question

IT Interview Practice · Accepted Answer

Primeiro diferencie uma falha no handshake de uma conexão que abre e fecha depois. Os dois sintomas levam a verificações diferentes.

## Permita que a aplicação receba a solicitação de upgrade

Para uma rota WebSocket dedicada, coloque isto 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 explicitamente HTTP/1.1 em direção ao backend. `Upgrade` repassa a mudança de protocolo solicitada pelo cliente. `Connection` informa ao backend que esta conexão solicita essa mudança. Esses cabeçalhos precisam de encaminhamento explícito porque proxies não repassam simplesmente todo cabeçalho específico de conexão.

## Leia o resultado

Um handshake bem-sucedido retorna `101 Switching Protocols`. Se receber 404, confira o caminho no backend; se a autenticação falhar, examine a política da aplicação. A configuração do proxy não substitui autenticação nem verificação de origens permitidas.

Se a conexão abrir, mas fechar após inatividade, examine timeouts de ociosidade no Nginx e nos outros proxies. Use frames de ping WebSocket enviados pelo servidor e um `proxy_read_timeout` adequado, junto com reconexão no cliente. Aumentar apenas o timeout pode manter conexões mortas por mais tempo.

[Documentação oficial](https://nginx.org/en/docs/http/websocket.html).

Permita que a aplicação receba a solicitação de upgrade

Leia o resultado

Perguntas relacionadas