НовинкаБезлимитные резидентные прокси: трафик без учёта объёма по фиксированной цене. От $33,25/день

Командная строка · Руководство по интеграции

Как использовать прокси в cURL

cURL — самый быстрый способ проверить прокси из терминала. Эти команды отправляют запросы через шлюз Proxonym, закрепляют IP, задают местоположение и расшифровывают ошибки шлюза.

  • 6 шагов
  • Настройка за 12 мин
  • Готовый код для копирования

Перед началом работы

  • cURL — входит в состав macOS, большинства дистрибутивов Linux, а также Windows 10 и новее
  • Тариф Proxonym на резидентные или мобильные прокси
  • Имя пользователя и пароль прокси из личного кабинета
Получить учётные данные прокси

Уже наш клиент? Имя пользователя и пароль — в личном кабинете.

  1. Проверьте версию cURL

    Любая свежая сборка поддерживает HTTP- и SOCKS5-прокси. В Windows PowerShell 5.1 вводите curl.exe вместо curl, потому что там curl сам по себе — это псевдоним Invoke-WebRequest.

    Shell
    curl --version
  2. Отправьте запрос через шлюз

    Укажите шлюз через -x, а учётные данные — через -U. Ответ api.ipify.org — это выходной IP, который видит целевой сайт; он не должен совпадать с вашим собственным адресом.

    Shell
    curl -x http://gw.proxonym.com:8000 -U "USERNAME:PASSWORD" https://api.ipify.org
  3. Укажите страну, штат, город или ASN

    Добавляйте параметры к имени пользователя через дефис: коды стран ISO строчными буквами, подчёркивания вместо пробелов в названиях мест и либо штат, либо город, но не оба сразу. Сервис ipinfo.io показывает, где находится выходной IP.

    Shell
    # Any IP in Germany
    curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-de:PASSWORD" https://ipinfo.io/json
    
    # New York City, United States
    curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-city-new_york:PASSWORD" https://ipinfo.io/json
    
    # The state of California
    curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-state-california:PASSWORD" https://ipinfo.io/json
    
    # The Comcast network (ASN 7922)
    curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-asn-7922:PASSWORD" https://ipinfo.io/json
  4. Меняйте IP или сохраняйте один и тот же

    Без параметра сессии каждое новое подключение получает новый IP, а каждый запуск cURL открывает новое подключение. Добавьте -session- с ID длиной от 1 до 32 букв и цифр, чтобы сохранить один IP, и -lifetime-, чтобы удерживать его от 1 до 120 минут (по умолчанию 10).

    Shell
    # Rotating: a new IP on every run
    for i in 1 2 3; do
      curl -s -x http://gw.proxonym.com:8000 -U "USERNAME-country-us:PASSWORD" https://api.ipify.org; echo
    done
    
    # Sticky: the same IP for up to 30 minutes
    for i in 1 2 3; do
      curl -s -x http://gw.proxonym.com:8000 -U "USERNAME-country-us-session-a7k2-lifetime-30:PASSWORD" https://api.ipify.org; echo
    done
  5. Перейдите на SOCKS5

    Используйте порт 1080 со схемой socks5h://. Буква h в конце указывает cURL, что имена хостов должен разрешать прокси, поэтому DNS-запросы не уходят с вашего компьютера. Параметры в имени пользователя работают точно так же, как с HTTP.

    Shell
    curl -x socks5h://gw.proxonym.com:1080 -U "USERNAME-country-gb:PASSWORD" https://api.ipify.org
  6. Разбирайте ошибки шлюза и повторяйте запросы

    Для HTTPS-сайтов на запрос CONNECT отвечает шлюз, поэтому выводите %{http_connect}, чтобы видеть его статус рядом со статусом целевого сайта. 407 означает неверные учётные данные, 402 — пустой баланс или истёкший тариф, 403 — заблокированный целевой сайт; при 429, 502 и 504 запрос стоит повторить (для --retry-all-errors нужен cURL 7.71 или новее).

    Shell
    # Show the gateway status and the target status side by side
    curl -s -o /dev/null -w "gateway=%{http_connect} target=%{http_code}\n" \
      -x http://gw.proxonym.com:8000 -U "USERNAME:PASSWORD" https://example.com
    
    # Retry transient failures up to 3 times
    curl --retry 3 --retry-all-errors --max-time 70 \
      -x http://gw.proxonym.com:8000 -U "USERNAME:PASSWORD" https://example.com

Часто задаваемые вопросы

Почему cURL получает от шлюза ошибку 407?

Шлюз не принял учётные данные. Заново скопируйте имя пользователя и пароль из личного кабинета, проверьте, что параметры соединены дефисами (USERNAME-country-us), и заключите значение -U в кавычки, чтобы оболочка не трогала спецсимволы. Если запустить ту же команду с -v, вы увидите запрос CONNECT и точный статус, который вернул шлюз.

Что выбрать для cURL: HTTP или SOCKS5?

Оба протокола дают доступ к одному и тому же пулу IP и принимают одинаковые параметры в имени пользователя. HTTP на порту 8000 туннелирует HTTPS через CONNECT и работает почти с любым инструментом. SOCKS5 на порту 1080 подходит для клиентов, работающих не по HTTP, а со схемой socks5h:// оставляет разрешение DNS на стороне прокси. Для обычных веб-запросов HTTP — более простой вариант по умолчанию.

Как получать новый IP при каждом запросе cURL?

Не добавляйте параметр сессии в имя пользователя. Шлюз выдаёт новый IP каждому новому подключению, а каждый запуск cURL открывает новое подключение. Если одна команда загружает несколько URL с одного хоста, cURL может повторно использовать подключение, а значит, и IP, поэтому, когда каждому запросу нужен новый адрес, запускайте по одной команде на запрос.

Как проверить местоположение выходного IP?

Отправьте через прокси запрос к сервису геолокации, например https://ipinfo.io/json. Он вернёт IP вместе с городом, регионом, страной и сетью, которые, скорее всего, увидят сайты. Базы геолокации иногда расходятся, поэтому сначала проверяйте точность на уровне страны или штата и сравните результаты нескольких проверок, прежде чем сообщать о несоответствии.

Другие руководства по интеграции

Все интеграции

Готовы подключить прокси? Получите учётные данные

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

  • Оплата по мере использования
  • Мгновенная активация
  • Принимаем криптовалюту
  • Без автопродления