可通过Nginx原生模块实现按合作伙伴IP段的差异化QPS限流:1.用geo指令将IP段映射为partner_id;2.用map将partner_id转为对应limit_req_zone名称;3.定义多个zone并配置不同rate与burst;4.在location中通过zone=$req_zone动态应用限流策略。

可以通过 Nginx 的 limit_req 模块结合 geo 和 map 指令,为不同合作伙伴的 IP 段配置独立的 QPS 限流策略,实现精细化流量整形。
1. 使用 geo 指令划分合作伙伴 IP 段
先用 geo 指令将不同合作伙伴的 IP 段映射为可识别的标识符(如 partner_a、partner_b),便于后续分流处理。注意:geo 变量必须是字符串类型,且默认值要设为通用标识(如 “default”)以覆盖未匹配的请求。
- 在
http块中定义:
default "default";
192.168.10.0/24 "partner_a";
203.0.113.64/26 "partner_b";
2001:db8:abcd::/48 "partner_c";
}
支持 IPv4 和 IPv6,每个段只匹配一次,优先级按配置顺序从上到下(首条匹配即终止)。
2. 用 map 将 partner_id 映射为不同 limit_req zone 名称
limit_req 的 zone 参数不支持变量直接拼接,需借助 map 把 $partner_id 转为预定义的 zone 名(如 zone_a、zone_b),再在 location 中引用。
- 示例:
default "zone_default";
partner_a "zone_a";
partner_b "zone_b";
partner_c "zone_c";
}
这样,每个 partner_id 对应唯一 zone,后续可为各 zone 单独设置 rate 和 burst。
3. 定义多个 limit_req_zone 并差异化配置
在 http 块中为每个 zone 显式声明,按合作伙伴的 SLA 或能力设定不同 rate(如 10r/s、50r/s、100r/s),burst 值建议设为 rate 的 2–5 倍以应对短时突发。
- 例如:
limit_req_zone $binary_remote_addr zone_a zone=10m rate=10r/s;
limit_req_zone $binary_remote_addr zone_b zone=10m rate=50r/s;
limit_req_zone $binary_remote_addr zone_c zone=10m rate=100r/s;
注意:所有 zone 必须使用相同 key(如 $binary_remote_addr)才能按客户端 IP 统计;内存大小(如 10m)需根据预期并发连接数估算,避免 zone 溢出。
4. 在 location 中应用动态 zone
在 server 或 location 块中使用 limit_req,通过 zone=$req_zone 引用 map 输出的 zone 名,即可实现按 partner_id 自动选择限流策略。
- 示例配置:
limit_req zone=$req_zone burst=20 nodelay;
proxy_pass http://backend;
}
nodelay 表示不延迟响应(立即拒绝超限请求),适合强控场景;若需平滑排队,可去掉该参数,并适当调大 burst。
整个方案不依赖外部模块或 Lua,纯原生 Nginx 实现,稳定高效。关键是 geo → map → limit_req_zone → limit_req 的链路要严格对应,变量名和 zone 名不能拼错,且所有指令必须放在正确作用域(geo/map 在 http,limit_req_zone 在 http,limit_req 在 server/location)。

















