Nginx 反向代理与 WebSocket 长连接生产调优实战
一、背景与常见问题
在现代前后端分离架构及实时通信应用(如 AI 流式对话、实时监控看板、在线协同编辑)中,Nginx 常作为最前端的反向代理网关,承担 HTTPS 终结、负载均衡与请求转发职责。然而在默认配置下,开发者经常遇到 WebSocket 握手返回 400 Bad Request、长连接在 60 秒后无故断开(1006 Abnormal Closure),或高并发下上游连接频繁重建导致端口耗尽等问题。
二、核心配置要点与原理解析
要稳定代理 HTTP/1.1 长连接与 WebSocket 协议,关键在于显式声明协议版本及透传 Upgrade 与 Connection 请求头,同时合理调整超时与连接池参数:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
upstream backend_ws {
server 127.0.0.1:8080 max_fails=3 fail_timeout=15s;
keepalive 64;
}
server {
listen 443 ssl http2;
server_name api.example.com;
location /ws/ {
proxy_pass http://backend_ws;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $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_connect_timeout 10s;
proxy_read_timeout 300s;
proxy_send_timeout 300s;
proxy_buffering off;
}
}
三、关键参数排查清单
1. proxy_http_version 1.1:Nginx 默认使用 HTTP/1.0 与上游通信,不支持 Upgrade 握手及 keepalive 复用,必须显式设为 1.1。
2. proxy_read_timeout:默认为 60 秒。若业务心跳间隔大于 60 秒且期间无数据交互,Nginx 会主动切断连接。建议在业务端保持 25–30 秒一次 Ping/Pong 心跳,并将 proxy_read_timeout 设为 300 秒以上。
3. proxy_buffering off:对于 SSE(Server-Sent Events)流式输出场景,关闭代理缓冲可确保后端吐出的首字 Token 实时抵达客户端,避免卡顿。
4. 系统句柄限制:高并发长连接场景下,需同步检查系统 ulimit -n 及 Nginx 的 worker_rlimit_nofile 与 worker_connections 配置,防止文件描述符耗尽。
四、总结
通过规范配置 map 头映射、开启 HTTP/1.1 长连接复用、关闭流式缓冲并匹配业务心跳超时时间,可显著提升网关在实时通信与 AI 流式响应场景下的稳定性与吞吐能力。
- 点赞
- 收藏
- 关注作者
评论(0)