UA Pro 使用指南

新用户使用指南

从第一条规则开始,了解生效范围、随机方式、资源回退与配置迁移。

适用版本:1.4.5 · 指南更新:2026 年 11 月 16 日

本指南介绍 1.4.5,实际可安装版本请以所选安装来源显示的信息为准。

UA Pro 可以为所有网站、指定域名或单个标签页设置 User-Agent,简称 UA。使用时先选择规则影响哪些页面,再选择 UA 的生成方式。多条规则同时存在时,插件按优先级选出一条主页面规则;普通页内资源优先沿用主页面的 UA。

01先认识 UA 和页面资源

UA 是浏览器向网站提供的一段身份描述,通常包含浏览器、操作系统和设备信息。UA Pro 可以修改普通网页请求中的 User-Agent,并对普通页面的 navigator.userAgent 提供对应值。

选择手机 UA 可以用于观察网站针对手机 UA 返回的内容,但不会把电脑变成手机,也不会自动改变屏幕尺寸、浏览器内核、IP 或全部浏览器指纹。

假设地址栏打开 https://shop.example.com/product:

名称 本例中的含义
主页面 地址栏打开的商品页面
主页面域名 shop.example.com,不包含协议和路径
父域名 相对 shop.example.com 而言,example.com 是父域名
子域名 img.shop.example.com 是 shop.example.com 的下级子域名
页内资源 页面加载的图片、脚本、样式、接口请求及普通网络 iframe 等
资源域名 资源请求的目的域名,如 cdn.example.net

本指南的“主页面域名”指地址栏页面的主机名,不是 .com 一类顶级域,也不一定是 example.com 这样的注册域名。

02三个独立的设置概念

设置 回答的问题 示例
生效范围 哪些页面使用这条规则? 全局、example.com 域名、当前标签页
UA 模式 UA 内容从哪里来? 内置、自定义、追加文本、随机
随机方式 选中随机模式后,何时重新抽取? 每次页面加载、每个标签页

例如“域名范围 + 随机 UA + 每个标签页”表示:访问该域名范围内页面的标签页,分别保存该规则的随机结果。它不表示所有访问该域名的标签页共用一份永久 UA。

2.1 生效范围

范围 影响对象 生命周期与覆盖关系
全局 没有更高优先级规则的普通网站页面 配置保留;可被域名或标签页规则覆盖
域名 主页面域名匹配指定域名或其下级子域名的页面 配置保留;可被更具体域名或标签页规则覆盖
标签页 创建规则时的那个标签页 优先级最高;该标签页导航到其他网站时仍适用,关闭标签页后失效

“全局范围 + 每个标签页随机”仍然是一条全局规则;分别保存随机结果并不会将它变成最高优先级的标签页规则。

2.2 UA 模式

模式 如何生成 UA 适合的用途
内置 UA 从预设浏览器或设备中选择一条 UA 快速使用预设身份
自定义 使用输入的完整 UA 字符串 使用指定 UA,或保存自己的 UA 列表
追加文本 在浏览器默认 UA 后加一个空格和指定文本 在默认 UA 中附加识别标记
随机 UA 从选定候选池中抽取 UA 按页面加载或标签页分配随机值

追加文本的基础是浏览器默认 UA,不是被覆盖的父域名 UA 或全局 UA。例如全局设为自定义 UA,域名设为追加 MyTest,该域名最终使用“浏览器默认 UA + 空格 + MyTest”。两条规则不会叠加。

随机候选池可以来自内置 UA、自定义列表、追加文本列表,或这些来源的组合;还可以选具体分类。追加文本候选会先与浏览器默认 UA 组合,再参与抽取。候选池为空或没有有效内容时,该规则不能成为有效主页面规则。

03主页面规则的优先级

标签页规则 → 最具体的有效域名规则 → 逐级父域名规则 → 全局规则 → 浏览器默认 UA。

