WebRTC 编解码器指纹:媒体能力泄露
通过 getCapabilities() 和 SDP offer 进行的 WebRTC 编解码器枚举会暴露因操作系统而异的硬件媒体能力。了解编解码器列表如何成为平台指纹,以及如何加以控制。
BotBrowser Team
通话建立之前,页面就能询问浏览器支持哪些视频与音频编解码器,而答案不需要权限提示、对等端或麦克风。BotBrowser 可以给出跟随已加载配置文件的编解码器列表,但不能保证每个对等端都接受这份列表,也不能保证真实通话的表现完全一致。下面说明这些列表从哪里来、哪些 API 表面必须彼此吻合,以及团队在把结果当作已复审之前应当记录什么。
TL;DR
RTCRtpSender.getCapabilities('video')与RTCRtpReceiver.getCapabilities('audio')都是静态方法,立即返回编解码器列表,不需要连接,也不需要权限。createOffer()把同一份协商写进 SDP,所以m=video与m=audio行列出的编解码器与编号,应当与同一配置文件下能力调用返回的结果一致。- 编解码器顺序以及
H264、VP8、VP9、AV1、opus是否出现,取决于平台的硬件与许可,这就是 Windows 配置文件与 Linux 主机结果不同的原因。 - BotBrowser 让 JavaScript 看到的列表跟随配置文件,而浏览器内部仍使用主机解码器,因此配置文件里主机缺少的编解码器不会让通话崩溃。
- 发布验收看三项检查:多次加载后计数一致、SDP 与
getCapabilities()吻合、双方之间的真实通话仍能完成协商。
目录
简介
WebRTC 支持浏览器中的实时视频和音频通信。在任何媒体在对等端之间流动之前,浏览器会枚举其支持的编解码器,并通过能力 API 和 SDP(会话描述协议)offer 来暴露它们。这种协商对于功能性视频通话至关重要,但它也创建了一个详细的系统媒体能力清单,任何网站都可以在不需要特殊权限的情况下查询。在受控环境中,BotBrowser 可以呈现与配置文件一致的编解码器列表;它不能保证与所有对等端兼容,也不能替代媒体协商测试。如需了解 CreepJS 如何把编解码器及其他 WebRTC 字段转换为部分字段摘要,请参阅报告字段来源分析。
WebRTC 编解码器能力因平台而异,可以用作追踪信号。不同的操作系统提供不同级别的硬件加速支持,这直接决定了哪些编解码器出现在浏览器的能力列表中。网站可以查询这些列表并将其与已知的平台配置文件进行比较,从而推断你的真实操作系统,即使你的 user agent 字符串声称的是其他系统。语音列表的情况与此类似,详见 语音合成指纹:语音列表追踪。
BotBrowser 通过从指纹配置文件构建 WebRTC 编解码器能力列表来解决这个问题,使 JavaScript 在配置文件覆盖范围内看到与目标平台对齐的内容,而不是主机系统的实际硬件。
BotBrowser 的解决方案
BotBrowser 在能力被组装的位置按配置文件数据生成 WebRTC 编解码器列表,而不是事后修补 JavaScript 对象或改写 SDP 字符串。其目标是让受支持的编解码器 API 与已加载配置文件保持一致;具体覆盖范围仍应按所用配置文件和浏览器版本验证。
配置文件驱动的编解码器构建
当加载 BotBrowser 配置文件时,WebRTC 编解码器能力是从配置文件记录的编解码器数据构建的,而不是从主机系统的实际硬件能力构建的。配置文件包含从匹配目标平台的真实设备捕获的完整编解码器配置:
- 完整的支持视频和音频编解码器列表
- 编解码器参数,包括 profiles、levels 和格式特定选项
- 能力列表中编解码器的正确排序
- 编解码器与 SDP 生成所用编号之间的对应关系
这意味着针对某个平台的配置文件,在完全不同的主机操作系统上加载时,仍会报告配置文件目标的正确 WebRTC 编解码器。主机系统的实际能力与 JavaScript 看到的内容无关。
SDP 一致性
在两者使用同一配置文件时,BotBrowser 旨在让 createOffer() 生成的 SDP 与 getCapabilities() 报告的编解码器能力保持一致。
SDP 中的 m=video 和 m=audio 行旨在携带与配置文件编解码器集对应的标识和编号。在该配置文件范围内比较两个 API 通常应看到匹配值;这不代表所有对等端或外部媒体路径都完全一致。
功能兼容性
编解码器检查只是一种能力观察;浏览器能否把非 Web URL 交给应用,是另一种,详见浏览器配置文件的外部 URL 安全处理。
BotBrowser 通过双层设计解决这个问题: JavaScript 看到配置文件的编解码器列表,而内部浏览器只注册主机系统实际可以处理的编解码器。这种分离意味着:
- 指纹脚本看到与配置文件准确匹配的编解码器列表。
- 实际的 WebRTC 通话使用双方和本地系统都能处理的编解码器进行协商。
- 当配置文件列出主机无法解码的编解码器时,不会崩溃或出错。
这是一个关键区别。简单地将编解码器条目注入能力列表会导致浏览器尝试实际使用这些编解码器时出现失败。BotBrowser 把上报能力与功能性媒体处理之间的边界留在浏览器内部。
跨 API 对齐
在已加载配置文件覆盖的范围内,BotBrowser 设计为对齐 WebRTC API 和以下媒体能力接口:
RTCRtpSender.getCapabilities()和RTCRtpReceiver.getCapabilities()返回与配置文件一致的编解码器。createOffer()的 SDP offer 包含匹配的编解码器标识和编号。canPlayType()和MediaCapabilities.decodingInfo()等通用媒体 API 返回与 WebRTC 编解码器配置文件一致的结果。- 整体媒体指纹以一致的方式描述平台。
这种跨 API 对齐有助于让编解码器报告路径关联到已加载配置文件;主机编解码器能力和实际对等端协商仍会限制媒体功能。关于 WebCodecs 暴露了什么以及各平台支持为何不同,请参阅WebCodecs 浏览器能力与隐私,其中介绍了隐私与兼容性边界。
加载配置文件并读取编解码器列表
基本 CLI 用法
加载配置文件时,WebRTC 编解码器保护是自动的。不需要额外的标志:
chrome --bot-profile="path/to/profile.enc" \
--user-data-dir="$(mktemp -d)"
配置文件的 WebRTC 编解码器配置在启动时应用。所有后续的 WebRTC 能力查询和 SDP 生成都将反映配置文件的编解码器集。
Playwright 集成
const { chromium } = require('playwright-core');
(async () => {
const browser = await chromium.launch({
executablePath: 'path/to/botbrowser/chrome',
args: ['--bot-profile=path/to/profile.enc'],
headless: true,
});
const context = await browser.newContext({ viewport: null });
const page = await context.newPage();
await page.goto('about:blank');
// Verify WebRTC codec capabilities from the loaded profile
const codecInfo = await page.evaluate(() => {
const videoCaps = RTCRtpSender.getCapabilities('video');
const audioCaps = RTCRtpSender.getCapabilities('audio');
return {
videoCodecCount: videoCaps?.codecs.length || 0,
audioCodecCount: audioCaps?.codecs.length || 0,
};
});
console.log('Video codecs:', codecInfo.videoCodecCount);
console.log('Audio codecs:', codecInfo.audioCodecCount);
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'],
headless: true,
defaultViewport: null,
});
const page = await browser.newPage();
await page.goto('about:blank');
// Verify WebRTC codec capabilities from the loaded profile
const codecs = await page.evaluate(() => {
const videoCaps = RTCRtpSender.getCapabilities('video');
const audioCaps = RTCRtpSender.getCapabilities('audio');
return {
videoCount: videoCaps?.codecs.length || 0,
audioCount: audioCaps?.codecs.length || 0,
};
});
console.log(`Video codecs: ${codecs.videoCount}`);
console.log(`Audio codecs: ${codecs.audioCount}`);
await browser.close();
})();
结合代理和平台设置
为了实现更广泛的平台一致性,将编解码器保护与代理和平台配置结合,并分别验证各类信号:
chrome --bot-profile="path/to/profile.enc" \
--proxy-server="socks5://user:[email protected]:1080" \
--bot-timezone="America/New_York" \
--bot-locale="en-US" \
--user-data-dir="$(mktemp -d)"
这可以让编解码器能力与配置文件平台对齐;网络身份、时区、区域设置和其他信号仍取决于各自设置及代理行为。关于如何在配置文件、真实和禁用这几种 WebRTC 姿态之间选择,请参阅WebRTC 网络身份与隐私:如何选择策略,其中解释了候选地址与统计地址为何应保持一致。
验证
配置 BotBrowser 加载配置文件后,验证 WebRTC 编解码器保护是否正常工作:
-
编解码器计数检查: 调用
RTCRtpSender.getCapabilities('video')并确认编解码器数量与配置文件目标平台的预期匹配。 -
稳定性检查: 重新加载页面并重复。编解码器的数量和类型在页面加载之间应该相同。使用相同的配置文件重启浏览器并再次验证。
-
指纹测试站点: 访问浏览器指纹测试服务并检查 WebRTC 部分。报告的编解码器不应标记任何异常。
同一份配置文件贯穿编解码器与通话测试
-
始终使用完整的配置文件。 WebRTC 编解码器能力必须与配置文件的操作系统、浏览器版本和 GPU 配置对齐。BotBrowser 配置文件从真实设备捕获,确保所有这些维度内部一致。不要混合和匹配配置文件组件。
-
将编解码器期望与你的用例匹配。 如果你正在处理积极使用 WebRTC 进行视频通话或流媒体的网站,请确保你的配置文件编解码器集支持这些站点期望的格式。排除常用编解码器的配置文件可能会导致实际 WebRTC 会话中的协商失败。
-
结合 WebRTC IP 保护。 编解码器指纹识别和 IP 泄漏是不同的 WebRTC 隐私问题,但两者都需要解决。使用 BotBrowser 的代理集成
--proxy-server和--bot-webrtc-ice确保你的 WebRTC IP 地址也受到控制。详见 WebRTC 泄漏防护 指南。 -
不要手动修改编解码器设置。 让配置文件完全处理编解码器配置。通过 chrome 标志或配置覆盖手动添加或删除编解码器可能会产生破坏配置文件一致性的不一致。
-
保持配置文件更新。 编解码器支持随浏览器版本变化。新的编解码器被添加,现有编解码器参数可能会改变。使用与声称的浏览器版本匹配的配置文件确保你的编解码器能力与该版本的真实浏览器报告的内容一致。
-
验证跨平台一致性。 如果你在不同的主机操作系统上使用相同的配置文件(例如,在 macOS 主机和 Linux 主机上运行 Windows 配置文件),请验证两个主机上的 WebRTC 编解码器能力是否相同。BotBrowser 的配置文件驱动方法应该无论主机如何都产生相同的输出,但验证可以给你信心。
-
监控与编解码器相关的 WebRTC 错误。 如果你遇到 WebRTC 连接问题,请检查浏览器控制台中的编解码器协商错误。BotBrowser 优雅地处理配置文件编解码器和本地可用编解码器之间的差距,但某些具有不寻常对等配置的边缘情况可能需要注意。
常见问题
什么是 WebRTC 编解码器指纹识别?
WebRTC 编解码器指纹识别是一种技术,网站查询你的浏览器的 WebRTC 媒体能力来了解你的系统支持哪些视频和音频编解码器。由于编解码器支持因操作系统和硬件而异,此信息可用作追踪信号来推断你的平台详情。
这与通用媒体编解码器指纹识别有什么不同?
通用媒体编解码器指纹识别使用 canPlayType() 和 MediaCapabilities 等 API。WebRTC 编解码器指纹识别使用 WebRTC 特定的 API: RTCRtpSender.getCapabilities()、RTCRtpReceiver.getCapabilities() 和来自 createOffer() 的 SDP offer。WebRTC 编解码器集与通用媒体编解码器集不完全相同,因为 WebRTC 有自己的支持编解码器列表,反映了实时通信需求。BotBrowser 的配置文件驱动方法一致地覆盖了两个表面。有关通用媒体编解码器保护,请参阅 MIME 类型和编解码器指纹识别 文章。
网站可以在不进行通话的情况下查询 WebRTC 编解码器吗?
是的。不需要实际的 WebRTC 连接。RTCRtpSender.getCapabilities('video') 是一个静态方法,可以立即返回编解码器信息。同样,createOffer() 生成 SDP 文档而不连接到任何远程对等端。两个操作都是快速、静默的,不需要用户交互或权限。
BotBrowser 是否禁用了任何编解码器?
不。BotBrowser 不会删除或禁用编解码器功能。相反,它控制向 JavaScript 报告的编解码器信息。JavaScript 可见的编解码器列表与加载的配置文件匹配。在内部,浏览器仍然使用主机系统上可用的编解码器进行实际媒体处理。这意味着你的指纹受到控制而不会牺牲 WebRTC 功能。
如果配置文件列出了我的系统不支持的编解码器会怎样?
BotBrowser 优雅地处理这种情况。JavaScript 可见的 API 报告配置文件的编解码器列表,保持正确的指纹。当实际的 WebRTC 媒体协商发生时,浏览器内部只使用主机系统可以处理的编解码器。如果配置文件编解码器在本地不可用,它将从内部处理中排除而不影响指纹呈现。这防止了崩溃并确保通话仍然正常工作。
这是否也保护音频编解码器?
是的。BotBrowser 的配置文件驱动编解码器构建适用于视频和音频能力。来自 getCapabilities('audio') 的音频编解码器列表和 SDP offer 中的音频条目也源自配置文件数据。
BotBrowser 如何处理编解码器排序?
能力列表和 SDP offer 中的编解码器排序可以携带平台特定的信息。BotBrowser 保留配置文件中的确切编解码器排序,这反映了目标平台上的自然排序。这个细节很重要,因为编解码器出现的顺序本身就是一个应该与配置文件目标匹配的信号。
这在无头模式下工作吗?
是的,但前提是同一个配置文件。以 --headless=new 和带窗口两种方式各启一次,都用同一个 --bot-profile,然后比较 RTCRtpSender.getCapabilities('video').codecs.map(c => c.mimeType) 的输出:两份数组应当完全相同,顺序也相同。如果不同,先检查两次启动是否读了不同版本的配置文件,而不是先怀疑无头模式。
我可以在不进行真实 WebRTC 通话的情况下验证保护吗?
是的。你可以通过在页面的 JavaScript 控制台或通过 Playwright/Puppeteer 自动化调用 RTCRtpSender.getCapabilities('video') 和 createOffer() 来验证。不需要对等连接或远程服务器。配置和使用部分中的代码示例演示了这一点。
总结
通过 getCapabilities() 和 SDP offer 的 WebRTC 编解码器枚举暴露了因操作系统而异的媒体能力,使编解码器列表成为潜在的追踪信号。BotBrowser 从加载的指纹配置文件构建 WebRTC 编解码器能力,因此每个暴露编解码器信息的 API,从 getCapabilities() 到 createOffer() SDP 生成,都返回与配置文件一致的结果。JavaScript 可见列表与内部注册解码器之间的分离,让上报的列表停留在目标平台上,同时实际的 WebRTC 功能继续正常工作。
结合 WebRTC IP 泄漏防护、MIME 类型和编解码器保护、跨平台浏览器配置文件 和全面的指纹验证,BotBrowser 提供了对每个可能暴露你平台身份的 WebRTC 信号的全面控制。
BotBrowser 支持受控 WebRTC 编解码能力设置用于指纹审查;它不能保证对等兼容,也不能替代媒体协商测试。
来源
- BotBrowser 的 WebRTC 指纹文档:MIME 与编解码器指纹
- 能力调用的 MDN 参考:RTCRtpSender.getCapabilities
实践结论
先决定这次复审要回答什么。编解码器列表回答的是兼容性问题,也就是这份配置文件能否提供应用需要的媒体格式,它并不回答关于设备或人的身份问题。把配置文件家族、目标平台、浏览器版本和应用路径写进发布记录,检查就限定在这四项输入上。
在同一个上下文里完成对比。调用 RTCRtpSender.getCapabilities('video') 和 RTCRtpSender.getCapabilities('audio'),记下数量与编解码器名称;再不接对等端调用 createOffer(),把 m=video 与 m=audio 行和能力调用的结果逐项对照。重载后再跑一次,并用同一份配置文件重启浏览器再跑一次;多次加载之间数量变化,指向配置文件或浏览器构建,而不是网络。只有当部署同时需要控制候选地址时,才加上 --proxy-server 和 --bot-webrtc-ice,并单独验证它们。
然后用产品真正使用的两个对等端跑通一次真实通话。如果配置文件的编解码器集合缺少站点依赖的格式,即使所有 JavaScript 检查都通过,协商仍会失败;相反,列表与配置文件一致却让通话坏掉,就是产品回归而不是隐私收益。浏览器版本改变列表时,保留上一份配置文件包和上一个浏览器构建,直到新组合同时通过列表对比与真实通话,并记录是哪一项检查决定了结论。
本文属于指南: 什么是 WebRTC 泄露?IP 泄露防护与浏览器隐私