Nginx需正确配置才能支持Socket.IO的WebSocket连接。必须使用1.3.13+版本（推荐1.18.0+），启用proxy_http_version 1.1，并透传Upgrade和Connection头，设置proxy_read_timeout与proxy_send_timeout≥60秒，配合前后端禁用旧协议、指定传输方式及正确监听地址，最终在浏览器Network中验证状态码101。
Nginx 默认不支持 WebSocket 协议的长连接转发，而 Socket.IO 在建立连接时会先发起 HTTP 升级请求（Upgrade: websocket），再切换到 WebSocket 协议通信。若 Nginx 未正确配置，Socket.IO 会降级为轮询（polling），导致延迟高、资源浪费。关键在于让 Nginx 正确透传 Upgrade 和 Connection 头，并启用代理 WebSocket 的必要参数。
确保 Nginx 版本支持 WebSocket
WebSocket 代理功能在 Nginx 1.3.13+ 中正式支持，推荐使用 1.18.0 或更高稳定版本。可通过以下命令确认：
nginx -v若版本过低，需升级 Nginx 或改用其他反代方案（如 Caddy）。
配置 proxy_set_header 支持协议升级
WebSocket 连接依赖 HTTP 的 Connection: upgrade 和 Upgrade: websocket 头完成协议切换。Nginx 默认会过滤掉这些头，必须显式设置：
- proxy_http_version 1.1：启用 HTTP/1.1（WebSocket 升级必需）
- proxy_set_header Upgrade $http_upgrade：透传客户端的 Upgrade 头
- proxy_set_header Connection "upgrade"：强制设置 Connection 为 upgrade（注意加引号，避免被解析为变量）
- proxy_set_header Host $host：保留原始 Host，便于后端识别
完整 location 示例（适配 Socket.IO v4+）
Socket.IO 默认路径为 /socket.io/，建议按路径匹配并启用长连接保持：
location /socket.io/ {
proxy_http_version 1.1;
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_pass http://backend_socketio;
proxy_read_timeout 60;
proxy_send_timeout 60;
}
其中 proxy_read_timeout 和 proxy_send_timeout 建议设为 60 秒以上，避免 Nginx 主动断开空闲 WebSocket 连接。
后端与客户端配合要点
Nginx 配置只是基础，还需前后端协同：
- Node.js 后端（如 express + socket.io）应禁用 allowEIO3（v4+ 默认关闭），避免旧版 Engine.IO 兼容逻辑干扰
- 前端初始化时显式指定 transports: ['websocket'] 可跳过 polling 探测（调试阶段可用，生产环境建议保留自动降级）
- 确保后端监听地址与 proxy_pass 地址一致（如 127.0.0.1:3001），且未绑定 localhost 导致仅本地可访问
配置完成后，可通过浏览器开发者工具 Network 标签查看 WebSocket 连接是否显示为 ws:// 或 wss://，状态码为 101 Switching Protocols，即表示升级成功。
