返回知识中心
指纹

Client Hints 指纹识别:HTTP 头部与身份暴露

sec-ch-ua 等 Client Hints 头部在每次请求中描述浏览器品牌、版本和平台。了解不一致从何而来,以及如何把请求头与 JavaScript 取值对照。

BotBrowser Team

文档中心

想直接进入 指纹 文档吗?

这篇文章属于知识中心的指南库。若你要步骤化配置、参考说明和持续更新,请直接进入对应 docs 分区。

BotBrowser 可以在声明的配置文件和路由下重放经授权的浏览器身份,但不能保证第三方如何分类会话、消除所有指纹信号,也不能协调 BotBrowser 之外施加的覆盖。安全目标是让 Client Hints、User-Agent 和脚本可见取值保持一致,同时限制收集与留存。

观看视频

这段英文视频在 Chrome DevTools 中录制了页面收到的 Client Hints 头部,以及从 navigator.userAgentData 读取的同一批取值,便于看出两者应在何处一致。这是本地浏览器检查,不能证明身份、匿名性、访问权限或远程站点的判定。

摘要

  • 低熵 Client Hints 默认发送;高熵提示需要来源同意,可能在后续请求出现。
  • 在同一会话中对照请求头、navigator.userAgentData、Worker 和 User-Agent;不一致是审查信号,不是身份凭证。
  • GREASE 品牌条目会随版本变化,不要照抄固定列表。
  • BotBrowser 能重复声明的配置,但不能承诺分类、跟踪或访问结果。

内容导航

基于 Chromium 的浏览器发出的每个请求,都可以带上一段简短的结构化描述,说明发出请求的是什么浏览器。这些描述叫作 Client Hints,其中三项默认发送:Sec-CH-UA、Sec-CH-UA-Mobile 和 Sec-CH-UA-Platform。它们以请求头的形式出现,早于页面上任何脚本的运行,所以服务器从第一次导航起就能读到浏览器品牌、主版本、设备类别和操作系统系列。 Client Hints 的初衷,是用更窄、更易控制的结构化信息取代冗长且格式自由的 User-Agent 字符串。实际上,它们也让浏览器多了一个描述自己的位置。如果请求头说一种情况,navigator.userAgentData 说另一种,User-Agent 字符串又说第三种,这种分歧本身就是指纹审查会注意到的信号。下面各节依次说明每一层报告什么、不一致从何而来、如何在一次会话中对照各层,以及 BotBrowser 在这个主题上记录了什么、没有记录什么。

一次会话中的 Client Hints 对照。HTTP 请求头、navigator.userAgentData 和 Worker 上下文都与同一套配置身份进行对照。

浏览器在任何脚本运行之前发送什么

Client Hints 分为两组。低熵提示默认发送。Sec-CH-UA 列出浏览器品牌及其主版本,Sec-CH-UA-Mobile 说明浏览器是否请求移动版体验,Sec-CH-UA-Platform 给出操作系统系列。这三项以相似的方式描述了很大一部分浏览器,因此规范把它们视为低风险,允许浏览器在无人请求时发送。

高熵提示是更详细的那一组:完整版本列表、平台版本、CPU 架构、位数、设备型号,以及 32 位浏览器是否运行在 64 位系统上。服务器必须先用 Accept-CH 响应头列出想要的提示表示同意,浏览器才会在之后发往该来源的请求中附带它们。如果服务器在第一次请求时就需要某项提示,还可以使用 Critical-CH,它会要求浏览器带上该提示重试请求。第三方框架只有在嵌入它的页面通过 Permissions-Policy 头部委托后,才会收到提示。

JavaScript 有自己通向同一批数据的路径。navigator.userAgentData 会立即给出品牌、移动标记和平台,页面请求具体名称时,getHighEntropyValues() 会以 Promise 形式返回详细取值。两条路径本应描述同一个浏览器,所以相互对照是最直接的一致性检查。

