Skip to main content
У каждого созданного прокси есть страница настроек с тремя вкладками: Обзор, Настройки и Интеграция. Это руководство - про вкладку Интеграция, где ваш прокси превращается в готовую строку подключения или рабочий фрагмент кода. Если вы никогда раньше не работали с прокси, внимательно прочитайте страницу. Знать заранее, что такое «ASN» или «закреплённая сессия», не нужно - всё объясняется по ходу.

Вкладка «Интеграция» на странице настроек прокси.


Зачем нужна эта вкладка

Чтобы работать через прокси, вашей программе нужны четыре вещи: Хост, порт и пароль не меняются. А вот имя пользователя - самое интересное, потому что в Catproxy это не просто идентификатор, а инструкция для запроса. Всё, чем вы хотите управлять - из какой страны будет IP, останется ли он тем же между запросами, как надолго, - записывается в имя пользователя цепочкой параметров:
Именно это делает Catproxy гибким: один и тот же прокси может отправлять трафик через Германию, потом через Японию, потом через фиксированный нью-йоркский IP - одновременно, из одной программы, просто за счёт разных строк имени пользователя. Обратная сторона - у строки есть правила. Параметры идут в определённом порядке, названия городов пишутся строчными буквами без пробелов, почтовый индекс нельзя сочетать с городом и так далее. Одна опечатка - и вы получите либо ошибку, либо, что хуже, трафик молча уйдёт не туда.
Вкладка «Интеграция» пишет эту строку за вас. Вы выбираете значения в нескольких списках, а она выдаёт корректное имя пользователя и полностью готовый фрагмент кода для вашего языка. Синтаксис запоминать не нужно.

Главное, что все понимают неправильно

Стоит отдельно проговорить чем отличаются настройки прокси ресурса от интеграции.

Вкладка «Настройки» = сохраняется

То, что вы задаёте на вкладке Настройки (местоположение по умолчанию, лимиты трафика), сохраняется в самом прокси. Это применяется ко всем запросам - всегда, пока вы не измените настройку.

Вкладка «Интеграция» = не сохраняется

То, что вы выбираете на вкладке Интеграция, нигде не сохраняется. Она лишь собирает текстовую строку, которую вы копируете. Закрыли страницу - выбор пропал.
Считайте вкладку «Интеграция» калькулятором, а не формой. Калькулятор не «запоминает», что вы ввели 2 + 2, - он просто выдаёт 4. Точно так же вкладка выдаёт имя пользователя и забывает о нём. Почему это удобно: из одного прокси можно получить сколько угодно разных конфигураций. Десять стран, пятьдесят сессий - всё работает одновременно, дополнительные прокси не нужны, переключать и сохранять нечего.
На вкладке «Интеграция» нет кнопки «Сохранить», и это сделано намеренно. Если нужно изменить поведение самого прокси по умолчанию, используйте вкладку Настройки.

Что вы видите, когда открываете вкладку

Вкладка состоит из трёх карточек, идущих сверху вниз.
1

Конфигурация - здесь вы делаете выбор

Протокол, местоположение, поведение сессии и готовые шаблоны в один клик.
2

Проверить и подключиться - здесь появляется результат

Готовый фрагмент кода на cURL, Python, Node.js или Go, который обновляется сразу же, как только вы что-то меняете выше.
3

Сгенерировать список - массовая выгрузка

Создаёт сразу много строк подключения, каждую со своей сессией (если тип сессии с фиксированным IP) - для инструментов, которым нужен файл со списком прокси.
При первом открытии вкладки поля уже заполнены местоположением по умолчанию вашего прокси (тем самым, что задано на вкладке «Настройки»), протоколом HTTPS и типом сессии «С ротацией IP». Ни один готовый шаблон не подсвечен. Так и задумано: вы видите ровно ту конфигурацию, которую получите, если вообще ничего не менять.

Пошаговый пример: ваша первая строка подключения

Разберём реальную задачу от начала до конца. Цель: собрать цены в немецком интернет-магазине, с немецкого IP-адреса, на Python.
1

Откройте вкладку «Интеграция»

Перейдите в раздел Мои прокси, откройте нужный прокси и нажмите вкладку Интеграция.

«Интеграция» - третья вкладка на странице настроек прокси.

2

Выберите протокол

В блоке Протокол три варианта: HTTP, HTTPS, SOCKS5.Если вы не знаете, что выбрать, - берите HTTPS. Он шифрует соединение между вашим компьютером и нашим шлюзом, поэтому никто в вашей сети не прочитает пароль от прокси.
  • HTTPS - безопасный вариант по умолчанию. Подходит почти для всего.
  • HTTP - то же самое, но соединение со шлюзом не шифруется. Выбирайте, только если этого прямо требует ваш инструмент.
  • SOCKS5 - другой, более низкоуровневый протокол. Нужен некоторым десктопным приложениям, игровым клиентам и антидетект-браузерам.
