---
title: "Прокси в Python Requests: HTTP и SOCKS5 | Proxonym"
description: "Python Requests с прокси с ротацией: словарь proxies, аутентификация, таргетинг по стране и городу, sticky-сессии, SOCKS5 и повторы при ошибке 502."
url: https://proxonym.com/ru/integrations/python-requests
updated: 2026-10-02T03:03:46+00:00
---

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

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

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

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

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

Параметры подключения

- **Хост**: `gw.proxonym.com`
- **HTTP**: `8000`
- **SOCKS5**: `1080`
- **Пользователь**: `USERNAME-country-us`

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, пока оно не закроется.

Советы и подводные камни

- Если пароль содержит @, : или /, закодируйте его с помощью urllib.parse.quote(password, safe="") перед вставкой в URL прокси.
- requests.Session повторно использует подключения, поэтому вызовы к одному хосту сохраняют один выходной IP, пока это подключение не закроется, даже без параметра сессии.
- Переменные окружения вроде HTTPS_PROXY имеют приоритет над прокси, заданными в Session, поэтому передавайте proxies= при каждом вызове или установите session.trust_env = False.
- Всегда задавайте тайм-аут: по умолчанию Requests ждёт бесконечно, а шлюз прерывает запрос к целевому сайту через 60 секунд с кодом 504.

Читайте также

- [Прокси в Python Requests: аутентификация, ротация, повторные попытки и SOCKS5](https://proxonym.com/ru/blog/python-requests-proxies)
- [Парсинг без блокировок: 12 практических приёмов](https://proxonym.com/ru/blog/web-scraping-without-getting-blocked)

Застряли на каком-то шаге?

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

- [Справочный центр](https://proxonym.com/ru/help)
- [Коды ошибок шлюза](https://proxonym.com/ru/docs#errors-and-troubleshooting)
- [Проверить прокси](https://proxonym.com/ru/proxy-checker)

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

[Все интеграции](https://proxonym.com/ru/integrations)

- [Scrapy (Python)](https://proxonym.com/ru/integrations/scrapy)
- [Selenium (Python)](https://proxonym.com/ru/integrations/selenium)
- [AdsPower (Антидетект-браузер)](https://proxonym.com/ru/integrations/adspower)
