Nginx如何限制单个IP的访问频率?限流规则与误拦截排查

网站被单台机器或单个 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。

六、数字怎么定:一个可落地的方法

限流阈值定得太松等于没限,定得太紧就误伤,建议这样定:

  1. 先观察再设限。看访问日志里正常用户的请求频率分布,取 P95 或 P99 作为参考基线(经验做法),不要把平均值当上限,否则一半以上正常用户会被波及。
  2. 接口分级。首页、静态资源这类可以宽松(如 50r/s),登录、短信、下单这类要严格(如 5r/s 甚至 1r/s)。
  3. 给突发留余地。burst 一般设为 rate 的 2~5 倍(经验值),既能吸收正常突发,又能挡住持续刷量。
  4. 压测验证。用 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/
  1. 上线后持续看错误日志,头几天重点盯 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 生效,是最稳妥的操作顺序;阈值要基于真实日志分布,别拍脑袋。