BotBrowser 配置文件管理实用指南

什么是 BotBrowser 配置文件？

BotBrowser 配置文件是加密文件（.enc 格式），定义了完整的浏览器身份。每个配置文件包含屏幕分辨率、WebGL 渲染器、字体、navigator 属性等浏览器信号的一致数据。

加载配置文件后，浏览器产生与真实设备配置匹配的一致指纹输出。

获取配置文件

BotBrowser Profiles 仓库 提供定期更新的即用配置文件。

git clone https://github.com/botswin/BotBrowser-Profiles.git

官方发布版二进制文件使用 .enc 文件，本地编译的二进制文件使用原始 .json 格式。

加载单个配置文件

./chrome --bot-profile=/path/to/profiles/windows-chrome-131.enc

同一配置文件每次产生相同的指纹输出，适用于跨会话维护持久身份。

随机配置文件选择

使用 --bot-profile-dir 在每次启动时从目录中随机选择配置文件：

./chrome --bot-profile-dir=/path/to/profiles/

按类别组织配置文件以实现定向选择：

profiles/
  windows-chrome/
    win-chrome-130.enc
    win-chrome-131.enc
  macos-chrome/
    mac-chrome-131.enc

配置覆盖

使用 --bot-config-* 参数覆盖配置文件中的特定值：

./chrome \
  --bot-profile=/path/to/profile.enc \
  --bot-config-timezone=Europe/London \
  --bot-config-locale=en-GB \
  --bot-config-languages=en-GB,en

可用覆盖参数：--bot-config-browser-brand、--bot-config-timezone、--bot-config-locale、--bot-config-languages、--bot-config-location、--bot-config-webgl、--bot-config-webgpu、--bot-config-noise-canvas。

最佳实践

使用绝对路径。 --bot-profile 的相对路径可能解析不正确。

配置文件格式匹配二进制类型。 发布版需要 .enc，源码编译版使用 .json。

保持配置文件更新。 定期拉取最新配置文件以匹配当前浏览器版本。

持久身份使用固定配置文件。 不要对持久身份使用 --bot-profile-dir，因为它是随机选择的。

下一步

• Playwright 入门 了解自动化集成
• Puppeteer 入门 了解 Puppeteer 工作流
• CLI 使用技巧 了解参数组合示例