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