Управляемые прокси

Направляйте браузеры через резидентные IP - из наших управляемых прокси или подключите свои.

Управляемые резидентные прокси

Платные тарифы включают управляемые резидентные прокси. Возьмите один, привяжите к профилю и запускайте. Использование учитывается помесячно (см. ниже).

Свой прокси

Передайте любой URL protocol://user:pass@host:port в launch() - http, https или socks5. Собственные прокси никогда не учитываются в квоте.

Аутентификация происходит в движке

Прокси с логином/паролем обрабатываются самим движком браузера: HTTP- и HTTPS-запросы 407 обрабатываются внутри сетевого стека, а SOCKS5 - по RFC 1929, согласованием логина/пароля во время рукопожатия. Отсюда два следствия. В chrome://extensions ничего не загружается - вспомогательное расширение для авторизации прокси, которое до сих пор ставят большинство антидетект-браузеров, можно перечислить с любой страницы, и это именно тот демаскирующий признак, ради устранения которого создан продукт. А учётные данные доходят только до сетевого процесса и никогда - до рендерера, так что ни один скрипт страницы не может их прочитать.

Квоты тарифов

Каждый тариф допускает определённое число разных прокси, используемых в месяц (N). Одновременно можно удерживать до 2×N (получение/удержание всегда бесплатно).

Тариф	Разных прокси в месяц (N)	Лимит удержания (2×N)
FREE	0	0
BASIC	2	4
PRO	5	10
TEAM	20	40

Получение

Получить (бесплатно)

Заберите доступный управляемый прокси. Он закрепляется за вами. Получение никогда не расходует месячную квоту - можно удерживать до 2×N.

Освобождение

Верните удерживаемый управляемый прокси, освободив слот удержания.

Замена

Верните один прокси и получите новый одним действием.

Учёт и сброс

Учёт ведётся по активному использованию за месяц: удержание бесплатно, учитывается запуск.

Запуск профиля с управляемым прокси учитывает один отдельный прокси в текущем месяце.

Повторный запуск того же прокси в том же месяце бесплатен (обновляются только время последнего использования и счётчик запусков).

После использования N разных прокси за месяц активация нового вернёт 403 (месячная квота исчерпана).

Автосброс каждый месяц: учёт ведётся по календарному месяцу UTC (YYYY-MM). В начале месяца счётчик автоматически обнуляется - прокси, которые вы продолжаете использовать, засчитываются заново, а те, что перестали использоваться, просто освобождаются.

Получение, удержание и привязка не учитываются в квоте. Собственные прокси не учитываются никогда.

API

Все эндпоинты требуют Authorization: Bearer <api-key>.

GET/api/v1/proxies

Список ваших назначенных прокси + месячная квота: limit, usedThisMonth, remaining, holdCount, holdCap.

POST/api/v1/proxies

Управляйте своими удержаниями через тело запроса с action:

{ action: 'claim' } - получить доступный управляемый прокси (бесплатно)
{ action: 'release', proxyId } - освободить удерживаемый управляемый прокси
{ action: 'swap', proxyId } - заменить на новый

POST/api/v1/proxies/:id/activate

Учёт + активация перед запуском. Идемпотентен в течение месяца для одной и той же пары (user, proxy). Возвращает 403, если месячный лимит превышен. SDK вызывает это автоматически, если вы передаёте proxyId.

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

Из Node SDK

import { listProxies, claimManagedProxy } from 'anti-detect-browser'

// See your managed proxies + quota
const { quota } = await listProxies({ key })
// { limit, usedThisMonth, remaining, holdCount, holdCap }

// Claim is free - does not touch monthly quota
const proxy = await claimManagedProxy({ key })

// Launching with proxyId meters one distinct proxy for the month
await ab.launch({ profile: 'acc-01', proxyId: proxy.id })

// Bring your own proxy - never metered
await ab.launch({
  proxy: 'socks5://user:pass@us-proxy.example.com:1080',
  profile: 'us-account',
})

Учётные данные в этом URL обрабатывает движок - 407 для HTTP/HTTPS, RFC 1929 для SOCKS5 - без загрузки вспомогательного расширения. Оба SDK и приложение для ПК ведут себя здесь одинаково.

Из Python SDK

# Bring your own - never metered
launch(profile="us-account", proxy="socks5://user:pass@us-proxy.example.com:1080")

Получение и квота живут на эндпоинтах /api/v1/proxies выше; пакет Python запускается с уже удерживаемым прокси, а не оборачивает эти вызовы. См. справочник Python SDK →

Из приложения для ПК

На странице Proxies получите управляемый прокси (или добавьте свой), затем привяжите его к профилю в диалоге создания/редактирования. Запуск профиля учитывает прокси за месяц точно так же, как в SDK. См. обзор приложения для ПК →