Mengapa koneksi WebSocket gagal melalui Nginx?

Question

IT Interview Practice · Accepted Answer

Pertama, bedakan handshake koneksi yang gagal dari koneksi yang terbuka lalu tertutup. Kedua gejala mengarah pada pemeriksaan berbeda.

## Biarkan aplikasi menerima permintaan upgrade

Untuk rute WebSocket khusus, letakkan ini di dalam `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` secara eksplisit memakai HTTP/1.1 ke backend. `Upgrade` meneruskan perubahan protokol yang diminta klien. `Connection` memberi tahu backend bahwa koneksi ini meminta perubahan tersebut. Header ini perlu diteruskan secara eksplisit karena proxy tidak sekadar meneruskan semua header khusus koneksi.

## Baca hasilnya

Handshake yang berhasil mengembalikan `101 Switching Protocols`. Jika menerima 404, periksa jalur backend; jika autentikasi gagal, periksa kebijakan aplikasi. Konfigurasi proxy tidak menggantikan autentikasi atau pemeriksaan origin yang diizinkan.

Jika koneksi terbuka tetapi tertutup setelah tidak aktif, periksa idle timeout di Nginx dan proxy lain. Gunakan frame ping WebSocket yang dikirim server dan `proxy_read_timeout` yang sesuai, bersama perilaku reconnect klien. Menaikkan timeout saja dapat membuat koneksi mati bertahan lebih lama.

[Dokumentasi resmi](https://nginx.org/en/docs/http/websocket.html).

Biarkan aplikasi menerima permintaan upgrade

Baca hasilnya

Pertanyaan terkait