根据User-Agent跳转站点设置教程

本文详细介绍了在宝塔面板中实现基于User-Agent自动跳转的四种实用方法——Nginx if指令、Nginx map指令、Apache .htaccess规则和PHP脚本判断，分别覆盖不同服务器环境与使用场景：从高性能高并发推荐的map预编译方案，到无需重启服务的.htaccess快速部署，再到灵活支持复杂逻辑的PHP动态处理，帮助开发者精准识别微信浏览器、移动端设备等访问来源，并一键完成302重定向至专属页面，兼顾效率、易用性与扩展性。

如果您希望宝塔面板托管的网站能根据访问者浏览器或客户端发送的 User-Agent 字符串，自动跳转至对应页面（如移动端跳转 m.example.com，微信内置浏览器跳转特定活动页），需在 Web 服务器层面进行条件判断与重定向配置。以下是实现该功能的多种方法：

一、通过 Nginx 配置文件手动添加 if 判断规则

此方法直接在站点的 Nginx 配置中使用 if 指令匹配 $http_user_agent 变量，并执行 rewrite 或 return 跳转。适用于对 Nginx 语法熟悉且需要精细控制跳转逻辑的场景。

1、登录宝塔面板，进入【网站】→ 找到目标站点 → 点击【设置】→ 切换到【配置文件】选项卡。

2、在 server 块内、location / 块上方或内部，插入如下类似规则：

3、判断是否为微信内置浏览器并跳转：
if ($http_user_agent ~* "MicroMessenger") {
  return 302 https://example.com/wechat.html;
}

4、判断是否为常见移动设备 UA 并跳转至 m 子域：
if ($http_user_agent ~* "(Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini)") {
  return 302 https://m.example.com;
}

5、保存配置文件后，点击【重载配置】使生效。

二、使用 Nginx 的 map 指令实现高效 UA 分类跳转

map 指令在 Nginx 启动时预编译匹配逻辑，性能优于 if，适合高并发站点。需将 map 定义置于 http 块（即站点配置之外的全局配置区域），再在 server 中引用。

1、点击宝塔面板左侧【软件商店】→ 找到已安装的 Nginx → 点击【设置】→ 【配置修改】。

2、在 http { 大括号起始位置下方（通常在 include mime.types; 后），添加如下 map 块：

map $http_user_agent $ua_redirect {
  default "";
  ~*MicroMessenger "/wechat.html";
  ~*(Android|iPhone|iPad) "/mobile/";
  ~*DingTalk "/dingtalk.html";
}

3、返回该站点的【配置文件】，在 server 块中添加：
if ($ua_redirect) {
  return 302 https://example.com$ua_redirect;
}

4、保存 Nginx 全局配置与站点配置，分别点击【重载配置】。

三、通过站点根目录放置 .htaccess（仅限 Apache 环境）

若站点使用 Apache 作为 Web 服务器，可通过启用 mod_rewrite 模块，在 .htaccess 文件中基于 HTTP_USER_AGENT 变量执行 RewriteCond + RewriteRule 跳转。此方式无需重启服务，便于快速测试。

1、确认该站点的 Web 服务类型为 Apache：进入【网站】→ 站点【设置】→ 【基本设置】中查看“运行环境”。

2、点击【网站目录】选项卡，勾选【启用防跨站攻击（open_basedir）】下方的【允许 .htaccess】并保存。

3、使用【文件】管理器进入站点根目录，新建文件命名为 .htaccess（注意开头为英文点号）。

4、在文件中写入以下内容：

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} MicroMessenger [NC]
RewriteRule ^(.*)$ https://example.com/wechat.html [R=302,L]
RewriteCond %{HTTP_USER_AGENT} (Android|iPhone|iPad) [NC]
RewriteRule ^(.*)$ https://m.example.com/ [R=302,L]

5、保存文件，无需重启服务，立即生效。

四、使用 PHP 脚本动态判断并跳转

当跳转逻辑复杂（如需结合数据库查询、时间判断、IP 地域等）时，可在入口文件（如 index.php）顶部嵌入 PHP 代码读取 $_SERVER['HTTP_USER_AGENT'] 并执行 header 重定向。该方式灵活性最高，但会增加 PHP 解析开销。

1、确保站点已启用 PHP 且版本兼容（建议 7.2+）。

2、编辑站点根目录下的主入口文件（如 index.php），在 开始后第一行插入判断代码。

3、示例代码：
$ua = $_SERVER['HTTP_USER_AGENT'] ?? '';
if (stripos($ua, 'MicroMessenger') !== false) {
  header('Location: https://example.com/wechat.html');
  exit;
}
if (preg_match('/Android|iPhone|iPad/i', $ua)) {
  header('Location: https://m.example.com/');
  exit;
}

4、保存文件，确保 PHP 错误报告未暴露敏感信息（生产环境应关闭 display_errors）。

五、借助宝塔反向代理功能配合自定义响应头识别

此方法不直接处理 UA，而是将请求先转发至一个轻量级中间服务（如 Python Flask 或 Node.js 微服务），由该服务解析 UA 并返回 302 响应或透传原始内容。适用于已有微服务架构或需统一 UA 处理策略的多站点场景。

1、部署一个监听本地端口（如 8081）的 UA 判断服务，支持接收原始请求头并返回重定向响应。

2、在宝塔【网站】→ 【设置】→ 【反向代理】中新增规则：
目标 URL 填写 http://127.0.0.1:8081；
启用代理后，所有请求将被转发至此服务。

3、确保该服务正确透传 $http_user_agent 头，并依据规则生成 Location 响应头。

4、在反向代理设置中勾选【启用缓存】（可选），并点击【提交】激活代理。

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