Nginx를 통과하는 WebSocket 연결은 왜 실패하나요?

Question

IT Interview Practice · Accepted Answer

먼저 연결 handshake 실패와, 열린 뒤 나중에 닫히는 연결을 구별합니다. 두 증상은 확인할 항목이 다릅니다.

## 애플리케이션이 upgrade 요청을 받게 하기

전용 WebSocket 라우트에 대해 다음을 `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`은 백엔드 방향으로 HTTP/1.1을 명시적으로 사용합니다. `Upgrade`는 클라이언트가 요청한 프로토콜 변경을 전달합니다. `Connection`은 이 연결이 해당 변경을 요청한다는 것을 백엔드에 알립니다. 프록시가 모든 연결 전용 헤더를 단순 전달하는 것은 아니므로 이 헤더들은 명시적으로 전달해야 합니다.

## 결과 읽기

성공한 handshake는 `101 Switching Protocols`를 반환합니다. 404라면 백엔드 경로를 확인하고, 인증 실패라면 애플리케이션 정책을 조사합니다. 프록시 설정은 인증이나 허용 origin 검사를 대체하지 않습니다.

연결이 열렸다가 비활동 후 닫힌다면 Nginx와 다른 프록시의 idle timeout을 확인합니다. 서버가 보내는 WebSocket ping 프레임과 적절한 `proxy_read_timeout`을 클라이언트 재연결 동작과 함께 사용합니다. 타임아웃만 늘리면 죽은 연결을 더 오래 유지할 수 있습니다.

[공식 문서](https://nginx.org/en/docs/http/websocket.html).

애플리케이션이 upgrade 요청을 받게 하기

관련 질문

결과 읽기