Рецепты CLI для BotBrowser: практические комбинации флагов

Обзор

BotBrowser поставляется с множеством CLI-флагов для загрузки профилей, маршрутизации прокси, настроек локали и многого другого. Эта статья собирает готовые рецепты для распространенных сценариев. Все рецепты предполагают наличие бинарного файла BotBrowser и файлов профилей .enc с GitHub.

Рецепт 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

Записывает все вызовы API Canvas 2D и WebGL в файл JSONL. --bot-noise-seed делает вывод шума детерминированным.

Рецепт 7: Bot Script (без фреймворка)

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

Запускает JavaScript-файл с прямым доступом к chrome.debugger CDP. Внешние зависимости не нужны.

Советы

1. Если установлен прокси, BotBrowser автоматически определяет часовой пояс, локаль и геолокацию. Переопределяйте только при необходимости.
2. CLI-флаги переопределяют настройки профиля. Нет необходимости редактировать зашифрованные файлы профилей.
3. Используйте --user-data-dir для изоляции параллельных экземпляров.
4. Полный список флагов см. в справочнике CLI-флагов.