Документация

Типы прокси

Если не уверены, какой тип нужен, начните с тестового пакета резидентных или мобильных прокси.

Строка доступа

Строка состоит из адреса шлюза, порта, логина и пароля. В кабинете доступны три формата: host:port:user:pass, user:pass@host:port и готовая команда curl.

gw.proxymaxy.zspzvs.ru:1337:USERNAME:PASSWORD

USERNAME:PASSWORD@gw.proxymaxy.zspzvs.ru:1337

curl -x http://USERNAME:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

Порт один для всех резидентных и мобильных прокси: 1337. Протокол HTTP или SOCKS5 выбирает ваш клиент, порт при этом не меняется.

Резидентные и мобильные прокси настраиваются через логин. Он собирается из частей: user-<ваш логин>-network-<тип>, затем по желанию -country-<код страны> и -sid-<метка>-ttl-<минуты>. Пароль остаётся прежним.

curl -x http://user-USERNAME-network-eco:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

curl -x http://user-USERNAME-network-eco-country-gb:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

curl -x http://user-USERNAME-network-eco-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

curl -x http://user-USERNAME-network-eco-country-us-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

У статических прокси вместо одной строки выдаётся список, по строке на каждый IP. Кнопка «Скопировать список» копирует все строки сразу, «Скачать всё» сохраняет их в файл .txt.

203.0.113.10:PORT:PORT:USERNAME:PASSWORD

У статических прокси порты приходят в выданном списке вместе с IP: там нет общего шлюза и порта 1337, подставляйте значения из своей строки.

Безлимит устроен проще: вам выдаётся один фиксированный набор данных для подключения. Выбора страны нет, а ротацию и сессии настраивать не нужно, поэтому суффиксы логина из таблицы выше к безлимиту не применяются.

Проверка подключения

Выполните команду в терминале, подставив логин и пароль из кабинета (USERNAME и PASSWORD) и адрес шлюза из своей строки доступа. В ответе должен быть IP прокси и его страна, а не ваш домашний адрес. Примеры ниже относятся к резидентным и мобильным прокси.

curl -x http://user-USERNAME-network-eco:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

curl -x socks5h://user-USERNAME-network-eco:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

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

Ротация и сессии

• Ротация: новый IP на каждое соединение. Подходит для парсинга и массовых запросов. Это режим по умолчанию.
• Липкая сессия: один IP держится до 24 часов. Нужна для входа в аккаунты, заполнения форм и других многошаговых действий.
• Статические: IP не меняется весь срок аренды.

Режим задаётся логином. В кабинете переключатель «Ротация / Липкая сессия» подставляет нужный суффикс сам: выберите время сессии (10 минут, 30 минут, 1, 4 или 24 часа), а кнопка «Новый IP» создаёт новую метку. В скриптах суффикс дописывают вручную: -sid-<метка>-ttl-<минуты>, время от 0 до 1440 минут (24 часа).

curl -x http://user-USERNAME-network-eco-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

Запросы с одной и той же меткой сессии идут через один IP, пока не истечёт время жизни. Новая метка даёт новый IP. Без метки каждый запрос получает новый IP. У безлимита и статических прокси этих режимов нет.

Выбор страны

• Резидентные и мобильные: страну можно сменить в кабинете в любой момент, логин в строке доступа обновится.
• Статические: страну выбирают при покупке. Доступны США, Германия, Великобритания, Франция, Италия, Польша, Канада, Австралия и Китай.
• Безлимит: выбора страны нет, выдаётся один фиксированный набор данных для подключения.

В скриптах страну задаёт суффикс логина: добавьте к нему -country- и двухбуквенный код страны строчными буквами. Без суффикса IP выдаётся из любой страны. Это относится к резидентным и мобильным прокси.

curl -x http://user-USERNAME-network-eco-country-gb:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

curl -x http://user-USERNAME-network-eco-country-us-sid-job1-ttl-30:PASSWORD@gw.proxymaxy.zspzvs.ru:1337 https://ipinfo.io

Код страны — ISO 3166-1 alpha-2: us, gb, de, fr и так далее. Список доступных стран показан в кабинете.

Безопасность

• Логин и пароль видны только в вашем кабинете. Не передавайте их третьим лицам и не публикуйте в репозиториях.
• Если доступ утёк, напишите в поддержку — мы выдадим новый.
• Хранить строку доступа лучше в переменных окружения или менеджере секретов, а не в коде.

Ошибки подключения

Если трафик закончился, прокси перестают отвечать. Остаток виден в кабинете, там же есть кнопка «Докупить трафик».