宝塔面板需手动配置nginx实现ua自动跳转：用map预定义$is_mobile变量精准匹配mobile、android、iphone、ipad等标识，配合return 302跳转并保留$request_uri；反向跳回须通过?desktop=1参数或cookie拦截，避免循环。
直接改 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，比如：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 跳转用：
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 的细节——漏掉斜杠、多传一个空格，都可能让登录态或追踪参数失效。
