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

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

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

Чтобы направить трафик через Proxonym, библиотеке Requests достаточно словаря proxies. В руководстве: аутентификация, таргетинг по местоположению, ротация и закрепление IP, SOCKS5 и повторные попытки при ошибках шлюза.

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

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

  • Python 3.10 или новее
  • Requests 2.x, а для SOCKS5 — дополнительная зависимость socks
  • Тариф Proxonym на резидентные или мобильные прокси
Получить учётные данные прокси

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

  1. Установите Requests

    Установите Requests через pip. Дополнительная зависимость socks подтягивает PySocks, который нужен только для SOCKS5-эндпоинта.

    Shell
    python -m pip install requests
    python -m pip install "requests[socks]"   # only for SOCKS5
  2. Отправьте запрос через шлюз

    Укажите учётные данные в URL прокси и используйте его для обоих ключей — http и https. HTTPS-сайты туннелируются через CONNECT, поэтому сам URL прокси сохраняет схему http://.

    Python
    import requests
    
    PROXY = "http://USERNAME:PASSWORD@gw.proxonym.com:8000"
    proxies = {"http": PROXY, "https": PROXY}
    
    response = requests.get("https://api.ipify.org", proxies=proxies, timeout=60)
    print("Exit IP:", response.text)
  3. Укажите страну, штат, город или ASN

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

    Python
    import requests
    
    
    def proxy_for(**params):
        """proxy_for(country="us", city="new_york", session="a7k2", lifetime=30)"""
        user = "USERNAME"
        for key in ("country", "state", "city", "asn", "session", "lifetime"):
            if key in params:
                user += f"-{key}-{params[key]}"
        url = f"http://{user}:PASSWORD@gw.proxonym.com:8000"
        return {"http": url, "https": url}
    
    
    for proxies in (
        proxy_for(country="us", city="new_york"),
        proxy_for(country="de", state="bavaria"),
        proxy_for(country="us", asn=7922),
    ):
        info = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=60).json()
        print(info["ip"], info.get("city"), info.get("country"))
  4. Меняйте IP или сохраняйте один и тот же

    Без параметра сессии каждое новое подключение получает новый IP, а requests.get() открывает новое подключение при каждом вызове. С помощью proxy_for() из предыдущего шага добавьте ID сессии длиной до 32 букв и цифр, чтобы сохранять один IP до 120 минут.

    Python
    import secrets
    
    import requests
    
    # Rotating: a new exit IP on every call
    for _ in range(3):
        print(requests.get("https://api.ipify.org", proxies=proxy_for(country="us"), timeout=60).text)
    
    # Sticky: the same exit IP for up to 30 minutes
    sticky = proxy_for(country="us", session=secrets.token_hex(4), lifetime=30)
    for _ in range(3):
        print(requests.get("https://api.ipify.org", proxies=sticky, timeout=60).text)
  5. Используйте SOCKS5-эндпоинт

    Когда PySocks установлен, направьте оба ключа на порт 1080. Схема socks5h:// разрешает имена хостов на стороне прокси, поэтому DNS-запросы не проходят через вашу собственную сеть.

    Python
    import requests
    
    PROXY = "socks5h://USERNAME-country-gb:PASSWORD@gw.proxonym.com:1080"
    proxies = {"http": PROXY, "https": PROXY}
    
    print(requests.get("https://api.ipify.org", proxies=proxies, timeout=60).text)
  6. Повторяйте запросы при ошибках шлюза

    Подключите политику повторных попыток для временных сбоев и перехватывайте ProxyError — это исключение Requests выбрасывает, когда шлюз отклоняет туннель. Повторные попытки не исправят 407, 402 или 403, поэтому сначала разберитесь с учётными данными, балансом или целевым сайтом.

    Python
    import requests
    from requests.adapters import HTTPAdapter
    from urllib3.util.retry import Retry
    
    retry = Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 504])
    session = requests.Session()
    session.mount("http://", HTTPAdapter(max_retries=retry))
    session.mount("https://", HTTPAdapter(max_retries=retry))
    
    PROXY = "http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000"
    proxies = {"http": PROXY, "https": PROXY}
    
    try:
        response = session.get("https://example.com", proxies=proxies, timeout=(10, 60))
        response.raise_for_status()
        print(response.status_code, len(response.text))
    except requests.exceptions.ProxyError as exc:
        # The message includes the gateway status, for example 407 or 502
        print("Gateway refused the tunnel:", exc)
    except requests.exceptions.RequestException as exc:
        print("Request failed:", exc)

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

Почему Requests выдаёт ошибку Tunnel connection failed: 407?

Шлюз отклонил учётные данные в вашем URL прокси. Заново скопируйте имя пользователя и пароль из личного кабинета, соединяйте параметры таргетинга дефисами и закодируйте спецсимволы в пароле для URL. Если один и тот же код работает на одной машине, но не на другой, поищите переменную окружения HTTPS_PROXY, которая переопределяет ваши настройки.

Поддерживает ли Requests SOCKS5-прокси?

Да, если установить дополнительную зависимость socks командой pip install "requests[socks]" — она добавляет PySocks. Используйте socks5h://USERNAME:PASSWORD@gw.proxonym.com:1080, чтобы имена хостов разрешались на стороне прокси. Параметры таргетинга и сессий работают так же, как на HTTP-эндпоинте, поэтому протокол можно сменить, не меняя имени пользователя.

Как отправлять много запросов параллельно?

Requests работает синхронно, поэтому запускайте вызовы в ThreadPoolExecutor или перейдите на асинхронный клиент, например httpx или aiohttp. Proxonym допускает неограниченное число параллельных сессий при ограничении всплесков около 10 000 запросов в секунду на аккаунт, так что на практике потолок обычно задаёт целевой сайт. Если воркеру нужен стабильный IP, дайте ему собственный ID сессии.

Можно ли использовать httpx или aiohttp вместо Requests?

Да. В httpx передайте proxy="http://USERNAME:PASSWORD@gw.proxonym.com:8000" при создании Client или AsyncClient. В aiohttp передайте тот же URL в аргументе proxy каждого запроса. Обе библиотеки используют пулы подключений, поэтому запросы, повторно использующие подключение, сохраняют один и тот же выходной IP, пока оно не закроется.

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

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

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