Перейти к основному содержанию
Управление сессиями позволяет вам контролировать жизненный цикл IP-адреса вашего прокси. По умолчанию каждый ваш запрос получает новый случайный IP-адрес из нашего пула (ротация на каждый запрос). Однако для многих задач необходимо сохранять один и тот же IP-адрес в течение нескольких запросов. Это называется “закреплённой сессией” (sticky session). Вы управляете этим поведением, добавляя параметры сессии к имени пользователя вашего прокси.

​
Типы сессий

Ротация IP (по умолчанию)

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

Фиксированный IP (закреплённая сессия)

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

​
Параметры управления сессией

Эти параметры работают вместе, чтобы дать вам полный контроль над закреплёнными сессиями.

​
Идентификатор сессии (-session)

Это основной параметр для включения закреплённой сессии.
  • Формат: -session-[id]
  • Значение: любая буквенно-цифровая строка по вашему выбору. Эта строка является вашим уникальным идентификатором для сессии.
  • Зависимости: нет. Обратите внимание на обратную зависимость: параметры -time, -const и параметры таргетинга, которые вы передаёте, привязываются к ID сессии в момент её начала (см. предупреждение ниже).
  • Как это работает: все запросы, отправленные с одним и тем же идентификатором сессии, будут направляться через один и тот же выходной IP на протяжении всей сессии. Чтобы получить новый IP или новую конфигурацию, измените ID сессии.
  • Примеры имени пользователя:
    • ...-my_scraper-session-user123 (получает IP A)
    • ...-my_scraper-session-user123 (по-прежнему получает IP A)
    • ...-my_scraper-session-user456 (получает новый IP, IP B)
Таргетинг фиксируется в момент начала сессии.ID сессии закрепляет не только IP - он закрепляет всю конфигурацию, с которой был использован в первый раз. Если вы измените -country, -state, -city, -zip, -asn или любой другой параметр таргетинга, но оставите прежнее значение -session, запросы будут по-прежнему идти из исходной локации, пока сессия не истечёт.Правило: новый таргетинг - новый ID сессии. Генерируйте новый ID сессии каждый раз, когда меняется таргетинг.

​
Время сессии (-time)

По умолчанию закреплённая сессия длится 10 минут. Параметр -time позволяет вам изменить эту продолжительность.
  • Формат: -time-[минуты]
  • Значение: целое число.
  • Зависимости: должен использоваться вместе с параметром -session.
  • Пример имени пользователя: ...-my_scraper-session-user123-time-30
  • Результат: закреплённая сессия для user123 будет длиться 30 минут вместо 10 по умолчанию.
  • Случай ошибки: использование -time-30 без -session приведёт к ошибке.
Важное замечание о надёжности сессии: Продолжительность сессии - это запрос, а не 100% гарантия. Из-за динамичной природы резидентных сетей устройство-узел может отключиться в любой момент. Если IP-адрес вашей сессии станет недоступным, наша система автоматически назначит вам новый IP при следующем запросе с тем же идентификатором сессии.

​
Строгий режим (-const)

Этот параметр изменяет поведение шлюза, когда IP-адрес сессии становится недоступным.
  • Формат: -const (это флаг, он не имеет значения).
  • Зависимости: должен использоваться вместе с параметром -session.
  • Поведение по умолчанию (без -const): если IP-адрес вашей сессии становится недоступным, мы автоматически назначаем новый IP для вашей сессии. Это гарантирует, что ваш парсер продолжит работу.
  • Поведение с -const: если IP-адрес вашей сессии становится недоступным, мы не назначаем замену. Вместо этого ваш запрос завершится с ошибкой 502 Bad Gateway и заголовком X-Catproxy-Error: Session IP is offline.
  • Пример использования: используйте этот вариант только в тех случаях, когда ваш рабочий процесс критически зависит от использования одного и того же IP от начала до конца, и вы предпочтете, чтобы процесс завершился ошибкой, а не продолжился с новым IP.
  • Пример имени пользователя: ...-my_scraper-session-user123-time-60-const

​
Принудительная смена IP (/change_ip)

Иногда нужен новый внешний IP, не дожидаясь окончания сессии и не меняя её идентификатор - чаще всего это нужно, когда профилем браузера управляют вручную.
  • Формат: HTTP-запрос на {схема}://{username}:{password}@proxy.catproxy.net:5555/change_ip, где {схема} совпадает с протоколом, выбранным для прокси (http или https).
  • Зависимости: имеет смысл только для имени пользователя с параметром -session. Прокси с ротацией и так меняет IP на каждом запросе.
  • Как это работает: запрос освобождает внешний IP, закреплённый за этим идентификатором сессии. Новый IP выдаётся на следующем запросе через прокси, а не в момент обращения к ссылке.
  • Что остаётся прежним: имя пользователя, пароль, идентификатор сессии и все параметры таргетинга. Новый IP берётся из того же таргетинга, что был задан.
  • Работает с -const: да. -const запрещает молчаливую автоматическую ротацию, а обращение к /change_ip - осознанное действие.
В антидетект-браузерах это поле называется IP change link в настройках прокси-профиля, а готовая ссылка показана в блоке «Проверить и подключиться» на вкладке «Интеграция». Полное руководство - в разделе Антидетект-браузеры.

​
Какой тип сессии использовать?

Выберите лучший тип сессии для вашей конкретной задачи. Все параметры можно комбинировать с любым допустимым геотаргетингом.