Перейти к основному содержанию

Установка

Требуется Node.js 20 или новее. Третья версия SDK поддерживает только ESM: подключайте его через import, а require('gologin') не сработает.

Базовое использование

Запуск через GologinApi

GologinApi запускает профиль и сам подключает Puppeteer. Метод launch() возвращает browser Puppeteer. Передайте cloud: true, чтобы запустить профиль в Gologin Cloud Browser, а не в локальном браузере Orbita:
Если profileId не указан, launch() сначала создаёт новый профиль. В GologinApi также есть вспомогательные методы, например createProfileRandomFingerprint(), addGologinProxyToProfile(), addCookiesToProfile() и deleteProfile(). Полный пример смотрите в разделе Быстрый старт.

Основные параметры

Остановка профилей

Сначала закройте браузер в вашем инструменте автоматизации, например через browser.close(). Метод stop() не принимает параметров и всегда загружает профиль в Gologin. Метод stopLocal({ posting: false }) завершает сеанс без загрузки данных профиля. Используйте его на серверах, где синхронизация с облаком не нужна. Cookies по-прежнему загружаются, если вы указали uploadCookiesToServer: true.

Управление версиями браузера Orbita

При запуске профиля SDK проверяет, какая версия Orbita нужна для user agent этого профиля. Если этой версии ещё нет в ~/.gologin/browser, SDK скачивает её, а если есть, использует установленную копию. Чтобы запустить конкретную сборку, передайте executablePath. Параметры autoUpdateBrowser (по умолчанию false) и checkBrowserUpdate по-прежнему принимаются, но в текущей версии SDK (3.0.7) на это поведение не влияют. Чтобы скачать Orbita заранее, вызовите checkAndDownloadBrowserByOpts() у экземпляра GoLogin. Это метод, а не отдельный экспорт:
Без параметров метод скачивает 5 последних версий. Используйте его перед параллельным запуском профилей, чтобы избежать нескольких одновременных загрузок.

Запуск 100+ профилей параллельно

Если на сервере одновременно работает много профилей:
Важно для серверов:
  • Ограничивайте число одновременных запусков профилей (для начала рекомендуется 10-20)
  • Скачивайте версии Orbita заранее, до запуска профилей
  • В Linux: установите Xvfb и задайте DISPLAY=:99
  • Увеличьте лимиты файловых дескрипторов: ulimit -n 65536
  • Следите за оперативной памятью: каждый профиль использует ~300-500 МБ

Отладка

Чтобы включить подробное логирование, задайте переменную окружения:

GitHub и список изменений