Nginx可通过map指令将变量（如$http_x_vip_level）映射为限速值，再在limit_rate中引用实现动态限速；需在http块定义map映射表，location中使用$vip_rate生效，支持请求头、参数、Cookie等多种变量源，且性能开销极小。
Nginx 的 limit_rate 本身不支持直接使用变量（如 $arg_vip_level 或 $http_x_vip_level），但可以通过 map 指令预先将变量映射为速率值，再在 limit_rate 中引用该映射结果，从而实现按 VIP 等级动态限速。
用 map 构建 VIP 等级到速率的映射关系
在 http 块中定义一个映射表，把用户标识（如请求头、参数或 cookie）转换为具体限速值（单位：字节/秒）：
http {
# 根据请求头 X-VIP-Level 设置限速值（单位：字节/秒）
map $http_x_vip_level $vip_rate {
"" 100k; # 默认未提供头，按普通用户限速 100KB/s
"basic" 100k;
"silver" 500k;
"gold" 2m; # 2MB/s
"platinum" 5m; # 5MB/s
default 100k;
}
}注意：map 只支持字符串匹配，不支持正则或数值比较；值必须是合法的限速单位（k、m），且不能含空格或表达式。
在 location 中启用动态限速
在需要限速的下载 location 块中，直接引用映射变量：
location /download/ {
# 开启静态文件服务或代理后端
alias /data/files/;
<pre class="brush:php;toolbar:false;"># 应用动态限速
limit_rate $vip_rate;
# （可选）记录实际应用的速率，便于调试
add_header X-Rate-Applied "$vip_rate";
}
该配置会为每个请求根据其携带的 X-VIP-Level 请求头自动选择对应速率。客户端需在请求中带上该头，例如：
curl -H "X-VIP-Level: gold" https://example.com/download/file.zip补充说明与注意事项
- 限速作用范围：limit_rate 是 per-connection 限速，对单个 TCP 连接生效；不适用于 HTTP/2 多路复用下的单连接多流场景（此时所有流共享连接带宽）
-
变量来源灵活：除了
$http_x_vip_level，也可用$arg_vip（GET 参数）、$cookie_vip_level（Cookie）、或通过auth_request子请求注入的自定义变量 -
避免覆盖风险：不要在同一个 location 中重复设置
limit_rate，Nginx 会以最后出现的为准；若需 fallback，应在 map 中统一处理 - 性能影响极小：map 查找是 O(1) 散列操作，无明显性能损耗，适合高并发场景
进阶：结合 auth_request 实现鉴权+等级识别
若 VIP 等级需从后端鉴权接口获取，可先用 auth_request 获取用户信息，再通过 auth_request_set 提取等级字段：
location = /auth {
internal;
proxy_pass https://auth-backend/verify;
proxy_pass_request_body off;
proxy_set_header Content-Length "";
# 假设后端返回 JSON：{"level":"gold", "uid":"u123"}
auth_request_set $vip_level $upstream_http_x_vip_level;
}
<p>server {
location /download/ {
auth_request /auth;
auth_request_set $vip_rate $upstream_http_x_rate_limit;</p><pre class="brush:php;toolbar:false;"> # 或用 map + $vip_level（需提前定义 map $vip_level $vip_rate { ... }）
limit_rate $vip_rate;
}
}
此时需确保后端在响应头中写入 X-VIP-Level 或 X-Rate-Limit，供 Nginx 提取。