Выбор HTTPS здесь не мешает заходить на сайты по http://. Эта настройка касается только канала между вашей программой и нашим шлюзом.
3

Укажите, где должен находиться IP

В блоке Режим таргетинга оставьте выбранным вариант по умолчанию - Местоположение. (Второй вариант, ASN, - для продвинутых сценариев, о нём ниже.)Ниже расположены четыре списка: Страна, Регион / штат, Город, Почтовый индекс.Для нашего примера откройте Страна и выберите Германия. Остальные поля оставьте пустыми.Правила, которые интерфейс соблюдает за вас:
  • Регион, город и почтовый индекс нельзя выбрать, пока не выбрана страна.
  • Выбор региона или города блокирует почтовый индекс, и наоборот. Эти два способа сузить местоположение несовместимы.
  • Любое пустое поле означает «где угодно»: пустой город - любой город Германии.

Выбрана Германия. Регион, город и почтовый индекс остаются пустыми.

4

Определите, как будет вести себя IP

В блоке Управление сессиями список Тип сессии содержит два значения:
  • С ротацией IP - на каждый запрос вы получаете новый IP. Лучший вариант для сбора большого числа страниц: сайт видит толпу разных посетителей, а не одного настойчивого.
  • С фиксированным IP - вы какое-то время работаете с одним и тем же IP. Нужна, когда шаги зависят друг от друга: войти в аккаунт, добавить товар в корзину, оформить заказ. При ротации сайт увидел бы на каждом шаге нового посетителя и разлогинил бы вас.
Для сбора цен оставляем С ротацией IP. Соседние поля - Время сессии (мин) и переключатель Фиксировать IP в блоке Строгий режим - остаются неактивными: они имеют смысл только для закреплённых сессий.

Управление сессиями с выбранной ротацией IP - поля для закреплённых сессий недоступны.

5

Скопируйте результат

Прокрутите страницу до карточки Проверить и подключиться. В ней уже лежит готовый фрагмент кода, собранный из ваших настроек.Списком в правом верхнем углу карточки переключите язык: cURL, Python, Node.js, Go. Выберите Python и нажмите кнопку копирования в углу блока кода.Теперь у вас есть рабочий код:
Обратите внимание на -country-de, появившийся в имени пользователя. В этом и весь смысл вкладки: вы выбрали «Германия» в списке, а параметр она написала сама.

Карточка «Проверить и подключиться». Фрагмент кода пересобирается при каждом изменении настроек выше.

6

Запустите код

Вставьте фрагмент в свой проект и запустите. Он обращается к https://api.ipify.org - бесплатному сервису, который просто сообщает, какой IP он видит.Если в ответе немецкий IP - всё работает. Это самый быстрый способ убедиться в правильности настроек, прежде чем направлять код на реальную цель.

Готовые шаблоны

В правом верхнем углу карточки «Конфигурация» расположены четыре кнопки: Электронная коммерция, Парсинг сайтов, SMM и аккаунты, Локальное SEO. Каждая одним нажатием заполняет все поля комбинацией, подходящей для соответствующей задачи. Они нужны, чтобы показать, как выглядит осмысленная конфигурация: если сомневаетесь, нажмите ближайший по смыслу шаблон и доработайте его под себя. Нажатие на шаблон перезаписывает всё, что вы выбрали ранее, включая страну. Как только вы измените любое поле после этого, подсветка шаблона снимется - потому что конфигурация уже не соответствует шаблону.

Готовые шаблоны. Активный шаблон подсвечен; правка любого поля снимает подсветку.


Подробнее о закреплённых сессиях

Переключите Тип сессии на С фиксированным IP - и произойдут три вещи. 1. Сгенерируется идентификатор сессии. Короткий случайный код вроде a1b2c3 добавится в имя пользователя как -session-a1b2c3. Этот код и есть сессия: все запросы с одним и тем же кодом идут через один и тот же IP. Смените код - получите другой IP. Ваша программа может создавать сколько угодно кодов: по одному на аккаунт, на профиль браузера, на задачу. 2. Станет доступно поле «Время сессии (мин)». Это то, сколько минут IP остаётся закреплённым за вами. В имени пользователя оно выглядит как -time-30. 3. Станет доступен переключатель «Фиксировать IP». Это и есть строгий режим, и его стоит объяснить отдельно. Наши IP-адреса принадлежат реальным домашним и мобильным устройствам, а реальное устройство может отключиться в любой момент: кто-то закрыл ноутбук, кто-то вышел из зоны Wi-Fi. Если это произошло с вашей сессией:
  • «Фиксировать IP» выключен (по умолчанию) - мы незаметно выдаём замену, и ваша программа продолжает работать.
  • «Фиксировать IP» включён - замену мы не выдаём. Вместо этого запрос завершится ошибкой.
