如何通过 `map` 实现根据客户端设备转发不同版本-Nginx-PHP中文网

nginx可通过map指令将$http_user_agent映射为结构化变量（如$version），再结合proxy_pass或try_files实现按设备类型分发；map须定义在http块顶层，支持~*不区分大小写正则、复合键匹配及default兜底。

如何通过 `map` 实现根据客户端设备转发不同版本

可以通过 Nginx 的 map 指令结合 $http_user_agent 或 $http_accept 等变量，将请求按客户端设备类型分类，再配合 proxy_pass 或 try_files 实现不同版本的转发或静态资源分发。

定义设备类型映射关系

在 http 块中使用 map 创建一个变量（如 $version），根据 User-Agent 字符串识别常见设备：

map $http_user_agent $version {
    default         "web";
    ~*android|mobile|blackberry|webos|iphone|ipod|iemobile|symbian "mobile";
    ~*tablet|ipad|kindle|silk|nexus.*[34]  "tablet";
}

说明：
- 正则匹配不区分大小写（~*）；
- 顺序重要，更具体的规则建议放在前面（如 ipad 在 mobile 之前，避免被误判为 mobile）；
- default 是兜底值，确保变量总有值，避免后续配置出错。

在 server 或 location 中使用映射结果

根据 $version 变量决定如何处理请求。常见方式有两类：

反向代理到不同后端服务：例如将 mobile 请求转发到 http://mobile-api/，web 请求到 http://web-api/
静态资源路径重写：例如用 try_files 优先尝试 /mobile/index.html，再回退到 /web/index.html

示例（反向代理）：

location /api/ {
    proxy_pass http://backend-$version/;
    proxy_set_header Host $host;
}

需提前在 upstream 中定义 backend-mobile、backend-web 等。

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

补充判断：兼顾现代特征检测（可选）

单靠 User-Agent 不够可靠（可伪造、更新滞后）。可叠加简单 HTTP 头判断，比如检查是否带 Sec-CH-UA-Mobile（Chrome 的客户端提示头）：

map $http_sec_ch_ua_mobile $is_mobile_hint {
    "?1"  "1";
    default "0";
}
<p>map $is_mobile_hint:$http_user_agent $version {
default "web";
"1:~<em>" "mobile";
"~</em>android|iphone|ipod|mobile" "mobile";
}</p>

注意：map 支持复合键（用冒号连接多个变量），适合多条件组合判断。