如何在Nginx中利用Limit-Req实现针对特定API路径的分布式频率限制-linux运维-PHP中文网

Nginx原生limit_req仅支持单机限流，分布式需依赖外部组件；通过shared memory zone定义规则、location精确匹配路径、key组合IP/URI/用户标识实现近似分布式限流，强一致须用Redis+Lua或统一网关。

如何在nginx中利用limit-req实现针对特定api路径的分布式频率限制

在 Nginx 中使用 limit_req 对特定 API 路径做分布式限流，核心在于：**共享状态（通过 shared memory zone） + 精确匹配 location + 合理的 key 构造（如结合 client IP 和 URI）**。单机限流容易，但“分布式”在此语境下通常指多台 Nginx 实例需行为一致——这实际依赖外部协调（如 Redis），而 Nginx 原生命令不支持跨节点共享计数器。因此更准确的说法是：**在每台 Nginx 上独立部署一致的限流策略，并通过 key 设计（如含用户标识）让逻辑上“同一请求流”被同一定速规则约束；若需强一致性限流，则必须引入 Redis + Lua（OpenResty）或网关层统一控制。**

1. 基础配置：定义共享内存区与限流规则

在 http 块中声明一个共享内存 zone，用于存储请求计数状态：

http {
    # 定义名为 'api_limit' 的共享内存区，大小 10m（约可存 16 万 IP+key 组合）
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
<pre class="brush:php;toolbar:false;"># 可选：按 URI 路径限流（适合固定路径如 /api/v1/users）
limit_req_zone $uri zone=uri_limit:10m rate=5r/s;

# 更实用：组合 client IP + 请求路径（防单 IP 刷多个接口）
limit_req_zone "$binary_remote_addr$uri" zone=ip_uri_limit:10m rate=20r/m;

}

说明：

$binary_remote_addr 比 $remote_addr 更节省内存（固定 4 字节）
rate=10r/s 表示每秒最多 10 个请求；20r/m 即每分钟 20 次
内存大小需根据预期并发请求数估算（1MB ≈ 1.6 万条记录）

2. 精确作用于特定 API 路径

在 location 块中启用限流，只对目标路径生效：

server {
    listen 80;
    server_name api.example.com;
<pre class="brush:php;toolbar:false;"># 仅对 /api/v1/orders 路径限流（每分钟最多 30 次，允许突发 5 次）
location ^~ /api/v1/orders {
    limit_req zone=ip_uri_limit burst=5 nodelay;
    proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
}

# 对所有 /api/ 开头路径统一限流（用 $uri 区分不同子路径）
location ^~ /api/ {
    limit_req zone=uri_limit burst=3;
    proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
}

}

关键参数说明：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

burst=5：允许突发 5 个请求进入队列（超限后排队或拒绝）
nodelay：不延迟处理 burst 内请求（立即响应，但可能瞬间打满后端）
不加 nodelay 时，burst 请求会按速率平滑释放（更友好）
^~ 保证前缀匹配优先于正则，提升性能

3. 支持用户级（而非仅 IP）限流的进阶做法

若需按用户 token 或 app_id 限流（如每个 API Key 每分钟 100 次），需从请求头或参数提取标识：

http {
    # 从请求头 X-API-Key 提取，若为空则 fallback 到 IP
    map $http_x_api_key $limit_key {
        "" $binary_remote_addr;
        default $http_x_api_key;
    }
<pre class="brush:php;toolbar:false;">limit_req_zone $limit_key zone=per_key_limit:10m rate=100r/m;

}

server { location ^~ /api/ { limit_req zone=per_key_limit burst=20; proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e; } }

注意：