-
Установите Requests
Установите Requests через pip. Дополнительная зависимость socks подтягивает PySocks, который нужен только для SOCKS5-эндпоинта.
Shell python -m pip install requests python -m pip install "requests[socks]" # only for SOCKS5 -
Отправьте запрос через шлюз
Укажите учётные данные в 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) -
Укажите страну, штат, город или 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")) -
Меняйте 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) -
Используйте 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) -
Повторяйте запросы при ошибках шлюза
Подключите политику повторных попыток для временных сбоев и перехватывайте
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, пока оно не закроется.
