nginx可通过map指令将请求头映射为变量，再结合limit_req_zone实现基于user-agent、authorization等请求头的动态限流；需注意大小写处理、空值判断及map执行时机。
Nginx 本身不支持直接基于任意请求头（如 User-Agent、X-Forwarded-For、Authorization 等）做动态限流，但可以通过 limit_req 模块配合 map 指令，将请求头映射为限流键（key），从而实现“基于请求头的动态限流”。
用 map 提取并分类请求头值
限流依赖唯一 key，而 Nginx 的 limit_req_zone 只接受变量作为 key。所以需先用 map 将请求头转为可控制的变量，比如按客户端标识、API 版本或用户等级分组限流：
- 定义一个 map，把
$http_user_agent映射为简化标签（如 mobile / desktop / bot） - 或提取
$http_authorization中的 token 前缀，用于区分不同应用 - 也可结合正则，例如从
$http_x_api_version提取 v1/v2，实现版本级限流
配置 limit_req_zone 使用 map 变量
在 http 块中定义限流区域，key 使用上一步生成的 map 变量：
map $http_user_agent $ua_type {
default "other";
"~*mobile" "mobile";
"~*curl|httpie" "tool";
"~*bot|crawl" "bot";
}
limit_req_zone $ua_type zone=by_ua:10m rate=5r/s;
这样，所有含 “mobile” 的 UA 被归为同一组，共享每秒 5 次的配额；爬虫请求则被单独限频，避免影响正常用户。
在 location 中启用限流并设置突发容量
在具体路由中引用 zone，并可选配置突发（burst）和延迟（nodelay）策略：
-
limit_req zone=by_ua burst=10 nodelay;允许最多 10 次瞬时突增，不排队直接拒绝超额请求 - 去掉
nodelay会启用平滑排队，超限请求等待，适合对延迟不敏感的接口 - 可叠加多个限流规则，例如同时按 IP 和 UA 限流：
limit_req zone=by_ip; limit_req zone=by_ua;
注意请求头大小写与空格处理
Nginx 默认将请求头转为小写并用下划线代替横线（如 X-Real-IP → $http_x_real_ip），且自动 trim 前后空格。但若头字段含特殊字符或空值，map 会匹配失败，默认走 default 分支。建议：
- 用
~*开头做大小写不敏感正则匹配 - 对关键头（如
Authorization）加非空判断：map $http_authorization $auth_key { "" "anonymous"; ~*^Bearer\s+(.+)$ "$1"; } - 测试时用 curl 模拟不同头：
curl -H "User-Agent: mobile-app/1.0" http://localhost/api
不复杂但容易忽略的是 map 的执行时机——它在请求头解析后、rewrite 阶段前完成，因此不能依赖 rewrite 后的变量，但足以支撑绝大多数基于请求头的分流与限流场景。
