Nginx根据UA跳转设置教程

本文深入解析了在Linux环境下通过Nginx原生配置实现基于User-Agent的智能移动端跳转方案，重点对比了传统if判断与更高效健壮的map预定义变量方式，强调精准识别Mobile、Android、iPhone、iPad等关键UA标识以避免误判或漏判，并系统讲解了如何安全实现“手机版→电脑版”的反向跳转（通过?desktop=1参数或Cookie拦截防止重定向循环）、return 302与rewrite redirect的本质区别及SEO影响、query string完整保留的重要性，以及处理微信浏览器、Opera Mini等边缘UA时的实战细节和常见陷阱——真正考验功力的不是几行代码，而是对Nginx执行时机、缓存行为、协议规范和真实用户场景的深度理解。

直接改 Nginx 配置就能实现 UA 自动跳转，不需要后端或 JS；但用错指令或正则会引发重定向循环、SEO 降权、iPad 被漏判等问题。

用 if + $http_user_agent 判断移动端最常用，但有坑

常见写法是：if ($http_user_agent ~* "(Mobile|Android|iPhone)") { return 302 https://m.example.com$request_uri; }。这能工作，但要注意三点：

• 不能只匹配 Mobile —— Chrome DevTools 模拟手机时也带这个字段，会导致桌面用户误跳
• 必须包含 iPad —— 它 UA 里没有 Mobile，默认被当桌面设备，但用户期望它走手机版
• if 在 location 块里可用，但在 server 级大量嵌套会降低性能；更稳的方式是先用 map 预计算变量

用 map 提前定义 $is_mobile 更健壮

map 把 UA 判断提到 server 上下文，每次请求只执行一次正则，避免重复计算。配置片段如下：

map $http_user_agent $is_mobile {
    default 0;
    ~*[Mm]obile 1;
    ~*[Aa]ndroid 1;
    ~*[iI]phone 1;
    ~*[iI]pad 1;
    ~*[Bb]lack[Bb]erry 1;
    ~*[Oo]pera [Mm]ini 1;
}

之后在 server 或 location 里直接用 $is_mobile，比如：

• 跳转用：if ($is_mobile = 1) { return 302 https://m.example.com$request_uri; }
• 静默路由用：location / { try_files /m$uri/index.html /index.html =404; }

return 302 和 rewrite ... redirect 别混用

两者都触发客户端跳转，但语义和缓存行为不同：

• return 302 是明确的临时重定向，搜索引擎不会把目标 URL 当作新首页，适合日常 UA 跳转
• rewrite ^(.*) https://m.example.com$1 redirect; 中的 redirect 本质也是 302；若写成 permanent 就是 301，一旦生效，浏览器和 CDN 会强缓存，改配置后用户仍跳旧地址
• 千万别在同一个 server 块里既对 PC 站加跳转，又对手机站加“反向跳回”逻辑而没加 Cookie/参数拦截，否则手机点“电脑版”后立刻又被跳回来，形成死循环

移动端返回 PC 版需要带状态标记，光靠 UA 不行

用户在 m.example.com 页面点“电脑版”，必须让 Nginx 下次请求知道“这次别再跳了”。前端 JS 来不及（Nginx 在网关层已处理完），得靠服务端传递信号：

• 推荐加 URL 参数：跳转时带上 ?desktop=1，然后在手机站的 server 块里加判断：if ($args ~ desktop=1) { set $is_mobile 0; }
• 或者用 Cookie：if ($http_cookie ~ "desktop=1") { set $is_mobile 0; }，再配合 add_header Set-Cookie "desktop=1; Max-Age=3600" 控制时效
• 注意：不要用 rewrite 去删参数再跳，Nginx 的 rewrite 不支持条件性丢弃 query string，容易残留参数导致后续逻辑错乱

真正麻烦的不是写几行正则，而是 iPad、Opera Mini、微信内置浏览器这些边缘 UA 的覆盖，以及跳转后 $request_uri 是否含 query string 的细节——漏掉斜杠、多传一个空格，都可能让登录态或追踪参数失效。

到这里，我们也就讲完了《Nginx根据UA跳转设置教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Linux的知识点！