Управление профилями BotBrowser: практическое руководство

Что такое профили BotBrowser?

Профиль BotBrowser - это зашифрованный файл (формат .enc), который определяет полную идентификацию браузера. Каждый профиль содержит согласованный набор значений для разрешения экрана, рендерера WebGL, шрифтов, свойств navigator и других сигналов браузера.

При запуске BotBrowser с профилем браузер производит согласованный вывод фингерпринта, соответствующий реальной конфигурации устройства.

Где получить профили

Репозиторий 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-рецепты для примеров комбинаций флагов