Параметры прокси с оплатой за ГБ

Параметры выбора PPG-прокси — это суффиксы, добавляемые к логину прокси. Используйте «Настройка и экспорт» в личном кабинете, чтобы выбрать пул, хаб, протокол, локацию и сессию. О том, что считается оплачиваемым трафиком и как его сократить, см. Как считается трафик с оплатой за ГБ.

Область подключения#

Одни и те же данные для подключения PPG работают с каждым подходящим хабом и с HTTP или SOCKS5. Выбранный пул определяет маршрутизацию и цену. Гибкий токен выбирает пул через _pool-.... Фиксированный токен использует сохранённый пул, и этот суффикс ему не нужен; суффикс другого пула отклоняется.

UDP#

Пулы с пометкой UDP передают UDP через SOCKS5-эндпоинт. HTTP-прокси передают только TCP. API пулов с оплатой за ГБ сообщает это как udp. UDP может достигать любого порта назначения, кроме нескольких сервисов, которыми часто злоупотребляют, таких как SNMP, NetBIOS, SIP, SSDP и memcached.

Браузеры не могут использовать UDP через настройку прокси: поддержка SOCKS5 в Chrome передаёт только TCP, поэтому HTTP/3 переходит на HTTP/2, а WebRTC может обойти прокси. Чтобы дать браузеру или всему устройству UDP (HTTP/3, звонки по WebRTC), привяжите прокси к VPN-профилю. Пулы, которые передают UDP, перечислены на странице UDP-прокси.

Грамматика логина#

Добавьте к базовому логину прокси ноль или более сегментов, разделённых подчёркиванием:

<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles_sid-crawl-42_sttl-600

Используйте слаги из личного кабинета в нижнем регистре. Для выбора города нужны и country, и region. state — псевдоним region для совместимости; не указывайте оба. Псевдоним страны uk в нижнем регистре нормализуется в gb в этой грамматике логина, в отличие от API бесплатных прокси.

Примеры географии#

# country
<base-username>_pool-residential-kilo_country-us

# region inside a country
<base-username>_pool-residential-kilo_country-us_region-california

# city inside a region
<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles

Используйте варианты географии, показанные в личном кабинете для выбранного пула. Синтаксически допустимый слаг всё равно может быть недоступен в этом пуле.

Недопустимые или неоднозначные примеры:

<base-username>_city-los-angeles
<base-username>_region-california_city-los-angeles
<base-username>_country-us_region-california_state-california

Сессии с фиксированным IP#

sid запрашивает привязку сессии. После очистки ID сессии содержит буквы, цифры и дефисы и должен быть не короче 3 символов. Используются только первые 15 символов, поэтому делайте ID сессий уникальными в пределах первых 15 символов.

<base-username>_pool-residential-kilo_country-de_sid-cart-17_sttl-900

sttl задаёт запрашиваемое время жизни фиксированной сессии в секундах. Значения 1–86400 учитываются. Текущее поведение для совместимости приводит 0 и значения 86401–999999 к 600 секундам; семь и более цифр недопустимы. Указывайте явное допустимое значение и не полагайтесь на запасное поведение.

Лимит трафика и срок действия#

У каждого прокси с оплатой за ГБ могут быть свой лимит трафика и своя дата окончания. Оба параметра необязательны. С их помощью можно выдать клиенту, участнику команды или инструменту фиксированный объём трафика или фиксированное время.

• Личный кабинет. Добавьте или измените прокси на странице «Оплата за ГБ». Лимит трафика (ГБ) — лимит в гигабайтах; дробную часть пишите через точку или запятую (2.5 или 2,5). Действует до — дата; прокси перестаёт работать в конце этого дня (UTC). В списке прокси блок «Статистика трафика» показывает, какая часть лимита учтена; она может немного опережать фактически переданный трафик.
• API. Передайте expiresAt и allowanceBytes при создании или изменении прокси. Оба поля возвращаются у каждого токена.

Лимит учитывает весь трафик между вашим клиентом и хабом в обоих направлениях, включая служебные данные протокола, поэтому он никогда не меньше оплачиваемого вами трафика. Прокси может остановиться немного не дойдя до лимита, но никогда не превышает его. Лимит только отклоняет трафик; сумма списания не меняется. Подробности см. в разделе Лимит трафика.

Прокси, израсходовавший весь лимит, получает отказ с ошибкой прокси 24. Добавление, изменение или снятие лимита один раз завершает открытые соединения прокси, и клиенты переподключаются уже с новым лимитом.

Адреса прокси#

Настройки > Адреса прокси содержит один флажок — Использовать нейтральные адреса. По умолчанию он выключен. Когда он включён:

• списки прокси, генератор прокси и API показывают нейтральные имена хостов и нейтральные имена пулов;
• ссылки для смены IP используют нейтральный адрес;
• строки HTTPS-прокси сохраняют litport.net, потому что сертификат HTTPS выдан на это имя.

Параметр меняет имена, которые мы показываем для вашего аккаунта. Он не меняет IP-адреса прокси, профили VPN, письма и собственный адрес личного кабинета. Если нейтральное имя совпадает со стандартным, для этого имени ничего не меняется.

Ошибки и повторы#

Сбои выбора PPG обычно возвращаются как код ошибки HTTP-прокси 11 с конкретным сообщением. Сбой учёта трафика — код 12. Недостаток средств на балансе — код 13 с HTTP 402; в этом случае нужно проверить или пополнить баланс, а не повторять сетевой запрос. Прокси, исчерпавший свой лимит трафика, получает код 24 с HTTP 403; код 25 с HTTP 503 означает, что лимит не удалось прочитать вовремя, и короткий повтор допустим.

Наблюдаемые HTTP-заголовки и ограничения SOCKS5 описаны в справочнике ошибок прокси. О сбоях PPG-апстрима см. рекомендации по коду 16.