按顺序找到第一条启用且能产生有效 UA 的规则后,就使用它,不再组合后面的规则。固定模式和随机模式之间没有额外的优先级。

检查顺序 主页面为 news.shop.example.com 时的示例
1 当前标签页规则
2 news.shop.example.com 的有效规则
3 shop.example.com 的有效规则
4 example.com 的有效规则
5 全局有效规则
6 上述均无有效规则,使用浏览器默认 UA

“有效”包含两个条件:规则已启用,且能够生成合法、非空的 UA。暂停规则、非法 UA、空随机候选池会被跳过。

3.1 域名如何匹配

设置 example.com 时,匹配以下主页面:

主页面域名 是否匹配
example.com 是
www.example.com 是
shop.example.com 是
a.shop.example.com 是
otherexample.com 否
example.com.other.net 否
example.net 否

域名栏填写 example.com,不填写 https://、路径、查询参数或端口。当前按域名配置,不按某个 URL 路径配置。

1.4.5 不提供“只匹配该主机名、排除所有子域名”的选项。 若只想影响 shop.example.com 这一分支,应填写 shop.example.com,但其下级子域名仍会包含在内。

兼容写法 *.example.com 在当前版本也覆盖 example.com 本身及其下级子域名,并非只覆盖子域名。若同时存在有效的 example.com 和 *.example.com 规则,前者优先;前者暂停后可以由后者接替。新用户通常只需使用普通域名写法。

3.2 暂停与移除的区别

操作或状态 含义
暂停 保留配置,暂时不参与匹配;可恢复
移除 删除该规则;需要时重新创建
被覆盖 规则仍启用,但当前页面有更高优先级规则
无效 当前内容无法产生有效 UA,需要修正内容或候选池

暂停或移除后,插件继续查找其他有效规则。因此,暂停不是“强制此页面使用浏览器默认 UA”的排除规则。

例如,假设一开始只有以下三条启用且有效的规则:全局为 UA-G、example.com 为 UA-P、shop.example.com 为 UA-C:

操作 打开 shop.example.com 的结果
三条规则均启用 UA-C
暂停子域名规则 UA-P
再暂停父域名规则 UA-G
再暂停全局规则 浏览器默认 UA
另加有效标签页规则 UA-T 该标签页使用 UA-T

这里的 UA-G、UA-P、UA-C、UA-T 只是不同 UA 内容的代号。

04两种随机方式

4.1 每次页面加载

每次主页面完整的网络加载抽取一次,普通页内资源沿用本次主页面的结果。刷新或完整导航会重新抽取;图片、接口、iframe 等页内请求不会各自触发主页面重新抽取。

例如候选池包含 UA-A、UA-B、UA-C:

操作 一种可能的结果
首次打开页面 主文档和普通资源使用 UA-A
页面继续请求图片、接口 仍使用 UA-A
只切换锚点或 SPA 页内路由 仍使用 UA-A
刷新页面 重新抽取,可能使用 UA-C
完整跳转到另一页面,仍匹配此规则 再抽取,可能使用 UA-B

“重新抽取”不等于“一定换成不同值”。浏览器前进后退如果直接恢复缓存文档、没有重新进行主文档网络加载,也不能简单视为一次新的抽取。

重定向仍需根据目的页面判断生效规则。同一导航在同一规则下不会因每一跳重定向反复抽取;若目的域名命中另一条规则,则按另一条规则处理。

4.2 每个标签页

按“规则 + 标签页”保存随机结果。配置不变且标签页未关闭时,同一规则下刷新、完整导航仍沿用该结果。

例如为 example.com 配置“每个标签页”随机:

操作 一种可能的结果
标签页 1 打开 example.com 此规则在标签页 1 绑定 UA-A
标签页 1 刷新或进入 shop.example.com,没有更具体规则 继续 UA-A
标签页 2 打开 example.com 保存标签页 2 的绑定,可能为 UA-B,也可能仍为 UA-A
标签页 1 进入没有规则的 other.net,且无全局规则 使用浏览器默认 UA
标签页 1 返回 example.com 恢复该规则原有的 UA-A
关闭标签页 1 后重新打开 原标签页绑定已清除,可重新分配

