如何利用 proxy_set_header User-Agent 实现根据设备类型转发后端-Nginx-PHP中文网

proxy_set_header User-Agent 用于透传或修改客户端 UA，需配合 map 指令识别设备类型，并通过 if 或 internal location 实现按 $device_type 路由至不同后端，同时必须显式设置 proxy_set_header User-Agent $http_user_agent 以避免被覆盖为“nginx”。

如何利用 proxy_set_header user-agent 实现根据设备类型转发后端

可以通过 proxy_set_header User-Agent 保留或修改请求头中的 User-Agent，再结合 Nginx 的 map 指令识别设备类型，最终在 location 或 upstream 中按条件转发到不同后端。核心不是靠 proxy_set_header 直接实现转发，而是用它配合其他指令完成设备识别与路由决策。

1. 用 map 指令提取设备类型

Nginx 本身不解析 User-Agent，但可通过 map 模块基于正则匹配做轻量级识别。建议在 http 块中定义：

map $http_user_agent $device_type {
    ~*android|mobile|blackberry|webos|iphone|ipod|ios|opera\ mini|iemobile|wpdesktop "mobile";
    ~*tablet|ipad|kindle|silk|nexus\ 7|nexus\ 10 "tablet";
    default "desktop";
}

说明：
– $http_user_agent 自动获取请求头中的 User-Agent；
– 匹配顺序从上到下，第一个命中即生效；
– 移动优先（含常见手机 UA 关键词），再判平板，其余归桌面；
– 注意转义空格（如 nexus\ 7）和特殊字符。

2. 在 proxy_pass 前根据 $device_type 路由

在 server 或 location 块中，用 if 或更推荐的 try_files + named location 方式跳转，或直接指定不同 upstream：

Bailian Usage Proxy

阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。

下载

方式一：用 if（简单场景可用，注意 if 在 location 外不支持 proxy_pass）

location / {
    if ($device_type = "mobile") {
        proxy_pass http://backend_mobile;
        proxy_set_header User-Agent $http_user_agent;
        break;
    }
    if ($device_type = "tablet") {
        proxy_pass http://backend_tablet;
        proxy_set_header User-Agent $http_user_agent;
        break;
    }
    proxy_pass http://backend_desktop;
    proxy_set_header User-Agent $http_user_agent;
}

方式二（更健壮）：用多个 location + 正则或前缀匹配，配合 internal 重定向

location / {
    set $target "desktop";
    if ($device_type = "mobile") { set $target "mobile"; }
    if ($device_type = "tablet") { set $target "tablet"; }
    rewrite ^(.*)$ /_route_$target$1 last;
}
<p>location /_route_mobile/ {
internal;
proxy_pass <a href="https://www.php.cn/link/91d054b242704a7a9196a568fb02974a">https://www.php.cn/link/91d054b242704a7a9196a568fb02974a</a>;
proxy_set_header User-Agent $http_user_agent;
}</p><p>location /_route_tablet/ {
internal;
proxy_pass <a href="https://www.php.cn/link/5adc3ad31cc0aa43aaab7f4e75a9f00d">https://www.php.cn/link/5adc3ad31cc0aa43aaab7f4e75a9f00d</a>;
proxy_set_header User-Agent $http_user_agent;
}</p><p>location /_route_desktop/ {
internal;
proxy_pass <a href="https://www.php.cn/link/e9631bea70bc3ae4018bff0eac2c0986">https://www.php.cn/link/e9631bea70bc3ae4018bff0eac2c0986</a>;
proxy_set_header User-Agent $http_user_agent;
}</p>

3. 确保后端能收到原始 User-Agent

proxy_set_header User-Agent $http_user_agent; 这行很重要 —— 默认 Nginx 会把 User-Agent 改成 “nginx”，不显式设置就丢失原始值。如果你希望后端也做二次判断（比如 SSR 渲染），必须透传：

不要写成 proxy_set_header User-Agent "custom-string"（覆盖掉原始 UA）
若需添加标记（如注入 Nginx 转发标识），可用拼接：proxy_set_header User-Agent "$http_user_agent; via-nginx"
确保客户端没通过 CDN 或中间代理篡改 UA，否则识别不准

4. 验证与调试技巧

快速验证是否生效：

用 curl 模拟不同设备：curl -H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)..." http://your-domain/
在后端日志或 Nginx access_log 中加 $device_type 变量：log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$device_type"';
临时返回设备类型用于调试：return 200 "Device: $device_type\n";