如何通过 `location` 块实现限流规则分层-Nginx-PHP中文网

nginx 通过 location 与 limit_req 配合实现分层限流，支持路径嵌套、变量动态选 zone、if+error_page 条件降级三种方式；需注意 zone 不叠加、burst 独立、正则优先级及显式声明规则。

如何通过 `location` 块实现限流规则分层

Nginx 的 location 块本身不直接支持限流，但可以通过与 limit_req 指令配合，在不同层级的 location 中嵌套或继承限流策略，实现“分层限流”——即按路径粒度、优先级或业务模块差异化控制请求速率。

基于路径层级嵌套限流

利用 location 的匹配顺序和作用域继承特性，可在父路径定义基础限流，子路径覆盖或叠加更严格的规则。Nginx 会优先匹配最具体的 location，其内部的 limit_req 生效，未定义则向上回溯（若上级有且未被子级显式禁用）。

示例：

limit_req_zone $binary_remote_addr zone=global:10m rate=10r/s;  
limit_req_zone $binary_remote_addr zone=api:10m rate=50r/s;  
limit_req_zone $binary_remote_addr zone=admin:10m rate=5r/s;  
<p>server {<br>
location / {<br>
limit_req zone=global burst=20 nodelay;  # 全站兜底：10qps<br>
}  </p><pre class="brush:php;toolbar:false;">location /api/ {  
    limit_req zone=api burst=100 nodelay;   # 接口层：50qps  
}  

location /api/admin/ {  
    limit_req zone=admin burst=10;         # 后台接口：5qps，严格限制  
}

}

注意：/api/admin/ 匹配时，只生效其自身 limit_req，不会叠加执行 /api/ 和 / 的规则——Nginx 不支持“多 zone 同时生效”，必须靠精准匹配和 zone 分离来模拟分层。

用变量动态选择限流 zone

通过 map 指令构造上下文感知的限流键或 zone 名，让同一 location 内根据请求特征（如 URI 前缀、header、参数）切换限流策略，实现逻辑上的分层。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

示例（按接口类型分流限流）：

map $request_uri $req_zone {  
    ~^/api/v1/user/     "user";  
    ~^/api/v1/order/    "order";  
    ~^/api/v1/report/   "report";  
    default             "default";  
}  
<p>limit_req_zone $binary_remote_addr zone=user:10m rate=30r/s;<br>
limit_req_zone $binary_remote_addr zone=order:10m rate=100r/s;<br>
limit_req_zone $binary_remote_addr zone=report:10m rate=5r/s;<br>
limit_req_zone $binary_remote_addr zone=default:10m rate=20r/s;  </p><p>server {<br>
location /api/ {<br>
limit_req zone=$req_zone burst=50 nodelay;<br>
}<br>
}</p>

这样，单个 location 就能根据 URI 自动路由到不同限流池，无需重复写多个 location 块，适合路径规则复杂或需频繁调整的场景。

结合 if + error_page 实现条件性限流降级

在关键 location 中，用 if 判断业务条件（如 header 标识、参数值），触发自定义限流行为，再通过 error_page 统一返回限流响应，形成“策略层 + 执行层”分离的分层结构。

示例（对未登录用户限流更严）：

limit_req_zone $binary_remote_addr zone=logged:10m rate=60r/s;  
limit_req_zone $binary_remote_addr zone=unlogged:10m rate=5r/s;  
<p>server {<br>
location /api/ {<br>
set $limit_key $binary_remote_addr;<br>
if ($http_x_user_id = "") {<br>
set $limit_key "unlogged:$binary_remote_addr";<br>
}  </p><pre class="brush:php;toolbar:false;">    # 动态 zone 名需提前定义，此处用固定 zone + key 区分  
    limit_req zone=logged burst=100 nodelay;  
    limit_req_status 429;  

    # 实际使用中常配合 error_page 拦截并重写响应  
    error_page 429 = @rate_limited;  
}  

location @rate_limited {  
    return 429 '{"error":"too many requests"}';  
    add_header Content-Type "application/json";  
}

}

该方式将“判断逻辑”和“限流执行”解耦，便于后期扩展风控维度（如 IP 地段、设备指纹等）。

避免常见分层陷阱

不要依赖 location 嵌套继承 limit_req：Nginx 不会自动合并父级和子级的限流指令，子 location 必须显式声明自己的 limit_req，否则沿用最近上级（可能不符合预期）
burst 缓存是 per-zone 的：不同 zone 的 burst 队列互不影响，不能靠多个 zone 累加缓冲能力
正则 location 优先级高于前缀匹配：若同时存在 location /api/ 和 location ~ ^/api/v\d+/，后者会优先生效，需检查匹配顺序是否符合分层意图
limit_req 默认拒绝超出请求：如需排队等待，必须显式加 nodelay 或设置 delay 参数，否则 burst 外的请求立即 503