桌面版 Chrome 系浏览器的默认请求,携带的头部形如下面几行。具体的 GREASE 条目及其位置会随 Chrome 版本变化,因此这些取值展示的是数据形态,不是用来照抄的内容。

Sec-CH-UA: "Chromium";v="136", "Google Chrome";v="136", "Not.A/Brand";v="99"
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Platform: "Windows"

User-Agent 头部仍然存在。Chrome 缩减了其中的细节,精确的版本和平台信息转移到了 Client Hints。因此服务器手里有同一个浏览器的两份描述,可以核对它们是否一致。关于字符串与结构化提示的更细对比,请参阅 Custom User Agent。

品牌列表中还有一个 GREASE 条目,它是刻意设成怪异形式的品牌,例如 Not.A/Brand,其文本、版本和位置会随时间变化。它的目的,是防止服务器把固定列表写死。对配置浏览器身份的人来说,GREASE 提醒我们:品牌列表遵循与版本相关的规则,手写的列表即使每个品牌名都是真的,也可能显得不对。

不一致从何而来

浏览器身份有多个表面,页面或服务器的不同部分各自读取其中一个。两个表面描述了不同的浏览器,就会出现不一致。最常见的来源如下:

  • User-Agent 字符串写的是一个浏览器版本,而 Sec-CH-UA 列出的是另一个主版本。
  • Sec-CH-UA-Platform 中的平台与 navigator.userAgentData 中的平台不同,或移动标记与平台相矛盾。
  • 请求头中的品牌列表与 JavaScript 返回的品牌不同,例如一处是 Edge,另一处只是 Chrome。
  • Worker 报告的身份与主线程不同,因为覆盖只作用于页面。
  • 两种不同工具各自施加覆盖,例如 Profile 加上框架层或 CDP 层的 User-Agent 修改,两种工具覆盖的表面子集并不相同。
  • 配置在编写时是正确的,但现在落后于生成浏览器二进制文件的那个 Chrome 版本。

请求头一侧的项目可以在服务器上读取,无需运行页面脚本:默认请求头随第一次请求到达,请求高熵提示的服务器会在下一个请求周期收到它们,并能与 User-Agent 对照。navigator.userAgentData 和 Worker 的对照则需要脚本。从隐私角度看,Client Hints 增加了一组取值,它们与其他信号结合后可以缩小浏览器的范围。EFF 的 Cover Your Tracks 展示了普通取值的组合如何变得有区分度,而 Client Hints 是这种组合中的又一个成分。一组一致的取值也比东拼西凑的取值更容易审查,因为你看到的每个差异都是真实的问题,而不是噪声。

设想一个团队加载了描述 Windows 桌面的 Profile,随后又通过测试框架设置了另一种操作系统的 User-Agent 字符串。框架覆盖的是字符串,也许还有部分元数据,Profile 覆盖的是它自己的表面,两个工具互不知情。结果是一次会话中,请求头和脚本可见的取值描述了两台不同的机器。解决办法不是更好的覆盖。解决办法是为每个取值选定一个来源,并去掉另一个。

执行上下文与请求类型同样重要。专用 Worker、共享 Worker 和服务 Worker 各有自己的全局作用域,NavigatorUAData 接口在 Worker 作用域和窗口中都会暴露。因此页面可以在 Worker 内读取品牌和平台取值,并与自己的取值对照。只修改页面的覆盖,会让这种对照暴露出来。

与平台相关的取值需要特别留意,因为它们彼此关联。平台名称、平台版本、架构、位数和移动标记描述的是同一台设备。对某个操作系统正常的平台版本,放在另一个系统的名称旁边就显得不对;移动标记为真却搭配桌面架构,会立刻引出疑问。修改其中一个取值时,要把它们放在一起复查。

Client Hints 在 Chrome、Safari 与 Firefox 中的差异

