Свой сервер: 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.