nodelay 参数使nginx跳过令牌桶等待，突发请求在burst容量内立即转发，超限即返503，保障静态资源毫秒级低延迟。
使用 limit_req 的 nodelay 参数，可以在不引入排队延迟的前提下，对请求进行速率控制，同时保持静态资源（如 JS、CSS、图片）的极低转发延迟。关键在于：它跳过令牌桶的等待逻辑，允许突发请求立即通过（只要不超过 burst 容量），避免了默认情况下因排队导致的毫秒级延迟累积。
理解 nodelay 的核心行为
nodelay 不是关闭限流，而是关闭“延迟执行”。默认模式下，当令牌桶暂空时，Nginx 会把超额请求挂起，等新令牌生成后再放行（产生 delay）；而启用 nodelay 后，Nginx 直接检查当前桶中是否有足够令牌——有则立即通过，没有则直接返回 503（或按配置拒绝），绝不等待。
- 适合静态网关场景：资源本身无后端计算，转发链路应尽可能接近网络往返时间（RTT）
- 必须配合
burst使用：单独用nodelay而无burst等价于严格每秒 N 个请求，突增即大量 503 - 不缓解瞬时洪峰，但防止慢速堆积：避免因排队把 10ms 请求拖成 200ms，保障 P99 延迟稳定
典型静态网关配置示例
假设需支撑日常 1000 QPS、允许短时 2000 请求突发，且绝不接受排队延迟：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
limit_req_zone $binary_remote_addr zone=static:10m rate=1000r/s;
<p>server {
location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ {
limit_req zone=static burst=2000 nodelay;
expires 1y;
add_header Cache-Control "public, immutable";
root /var/www/static;
}
}</p>
-
rate=1000r/s：长期平均速率基线 -
burst=2000：允许最多 2000 个请求暂存于桶中（非队列，是“信用额度”） -
nodelay：所有在 burst 范围内的请求零等待直接转发 - 超出 burst 的请求立即返回 503，不缓冲不排队
与默认模式的关键对比
同样配置 zone=static burst=2000，有无 nodelay 行为截然不同：
- 无
nodelay：第 1001 个请求会被挂起约 1ms（1/1000 秒），第 2000 个可能等 1s，P99 延迟被拉高 - 有
nodelay：前 2000 个请求全部在微秒级完成，第 2001 个立刻 503，延迟曲线陡峭但可控 - 真实网关中，后者更利于 CDN 回源、浏览器并发加载等对延迟敏感的场景
注意事项与调优建议
nodelay 是一把双刃剑，需结合监控和业务容忍度使用：
- 务必开启日志记录被限流请求：
limit_req_log_level error;，便于识别是否误伤正常突发 - burst 值不宜过大：过大的 burst 会掩盖真实攻击，也增加内存占用（每个连接需跟踪状态）
- 优先按客户端 IP 分区（
$binary_remote_addr），而非全局 zone，避免单用户占满额度影响他人 - 可叠加
limit_req_status 429返回标准码，方便前端做降级或重试策略