搜索 client hints chrome、client hints safari 或 client hints browser support 的读者,想知道的是这三个引擎里究竟谁真的发送这些请求头,以及某个头缺失意味着什么。答案不是一张支持矩阵,而是这套请求头用途本身的差别。

Chrome 及其他基于 Chromium 的浏览器在每个请求上发送低熵集合:Sec-CH-UA、Sec-CH-UA-Mobile、Sec-CH-UA-Platform,并把 navigator.userAgentData 暴露给页面脚本。高熵提示如 Sec-CH-UA-Full-Version-List、Sec-CH-UA-Arch、Sec-CH-UA-Bitness,只有在服务器通过 Accept-CH 请求之后才会发送。正是这个「请求/响应」步骤让 Client Hints 具备 User-Agent 字符串所没有的可指纹性:服务器看到的集合取决于它请求了什么,因此两个服务器可以观察到同一个浏览器的两种不同描述。

Safari 不实现 User-Agent Client Hints。 它只发送 User-Agent 字符串,不发送任何 Sec-CH-UA-* 头。由此产生两个容易被误读的结果。其一,做 navigator.userAgentData 特性检测的页面在 Safari 里会得到 undefined;这是正确信号,不是构建损坏。其二,习惯于依赖 Sec-CH-UA-Platform 的服务器从 Safari 客户端什么也收不到,任何「从头缺失推断平台」的逻辑都会推错。把头缺失理解为「该客户端不发送提示」,绝不要理解为「该客户端不正常」。

Firefox 同样不实现 User-Agent Client Hints,它的 User-Agent 缩减也不与提示 API 绑定。因此在三个引擎中,这套请求头只有一份真实实现。这就是为什么「Client Hints 的浏览器支持」这个问题归结为:Chromium 发送,另外两个不发送,回退路径是 User-Agent 字符串加上服务器自身能推断的部分。

比对单个会话时,每种观察的读法:

观察结果正确解读错误解读
存在 Sec-CH-UA,且 navigator.userAgentData 已定义基于 Chromium 的客户端,发送低熵集合认为高熵提示也都在;服务器必须主动请求
没有 Sec-CH-UA,且 navigator.userAgentData 未定义Safari、Firefox,或较旧的 Chromium 构建认为配置写错或请求头被剥离
User-Agent 字符串里的品牌不在 Sec-CH-UA 列表中两个面出现分歧,是值得记录的真实不一致认为浏览器在撒谎;更常见是某次覆盖只改了单一面
服务器已发送 Accept-CH,但某个高熵提示缺失该客户端早于该提示,或根本不实现提示认为权限被拒绝;这些请求头没有权限弹窗

因此一致性检查不能把「没有提示」和「提示互相矛盾」当成同一种失败。前者是引擎家族的事实,后者才是真正的身份不一致。每一行都要把引擎家族记录在请求头集合旁边,否则这两种情况会混为一谈。

在一次会话中对照请求头与 JavaScript 取值

对照的目标很窄:确认一次会话在你能读取的所有位置都报告同一个身份。为此不需要第三方评分页面。一个你能控制的页面和服务器就够了,它们还能让你有意请求高熵提示。 第三方评分回答的是另一类问题:EFF Cover Your Tracks 结果解读区分跟踪器模拟与受数据集限制的指纹比较,两者都不能证明 Client Hints 是否一致。

  1. 从你能控制的服务器通过 HTTPS 提供一个测试页面,并记录它在第一次导航时收到的请求头。
  2. 添加 Accept-CH 响应头,列出你想对照的高熵提示,例如 Sec-CH-UA-Full-Version-List、Sec-CH-UA-Platform-Version 和 Sec-CH-UA-Arch,然后再加载一次页面,让浏览器带上它们。
  3. 在页面中读取 navigator.userAgentData,并用相同的名称调用 getHighEntropyValues(),把结果记录在请求头旁边。
  4. 在专用 Worker 中重复这些 JavaScript 读取,如果你的站点使用服务 Worker,也在其中重复,并记下与主线程的任何差异。
  5. 对照品牌名称、主版本、平台、平台版本、架构、位数、型号和移动标记,再加上 User-Agent 字符串,并写下每个差异以及产生它的请求或上下文。

