Начало работы · Таргетинг и сессии
Все требования к выходному узлу указываются в логине.
Страна, штат США, город, провайдер, идентификатор и срок действия сессии. Шесть параметров в любом порядке на обоих общих шлюзах.
Синтаксис#
Начните с логина, затем добавьте пары -key-value. Ключи и значения записываются в нижнем регистре; порядок не имеет значения; пароль остаётся прежним. Если параметры не указаны, выходной узел выбирается в любой стране и меняется при каждом подключении.
USER-cc-us-state-tx-city-austin-sid-a1b2c3-ttl-30m:PASS
│ │ │ │ │ │
│ │ │ │ │ └─ закрепить на 30 минут
│ │ │ │ └─ идентификатор сессии: тот же ID — тот же IP
│ │ │ └─ город (только буквы и цифры)
│ │ └─ штат США (только для Соединённых Штатов)
│ └─ страна, код ISO 3166-1 alpha-2
└─ ваш логинПараметры#
| Параметр | Значения | Назначение |
|---|---|---|
| -cc- | Двухбуквенный код страны: us, de, br, jp | Выходной узел в этой стране. Резидентские прокси доступны в 199 странах; мобильный пул охватывает страны, перечисленные при оформлении заказа. |
| -state- | Код штата США: tx, ca, ny | Выходной узел в этом штате. Требует -cc-us; недоступен для других стран. |
| -city- | Название города в нижнем регистре, только буквы и цифры: newyork, berlin, saopaulo | Выходной узел в этом городе. Требует -cc-. На странице каждой страны перечислены доступные города с точными значениями. |
| -asn- | Номер автономной системы без префикса AS: 7922, 3320 | Выходной узел, анонсируемый этим провайдером. Сочетайте с -cc-. В мобильном пуле так выбирается оператор. |
| -sid- | Буквы и цифры, до 32 символов: a1b2c3, job42 | Закреплённая сессия. Запросы с одним ID используют один выходной узел, пока не истечёт срок действия или устройство не отключится. Новый ID означает новый IP. |
| -ttl- | Минуты или часы, от 1m до 24h: 10m, 2h | Срок действия закреплённой сессии, отсчитываемый от её первого запроса. По умолчанию — 10m, если указан -sid- без -ttl-. |
Ротация и сессии#
Без -sid- шлюз выбирает новый выходной узел для каждого нового подключения, которое получает. Клиенты, сохраняющие соединение или отправляющие много запросов через один туннель CONNECT, используют один выходной узел, пока существует это соединение. Чтобы менять узел при каждом запросе, отключите keep-alive или закрывайте соединение после каждого вызова; чтобы сохранять один IP между подключениями, используйте ID сессии.
- Одинаковое значение
-sid-означает один IP при любом количестве параллельных подключений. Запускайте столько одновременных сессий, сколько нужно: ограничений нет. - Когда срок действия истекает или домашняя сеть отключается, следующий запрос с этим ID получает новый IP, который по-прежнему соответствует остальным параметрам. Учитывайте это при проектировании: IP может измениться посреди процесса в любой резидентской сети.
- Чтобы немедленно сменить IP, измените ID. Идентификаторы действуют в пределах вашего аккаунта и ничего не стоят.
- Закреплённые сессии доступны в резидентском и мобильном пулах. Выделенные ISP-прокси, серверные прокси и прокси мобильных устройств имеют один фиксированный IP и игнорируют
-sid-и-ttl-.
Примеры#
| Что вам нужно | Логин |
|---|---|
| Новый IP в любой стране при каждом подключении | USER |
| Новый IP в США при каждом подключении | USER-cc-us |
| Домохозяйство в Техасе | USER-cc-us-state-tx |
| Любой IP в Берлине | USER-cc-de-city-berlin |
| Один IP в Берлине, закреплённый на десять минут | USER-cc-de-city-berlin-sid-7f3a9 |
| Один IP в Японии, закреплённый на два часа | USER-cc-jp-sid-tokyo1-ttl-2h |
| Абонент Comcast (AS7922) | USER-cc-us-asn-7922 |
| IP из мобильной сети Deutsche Telekom, закреплённый на 15 минут | USER-cc-de-asn-3320-sid-m1-ttl-15m |
| Двадцать параллельных сессий в Бразилии | USER-cc-br-sid-w01 … USER-cc-br-sid-w20 |
Названия городов#
Значение города — это его название в нижнем регистре ASCII без пробелов, дефисов, апострофов и диакритических знаков: New York превращается в newyork, São Paulo — в saopaulo, Düsseldorf — в dusseldorf, а Frankfurt am Main указан как frankfurt. Не пытайтесь угадать значение, а используйте указанное на странице страны: именно с этой строкой выполняет сопоставление шлюз.
Что происходит, если параметр невозможно применить#
| Случай | Ответ | Что делать |
|---|---|---|
Неизвестный ключ или неверно сформированное значение (-country-us, -ttl-90x) | 400 Bad Request | Исправьте строку; в теле ответа указан параметр. |
-city- или -state- без -cc- либо -state- за пределами США | 400 Bad Request | Добавьте -cc-us или удалите параметр. |
| Сейчас нет доступного выходного узла для сочетания параметров (например, небольшой город и один ASN) | 502 Bad Gateway | Повторите запрос, затем расширьте выбор: удалите -asn-, а после него — -city-. |
| Параметры переданы выделенному адресу | Игнорируются | Ничего; IP фиксирован. |