Nginx에서 Next.js proxy_pass 설정했는데 WebSocket 연결이 끊깁니다

Nginx에서 WebSocket을 프록시하려면 Upgrade 헤더를 전달해야 합니다. 기본 proxy_pass로는 WebSocket이 작동하지 않습니다.

server {
    server_name mysite.com;
    
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        
        # WebSocket 지원을 위한 필수 헤더
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

핵심은 proxy_set_header Upgrade와 Connection "upgrade" 두 줄입니다. 이걸 빼면 WebSocket이 일반 HTTP로 다운그레이드됩니다.