网站被单台机器或单个 IP 疯狂刷接口,是中小站点头疼的常见事:轻则带宽被打满、后端扛不住,重则数据库连接被耗尽、正常用户也跟着打不开页面。Nginx 自带的限流模块(limit_req 与 limit_conn)能在入口处就把这类请求挡掉,不需要写一行代码,也不用额外装组件,配置得当就能显著降低被刷的成本。
这篇文章讲清楚 Nginx 限流的两套工具分别在做什么、rate、burst、nodelay 这些参数到底怎么算、按 IP 还是按 URI 限流、以及最麻烦的一件事——上线后发现自己人/正常用户被误拦了怎么排查和放行。文中给出的速率、突发额度都是常见经验值,具体数值要结合你的业务峰值来定,不能照抄。
读完之后,你应该能在不影响正常用户的前提下,给登录接口、短信接口、搜索接口这类高风险入口装上合适的限流规则,并且知道 503 和 429 是怎么来的、日志里该看哪个字段来定位误伤。
一、两种限流工具:请求速率 vs 并发连接
Nginx 原生有两条独立的限流路径,作用完全不同,很多人会把它们搞混:
limit_req(请求速率限流):限制单位时间内允许的请求数,比如"每个 IP 每秒最多 10 个请求"。超出部分按配置被延迟或直接拒绝。它管的是"请求有多快"。limit_conn(并发连接限流):限制单个 IP 同时保持的连接数,比如"每个 IP 最多同时 20 个连接"。它管的是"同时占用多少条连接",对下载、长连接、爬虫特别有用。
简单经验:接口被高频调用的用 limit_req,被长时间占用连接(下载、大响应)的用 limit_conn,两者可以同时启用,互补。比如一个下载站,既限制单 IP 每秒请求数(防枚举),又限制单 IP 并发连接数(防多线程狂拖),效果最好。
要理解限流,先得知道 Nginx 用"漏桶"的方式计数:每个 key(通常是 IP)对应一个桶,请求进来往桶里加水,桶按 rate 设定的速度往外漏。桶满了,新请求要么排队等(burst 允许的缓存量),要么直接被拒。
二、limit_req 的核心参数
先看一段典型配置,再逐条拆解:
# 在 http 块中定义限流区域(内存区)
# 10m 大约能存约 16 万个 IP 的状态(经验值,与平台和 key 长度有关)
limit_req_zone $binary_remote_addr zone=req_perip:10m rate=10r/s;
server {
listen 80;
server_name www.example.com;
location /api/ {
limit_req zone=req_perip burst=20 nodelay;
limit_req_status 429;
proxy_pass http://backend;
}
}
参数含义:
| 参数 | 含义 | 说明 |
|---|---|---|
$binary_remote_addr |
限流 key | 用二进制形式的客户端 IP,比 $remote_addr 省内存 |
zone=req_perip:10m |
共享内存区名称与大小 | 10m 约存 16 万 IP 状态,经验值 |
rate=10r/s |
平均速率 | 每秒 10 个请求;也可写 600r/m |
burst=20 |
突发额度 | 允许瞬时超出的排队请求数 |
nodelay |
不延迟 | 突发内的请求立即处理,而不是排队慢慢放 |
limit_req_status 429 |
超限状态码 | 默认 503,建议改成 429 更语义化 |
几个关键点必须讲透:
rate 是平均速率,不是硬性"每秒最多 N 个"。 由于是漏桶,允许一定的瞬时抖动,burst 越大越平滑但越宽松。
burst 决定"排队"还是"拒绝"。 假设 rate=10r/s、burst=20,某 IP 瞬间发 30 个请求:前 10 个正常处理,接下来的 20 个进入桶等待,超出的部分才被拒。如果不加 burst,任何超过速率的请求直接被拒,正常用户偶尔连点也会被误伤。
nodelay 是个双刃剑。 不加 nodelay 时,burst 里的请求会被 Nginx 压着按 rate 的速度逐个放行,用户会感觉"卡顿";加了 nodelay 后,桶内请求立即全部放行,只有真正超出 rate × 时间 + burst 的才被拒,用户体验更顺滑。对普通接口,建议加 nodelay;对后端脆弱、需要削峰的接口,可以不加,让流量被拉平。
还有一种折中写法,适合后端偶尔抽风但又不想要总延迟的场景:
# 允许 burst 中有 5 个立即放行,其余排队
limit_req zone=req_perip burst=20 delay=5;
三、limit_conn:限制并发连接数
下载站、视频站最怕单个 IP 拉几十条连接狂下。limit_conn 解决这个:
# http 块中定义连接区
limit_conn_zone $binary_remote_addr zone=conn_perip:10m;
server {
location /download/ {
limit_conn conn_perip 5; # 单 IP 最多 5 个并发连接
limit_conn_status 429;
alias /data/files/;
}
}
limit_conn conn_perip 5 表示每个 IP 对 /download/ 的并发连接不超过 5,超过的请求返回 429。经验上,普通浏览类站点单 IP 并发 10~20 足够,下载类可以设 3~5,具体看文件大小和带宽。注意:连接数限制是按"请求/连接"计的,HTTP/2 下一条连接可承载多路复用,计数行为与 HTTP/1.1 略有差异,要结合实际压测确认。
四、按什么维度限流:IP、URI 还是别的
默认按 IP 限流最省事,但有时想按接口维度或"IP+接口"组合限。Nginx 允许自定义 key:
| 限流维度 | key 写法 | 适用场景 |
|---|---|---|
| 单 IP | $binary_remote_addr |
通用防刷 |
| 单接口 | $uri |
保护热点接口整体吞吐 |
| IP + 接口 | $binary_remote_addr$uri |
精准到"某 IP 刷某接口" |
| IP + 域名 | $binary_remote_addr$host |
多站点共用一套限流 |
| 用户登录态 | $http_authorization 等 |
按用户而非 IP 限,避免 NAT 误伤 |
组合 key 要留意内存:key 越长、组合越多,zone 需要的内存越大,10m 的容量要相应上调。
NAT 场景的坑:公司、学校、商场出口往往几百人共用一个公网 IP。如果你按 IP 限得很死(比如 1r/s),整栋楼的用户会一起被拦,这是最常见的"误拦截"来源。这时候要么按 $http_x_forwarded_for 里更细的 IP 限(前提是 Nginx 前面有可信代理且 XFF 未被伪造),要么把 rate 放宽,要么按登录用户维度限。
五、误拦截排查:四步定位
限流上线后最怕的是"正常用户被拦,还找不到原因"。按下面顺序查:
第一步,确认是不是限流拦的。 看错误日志,限流拒绝默认记为 limiting requests(limit_req)或 limiting connections(limit_conn),状态码默认 503,改过则是 429:
sudo tail -f /var/log/nginx/error.log
# 典型输出:
# 2027/10/12 10:20:31 [error] 1234#0: *567 limiting requests, excess: 1.234 by zone "req_perip", client: 1.2.3.4, server: www.example.com, request: "POST /api/login ..."
这里 excess: 1.234 表示超出额度 1.234 个请求,by zone 说明命中的是哪条限流规则,client 是被拦的 IP。这条日志信息量很大,一定要会读。
第二步,统计是不是某个 IP 集中被拦。 按时段聚合错误日志里的 client:
# 统计被限流次数最多的 IP(近万行日志)
sudo grep "limiting requests" /var/log/nginx/error.log | \
grep -oP 'client: \K[0-9.]+' | sort | uniq -c | sort -rn | head
# 统计命中限流的接口
sudo grep "limiting requests" /var/log/nginx/error.log | \
grep -oP 'request: "\w+ \K/[^ "]*' | sort | uniq -c | sort -rn | head
第三步,确认是不是 NAT 共享出口。 如果一个 IP 在访问日志里对应多个完全不同的 User-Agent、且请求形态差异大,多半是共享出口。可以临时把这台 IP 加白名单验证业务是否恢复。
第四步,调整参数或加白名单。 临时放行某个 IP 用 allow 但要注意顺序——allow/deny 的控制和限流是两回事,限流白名单更推荐用 geo 变量把 key 置空:
# 把内网和监控 IP 排除在限流之外
# 方式:用一个空 key,使这些 IP 不进入限流桶
geo $limit_key {
default $binary_remote_addr;
10.0.0.0/8 ""; # 内网不限
192.168.0.0/16 "";
203.0.113.10/32 ""; # 公司出口、监控探针
}
limit_req_zone $limit_key zone=req_perip:10m rate=10r/s;
风险提示:修改 Nginx 配置后,务必先 nginx -t 校验语法,通过再 nginx -s reload。reload 是平滑的,不会断开现有连接;但如果新配置本身有语法错误,reload 会被拒绝(旧配置继续生效),这其实是保护机制,不要用 restart 硬重启去"绕过"报错。回滚方式:事先把旧配置备份成 .bak,出问题时还原并 nginx -t 后 reload。
六、数字怎么定:一个可落地的方法
限流阈值定得太松等于没限,定得太紧就误伤,建议这样定:
- 先观察再设限。看访问日志里正常用户的请求频率分布,取 P95 或 P99 作为参考基线(经验做法),不要把平均值当上限,否则一半以上正常用户会被波及。
- 接口分级。首页、静态资源这类可以宽松(如 50r/s),登录、短信、下单这类要严格(如 5r/s 甚至 1r/s)。
- 给突发留余地。
burst一般设为rate的 2~5 倍(经验值),既能吸收正常突发,又能挡住持续刷量。 - 压测验证。用
ab、wrk或hey在测试环境验证阈值,观察 429 比例是否可控:
# 用 wrk 压测,观察限流是否按预期触发(需先安装 wrk)
wrk -t4 -c50 -d10s http://www.example.com/api/
# 用 ab 简单验证
ab -n 2000 -c 100 http://www.example.com/api/
- 上线后持续看错误日志,头几天重点盯
limiting记录,确认没有大面积误伤再稳定下来。
常见问题
Q1:限流返回的是 503 还是 429?能不能改?
默认 503。建议显式配置 limit_req_status 429; 和 limit_conn_status 429;,429 是标准的"请求过多"语义,前端和监控更容易识别。
Q2:加了限流后,公司同事全被拦了,怎么办?
典型 NAT 共享出口问题。用 geo 把公司出口 IP 的 key 置空放行,或把限流维度从"纯 IP"改成"IP+接口/用户"并放宽阈值。
Q3:burst 和 nodelay 到底要不要一起用?
要。只有 burst 没有 nodelay,突发请求会排队变慢;加了 nodelay 突发请求立即放行,体验最好。但对需要削峰的后端,可以故意不加 nodelay。
Q4:限流生效了但刷量还在,为什么?
可能是对方有大量 IP(代理池),按单 IP 限自然挡不住。这种情况要下沉到 WAF、按 URI 整体限流、或加验证码/风控,单靠 Nginx 单 IP 限流能力有限。
Q5:改了配置 reload 出问题怎么快速回滚?
保留 .bak 备份,出问题把备份复制回去,nginx -t 通过后 nginx -s reload。切记不要在语法错误未解决时用 restart 强起,会导致服务不可用。
总结
limit_req管请求速率(每秒多少个请求),limit_conn管并发连接数(同时几条连接),两者互补,高风险站点建议同时开启。- 关键参数是
rate(平均速率)、burst(突发额度)、nodelay(是否延迟突发请求),burst一般取rate的 2~5 倍(经验值)。 - 限流维度可自定义,NAT 共享出口是误拦截的头号原因,用
geo把可信 IP 的 key 置空即可放行。 - 排查误拦按"看 error.log 里的 limiting 记录 → 聚合 client/接口 → 判断是否 NAT → 调整或放行"四步走。
- 改配置先备份、
nginx -t校验、reload生效,是最稳妥的操作顺序;阈值要基于真实日志分布,别拍脑袋。
企业QQ咨询




