BotBrowser：跨平台指纹防护浏览器内核

项目简介

BotBrowser 是一个隐私优先的浏览器内核，用于抵御浏览器指纹识别。它让指纹信号在所有平台上保持统一，避免追踪系统采集并关联数据来识别用户。同一份 profile 在 Windows、macOS 或 Linux 上运行时，指纹特征保持一致。

内核基于最新稳定版 Chromium，并提供 Android WebView 与 WebKit 系列 profile 的一致性支持。项目的工程重点放在隐私研究、跨平台抗追踪验证，以及授权环境下的防御性基准测试。使用前请阅读项目仓库中的 Legal Disclaimer 与 Responsible Use Guidelines。

主要功能

• 统一的跨平台指纹：单份 profile 覆盖 UA、屏幕参数、触摸面、字体与设备 API，覆盖 Windows、macOS、Linux（ENT Tier1）、Android（PRO）、WebView（ENT Tier3）与 WebKit 系列 profile 包（ENT Tier4）。
• 高保真、持续更新的 profile：基于最新稳定版 Chromium 构建，降低引擎陈旧带来的关联风险。
• 网络栈一致性：Full-Proxy QUIC/STUN（UDP over SOCKS5），避免地理位置元数据泄漏。
• 程序化控制：提供 Playwright／Puppeteer 集成，并支持 CDP 泄漏阻断。
• Per-Context Fingerprint：为每个 BrowserContext 提供独立指纹包，无需新建进程，毫秒级切换并降低内存开销。
• 分布式验证：配合 Mirror 工具同步输入，在多个浏览器实例上并行验证隐私防护表现。
• 自动推导环境：时区、locale 与语言根据代理 IP 自动推导，必要时可通过 CLI 覆盖。
• 性能：Speedometer 3.0 与原生 Chrome 差距小于 1%，指纹 API 零开销；大规模场景下 Per-Context 可节省 29% 内存。Trimmed Build（ENT Tier3）在 Linux x64 上墙钟时间降低 62%，每上下文创建快 85%。

安装与使用

第一步：下载

• 从 Releases 下载对应系统的版本。
• 准备匹配的 profile 包。BotBrowser 150 及更新版本的 profile 需通过订阅或联系 [email protected]、@botbrowser_support 获取；旧版演示 profile 仍可用于早期评估。

第二步：启动

• GUI：使用 BotBrowser Control 一键选择 profile 并管理多实例。
• CLI（请使用绝对路径）：

chrome.exe --bot-profile="C:\absolute\path\to\profile.enc" --user-data-dir="%TEMP%\botprofile_%RANDOM%"
macOS/Linux 的命令遵循同样的模式，完整说明见 [INSTALLATION.md](https://github.com/botswin/BotBrowser/blob/main/INSTALLATION.md)。

**第三步：验证**

访问 [CreepJS](https://abrahamjuliot.github.io/creepjs/) 或你常用的追踪检测站点，确认指纹表现一致。

**Playwright 最小示例**

```javascript
const browser = await chromium.launch({
  headless: true,
  executablePath: BOTBROWSER_EXEC_PATH,
  args: [`--bot-profile=${BOT_PROFILE_PATH}`,
         '--proxy-server=socks5://usr:[email protected]:8989']
});
const page = await browser.newPage();
await page.goto('https://abrahamjuliot.github.io/creepjs/');

更多示例见 Playwright 与 Puppeteer，Docker 用法见 docker/README.md，完整参数见 CLI Flag Directory。

注意事项

• 请为 --user-data-dir 指定唯一的临时目录，避免与已运行的 Chromium 实例冲突。
• 优先使用 --proxy-server 或 per-context 代理（ENT Tier1），两种方式都会启用自动时区与语言检测。
• 避免使用框架自带的代理认证选项（如 page.authenticate()），这会关闭 BotBrowser 的地理检测并可能导致位置信息泄漏。
• 项目提供两种构建：Standard Build 走公开 release，适合长时间交互式会话；Trimmed Build（ENT Tier3）仅通过企业渠道提供，面向短会话、高并发自动化。两者指纹保护模型、profile 格式与接口一致，具体能力取决于所用 profile 包与订阅等级。
• 请遵守项目法律声明与负责任使用准则，仅用于授权范围内的隐私研究与测试。

本作品整理自 GitHub 开源项目 botswin/BotBrowser，原作者 @botswin，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。