高性能实时推送网关需围绕长连接稳定、消息低延迟、节点可伸缩、故障不中断四大目标设计：配全WebSocket三要素（Upgrade头透传、HTTP/1.1强制、禁用缓冲与拉长超时）、启用Cookie粘性会话与主动健康检查、调优连接复用及内核参数、实施多层防护（客户端限速、后端熔断、HTTPS卸载）。
要打造高性能的企业级实时推送网关代理，核心不是堆参数，而是围绕“长连接稳定、消息低延迟、节点可伸缩、故障不中断”四个目标来设计 Nginx 配置与架构。Nginx 本身不是消息中间件，但它能高效承载 WebSocket、gRPC-Web、SSE（Server-Sent Events）等实时协议的反向代理和连接管理——关键在于把它的事件驱动模型用对、把连接生命周期管住、把后端粘性与容错平衡好。
WebSocket 实时通道必须配全三要素
仅写 proxy_pass 不足以支撑生产级 WebSocket 推送。缺一不可的三项配置是：
-
协议升级头必须显式透传：
proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade"; -
HTTP 版本强制设为 1.1：
proxy_http_version 1.1;（WebSocket 依赖 HTTP/1.1 的 Connection: upgrade 机制） -
禁用缓冲与超时拉长：
proxy_buffering off;proxy_read_timeout 86400;（设为 24 小时，避免空闲断连；真实场景建议配合心跳由后端控制）
粘性会话 + 健康检查 = 推送状态不漂移
实时推送常依赖后端节点内存中维护的用户连接上下文（如 session map、channel 列表）。一旦请求被轮询到新节点，推送就会丢失。Nginx 1.29.6+ 已原生支持 sticky 指令，比老式 ip_hash 更可靠：
- 用 Cookie 标识用户（如
Set-Cookie: SESSIONID=abc123），配置：
upstream push_backend {<br> sticky cookie SESSIONID expires=1h domain=.example.com path=/;<br> server 10.0.1.10:8080 max_fails=2 fail_timeout=15s;<br> server 10.0.1.11:8080 max_fails=2 fail_timeout=15s;<br> } - 搭配主动健康检查（需启用
ngx_http_upstream_check_module或使用 Plus 版）：
定期探测/healthz，失败节点自动摘除，恢复后再平滑加回，避免推送中断
连接复用与内核调优决定并发上限
Nginx 作为入口网关，单机扛住数万长连接的前提是“连接不泄漏、资源不卡死”：
-
worker 级别连接池要开足：
events { worker_connections 65535; use epoll; }同时确认系统级限制：ulimit -n 1048576、fs.file-max = 2097152 -
上游 keepalive 复用 TCP 连接：
upstream push_backend {<br> keepalive 200;<br> keepalive_requests 10000;<br> keepalive_timeout 60s;<br> }避免每条 WebSocket 握手都新建 TCP 连接，降低后端 TIME_WAIT 和 CPU 开销 -
关闭日志写入高频路径：
实时推送接口（如
/push/ws）建议关闭 access_log，或异步刷盘：access_log /var/log/nginx/push.log main buffer=128k flush=5s;
多层防护保障推送链路不被拖垮
推送网关不能只做转发，还要防误用、防压垮、防雪崩：
-
按客户端限速（非 IP）：利用 $cookie_xid 或 $http_authorization 提取唯一标识，配合
limit_req控制单用户建连频次 - 后端熔断兜底：当 upstream 所有节点失败时，返回预设的降级响应（如 503 + JSON 提示），避免请求堆积在 Nginx 队列中
- HTTPS 卸载前置：TLS 握手耗 CPU，务必让 Nginx 终结 HTTPS（配 fullchain + private key），后端走内网 HTTP，减轻推送服务压力
