TCP_NODELAY需通过so_keepalive=...:1在stream块listen指令中启用,禁用Nagle算法以降低小包延迟,仅nginx 1.19.5+支持,且仅作用于nginx到后端连接。

nginx 四层负载均衡中,TCP_NODELAY 是一个直接影响延迟表现的关键内核级选项。它不直接由 nginx 配置指令控制,而是通过 so_keepalive 语法的扩展参数显式启用,作用是禁用 Nagle 算法,避免小包合并等待,从而降低 TCP 交互延迟。
为什么四层代理必须关注 TCP_NODELAY
在数据库(如 MySQL)、游戏服务、实时通信等场景中,客户端与后端常有高频、小体积的请求/响应交互(例如单条 SQL 查询、心跳帧)。若开启 Nagle 算法(默认行为),nginx 作为中间代理可能缓存多个小数据段,等待 ACK 或超时(通常 200ms)后才发包,造成明显“粘包延迟”。而 TCP_NODELAY = on 强制立即发送,对时延敏感业务至关重要。
如何在 stream 块中正确启用
nginx 的 listen 指令支持以 so_keepalive 形式透传 socket 选项,其中第三个参数即控制 TCP_NODELAY:
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求,未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
-
listen 3306 so_keepalive=on;—— 仅启用 keepalive,不启用 NODELAY -
listen 3306 so_keepalive=on:10m:30s:5;—— 格式为so_keepalive=[on|off]:[idle]:[interval]:[probes],仍不涉及 NODELAY -
listen 3306 so_keepalive=on:::1;—— 第三个参数留空表示使用系统默认值,第四个参数1表示启用 TCP_NODELAY(nginx 1.19.5+ 支持) -
listen 3306 so_keepalive=on:7200s:30s:5:1;—— 完整写法:启用 keepalive + 自定义参数 + 启用 NODELAY
实际配置建议与验证要点
启用 NODELAY 不代表无代价,需结合业务特征权衡:
- 对高吞吐批量写入(如日志推送)可关闭 NODELAY,提升带宽利用率
- 对交互式协议(MySQL、Redis、自定义 TCP 协议)强烈建议开启
- 确认 nginx 版本 ≥ 1.19.5,旧版本即使加
:1也无效 - 用
ss -i或netstat -tnv在 nginx 连接上检查ts sack reord字段旁是否显示nodelay - 注意:该设置只影响 nginx 与后端建立的连接(
proxy_pass方向),客户端到 nginx 的连接需由客户端自身控制或通过其他机制(如客户端设TCP_NODELAY)
常见误区澄清
很多人误以为 tcp_nodelay on;(这是 http 模块里的指令)在 stream 中也生效 —— 实际上它完全不被识别,stream 块中无效。也有用户尝试在 upstream 或 proxy_pass 中设置,但目前 nginx 尚未提供此类指令。唯一可靠方式就是通过 listen ... so_keepalive=...:1 显式声明。










