发布时间:2026-09-30 12:32 更新时间:2026-09-30 12:32 阅读量:11
给接口加限流是很多站长做过的事,配置写上去、Nginx 也重载了,可一压测还是随便打穿,日志里看不到一条 503,限制像是完全没生效。这类问题多半不是 Nginx 坏了,而是三个细节没对齐:zone 定义的位置和作用域、limit_req 所放层级与请求实际经过的 server、以及开了 CDN 之后 $binary_remote_addr 取到的到底是谁的 IP。下面按这三条逐个验证,每条都给出能直接照着跑的命令。
limit_req_zone 属于 http 上下文指令,只能写在 http 块里,不能写在 server 或 location 内。很多站长图省事把它塞进某个站点的 server 块,Nginx -t 会直接报错,于是又挪回去,改来改去反而忘了原来的定义。正确做法是在 http 块(宝塔面板通常是 nginx.conf 或单独引入的 conf 文件)中定义,例如按 IP 限流每秒 10 个请求、突发 20:
http {
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
server {
listen 80;
server_name example.com;
location /api/ {
limit_req zone=api_limit burst=20 nodelay;
proxy_pass http://127.0.0.1:8080;
}
}
}
zone 的容量参数(这里是 10m)决定能记住多少个 key 的状态。10m 大约能容纳十几万个 IPv4 地址的状态,具体换算以官方文档为准。如果站点日活 IP 量很大而 zone 给小了,超出容量的新 key 会被丢弃、不再计数,表现就是“有时候限得住、有时候限不住”。判断方法很简单:看 limit_req 生效时返回的状态码是否为 503,同时用下面命令确认配置确实被加载:
nginx -t
nginx -T | grep -A2 limit_req_zone
nginx -s reload
nginx -T 会把最终合并后的完整配置打印出来,如果 grep 不到 limit_req_zone,说明你改的文件根本没被 include 进来,或者改错了站点目录。这一条是排查的第一站,不要跳过。
limit_req 可以出现在 http、server、location 三个层级,作用范围是“包含它的块及其子块”。常见失误有两种:一是把限流写在某个 location 上,但真实请求命中的是另一个更精确的前缀或正则 location;二是伪静态或反代规则里用了 try_files、rewrite,请求被内部重写后跑到了别处,限流那条 location 压根没匹配上。
验证思路是让 Nginx 告诉你请求进了哪个 location。可以临时加一个响应头或打日志,最简单的是在疑似生效的 location 里写 add_header:
location /api/ {
limit_req zone=api_limit burst=20 nodelay;
add_header X-Limit-Zone "api" always;
proxy_pass http://127.0.0.1:8080;
}
重载后用 curl 看响应头里有没有 X-Limit-Zone,没有就说明请求没进这个 location。也可以打开 error_log 的 info 级别观察限流记录,但注意 info 级别日志量较大,排查完记得调回 warn 或 error。另外要留意 limit_req 只对当前请求生效,如果前面还有一层负载均衡或另一台 Nginx,限流只发生在你配置的那一层,前端那层不配就等于没配。
还有一个容易忽略的点:location 匹配优先级。前缀 location 之间是最长匹配优先,正则 location 按出现顺序匹配。如果你在 /api/ 上配了限流,又在 /api/v1/ 上配了别的规则,那么 /api/v1/xxx 会走 /api/v1/ 而不是 /api/,限流自然绕过去了。排查时把 nginx -T 的输出从头到尾看一遍,确认每个路径最终落到哪个块。
这是压测“无效”最常见的原因。开了 CDN 之后,真正连到源站的是 CDN 回源节点,$binary_remote_addr 拿到的就是那几个节点 IP。所有访客在 Nginx 眼里都是同一个 IP,要么一起被限、要么因为节点数量少而永远触发不了阈值,压测时用一台机器打,看起来就像限流没开。
解决办法是配置 real_ip 模块,让 Nginx 从回源请求头里还原真实客户端 IP。注意:只有当你确认源站只接受该 CDN 节点回源、且 CDN 会正确覆盖该头时,这样配才是安全的;否则客户端可以伪造头绕过限流。示例(以 Cloudflare 的 CF-Connecting-IP 为例,其他 CDN 请对照其官方文档选择对应头):
http {
set_real_ip_from 173.245.48.0/20;
set_real_ip_from 103.21.244.0/22;
real_ip_header CF-Connecting-IP;
real_ip_recursive on;
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
}
set_real_ip_from 填的是 CDN 回源节点网段,各厂商会不定期更新,务必从官方地址列表获取,不要照抄网上的旧网段。配置完成后,用一条带真实 IP 的请求验证:
curl -H "CF-Connecting-IP: 203.0.113.10" -I https://example.com/api/test
tail -f /www/wwwlogs/example.com.log
看访问日志里记录的 remote_addr 是不是变成了 203.0.113.10。如果日志里还是节点 IP,先检查 real_ip 模块是否编译进当前 Nginx(nginx -V 查看),再确认头名称和网段是否匹配。宝塔面板用户还要注意:日志里显示的 IP 和限流用的 key 是两套逻辑,real_ip 配置正确后两者才会一致。
限流不生效,先别急着怀疑 Nginx 版本,按“zone 定义 → limit_req 层级 → 真实 IP”这条顺序走一遍,多数问题都能定位。压测时建议用多台不同出口 IP 的机器或带随机 X-Forwarded-For 的工具,避免单 IP 测试掩盖问题。改完配置用 nginx -t 校验后再 reload,观察一段时间 error_log 里 limit_req 相关记录,确认 503 出现的频率符合预期。如果业务对突发流量敏感,可以把 burst 和 nodelay 组合起来做削峰,具体参数需要结合接口承载能力压测后确定,不要照搬网上的固定值。
| 📑 | 📅 |
|---|---|
| WordPress数据库MyISAM转InnoDB:引擎、行格式与写入观察 | 2026-09-30 |
| 宝塔面板站点开 HTTP/3:Nginx 版本、Brotli 与 CDN 回源链路评估 | 2026-09-30 |
| Nginx 与 PHP-FPM 用 Unix socket 报 502:属主与用户组对齐排查 | 2026-09-30 |
| 宝塔面板 Nginx 反代 Node.js 与 Python:proxy_pass、WebSocket 与 502 排查 | 2026-09-30 |
| WordPress迁移后小工具和菜单丢失:序列化数据与WP-CLI替换思路 | 2026-09-30 |
| 宝塔多版本PHP站点选错版本:fastcgi_pass与.user.ini排查 | 2026-09-30 |
| 宝塔面板站点被降权前的征兆:抓取频次、收录量与Nginx日志交叉观察 | 2026-10-01 |
| 宝塔面板防盗链误伤自家CDN:白名单与空Referer放行 | 2026-10-01 |
| Nginx add_header 层层覆盖导致安全响应头丢失:继承规则与location嵌套排查 | 2026-10-01 |
| WordPress上传图片自动生成多尺寸缩略图:禁用与冗余清理 | 2026-10-01 |