如果另有 shop.example.com 规则,即使两条规则选择相同候选池,它们仍是不同规则,会分别保存随机绑定。修改规则参数或候选库、重启浏览器后,随机结果可能重新分配。

4.3 范围与模式组合表

下表描述某条规则已经赢得主页面优先级后的行为。固定模式包括内置、自定义和追加文本。

范围 固定模式 每次页面加载随机 每个标签页随机
全局 匹配页面使用该规则的 UA 各次主页面网络加载抽取 各标签页分别保存此全局规则的绑定
域名 匹配域名及子域名的页面使用该 UA 匹配范围内各次主页面网络加载抽取 各标签页分别保存此域名规则的绑定
标签页 此标签页使用该 UA,包括导航到其他网站 此标签页每次主页面网络加载抽取 此标签页为该规则固定随机结果,刷新及跨站导航保持

所有组合中,普通页内资源优先继承主页面 UA。随机方式决定值的生命周期,不改变规则优先级。

05页内资源与资源域名回退

5.1 主页面有规则时资源优先继承

假设有以下规则:

  • shop.example.com → UA-Shop。
  • cdn.example.net → UA-CDN。

打开 shop.example.com,其页面加载 cdn.example.net/photo.png 时,图片使用 UA-Shop。即使资源目的域名有自己的规则,也不会覆盖主页面规则。这让主文档与普通页内资源保持同一 UA。

若在新标签页地址栏直接打开 cdn.example.net,它此时是主页面域名,可以匹配自己的 UA-CDN 规则。

5.2 回退开关何时起作用

“更多操作”中的 资源域名回退 默认关闭,是独立的全局开关,适用于所有 UA 模式。

它只在主页面没有任何有效标签页、域名或全局 UA 时,允许资源根据自己的目的域名寻找有效域名规则。资源域名同样采用“更具体规则优先,暂停子规则后继承父规则”的逻辑。

主页面是否有有效 UA 开关 资源自身是否匹配有效域名规则 普通资源的 UA
有 关闭或开启 有或无 继承主页面 UA
无 关闭 有或无 浏览器默认 UA
无 开启 有 使用资源域名规则生成的 UA
无 开启 无 浏览器默认 UA

主页面无有效规则时,其主文档仍使用浏览器默认 UA;资源回退不会反过来为主页面赋值。有效全局规则也属于“主页面有有效 UA”,因此全局规则会阻止资源回退接管普通资源。

5.3 回退实例

打开 news.example.org,没有标签页规则、主页面域名规则或全局规则。另有 cdn.example.net → UA-CDN:

请求 回退关闭 回退开启
news.example.org 主文档 默认 UA 默认 UA
news.example.org/api 接口 默认 UA 默认 UA
cdn.example.net/app.js 默认 UA UA-CDN
img.cdn.example.net/photo.png 默认 UA UA-CDN,继承资源父域名规则
other.net/font.woff,无对应规则 默认 UA 默认 UA

若再增加全局 UA-G,以上普通请求均由主页面的 UA-G 统管,资源 UA-CDN 不再接管。

5.4 回退遇到随机模式

资源域名规则模式 在允许回退时如何取值
固定模式 使用资源规则配置的 UA
每次页面加载随机 按“宿主页面本次加载 + 资源规则”保存结果;该次页面中匹配同一规则的资源共用
每个标签页随机 按“宿主标签页 + 资源规则”保存结果;同一标签页刷新后继续使用

例如 cdn.example.net 使用随机模式,img.cdn.example.net 和 js.cdn.example.net 都继承它,则两者共享该次绑定。如果 img.cdn.example.net 另有有效规则,它属于另一条规则,可以使用另一个 UA。

