文本测量指纹识别:亚像素追踪技术
Canvas measureText() 返回的文本宽度值具有亚像素精度,由于字体渲染引擎的差异,这些值在不同操作系统之间各不相同。了解这些微小的数值差异如何成为可靠的平台指纹信号。
BotBrowser Team
BotBrowser 可将受支持的文本和 Canvas 度量与已加载配置文件对齐,但无法控制网站收集数据;不同浏览器、字体和图形环境仍可能产生不同值。
Watch the video
这段视频为英语讲解,沿文章同一问题展开:读取已声明字符串的 Canvas measureText() 宽度与边界值,展示变体选择符与 Emoji 组合序列如何改变结果,并始终限制在受控的本地测试页内。它不涉及网站收集行为,单一测量值也不构成唯一身份。 CreepJS Emoji 度量分组 有另一条边界:相同几何的代表不是完整字形支持清单。
DOMRect 片段列表描述布局,而不是 Canvas 字形度量;getClientRects 一致性分析 区分 Element 与 Range 几何,以及空列表的不同情况。
TL;DR
文本测量会暴露受浏览器、字体、区域设置和图形路径影响的宽度与边界数值。加载 BotBrowser 配置文件可以在文档所述部署条件下提高受支持测量的可重复性,但无法控制网站收集数据,也不能保证所有环境输出相同。
目录
简介
当网站使用 Canvas API 的 measureText() 方法测量文本字符串的宽度时,结果是一个具有亚像素精度的浮点值。这些值在不同操作系统之间有所不同,因为每个平台使用具有自己内部算术模型的不同内置渲染引擎。这些差异非常微小,肉眼不可见,但它们是一致的、可重现的,并且可以通过 JavaScript 测量。
这种亚像素精度使 measureText() 成为脚本可以比较的可观察信号。与需要读取像素的 Canvas 图像指纹识别不同,它直接返回数值度量。CreepJS 的 SVG 收集器则使用另一种 API getComputedTextLength();它的字段图说明了这种不同的测量方式。它本身不能识别操作系统;字体、浏览器版本、区域设置、图形设置和运行模式同样会影响结果。
这使得文本测量成为脚本可能收集的浏览器可观察信号。它不需要特殊权限,也不会产生用户可见的行为,但稳定性取决于浏览器会话和部署条件。由于 API 层面的改变可能影响 Web 应用行为,文本测量需要结合其他信号和受控测试来评估。
BotBrowser 的配置文件对齐方法
加载 --bot-profile 后,受支持的文本和 Canvas 行为可按配置文件的声明进行对比;浏览器版本、字体、区域设置、图形路径和运行模式仍是结果输入,不能保证网站看不到差异。
统一的字体渲染路径
配置文件设置会应用到受支持的文本测量路径,使结果能够与声明的环境比较。解释差异前应先核对部署使用的浏览器版本和字体集合。
当配置文件指定设备配置时,应将 measureText() 与 Canvas 和 CSS 检查一起使用,以验证文档所述行为。主机字体和浏览器版本仍是结果的一部分。
配置文件驱动的一致性
每个 BotBrowser 指纹配置文件描述声明环境的文本度量范围。当加载配置文件时,字体渲染引擎会生成可与该声明比较的测量值:
- 在配置文件、浏览器版本、字体、区域设置和运行模式都不变时,相同文本与字体设置可以用于跨运行比较。
- 在 macOS、Windows 和 Linux 上加载相同配置文件时,只有在浏览器版本、字体和运行模式一致的情况下,结果才适合直接比较。
- 结果与其他与字体相关的信号(字体列表、Canvas 文本渲染、CSS 布局度量)内部一致。
请逐项验证应用使用的 TextMetrics 属性。actualBoundingBoxAscent、actualBoundingBoxDescent、fontBoundingBoxAscent、fontBoundingBoxDescent 和边界框左/右值的支持情况与具体数值,可能随浏览器版本、字体和图形模式变化。
跨平台比较
跨平台比较的每行应记录 browserVersion、fontSet、locale、graphicsStack 和 executionMode;相同配置文件不代表主机输出逐字节相同。
只有在控制浏览器版本、字体、图形栈和运行模式时,跨平台比较才有意义。扩展、API 代理和 JavaScript 包装器无法决定网站浏览器的确切输出,因此应验证完整部署。
配置文件在文档约束范围内定义预期行为;主机的字体和图形设置仍可能改变输出。
可观察行为与隐私边界
可观察行为仍是公开 Canvas API 的行为:
measureText()通过标准 API 返回具有完整双精度浮点精度的原生 JavaScriptNumber值;具体结果仍受浏览器版本、字体和图形环境影响。- 应在同一部署中将值与 Canvas 和 CSS 检查比较;小差异可能是正常的。
- BotBrowser 不会阻止网站收集或传输这些值,也不决定网站如何存储或解释它们。
与其他信号的内部一致性
文本度量应与其他可观察信号一起评估,例如 Canvas 输出、字体可用性和 CSS 布局。配置文件可以在文档范围内提高一致性,但无法让配置文件之外的信号自动一致,也无法决定网站如何解释交叉比较结果。另一个取决于运行环境的浏览器可观察信号见 JavaScript 栈深度:浏览器隐私信号。
配置和使用
CLI 用法
使用指纹配置文件启动 BotBrowser 以启用文本测量保护:
chrome --bot-profile="path/to/profile.enc" \
--user-data-dir="$(mktemp -d)"
对于跨运行的确定性结果,添加噪声种子:
chrome --bot-profile="path/to/profile.enc" \
--bot-noise-seed=12345 \
--user-data-dir="$(mktemp -d)"
结合时区、区域设置和代理设置以实现全面的身份一致性:
chrome --bot-profile="path/to/profile.enc" \
--bot-noise-seed=12345 \
--proxy-server="socks5://user:pass@proxy:1080" \
--bot-timezone="America/New_York" \
--bot-locale="en-US" \
--bot-languages="en-US,en"
Playwright 集成
const { chromium } = require('playwright-core');
(async () => {
const browser = await chromium.launch({
executablePath: 'path/to/botbrowser/chrome',
args: ['--bot-profile=path/to/profile.enc', '--bot-noise-seed=42'],
headless: true,
});
const context = await browser.newContext({ viewport: null });
const page = await context.newPage();
await page.goto('https://example.com');
// measureText() results will be consistent with the loaded profile
const metrics = await page.evaluate(() => {
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d');
ctx.font = '16px Arial';
const measurement = ctx.measureText('Sample text for measurement');
return {
width: measurement.width,
actualBoundingBoxAscent: measurement.actualBoundingBoxAscent,
actualBoundingBoxDescent: measurement.actualBoundingBoxDescent,
};
});
console.log('Text metrics:', metrics);
await browser.close();
})();
Puppeteer 集成
const puppeteer = require('puppeteer-core');
(async () => {
const browser = await puppeteer.launch({
executablePath: 'path/to/botbrowser/chrome',
args: ['--bot-profile=path/to/profile.enc', '--bot-noise-seed=42'],
headless: true,
defaultViewport: null,
});
const page = await browser.newPage();
await page.goto('https://example.com');
// Verify text measurement from the loaded profile
const metrics = await page.evaluate(() => {
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d');
ctx.font = '16px Arial';
const m = ctx.measureText('Sample text for measurement');
return { width: m.width };
});
console.log('Text width:', metrics.width);
await browser.close();
})();
实践 fixture
保留一个小型本地 fixture,让度量变化有可解释的原因。等待 Web 字体加载,显式设置 Canvas 状态,并保存未经四舍五入的原始值:
await page.evaluate(async () => {
await document.fonts.ready;
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d', { alpha: false });
ctx.font = '16px Arial';
ctx.direction = 'ltr';
ctx.textAlign = 'start';
ctx.textBaseline = 'alphabetic';
const sample = 'Aa 123, مرحبا, 世界';
const m = ctx.measureText(sample);
return {
sample,
font: ctx.font,
width: m.width,
actualBoundingBoxAscent: m.actualBoundingBoxAscent,
actualBoundingBoxDescent: m.actualBoundingBoxDescent,
devicePixelRatio: window.devicePixelRatio,
visualViewportScale: window.visualViewport?.scale ?? 1,
};
});
在控制浏览器和配置文件部署中使用相同的版本、字体、区域设置、缩放和运行模式执行 fixture。值发生变化意味着需要调查,并不能证明网站一定能或不能识别用户。
验证
使用配置文件启动 BotBrowser 后,验证文本测量保护是否激活:
const width = await page.evaluate(() => {
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d');
ctx.font = '16px Arial';
return ctx.measureText('Verification string').width;
});
console.log('Text width:', width);
检查要点:
- 宽度值是全精度浮点数,可在文档条件下与配置文件声明的平台比较。
- 重新加载页面并重复测量产生相同的值。
- 使用相同的配置文件和噪声种子重启浏览器产生相同的值。
- 将结果与受控的 Canvas 和 CSS 检查进行比较;第三方测试页面可能独立变化。
最佳实践
始终使用完整的配置文件
文本测量保护作为 BotBrowser 完整指纹配置文件的一部分工作。配置文件可在文档化条件下对齐受支持的文本度量;浏览器版本、字体、图形路径和运行模式仍会影响具体结果。加载配置文件是启用受支持行为的必要条件。
结合网络身份
文本度量可提供环境线索。网络信号提供位置上下文。为了比较部署,将指纹配置文件与适当的代理和区域设置结合:
chrome --bot-profile="path/to/profile.enc" \
--proxy-server="socks5://user:pass@proxy:1080" \
--bot-timezone="Europe/London" \
--bot-locale="en-GB" \
--bot-languages="en-GB,en"
使用确定性模式进行测试
运行自动化测试或研究实验时,使用 --bot-noise-seed 以便更容易重现结果。这有助于检查测试运行之间的文本度量是否稳定,并发现一致性回退。
使用多种字体配置进行测试
验证保护时,使用各种字体族和大小进行测试。在测试集中包括常见的 Web 字体和系统默认值。这确保了配置文件的文本度量一致性在追踪脚本通常探测的字体范围内得到全面覆盖。
保持配置文件和 BotBrowser 更新
文本测量指纹识别持续演变。最近的浏览器版本添加了新的 TextMetrics 属性,追踪脚本更新了其收集以包括这些新信号。保持 BotBrowser 安装和配置文件更新,以确保覆盖新的可利用属性。
完整字体字符串属于输入的一部分。记录样式、字重、字号、变体、字体族以及 document.fonts.ready 状态;回退字体可能改变后续所有字形度量。
在相关场景下按文字系统分开保存样本。为 Latin、Cyrillic、Arabic 或 CJK 保留有版本的短语料,并仅在产品实际使用时加入标点、组合标记、emoji 和双向文本。
记录 devicePixelRatio、visualViewport.scale、Canvas 尺寸、页面缩放和系统缩放。measureText() 使用 CSS 坐标,而像素比较还会受到缓冲区尺寸和栅格化影响。
每次探测前重置 Canvas 状态,明确设置字体、方向、对齐方式和基线。使用相同版本、字体、区域设置和 headed/headless 模式比较控制页面与配置文件页面;出现差异应先调查原因。
权限、存储分区、CSP 或被阻止的 Web 字体可能导致探测无法完成。记录网络和权限状态,保留本地样本,并同时比较 TextMetrics、Canvas 栅格、DOM 和字体加载事件。关于在类似测试环境中安全处理外部 URL,可参阅浏览器配置文件的外部 URL 安全处理。应在字体加载完成后再测量文本或布局,因为晚到的字体替换可能改变字形度量与换行;Web 字体加载与布局稳定说明了这种关系。
常见问题
什么是文本测量指纹识别?
文本测量指纹识别使用 Canvas measureText() API 比较渲染行为。字体、浏览器版本、图形设置和区域设置变化时,文本宽度可能不同。脚本可以把这些差异作为环境推断的一部分,但单次测量不是通用的操作系统标识,也不能证明某个具体设备。
这与 Canvas 指纹识别有什么不同?
Canvas 指纹识别将可视内容(文本、形状、渐变)渲染到 Canvas 元素并对生成的像素数据进行哈希。文本测量指纹识别使用 measureText() 获取数值宽度值而不渲染任何可见内容。文本测量更快,产生直接的数值结果,并提供不同类型的信号。两种技术都依赖于平台特定的渲染差异,但它们操作 Canvas API 的不同输出。你可以在我们的 Canvas 指纹识别 指南中了解更多关于 Canvas 指纹识别的信息。
BotBrowser 在所有平台上产生相同的值吗?
目标部署验收应重新读取 TextMetrics.width、actualBoundingBoxAscent 和 actualBoundingBoxDescent,并将结果与 browserVersion 和 fontSet 一起保存。
文本测量保护会破坏网站吗?
不会。BotBrowser 不会阻止或修改 measureText() API。该 API 正常工作,返回 Web 应用程序可用于布局、文本截断、图表渲染和所有其他合法用途的准确文本宽度值。这些值只是与加载的配置文件一致,而不是与主机系统的原生渲染一致。
这与字体指纹识别有什么关系?
文本测量指纹识别与字体指纹识别密切相关,但针对不同的信号。字体指纹识别通过检查特定字体族是否可用来识别安装了哪些字体。文本测量指纹识别通过检查亚像素度量值来识别渲染路径如何处理这些字体。两个信号都源自字体渲染堆栈,两者都由 BotBrowser 的渲染路径级保护覆盖。有关更广泛的概述,请参阅我们关于浏览器指纹识别的文章。
我可以在现有的自动化框架中使用 BotBrowser 的文本测量保护吗?
是的。BotBrowser 与 Playwright、Puppeteer、Selenium 和其他自动化框架集成。加载指纹配置文件时,文本测量保护会自动激活。除了传递 --bot-profile 标志外,不需要额外的配置或代码更改。有关设置说明,请参阅 Playwright 入门指南 和 Puppeteer 入门指南。
这种保护覆盖所有 TextMetrics 属性吗?
BotBrowser 支持文档所述的 TextMetrics 属性,包括 width、边界框字段以及 ascent/descent 字段。具体可用性和值取决于浏览器版本、字体、图形、区域设置和运行模式;请在目标部署中验证实际使用的字段。
总结
文本测量指纹识别利用 Canvas measureText() API 的亚像素精度比较渲染行为。字体、浏览器版本、图形路径或缩放变化时,相同文本可能产生不同宽度。脚本可以观察这些差异,但稳定性取决于部署条件。
BotBrowser 通过将已加载配置文件应用于受支持的文本和 Canvas 行为来处理这一信号。请使用生产环境的确切浏览器版本、字体、区域设置、图形和运行模式验证结果;不保证主机之间逐字节相同,也不保证其他信号会被网站以同样方式解释。
结合 BotBrowser 对 Canvas 渲染、字体枚举和跨平台配置文件一致性的保护,文本测量保护可处理追踪系统使用的一种指纹信号。
BotBrowser 功能与限制
BotBrowser 可在文档约束范围内,让受支持的 Canvas measureText() 行为与已加载配置文件对齐;结果仍受浏览器、字体、图形栈和运行模式影响。它无法阻止网站收集或传输这些值,无法控制网站如何存储或解释这些值,也不覆盖配置文件之外的信号。可重复比较需要相同配置文件、标志、字体和测试方案。
实际结论
在依赖这些测量之前,请固定浏览器版本、配置文件、字体、区域设置、图形模式和运行模式,然后将完整 TextMetrics 结果与 Canvas 和 CSS 检查进行比较。应把它视为隐私和兼容性评估中的一个信号,而不是单独的保证。
公开来源
本文属于指南: 什么是浏览器指纹?原理、风险、信号与隐私边界