Формат строки прокси

Вход только по логину и паролю: привязки по IP (белого списка адресов) нет. Пароль один для всех ваших строк, а логин меняется вместе с настройками. UDP не поддерживается, в том числе через SOCKS5.

Чем HTTP отличается от SOCKS5 и какой протокол выбрать, разобрано в статье «HTTP или SOCKS5: какой протокол прокси выбрать».

Параметры в квадратных скобках необязательны, вертикальная черта означает «одно из двух». Каждый параметр отделяется дефисом:

Страна обязательна. Регион и город уточняют локацию, их можно указать вместе или по отдельности: строка с country-us-city-miami тоже допустима.

Дальше выбирается что-то одно: провайдер (isp) или ZIP-код (zip). В генераторе за это отвечает переключатель «Таргетинг»: «Провайдер (ISP)» или «ZIP-код». У мобильных прокси в поле провайдера выбирается оператор связи.

Если задан ZIP-код, регион и город в строку не попадают: локацию определяет индекс. В генераторе они только сужают список ZIP-кодов.

Строка с параметром sid — это липкая сессия. Пока вы подключаетесь с этой строкой без изменений, сервис сохраняет один выходной IP максимально долго, до разрыва соединения со стороны провайдера. Настройки длительности нет, и конкретный срок мы не обещаем, поэтому проверяйте IP после переподключения.

Каждая строка из одной генерации получает свой sid, то есть это отдельные сессии. Нужен другой адрес — возьмите другую строку или нажмите «Перегенерировать». Значение sid состоит только из строчных латинских букв и цифр, без дефисов; генератор создаёт его из 10 символов. Если вы собираете строки сами, для новой сессии подставьте новое значение.

Строка без sid работает в режиме ротации: каждое новое соединение может получить новый IP. Запросы внутри одного открытого соединения (keep-alive) могут выходить с одного адреса.

Когда какой режим выбирать, разобрано в статье «Sticky-сессия или ротация IP».

Мобильная строка отличается от резидентской только параметром type-mobile. Оба типа расходуют один баланс трафика. Параметр ipv4-true соответствует переключателю «Только IPv4».

Фильтр соответствует блоку «Оптимизация пула» в генераторе и всегда стоит в конце логина:

Любой фильтр сужает пул доступных адресов. Без параметра фильтра строка использует весь пул без отбора, но кабинет и бот таких строк не выдают. Шлюз понимает и более строгий фильтр качества filter-high (вместе со скоростью — filter-high-speed-fast), которого нет в генераторе.

Откройте раздел «Создать прокси» в личном кабинете, выберите страну, регион, город, провайдера или ZIP-код и сгенерируйте строку: коды появятся в логине. Списки регионов, городов, провайдеров и ZIP-кодов зависят от типа прокси и режима «Только IPv4», поэтому код, доступный для резидентских прокси, может отсутствовать у мобильных.

Коды стран, регионов и городов есть и в строках из Telegram-бота @proxetabot: найдите страну или город через поиск. Бот выдаёт только липкие сессии с фильтром «Качество», без выбора провайдера и ZIP-кода.

Коды пишутся строчными латинскими буквами, а слова в них разделены подчёркиванием: los_angeles, t_mobile_usa. Если вы собираете строку сами, берите коды только из сгенерированных строк: при неизвестном коде, лишнем параметре или нарушенном порядке шлюз может отказать в авторизации или выдать IP не из той локации.

Кабинет выдаёт строки в формате host:port:login:password. Многим программам нужен URL: http://login:password@host:8080 для HTTP или socks5h://login:password@host:1080 для SOCKS5 (с socks5h имена сайтов разрешает прокси, а не ваше устройство). Например:

Если в пароле есть символы вроде @, : или /, закодируйте их для URL. Примеры для curl — в статье «curl через прокси», для Python и Playwright — в статье «Прокси в Python: requests, httpx и Playwright».

Параметры из этой статьи относятся только к резидентским и мобильным прокси. Данные ISP-прокси фиксированы: IP, порт, логин и пароль указаны в заказе во вкладке «Мои прокси». Страна выбирается при заказе, а регион, город, провайдер, ZIP-код и сессия не настраиваются.