其他标签页访问资源域名,不会改写当前页面已保存的资源随机绑定。开启回退允许同一个页面的不同资源规则使用不同 UA;希望普通页面整体保持一致时,通常保持默认关闭。

06第一次设置规则

  1. 打开需要设置的网站,点击工具栏中的 UA Pro 图标。
  2. 如果首页显示为当前网站设置规则的按钮,点击该按钮;也可以通过“更多操作”新建规则。
  3. 选择范围。仅临时测试当前标签页选“标签页”;希望同一网站的多个标签页都适用选“域名”;希望作为所有网站默认设置选“全局”。
  4. 若选择域名,核对域名输入框。例如当前在 www.example.com,若希望包括 shop.example.com,应填写 example.com。
  5. 选择模式。选“内置 UA”时选择浏览器或设备;选“自定义”时输入完整 UA;选“追加文本”时只输入追加内容;选“随机 UA”时选择候选池和随机方式。
  6. 在“确认并应用”中核对范围及内容,点击“应用”或“保存并应用”。等待“规则已保存并启用”的提示。
  7. 刷新网页,查看首页显示的当前生效规则。已有页面需刷新才能使主文档与脚本同步采用新 UA。

在规则列表中可以修改、暂停、恢复或移除规则。被其他规则覆盖的规则仍然启用,但当前未获优先级;暂停的规则不参与匹配。出现无有效 UA 提示时,检查自定义内容或随机候选池。

自定义 UA 应为单行有效请求头内容,不包含换行或控制字符。新建自定义内容或追加文本可按分类保存到列表,供以后选择或用作随机候选。

07开启 UA 悬浮层

打开更多操作并开启UA 悬浮层。悬浮层默认关闭,可显示在允许访问的 HTTP/HTTPS 页面上。

页面 UA:网页里的 JavaScript 通过 navigator.userAgent 读取到的值。

请求 UA:浏览器观察到的当前主文档请求 User-Agent。

这里显示的是浏览器地址栏中当前网页的 UA。网页加载的图片、脚本、接口等资源请求的 UA 不在显示范围内,例如 CDN 上的资源。

两项都已获取且完全相同时合并成一行;不同或未获取时分别显示。

如果开启前页面已经加载,请刷新页面以记录该页面的请求。没有记录时,悬浮层会显示“未获取”,不会用规则配置值冒充请求值。

拖动握柄或 UA 标签可移动窗口;拖动左右边缘调整宽度,拖动上下边缘调整高度。双击边缘只会恢复对应方向的自动尺寸。半圆按钮调整背景不透明度;关闭按钮会关闭所有页面的悬浮层。

长 UA 在窄窗口内会自动换行并增高;内容超过屏幕时可在悬浮层内滚动。手动设置的尺寸会保留,直到重置。

切换网页时,悬浮层在获取当前 UA 期间会尽量保持之前的尺寸并显示占位符,不会显示上一页的 UA。完整导航会重新创建网页,因此悬浮层仍可能短暂消失。

更改规则不会改变已经加载的页面及其原始请求,检查新值前请刷新。浏览器观察之后,代理或服务器仍可能改写请求头。浏览器受保护页面和扩展商店无法显示悬浮层。

更多操作中还有新用户使用指南入口;点击菜单底部的 UA Pro 可打开官网。

08常见目标怎样配置

想实现的目标 设置方法 注意事项
只在当前标签页试用手机 UA 标签页 + 内置手机 UA 在该标签页进入其他网站仍生效;关闭后失效
整个站点使用固定 UA 域名 example.com + 内置或自定义 包含全部下级子域名;其他标签页也适用
商店子站使用另一 UA 保留父规则,新增 shop.example.com 规则 没有更高优先级规则时,子规则优先;暂停子规则后,父规则可能接替
所有网站默认用一个 UA,某站例外 全局设置 UA-G,目标域名设置 UA-D 没有其他更高优先级规则时,目标域名用 UA-D,其余页面用 UA-G
某站每次刷新重新随机 域名 + 随机 + 每次页面加载 本次页面资源共用;抽取可能重复
某站每个标签页保持稳定 域名 + 随机 + 每个标签页 每条规则在各标签页分别保存绑定
只有外部资源要按目的域名设置 创建资源域名规则并开启资源回退 宿主页面不能有有效标签页、域名或全局 UA
暂时停用一条子域名规则 点击暂停 页面按优先级使用剩余有效规则,例如标签页规则、其他匹配的域名规则或全局规则;都不适用时使用浏览器默认 UA