Включайте его только тогда, когда смена IP хуже, чем сбой, - например, при работе с чувствительным аккаунтом, где внезапная смена IP вызовет срабатывание защиты. Для обычного сбора данных оставляйте выключенным.

Таргетинг по сети вместо местоположения

Второй вариант в блоке Режим таргетинга заменяет списки местоположения выбором сети. Используйте его, когда важно не где находится IP, а какому провайдеру он принадлежит.
  • Резидентные прокси - ASN. Укажите номер автономной системы, то есть идентификатор сети интернет-провайдера (например, 7922 для Comcast). Вы получите IP внутри сети этого провайдера.
  • Мобильные прокси - провайдер. Выберите мобильного оператора из списка, например T-Mobile или Vodafone. Вы получите IP в сети этого оператора.
Сетевой и географический таргетинг несовместимы. Выбор ASN или провайдера полностью убирает из имени пользователя параметры страны, региона, города и почтового индекса. Именно поэтому переключение режима таргетинга прячет поля местоположения, а не просто блокирует их.
Если у вас нет конкретной причины целиться в провайдера, оставайтесь в режиме Местоположение.

Генерация списка прокси

Некоторым инструментам - антидетект-браузерам, менеджерам мультиаккаунтов, фреймворкам для парсинга - нужен не один прокси, а файл с десятками строк, по прокси в строке. Этим занимается карточка Сгенерировать список внизу вкладки:
  1. Задайте Количество - сколько строк вам нужно.
  2. Выберите Формат - раскладку, которую ждёт принимающий инструмент: host:port:user:pass, user:pass@host:port или host,port,user,pass.
  3. Нажмите Сгенерировать.
  4. Заберите содержимое поля Результат: кнопкой Копировать всё или файлом - Скачать .txt либо Скачать .csv.
Каждая строка использует собранную выше конфигурацию, но с собственным уникальным идентификатором сессии. То есть список из 50 строк даёт 50 независимых закреплённых сессий - ровно то, что нужно, когда вы запускаете 50 профилей браузера, которые не должны делить один IP.

«Сгенерировать список» выдаёт учётные данные пачкой, и в каждой строке свой идентификатор сессии.


Частые вопросы

Нет. Сохранять нечего. Вкладка производит только текст. Значение имеет строка, которую вы скопировали: как только она оказалась в вашем коде, вкладка свою работу выполнила.
Нет. Соберите её заново в несколько кликов - или, что удобнее, храните скопированную строку подключения в своём проекте. Если конфигурация нужна постоянно, задайте её как значение по умолчанию на вкладке Настройки.
Да, и в этом главное преимущество такой схемы. Один прокси - много имён пользователя. Ничего не блокируется, ничего не конфликтует, и доплачивать не нужно: тарифицируется израсходованный трафик, а не количество созданных конфигураций.
Потому что вы выбрали регион или город. Почтовый индекс и регион/город - два конкурирующих способа сузить местоположение, вместе они не работают. Очистите поля «Регион / штат» и «Город», и почтовый индекс снова станет доступен.
Потому что в нём ваш собственный идентификатор клиента и имя вашего прокси. Часть с параметрами после них подчиняется ровно тем же правилам, которые описаны в разделах Параметры геотаргетинга и Параметры управления сессией.
Да. Вкладка - это удобство, а не обязательное условие: всё, что она генерирует, вы можете написать сами, и корректно написанная строка будет работать. Справочник по параметрам - в разделе Параметры геотаргетинга. Конструктором пользуются просто потому, что он исключает опечатки.
Сначала запустите фрагмент без изменений - он обращается к https://api.ipify.org. Это покажет, в чём дело: в прокси или в целевом сайте. Если ошибка сохраняется, посмотрите раздел Коды ошибок и убедитесь, что баланс аккаунта положительный.

Что почитать дальше

Параметры геотаргетинга

Полный справочник по всем параметрам местоположения, которые умеет собирать конструктор.

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

Как ротация и закреплённые сессии устроены изнутри.

Протоколы

Подробное сравнение HTTP, HTTPS и SOCKS5.

Аутентификация

Как работает авторизация по логину с паролем и по списку разрешённых IP.