tcp_nodelay并非全局提速，而是精准消除20–200ms小包攒包延迟，仅在长连接、响应≤1KB、后端已flush三条件同时满足时生效；必须按location/upstream/stream精细化配置，避开sendfile、tcp_nopush、proxy_buffering等冲突项，并实证验证。
在 Nginx 中启用 tcp_nodelay 不是为了“全局提速”，而是精准消除小包在 TCP 层的攒包等待（20–200ms），适用于长连接、响应 ≤1KB、后端已 flush 的交互场景。它只对满足条件的流量生效，配错位置或忽略前提等于没开。
确认是否适用你的业务场景
该优化仅在以下三个条件同时满足时才真正起效：
- 连接是长连接：HTTP/1.1 带
Connection: keep-alive或 HTTP/2；需配置keepalive_timeout 60;并确认客户端复用连接（可用ss -i dst <ip>:<port>查看是否带nodelay标志） - 响应体足够小：如健康检查
{"ok":true}、SSE 事件帧、WebSocket ping、favicon.ico 等 ≤1KB 的内容；大文件（如图片、JS bundle）不受 Nagle 影响，开了也无效 - 数据已被后端显式刷出：例如 Node.js 调用
res.flush()，Go 调用rw.(http.Flusher).Flush()；若 Nginx 自身开启proxy_buffering on，tcp_nodelay就失去作用对象
在正确位置启用 tcp_nodelay
该指令不支持全局统一开启，必须按路径或连接方向精细化配置：
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
-
面向客户端连接（Nginx → 客户端）：写在
location块中，适用于 WebSocket、SSE、实时 API 等前端直连场景
location /api/events {<br> proxy_pass http://sse_backend;<br> proxy_http_version 1.1;<br> proxy_set_header Connection '';<br> tcp_nodelay on;<br> tcp_nopush off;<br> proxy_buffering off;<br> } -
面向后端连接（Nginx → 上游服务）：写在
upstream块中，配合keepalive使用
upstream api_cluster {<br> server 10.0.1.10:8080;<br> keepalive 32;<br> tcp_nodelay on;<br> } -
四层 TCP 代理（stream 模块）：不识别
tcp_nodelay指令，须通过so_keepalive=...:1启用
stream {<br> upstream db_pool { server 192.168.1.100:3306; }<br> server {<br> listen 3306 so_keepalive=on:::1;<br> proxy_pass db_pool;<br> }<br> }
注意：仅 Nginx ≥ 1.19.5 支持，且只影响 nginx 到后端的连接
避开常见冲突配置
以下设置会直接抵消或静默忽略 tcp_nodelay 效果：
- 与
sendfile on;共存时，tcp_nodelay在零拷贝路径下自动失效（内核接管发送逻辑），但无需手动关闭——静态资源走 sendfile，动态接口走 proxy_pass + tcp_nodelay，天然隔离 -
tcp_nopush on;与tcp_nodelay on;逻辑相斥，不能同时启用；如用于 SSE 或 WebSocket，必须设为tcp_nopush off; -
proxy_buffering on;（默认值）会缓存响应，使tcp_nodelay失去作用目标；实时接口应设为proxy_buffering off;
验证是否真正生效
不能只看配置是否存在，要实证确认：
- Linux 下执行：
ss -i state established '( dport = :80 )' | grep nodelay，输出含nodelay表示已启用 - 抓包验证：用 Wireshark 观察两个相邻小响应包的时间间隔，排除网络排队后应接近 0ms
- 对比测试：用 ab（带
-k参数）压测同一接口，分别开启/关闭tcp_nodelay，观察 P95/P99 延迟变化