公开页面可以作为补充。EFF 的 Cover Your Tracks 展示你的浏览器在典型跟踪者眼中的样子,可作为整体区分度的第二意见。这类页面不太适合逐个请求头的对照,因为它们不会告诉你哪个请求产生了哪个取值。这件事请用你自己的测试页面,把公开工具当作背景。更完整的检查流程请参阅 Verify Browser Fingerprint。

把结果记在一个简单的表格里,每个取值一行,每个表面一列:请求头、主线程、Worker 和 User-Agent 字符串。各列不同的行是一个发现。各列一致的行只是该取值的证据,并不说明某个网站会如何对待这次会话。

发现差异时,从出错的表面倒推。问清楚是哪个工具或参数负责该表面,检查是否还有第二个工具也在写入它,然后去掉重复的来源。之后重新运行整个对照,而不只是失败的那一行,因为改动一个取值可能让相邻取值的不一致暴露出来。

用 BotBrowser 保持唯一的 Client Hints 来源

BotBrowser 文档说明,配置身份参数(包括 --bot-browser-brand 以及 User-Agent 和平台参数)会生成相互匹配的 Client Hints 品牌、GREASE 令牌、高熵取值和 Client Hints HTTP 头部,并在主线程、Worker 和 HTTP 请求中与 navigator.userAgentData 保持一致。对于上面描述的对照,这意味着你可以把一次会话的请求头和 JavaScript 取值,与同一套配置身份进行核对,而不必手工协调多个来源。BotBrowser 不能控制网站如何归类 Client Hints 或其他指纹信号,不保证任何检测或访问结果,也不能协调在 BotBrowser 之外施加的 CDP 层或框架层 User-Agent 覆盖。自定义 User-Agent 和完整的 userAgentData 控制需要文档所述的 ENT Tier3 许可。

文档中的路径很短。加载一个 Profile,只有在需要不同于 Profile 的品牌或平台时,才添加身份参数。参数写在启动参数中,不要写在框架选项里。BotBrowser 会根据这些输入生成依赖的取值,所以你不必自己编写品牌列表或 GREASE 条目。

chromium-browser \
  --bot-profile="path/to/profile.enc" \
  --bot-browser-brand=edge \
  --bot-ua-full-version=142.0.7444.60 \
  --bot-brand-full-version=142.0.3595.65

文档中的品牌取值是 chrome、edge、brave、opera、chromium 和 webview。每个品牌有自己的版本节奏,所以即使主版本相同,Edge 和 Opera 的完整版本也与 Chromium 版本不同。用 --bot-ua-full-version 设置 Chromium 版本,用 --bot-brand-full-version 设置品牌自身的版本,并让两者保持相同的主版本。品牌切换记录在 ENT Tier2 许可下,而 WebView 品牌和自定义 User-Agent 记录在 ENT Tier3 下。

把 Profile 和身份参数当作唯一来源。如果你还通过 CDP 或框架选项设置了 User-Agent,这个覆盖是在 BotBrowser 之外施加的,BotBrowser 不会把它与生成的 Client Hints 协调起来。为每个取值选择一个来源。传入 --user-agent 时,使用文档中的占位符,例如 {ua-full-version},让字符串与提示遵循相同的参数。

每次 Chrome 发布新版本后,检查 --bot-ua-full-version 的 Chromium 主版本是否仍与你的 BotBrowser 二进制文件一致。当二进制文件升级到新的主版本时,请使用针对该版本的 Profile 和参数。文档中记录的不一致症状是 Client Hints 与二进制文件不符,而过期的版本本身就是配置与运行它的浏览器之间的不一致。

关于 Client Hints 的常见问题

