Nginx 中怎么使用 proxy_pass 实现移动端与 PC 端的不同后端代理-Nginx-PHP中文网

Nginx 推荐用 map 指令基于 User-Agent 区分移动端和 PC 端请求：在 http 块中定义 $backend_host 变量匹配 iOS/Android/Mobile，location 中 proxy_pass $backend_host 实现自动路由，并可加 X-Device-Type 标识终端类型。

nginx 中怎么使用 proxy_pass 实现移动端与 pc 端的不同后端代理

在 Nginx 中，可以通过识别请求头中的 User-Agent 字段，结合 if 指令或 map 指令，将移动端和 PC 端的请求分别代理到不同后端服务。推荐使用 map 方式，它更高效、更安全，避免 if 在 location 中的潜在问题。

用 map 提前判断设备类型

Nginx 不允许在 location 块中直接用 if 改变 proxy_pass 目标，但可以在 http 块中用 map 定义变量，根据 $http_user_agent 匹配移动端特征（如 iOS、Android、Mobile），赋值为不同的后端地址。

在 http 块顶部定义：

map $http_user_agent $backend_host {
    ~*[iI][oO][sS]|~*[aA][nN][dD][rR][oO][iI][dD]|~*[mM][oO][bB][iI][lL][eE]  "http://backend-mobile:8080";
    default                                                                  "http://backend-pc:8080";
}

注意：map 的匹配是正则，大小写不敏感（~*），且只在请求初始化时执行一次，性能好、无副作用。

在 location 中引用变量做代理

在 server 或 location 块中，直接使用该变量作为 proxy_pass 的目标：

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;">location / {
    proxy_pass $backend_host;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

}

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

这样，带 “iPhone”、“Android”、“Mobile” 等关键词的请求会自动转发到移动端后端；其余走 PC 后端。无需重写 URL，路径完全透传。

补充：可加 header 标识设备来源（便于后端区分）

如果后端需要明确知道请求来自哪类终端，可在 proxy 配置中添加自定义 header：

map $http_user_agent $device_type {
    ~*[iI][oO][sS]|~*[aA][nN][dD][rR][oO][iI][dD]|~*[mM][oO][bB][iI][lL][eE]  "mobile";
    default                                                                  "desktop";
}
<h1>然后在 location 中：</h1><p>proxy_set_header X-Device-Type $device_type;
</p>

后端可通过读取 X-Device-Type 头快速做差异化处理，比如返回适配模板或启用轻量接口。

注意事项与常见坑

map 必须定义在 http 块内，不能放在 server 或 location 中
正则匹配要覆盖主流 UA，建议测试真实设备 UA 字符串（如微信内置浏览器、QQ 浏览器也常含 “Mobile”）
避免用 if ($http_user_agent ~* ...) + set $backend ... 的方式——Nginx 官方明确不推荐在 location 中用 if 设置变量再用于 proxy_pass，可能导致变量未生效或行为异常
若后端服务域名含路径（如 http://m.api.com/api/），proxy_pass 必须以 / 结尾才能正确重写路径；否则路径拼接可能出错