Свой сервер: OEM-версия

OEM-версия запускает сервис AntiBrow на вашей инфраструктуре: API-сервер, с которым работают SDK и десктопное приложение, и панель администратора для тарифов, пользователей и ключей. Исходный код под MIT лежит в папке server/ публичного репозитория, полный справочник - его README (на английском). Здесь краткая версия. Что входит в OEM-версию и что нет, описано на странице OEM-версии.

Что понадобится

  • PostgreSQL 15 или новее.
  • S3-совместимый бакет (R2, MinIO, Aliyun OSS и подобные), если у пользователей будет облачная синхронизация.
  • Хост с Docker или аккаунт Cloudflare. Одна кодовая база собирается под оба варианта.
  • Ключ подписи для ядра, согласованный с нами (см. FP_LICENSE_PRIVKEY ниже).

Запуск в Docker

cp .env.example .env   # set FP_LICENSE_PRIVKEY
docker compose up -d --build
curl localhost:4321/api/v1/health

Compose-файл поднимает приложение, PostgreSQL 17 и S3-совместимое хранилище на одной машине. Образ запускает prisma migrate deploy при каждом старте, так что база мигрирована до того, как сервер начнёт принимать запросы. Для боевого развёртывания задайте S3_PUBLIC_ENDPOINT - адрес, доступный вашим пользователям; значение из compose работает только на той же машине.

Запуск на Cloudflare Workers

pnpm build:cf
DATABASE_URL=postgresql://... pnpm db:migrate

Скопируйте deploy/cloudflare.jsonc.example в свой конфиг, задайте перечисленные там секреты через CLI Cloudflare и задеплойте папку dist. PostgreSQL и бакет по-прежнему ваши. Миграции запускайте сами перед каждым деплоем.

Настройки

  • DATABASE_URL - Строка подключения к PostgreSQL. Обязательно.
  • FP_LICENSE_PRIVKEY - Seed Ed25519 (64 hex-символа), которым подписываются лицензионные токены ядра. Обязательно. Ядро должно знать ваш ключ подписи, поэтому согласуйте его с нами при подключении OEM-версии.
  • OEM_ADMIN_PASSWORD - Пароль панели администратора. Без него все маршруты администратора отвечают 404, в том числе по bearer-токену.
  • OEM_ADMIN_TOKEN - Необязательный bearer-токен для скриптов, вызывающих admin API.
  • OEM_SESSION_SECRET - Подписывает cookie сессии администратора.
  • S3_ENDPOINT, S3_BUCKET, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY - S3-совместимое хранилище для архивов профилей. Все четыре вместе или ни одной (тогда без облачной синхронизации).
  • S3_PUBLIC_ENDPOINT - Адрес, по которому клиенты загружают и скачивают по подписанным ссылкам, если он отличается от S3_ENDPOINT. Должен быть доступен вашим пользователям.
  • S3_ADDRESSING, S3_REGION - Адресация path (по умолчанию) или virtual. Для Aliyun OSS нужны virtual и id региона.
  • OEM_PUBLIC_URL, OEM_BRAND_NAME - Публичный адрес вашего сервера и название бренда, которое показывают клиенты.
  • KERNEL_MANIFEST_URL - Каталог ядер. По умолчанию - сайт загрузок AntiBrow.

Панель и API администратора

Откройте /admin и войдите с OEM_ADMIN_PASSWORD. Там вы создаёте тарифы (лимиты параллельных запусков и облачной синхронизации), заводите пользователей на тарифе с необязательной датой окончания, выпускаете и отзываете API-ключи и задаёте последнюю и минимальную версию десктопного приложения. Первая миграция создаёт тариф по умолчанию FREE; пользователи с истёкшим тарифом возвращаются на него.

Всё, что делает панель, проходит через admin API в /api/admin/ (plans, users, users/:id/keys, releases, status), который принимает и Authorization: Bearer <OEM_ADMIN_TOKEN>. Так ваш биллинг или бэк-офис создаёт пользователей и продлевает тарифы.

Подключение SDK

from antibrow import launch

browser = launch(profile="client-042", server="https://api.your-brand.com", api_key="...")

SDK для JavaScript принимает тот же параметр server, и оба читают ANTI_DETECT_BROWSER_SERVER. SDK читает /api/v1/config вашего сервера, чтобы узнать, что он поддерживает; функции, которых на нём нет, выбрасывают FeatureUnavailableError, а не обращаются к antibrow.com.

Десктопное приложение

Два варианта. Без сборки: пользователи ставят официальное приложение AntiBrow и вводят адрес вашего сервера на странице входа; приложение показывает название, логотип, цвет и ссылки с вашего сервера и по-прежнему скачивает ядро только с сайта загрузок AntiBrow. Или соберите своё приложение под вашим брендом из приватного репозитория, к которому мы даём доступ: с зашитым адресом сервера, подписанное вашими сертификатами и выложенное в ваше хранилище.

Обновления

Новые версии server/ забирайте с GitHub, когда удобно. Изменения схемы приходят только миграциями Prisma, у каждого изменения есть версия и запись в changelog. Вопросы по настройке или условиям: partners@antibrow.com.