Управляемые прокси
Направляйте браузеры через резидентные IP - из наших управляемых прокси или подключите свои.
Управляемые резидентные прокси
Управляемые резидентные прокси приобретаются отдельно и включаются для аккаунта - напишите нам, чтобы их активировали. После активации возьмите один, привяжите к профилю и запускайте. Использование учитывается помесячно (см. ниже).
Свой прокси
Передайте любой URL protocol://user:pass@host:port в launch() - http, https или socks5. Собственные прокси никогда не учитываются в квоте.
Аутентификация происходит в движке
Прокси с логином/паролем обрабатываются самим движком браузера: HTTP- и HTTPS-запросы 407 обрабатываются внутри сетевого стека, а SOCKS5 - по RFC 1929, согласованием логина/пароля во время рукопожатия. Отсюда два следствия. В chrome://extensions ничего не загружается - вспомогательное расширение для авторизации прокси, которое до сих пор ставят большинство антидетект-браузеров, можно перечислить с любой страницы, и это именно тот демаскирующий признак, ради устранения которого создан продукт. А учётные данные доходят только до сетевого процесса и никогда - до рендерера, так что ни один скрипт страницы не может их прочитать.
Квоты тарифов
Каждый тариф допускает определённое число разных прокси, используемых в месяц (N). Одновременно можно удерживать до 2×N (получение/удержание всегда бесплатно).
Получение
Получить (бесплатно)
Заберите доступный управляемый прокси. Он закрепляется за вами. Получение никогда не расходует месячную квоту - можно удерживать до 2×N.
Освобождение
Верните удерживаемый управляемый прокси, освободив слот удержания.
Замена
Верните один прокси и получите новый одним действием.
Учёт и сброс
Учёт ведётся по активному использованию за месяц: удержание бесплатно, учитывается запуск.
Запуск профиля с управляемым прокси учитывает один отдельный прокси в текущем месяце.
Повторный запуск того же прокси в том же месяце бесплатен (обновляются только время последнего использования и счётчик запусков).
После использования N разных прокси за месяц активация нового вернёт 403 (месячная квота исчерпана).
Автосброс каждый месяц: учёт ведётся по календарному месяцу UTC (YYYY-MM). В начале месяца счётчик автоматически обнуляется - прокси, которые вы продолжаете использовать, засчитываются заново, а те, что перестали использоваться, просто освобождаются.
Получение, удержание и привязка не учитываются в квоте. Собственные прокси не учитываются никогда.
API
Все эндпоинты требуют Authorization: Bearer <api-key>.
/api/v1/proxiesСписок ваших назначенных прокси + месячная квота: limit, usedThisMonth, remaining, holdCount, holdCap.
/api/v1/proxiesУправляйте своими удержаниями через тело запроса с action:
{ action: 'claim' } - получить доступный управляемый прокси (бесплатно){ action: 'release', proxyId } - освободить удерживаемый управляемый прокси{ action: 'swap', proxyId } - заменить на новый
/api/v1/proxies/:id/activateУчёт + активация перед запуском. Идемпотентен в течение месяца для одной и той же пары (user, proxy). Возвращает 403, если месячный лимит превышен. SDK вызывает это автоматически, если вы передаёте proxyId.
Инструкции по провайдерам
Используете свой аккаунт? В каждой инструкции три шага, параметры шлюза и сессии в том виде, в каком их публикует провайдер, и ссылка на его собственную документацию.
Bright Data
brd.superproxy.io
Oxylabs
pr.oxylabs.io
Decodo
gate.decodo.com
RapidProxy
us.rapidproxy.io
Proxy Solutions
82.97.251.114
Froxy
fast.froxy.com
ProxyEmpire
v2.proxyempire.io
IPRoyal
geo.iproyal.com
Helodata
gate.helodata.io
Singapore Mobile Proxy
sg.veerlane.com
SocksNode
global.socksnode.com
GonzoProxy
connect.gonzoproxy.app
MangoProxy
p1.mangoproxy.com
Использование
Из 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. См. обзор приложения для ПК →