禁用 JavaScript 时还会发送 Client Hints 吗?

默认的低熵提示是请求头,不依赖页面脚本。高熵提示取决于服务器通过 Accept-CH 表示同意。JavaScript 接口当然需要脚本运行。这种划分说明了为什么请求头检查和脚本检查回答的是不同的问题,也说明了为什么两者都属于一致性检查。

服务器能收到它从未请求过的高熵提示吗?

通过请求头不能。浏览器只在得到同意之后才附带它们。页面上运行的脚本仍然可以调用 getHighEntropyValues() 并自行转发结果,这是另一条有自己控制方式的路径。审查一个站点的行为时,两条路径都要看。

测试框架可以设置 Client Hints 吗?

测试框架和 DevTools 协议可以覆盖 User-Agent 字符串,在某些情况下还能覆盖相关元数据。覆盖能涵盖什么取决于工具,不同工具的覆盖还可能相互矛盾。请用上面的对照检查每个表面。BotBrowser 不会协调在 BotBrowser 之外施加的覆盖,所以请把身份取值放在一个地方。

Sec-CH-UA 与 Sec-CH-UA-Full-Version-List 有什么区别?

Sec-CH-UA 携带品牌及主版本,默认发送。Sec-CH-UA-Full-Version-List 携带每个品牌的完整版本字符串,是需要事先同意的高熵提示。在 JavaScript 中,同样的划分表现为:brands 对应主版本,fullVersionList 对应详细版本。两者应当列出相同的品牌和相同的主版本。

Client Hints 一致就能决定网站如何对待会话吗?

不能。Client Hints 只是众多指纹信号之一。一致性消除了一类不一致,但网站还会结合许多其他输入,BotBrowser 也不能保证任何分类、跟踪结果或访问结果。把干净的对照结果当作对你自己配置的质量检查即可,仅此而已。

哪些 BotBrowser 参数会影响 Client Hints?

文档中的身份参数是 --user-agent、--bot-platform、--bot-platform-version、--bot-model、--bot-architecture、--bot-bitness 和 --bot-mobile,另有辅助参数 --bot-browser-brand、--bot-ua-full-version 和 --bot-brand-full-version。--user-agent 参数支持从其他参数读取取值的占位符,因此字符串和提示取自相同的取值。

信赖某个配置之前的检查清单

一份简短的清单能让审查可以重复。每次修改 Profile、品牌、平台参数或浏览器二进制文件时都运行一遍。

  • 每个取值只有一个来源:Profile、身份参数,或者别无其他。
  • 品牌、平台和移动标记在请求头、主线程和 Worker 之间一致。
  • 通过 Accept-CH 请求的高熵取值与 getHighEntropyValues() 的结果相符。
  • User-Agent 字符串和 Client Hints 指向相同的 Chromium 主版本。
  • 每次发布后,--bot-ua-full-version 的主版本与 BotBrowser 二进制文件一致。
  • 许可级别覆盖了所使用的参数。

延伸阅读:Navigator Properties Fingerprinting 介绍了与 navigator.userAgentData 相邻的、脚本可见的 navigator 取值,What Is Browser Fingerprinting 则提供了信号如何组合的更广背景。

公开来源

实践结论

针对受控端点运行一次冷会话和一次热会话,对照请求头、navigator.userAgentData 与 Worker 取值,只记录修复配置所需的不一致类别。保持身份取值只有一个来源,并随浏览器版本更新;结果只是一致性检查,不是隐私或访问保证。

#Client Hints#Sec-Ch-Ua#浏览器指纹识别#GREASE#User-Agent#隐私#浏览器身份#HTTP 请求头

本文属于指南: 什么是浏览器指纹?原理、风险、信号与隐私边界

在 BotBrowser 里跑一遍同样的检查

加载 profile,让刚读到的这些信号在浏览器内部保持一致,并在正式上线前先在自己的机器上确认结果。