BotBrowser CLI 使用技巧：实用参数组合

概述

BotBrowser 提供了众多 CLI 参数用于配置文件加载、代理路由、区域设置等。本文收集了常见场景的即用命令。所有示例假设你已有 BotBrowser 二进制文件和来自 GitHub 的 .enc 配置文件。

配方 1：基础启动

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --headless \
  --remote-debugging-port=9222

BotBrowser 自动从出口 IP 推导时区、区域和语言设置。

配方 2：代理 + 区域覆盖

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --proxy-server=socks5://user:pass@de-proxy.example.com:1080 \
  --bot-config-timezone="Europe/Berlin" \
  --bot-config-locale="de-DE" \
  --bot-config-languages="de-DE,de,en-US" \
  --bot-config-location="52.5200,13.4050" \
  --headless

省略覆盖参数时，BotBrowser 会自动从代理 IP 推导。

配方 3：多实例设置

# 实例 1
chromium-browser \
  --bot-profile="/path/to/profiles/win10-chrome.enc" \
  --bot-title="Session A" \
  --user-data-dir="/tmp/session-a" \
  --headless \
  --remote-debugging-port=9222 &

# 实例 2
chromium-browser \
  --bot-profile="/path/to/profiles/mac-chrome.enc" \
  --bot-title="Session B" \
  --user-data-dir="/tmp/session-b" \
  --headless \
  --remote-debugging-port=9223 &

每个实例需要独立的 --user-data-dir 和 --remote-debugging-port。自动轮换配置文件使用 --bot-profile-dir：

chromium-browser \
  --bot-profile-dir="/path/to/profiles/" \
  --user-data-dir="/tmp/rotating" \
  --headless

配方 4：浏览器品牌切换

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-config-browser-brand="edge" \
  --headless

可用品牌值：chrome、chromium、edge、brave、opera、webview。

配方 5：会话丰富

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-always-active \
  --bot-inject-random-history \
  --bot-bookmarks='[{"title":"GitHub","type":"url","url":"https://github.com"}]' \
  --headless

配方 6：Canvas 录制

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-canvas-record-file="/tmp/canvas-capture.jsonl" \
  --bot-noise-seed=12345 \
  --headless

将所有 Canvas 2D 和 WebGL API 调用录制到 JSONL 文件。--bot-noise-seed 使噪声输出确定性。

配方 7：Bot Script（无框架）

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-script="/path/to/automation.js" \
  --headless

运行带有 chrome.debugger CDP 直接访问的 JavaScript 文件，无需外部依赖。

提示

1. 设置代理后，BotBrowser 自动推导时区、区域和地理位置。仅在需要时覆盖。
2. CLI 参数优先级最高，会覆盖配置文件设置。
3. 并发实例使用 --user-data-dir 实现隔离。
4. 查看 CLI 参数参考 获取完整列表。