Nginx 限流不生效排查:zone、层级与 CDN 真实 IP 三个坑

    发布时间:2026-09-30 12:32 更新时间:2026-09-30 12:32 阅读量:11

    给接口加限流是很多站长做过的事,配置写上去、Nginx 也重载了,可一压测还是随便打穿,日志里看不到一条 503,限制像是完全没生效。这类问题多半不是 Nginx 坏了,而是三个细节没对齐:zone 定义的位置和作用域、limit_req 所放层级与请求实际经过的 server、以及开了 CDN 之后 $binary_remote_addr 取到的到底是谁的 IP。下面按这三条逐个验证,每条都给出能直接照着跑的命令。

    一、zone 定义位置与共享内存是否真的生效

    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 放错层级,请求根本没走到那条 location

    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 场景下 $binary_remote_addr 取到的是节点 IP

    这是压测“无效”最常见的原因。开了 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