不能直接在 limit_req_zone 中用 $http_user_agent,因为其 key 仅支持变量插值,不支持条件过滤;每个 UA 会被单独计数,无法实现“仅限特定 UA”的效果。需用 map 指令预筛 UA 并映射为非空字符串(如 "1")作为限流开关,空字符串则跳过限流;正则须加 ~* 忽略大小写,default "" 不可省略;zone 应基于 $limit_key 定义,并在 location 中启用 limit_req;验证时用 curl 模拟目标 UA,注意 map 必须置于 http 块顶层且 reload 生效。

为什么不能直接在 limit_req_zone 里用 $http_user_agent?
因为 limit_req_zone 的 key 只支持变量插值,但不支持对原始字符串做条件过滤或白名单匹配;直接写 $http_user_agent 会导致每个 UA 都被单独计数,根本起不到“只限特定 UA”的效果。真正要的是:只有匹配某类 UA(比如爬虫)才触发限流,其余放行。
用 map 指令预筛 User-Agent 并映射为限流开关值
map 是 Nginx 内置的键值映射模块,适合把复杂条件转成简单标识符。关键在于:把目标 UA 匹配结果映射为一个非空字符串(如 "1"),而其他 UA 映射为空字符串 —— 因为 limit_req_zone 会忽略空 key。
map $http_user_agent $limit_key {
~*(python-requests|curl|wget|httpie) "1";
~*bot.*google|bing|yandex "1";
default "";
}
- 正则必须加
~*表示忽略大小写,否则多数 UA 不会匹配 -
default ""很重要:空字符串会让limit_req跳过该请求,不参与计数 - 不要用
0或"0"代替空字符串——Nginx 会把它当有效 key 计数
搭配 limit_req_zone 实现精准限流
定义 zone 时使用 $limit_key 作为 key,这样只有 map 输出非空时才会进入限流逻辑:
limit_req_zone $limit_key zone=ua_limit:10m rate=5r/s;
然后在 server 或 location 块中启用:
limit_req zone=ua_limit burst=10 nodelay;
-
burst=10允许短时突发,避免误杀(比如合法爬虫偶发多请求) -
nodelay表示不延迟响应,超限直接返回 503;若想平滑限速,去掉它 - 注意:如果同时有其他限流规则(如按 IP),需确认它们的 zone 名称不冲突
验证是否生效及常见失效点
最直接的方式是用 curl 发送带目标 UA 的请求,观察响应头或日志:
curl -H "User-Agent: python-requests/2.28.0" http://your.site/
若返回 503 或日志中出现 limiting requests,说明命中限流。常见失效原因:
-
map块没放在http块顶层,导致无法被limit_req_zone引用 - UA 字符串里含空格或特殊字符(如
Mozilla/5.0 (X11; Linux x86_64)),正则未覆盖全,建议先用log_format打印原始$http_user_agent确认实际值 - 浏览器或工具自动发送多个 UA(如 Chrome DevTools 的 Network → Edit → User-Agent),干扰测试结果
map 的匹配逻辑是静态编译进配置的,改完必须 nginx -t && nginx -s reload,热重载不生效这点容易被忽略。


















