Токены, прокси-продукты и хабы
Litport разделяет купленные вами данные для подключения, сетевую точку, к которой вы подключаетесь, и апстрим-прокси, который выходит к целевому сайту.
Путь запроса#
client -> chosen Litport hub/ingress -> Litport routing -> selected upstream proxy -> target
Токен — это данные для подключения к прокси и единица продажи и учёта. Хаб — это входной ретранслятор Litport. Хаб — это не страна выхода, не регион, не город, не ASN и не пул прокси.
Безлимитные и PPG-токены#
| Продукт | Коммерческая модель | Параметры подключения |
|---|---|---|
| Безлимитный | Продаётся как пакет с периодом продления, безлимитным трафиком и необязательными разрешёнными IP. Старые предоплаченные токены (доступ до фиксированной даты окончания, без пакета) по-прежнему существуют. | Используйте назначенные ему хаб и протокол входа |
| Оплата за ГБ (PPG) | Доступ за счёт баланса; трафик считается как отправленный плюс полученный | Выберите пул для каждого экспорта данных для подключения или привяжите токен к одному пулу; выберите подходящий хаб и HTTP либо SOCKS5 |
Безлимитные токены работают только с назначенными им хабом и протоколом. Истёкший или отсутствующий пакет проявляется как одна из ошибок прокси с 17 по 22; ошибка 17 относится только к старому пакету с лимитом трафика. Состояние самого пакета можно прочитать через API пакетов. PPG-токены — это многоразовые данные для подключения: «Настройка и экспорт» выбирает подходящий хаб и протокол. Гибкие токены добавляют выбранный пул в логин; фиксированные токены всегда используют сохранённый пул. Сохранённые у PPG-токена хаб и протокол — это предпочтения экспорта, а не ограничения авторизации.
Вход в прокси#
Используйте эндпоинт, указанный для токена в личном кабинете. Текущие порты по умолчанию:
| Семейство хабов | HTTP | SOCKS5 |
|---|---|---|
| Мобильные и общие | 1337 |
5337 |
| Серверные и ISP | 31337 |
35337 |
Хаб может явно задавать собственный порт, и он имеет приоритет. Для конкретного токена определяющим является эндпоинт из личного кабинета.
Вход по HTTP принимает запросы прямого прокси и туннели CONNECT. Вход по SOCKS5 принимает поддерживаемые команды SOCKS5. Аутентификация и представление ошибок у них различаются; см. справочник ошибок прокси.
HTTP- и HTTPS-эндпоинт прокси#
Каждый HTTP-эндпоинт прокси также принимает https:// на том же хосте и порту. Меняется только схема URL:
| Схема | Пример |
|---|---|
| Без шифрования | http:// |
| TLS до прокси | https:// |
TLS действует между вашим клиентом и хабом. Он защищает ваши данные для подключения к прокси, имя целевого хоста из CONNECT и обычные HTTP-запросы на этом участке. Он не меняет то, что видит целевой сайт: целевой сайт по-прежнему видит выбранный выходной IP апстрима, а Litport по-прежнему маршрутизирует запрос.
| Плюсы | Минусы | |
|---|---|---|
| Вход по HTTPS | Данные для подключения и адреса назначения остаются закрытыми в недоверенных сетях; проходит через сети, которые блокируют обычный прокси-трафик | Ваш клиент должен доверять корневому сертификату Litport для участка до прокси; одно дополнительное TLS-рукопожатие на соединение; накладные расходы TLS на участке до прокси учитываются как трафик для запросов вне кеша; некоторым клиентам (например, Scrapy) нужен дополнительный обработчик |
Используйте эндпоинт с именем хоста, показанный в личном кабинете, а не IP-адрес. Хаб предъявляет сертификат, выданный корневым сертификатом кеша Litport, поэтому ваш клиент должен доверять этому корневому сертификату для соединения с прокси: установите его так, как описано на той странице, или передайте его как CA прокси (например, curl --proxy-cacert litport-cache-root.crt). Доверие к корневому сертификату не включает режим кеша; его включает только суффикс пароля _cache-. У SOCKS5 нет варианта с TLS. Модель угроз, причину, по которой curl -k не применяется к участку до прокси, и проверенные примеры для каждого клиента смотрите в разделе HTTPS-эндпоинт прокси.
curl --proxy-cacert litport-cache-root.crt -x https://USER:PASS@HUB:PORT https://example.com
Данные для подключения привязаны к назначению#
- Отправляйте логин и пароль прокси на эндпоинт прокси.
- Используйте ID токена только для того, чтобы указать токен после аутентификации в Litport API.
- Отправляйте API-ключ пользователя только на
https://litport.net/api/v1/...в заголовке Bearer.
Не используйте API-ключ пользователя в качестве пароля прокси.