要让nginx代理node.js时真正复用tcp连接,必须三者协同:upstream中配置keepalive 16~32、location中设proxy_http_version 1.1并proxy_set_header connection '';同时node.js需设server.keepalivetimeout≥25s且禁用主动断连,否则仍为短连接。

要让 Nginx 代理 Node.js 服务时真正复用 TCP 连接,不能只在 upstream 里写 keepalive 32。Node.js 默认支持 HTTP/1.1 keep-alive,但 Nginx 和它之间必须协议、头、连接池三者对齐,否则仍是短连接,后端 TIME_WAIT 暴涨、延迟升高。
Upstream 连接池必须配全三项
缺一不可,否则 keepalive 完全不生效:
-
upstream 块内声明连接数:如
keepalive 32;,表示每个 worker 进程对每台 Node 实例最多缓存 32 个空闲长连接;Node.js 轻量,建议从 16~32 起步,别盲目设高(Go/Node 默认MaxIdleConnsPerHost=2,Nginx 设再大也连不上) -
location 中强制 HTTP/1.1:加
proxy_http_version 1.1;,Nginx 默认向上游发 HTTP/1.0 请求,不支持复用 -
清空 Connection 头:加
proxy_set_header Connection "";(注意是空字符串),否则可能透传客户端的Connection: close,导致 Node 主动断连
控制空闲连接生命周期(1.15.3+ 才生效)
仅靠 keepalive 不够,需搭配超时与请求数限制,防止连接积压或状态泄漏:
-
keepalive_timeout 20s;:空闲连接在池中最多保留 20 秒;建议比 Node 的空闲超时(如 Express + http.Server 的
timeout或keepAliveTimeout)小 5~10 秒,避免持有已失效连接 - keepalive_requests 500;:单个空闲连接最多转发 500 次请求后主动关闭;默认 100 太保守,API 场景推荐 500~1000,防内存堆积或响应头污染
Node.js 侧必须匹配配置
Nginx 配得再好,Node 不配合也会复用失败:
- 确保 Node 使用原生
http.Server或兼容 keep-alive 的框架(Express、Fastify 默认支持) - 显式设置服务器空闲超时:如
server.keepAliveTimeout = 30_000;(30 秒),并确认server.timeout≥ 该值 - 避免中间件或错误处理中手动调用
res.destroy()或req.socket.destroy(),这会强制中断连接 - 若用 PM2 或反向代理前置(如 Cloudflare),检查是否拦截或改写
Connection头
验证是否真复用成功
配置完别只看语法,用实际现象判断:
- 在 Node 服务器上运行
ss -tan | grep :3000 | grep ESTAB | wc -l(替换为你的端口),压测时观察连接数是否稳定在预期范围(如 4 worker × 1 Node × 32 = 128),而非持续增长 - 查 Node 日志或监控指标:TIME_WAIT 数量应明显下降,P95 延迟降低,建连耗时减少
- 用
curl -v http://nginx-proxy/api/test多次请求,结合ss -t -o观察源端口是否复用(相同本地端口连续通信)











