如何配置 limit_req_zone 在 http 块定义全局的请求速率限制桶-Nginx-PHP中文网

limit_req_zone在http块中定义共享内存区域用于限流统计，仅声明“建桶”不生效，必须配合location/server中的limit_req使用；参数包括$key（如$binary_remote_addr）、zone=name:size（名称唯一、大小合理）、rate=rate（静态值，单位r/s或r/m），禁用server/location内定义。

如何配置 limit_req_zone 在 http 块定义全局的请求速率限制桶

在 Nginx 的 http 块中配置 limit_req_zone，本质是定义一个共享内存区域（zone），用于存储按指定键（key）统计的请求频次数据。它本身不生效，只是“建桶”，后续需在 server 或 location 中用 limit_req “取桶使用”。

✅ 正确写法：必须放在 `http { ... }` 大括号内

http {
    # 定义一个名为 perip、大小 2MB、按客户端 IP 限速 5r/s 的桶
    limit_req_zone $binary_remote_addr zone=perip:2m rate=5r/s;

    # 定义一个按接口路径限速的桶（适合保护 API）
    limit_req_zone $request_uri zone=byuri:3m rate=2r/s;

    # 组合键示例：IP + 路径（更精细，但内存占用更高）
    limit_req_zone $binary_remote_addr$request_uri zone=ipuri:4m rate=1r/s;

    server {
        listen 80;
        location /api/ {
            limit_req zone=byuri burst=3;
        }
    }
}

⚠️ 注意：limit_req_zone 不能出现在 server、location 或 if 块中，否则启动会报错：
"limit_req_zone" directive is not allowed here

? 关键参数说明

$variable（键）
推荐用 $binary_remote_addr（IPv4 固定 4 字节，IPv6 固定 16 字节），比 $remote_addr 更省内存、哈希更稳；
若需按接口限速，用 $request_uri；组合时可拼接，如 $binary_remote_addr$request_uri。
zone=name:size（内存区域）
name 必须全局唯一；size 要合理——Linux 下常用 10m，但 phpEnv 等 Windows 环境建议 ≤3m（实测 2m–3m 最稳定）；
内存不足会导致限流静默失效（日志里出现 limiting requests, excess 却无拒绝）。
rate=xxr/s 或 xxr/m（速率）
只支持静态值，不能用变量（如 rate=$my_rate 是非法的）；
单位 r/s 表示每秒请求数，基于漏桶算法平滑控制。