09备份与迁移

“更多操作”中的导入导出功能可备份或迁移全局规则、域名规则、自定义库、追加文本库和资源域名回退开关。

标签页规则和已经抽取的随机绑定不属于这份持久配置导出。导入不会重建原来的标签页及其随机状态。

支持本地配置文件导入,也支持从远程配置地址加载并确认导入。导入前请先导出备份。配置中提供的全局规则、域名规则、自定义库或追加文本库对象会分别替换对应部分。这四项缺失或为 null 时,相应现有设置会保留;特别是,null 全局规则不会清除现有全局规则。资源域名回退字段只有为 true 时才开启;不为 true(包括字段缺失或为 null)时,导入后该开关关闭。

旧版随机方式 domain 在 1.4.5 中按“每次页面加载”处理;未注明随机策略的旧随机规则按“每个标签页”处理。迁移后应在界面核对所需随机方式。

10常见疑问与使用边界

疑问 解释
为什么刚保存但网页显示旧 UA? 已有文档不会重新加载;等待保存成功后刷新。也应检查是否被更高优先级规则覆盖
为什么暂停子规则仍有自定义 UA? 有效的标签页规则可能仍然优先;否则,其他匹配的域名规则或全局规则可能接替。修改规则后刷新页面,并检查当前生效规则
为什么资源域名规则不起作用? 先看主页面是否已有有效 UA,再看资源回退是否开启,最后检查资源域名规则是否有效
为什么刷新后随机值没有变化? 每标签页模式本来就保持;每页面加载模式也允许抽到相同值
为什么同时新开的标签页 UA 相同? 随机值允许重复;并发首次导航还可能共用同一个预抽取备用值
为什么换成手机 UA 仍像电脑网页? 网站也可能依赖屏幕尺寸、Client Hints 或其他信息,单独修改 UA 不保证改变页面布局

并发首次导航采用保留浏览器原生导航的方案:多个新标签页同时直接打开网址、首包早于专属规则安装时,可能使用同一个预抽取 UA;之后各标签页分别保存绑定。本插件不增加导航中转,也不将原生表单 POST 改为其他导航方式。

普通 HTTP/HTTPS 页面及其资源是本功能的主要适用对象。共享 Service Worker 请求不一定能归属到唯一标签页;Client Hints、Worker 内的 navigator、无网络文档 iframe 的 UA 同步未在本版本中完整实现。站点原有 Server-Timing 的保留也尚未在本次修改中实现。不要将 UA 修改理解为完整浏览器指纹伪装。

1.4.5 使用 webRequest 和 webNavigation 权限跟踪主页面导航及实际发送的 UA,不使用阻塞请求权限或调试器权限。

11版本验证与参考

1.3.0 最终验证环境为 Windows Edge 157.0.4341.42 的隔离测试配置及本地 HTTP/HTTPS 站点。HTTPS 全量 128 个用例、2527 项断言通过;HTTP 边界回归 5 个用例、441 项断言通过。它们验证了上述规则组合及已说明的并发边界,不代表所有浏览器版本和网站均已覆盖。

1.4.5 悬浮层在隔离的 Chrome 和 Edge 配置与本地 HTTPS 页面中完成测试,覆盖导航、相同 UA 合并、窗口尺寸调整和延迟读取等情况;测试不代表覆盖了所有网站。

详细测试记录保存在项目资料中。可以在 Chrome 应用商店 或 离线下载页面 查看可安装版本;实际版本可能与本指南不同。