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

Направляйте браузеры через резидентные 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)
FREE00
BASIC24
PRO510
TEAM1020
ENTERPRISE10002000

Получение

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

Заберите доступный управляемый прокси. Он закрепляется за вами. Получение никогда не расходует месячную квоту - можно удерживать до 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.

Инструкции по провайдерам

Используете свой аккаунт? В каждой инструкции три шага, параметры шлюза и сессии в том виде, в каком их публикует провайдер, и ссылка на его собственную документацию.

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. См. обзор приложения для ПК →