nginx可通过正则匹配user-agent实现移动端自动分流,推荐用if ($http_user_agent ~* "(android|iphone|ipad|ipod)")设$site_type,再结合try_files或rewrite分发至/m/或/pc/路径,无需后端参与且性能高。

直接用 Nginx 判断 User-Agent,把移动端请求自动转发到对应站点或路径,无需后端参与,性能高、配置轻量。
识别常见移动端 UA 的核心规则
Nginx 本身不内置“移动端”判断逻辑,需手动匹配主流移动浏览器和设备的 UA 特征字符串。关键是覆盖全面但不过度宽松,避免误判:
- 必须包含:Android、iPhone、iPod、iPad、Mobile(注意不是所有含 Mobile 的都是真手机,如某些桌面版 Chrome 会带 Mobile)
- 排除干扰:Windows Phone 已淘汰可忽略;Firefox/Chrome 桌面版若含 Mobile 但同时含 Windows、Macintosh、Linux,则视为桌面
- 推荐写法:用 if ($http_user_agent ~* "(Android|iPhone|iPad|iPod)") { ... },简洁可靠;避免正则过于复杂(如嵌套否定断言),影响性能
实现自动分流的三种典型方式
根据你的架构选择合适路径,不依赖 rewrite 或 proxy_pass 硬编码,保持可维护性:
- 同域名不同路径:移动端访问 /m/xxx,PC 访问 /pc/xxx。用 set $site_type "mobile"; 配合 location 匹配前缀,再用 try_files $uri /m/index.html;
- 同域名不同后端:PC 流量 proxy_pass 到 http://backend-pc,移动端到 http://backend-mobile。在 upstream 块中定义两组服务器,用 if + proxy_pass 切换(注意:if 在 location 外不可用 proxy_pass,需包在 location 内)
- 重定向到子域名:把 example.com 的移动端请求 302 跳转至 m.example.com。用 return 302 https://m.example.com$request_uri;,简单高效,适合静态资源分离场景
规避常见陷阱与增强健壮性
线上环境容易因细节翻车,这些点务必检查:
- UA 可被伪造:仅用于体验优化,敏感逻辑(如权限、支付)绝不能依赖 UA 分流,必须由业务层二次确认
- 缓存污染风险:如果启用了 proxy_cache 或 fastcgi_cache,需在 cache key 中加入 $http_user_agent 或自定义变量(如 $site_type),否则 PC 用户可能看到缓存的移动端页面
- 微信/QQ 内置浏览器特殊处理:它们 UA 同时含 Mobile 和 Safari,但渲染行为更接近移动端。建议保留默认移动端规则,无需额外判断;若需区分,可加 ~* "MicroMessenger|QQBrowser" 单独处理
- 测试真实设备 UA:不要只靠 curl 模拟,用真机访问并查看 Nginx access_log 中的 $http_user_agent 字段,确认匹配准确
一个开箱即用的最小化配置示例
放在 server 块内即可运行,支持 PC / 移动端双路径,无重定向、无外部依赖:
set $site_type "pc";
if ($http_user_agent ~* "(Android|iPhone|iPad|iPod)") {
set $site_type "mobile";
}
location / {
try_files $uri @dynamic;
}
location @dynamic {
if ($site_type = "mobile") {
rewrite ^(.*)$ /m$1 break;
}
if ($site_type = "pc") {
rewrite ^(.*)$ /pc$1 break;
}
proxy_pass http://backend;
}
其中 /m/ 和 /pc/ 对应静态资源目录,或由后端统一处理。注意 rewrite 的 break 保证内部重写不暴露给客户端。











