limit_req_zone本身不用于负载均衡，而是通过自定义变量（如用户等级、来源IP、接口路径等）实现按业务维度的差异化限流，需配合map、多zone定义或OpenResty/Lua动态控制，本质是精细化流量治理而非流量分发。
limit_req_zone 本身不用于负载均衡，而是用于请求速率限制（限流）。它不能直接分配流量到不同后端（那是 upstream + proxy_pass 的职责），但可以和自定义变量配合，在限流层面实现基于业务逻辑的差异化管控——比如对高优先级用户放行、对爬虫限速、对特定接口或来源做弹性限流等。这种“管控”虽非传统负载均衡，却是生产中更精细的流量治理手段。
一、核心原理：用变量动态决定限流策略
limit_req_zone 的第一个参数是 $variable，它的值决定了“谁被归为同一限流单元”。只要让这个变量携带业务含义（如用户等级、API 分组、设备类型、来源渠道），就能实现按需限流。
http {
# 根据用户等级（来自 Header 或 Cookie）生成限流键
map $http_x_user_tier $rate_key {
default $binary_remote_addr;
"vip" "$binary_remote_addr-vip";
"partner" "$binary_remote_addr-partner";
}
# 定义不同 key 对应不同速率的限流区（注意：一个 zone 只能配一种 rate）
limit_req_zone $rate_key zone=per_tier:10m rate=5r/s;
}⚠️ 注意：Nginx 不支持单个 zone 动态切换 rate。所以真正实现“差异化速率”，需配合多个 limit_req_zone + map 分流判断。
二、实现多级速率：用 map 映射不同限流区
http {
# 步骤1：提取业务维度（例如从请求头取用户类型）
map $http_x_user_role $limit_zone {
"admin" "admin_zone";
"vip" "vip_zone";
"free" "free_zone";
default "free_zone";
}
# 步骤2：定义多个独立限流区（每个 zone 对应一种速率）
limit_req_zone $binary_remote_addr zone=admin_zone:10m rate=100r/s;
limit_req_zone $binary_remote_addr zone=vip_zone:10m rate=20r/s;
limit_req_zone $binary_remote_addr zone=free_zone:10m rate=5r/s;
# 步骤3：在 location 中按需调用对应 zone
server {
location /api/ {
# 利用 if + set 模拟“条件调用”（Nginx 不支持变量 zone 名，需迂回）
set $chosen_zone "";
if ($limit_zone = "admin_zone") { set $chosen_zone "admin_zone"; }
if ($limit_zone = "vip_zone") { set $chosen_zone "vip_zone"; }
if ($limit_zone = "free_zone") { set $chosen_zone "free_zone"; }
# ⚠️ 以下写法无效！Nginx 不允许变量 zone 名：
# limit_req zone=$chosen_zone burst=10;
# ✅ 正确做法：用多个 limit_req 指令 + if（需搭配 error_page 或 rewrite 规避冲突）
# 更推荐：拆成多个 location 或用 Lua（OpenResty）实现动态 zone 调用
}
}
}? 实际生产中，纯 Open Source Nginx 不支持动态 zone 名。上述
if + set无法直接驱动limit_req zone=。可靠方案有两种：
-
方案 A：按业务维度拆 location
location ^~ /api/vip/ { limit_req zone=vip_zone burst=20 nodelay; proxy_pass http://backend_vip; } location ^~ /api/admin/ { limit_req zone=admin_zone burst=50 nodelay; proxy_pass http://backend_admin; } -
方案 B：引入 OpenResty + Lua（推荐）
-- 在 access_by_lua_block 中动态计算 key 和阈值 local user_role = ngx.req.get_headers()["x-user-role"] or "free" local key = ngx.var.binary_remote_addr .. ":" .. user_role local rate_map = { admin = 100, vip = 20, free = 5 } local rate = rate_map[user_role] or 5 -- 调用 resty.limit.traffic 或自定义令牌桶逻辑
三、结合黑白名单做业务豁免
常见需求：内部运营系统、监控探针、合作方 IP 免限流。
# 1. 定义白名单网段
geo $is_whitelist {
default 0;
10.0.0.0/8 1;
192.168.100.0/24 1;
203.0.113.5 1; # 合作方固定 IP
}
# 2. 构造限流 key：白名单用户用空字符串 → 不触发限流
map $is_whitelist $limit_key {
1 ""; # 白名单：key 为空 → limit_req 不生效
0 $binary_remote_addr;
}
# 3. 应用限流（仅对非白名单生效）
limit_req_zone $limit_key zone=api_limit:10m rate=10r/s;
server {
location /api/ {
limit_req zone=api_limit burst=5 nodelay;
proxy_pass http://backend;
}
}✅ 效果：白名单 IP 完全绕过限流；其余按 IP 精确限速。
四、按接口路径 + 用户特征组合限流（灰度/AB 流量控制）
例如：对 /payment 接口，VIP 用户不限速，普通用户限 2r/s，灰度用户限 10r/s。
map $http_x_user_type $api_limit_key {
"vip" "";
"gray" "$binary_remote_addr-gray";
"normal" "$binary_remote_addr-normal";
default "$binary_remote_addr-normal";
}
limit_req_zone $api_limit_key zone=pay_limit:10m rate=2r/s;
limit_req_zone $api_limit_key zone=pay_gray:10m rate=10r/s;
# ❌ 仍受限于单 zone 单 rate —— 所以更实用的是：
# 将 gray 和 normal 分到不同 location，或用 Lua 做运行时判断
location /payment {
# 先匹配灰度用户（Header 中带 x-env: gray）
if ($http_x_env = "gray") {
set $use_gray_limit "1";
}
# 利用 error_page + internal 跳转实现“条件限流”
limit_req zone=pay_normal burst=3 nodelay;
if ($use_gray_limit = "1") {
limit_req zone=pay_gray burst=15 nodelay;
}
# ⚠️ 注意：if 在 location 中对 limit_req 无效 —— 这里仅为示意逻辑
# 实际需用 Lua 或拆 path
}? 关键提醒：Nginx 配置是静态解析的，
if不能改变limit_req的执行路径。真要实现运行时多策略，必须用 OpenResty/Lua，或提前规划好 path/Host/URI 分层。
不复杂但容易忽略：限流只是流量整形的第一步。它和负载均衡（upstream）、缓存（proxy_cache）、灰度（split_clients / lua-resty-balancer）协同，才能构成完整的业务流量调度体系。limit_req_zone + 自定义变量的价值，不在替代负载均衡，而在让限流这件事“懂业务”。
