Инструкция · Python

Использование прокси в Python requests и httpx

requests — самая популярная HTTP-библиотека для Python со встроенной поддержкой авторизации на прокси. Наиболее частые ошибки — некорректное указание ключа https в словаре proxies и отсутствие кодирования спецсимволов в пароле. В этом руководстве рассмотрена правильная настройка, включая таймауты и обработку ошибок для долго работающих скриптов.

Автор: Bùi Toàn · Обновлено: 19/11/2026

Базовая настройка

  • Сформируйте URL из строки ip:port:user:pass: proxy_url = "http://user:pass@IP:PORT".
  • Укажите оба ключа: proxies = {"http": proxy_url, "https": proxy_url}. Ключ "https" по-прежнему указывает на URL, начинающийся с http://, поскольку прокси ONET являются HTTP-прокси; requests автоматически использует метод CONNECT для сайтов с HTTPS.
  • Отправьте запрос: r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). В ответе должен отобразиться IP-адрес прокси.
  • Не указывайте "https": "https://IP:PORT". Прокси ONET не принимают TLS-подключения к себе и вернут ошибку SSL или закроют соединение.

Как использовать в requests прокси со спецсимволами в пароле?

Выполните URL-кодирование логина и пароля перед сборкой строки: from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". Без этого шага символы @ или : в пароле приведут к ошибке парсинга адреса прокси в requests.

Использование Session и повторных попыток

  • Создайте s = requests.Session(); s.proxies.update(proxies). Все запросы через s используют общий прокси и поддерживают постоянные соединения, что быстрее повторных вызовов requests.get.
  • Подключите HTTPAdapter с Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) для автоматического повтора при временных сбоях.
  • Всегда задавайте таймаут. Без таймаута зависшее соединение может заблокировать работу программы на неопределенный срок.
  • Переменная окружения HTTPS_PROXY также считывается библиотекой requests, если не задано s.trust_env = False.

Работа с httpx

Начиная с httpx 0.26, передавайте прокси через параметр proxy: httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). В более старых версиях используется proxies={"all://": url}. httpx поддерживает асинхронный режим (httpx.AsyncClient), если требуется выполнять параллельные запросы.

С какими ошибками прокси чаще всего сталкивается Python requests?

Три самые распространенные ошибки: 407 из-за неверного логина или пароля, тайм-ауты из-за недоступности прокси и 429 из-за ограничений по частоте запросов на целевом сайте.

ProxyError … 407 Proxy Authentication Required

Неверный логин или пароль, либо спецсимволы не были закодированы.

ConnectTimeout или ProxyError … timed out

Не удается связаться с прокси: неверный IP, порт или сетевая блокировка. Проверьте подключение с помощью curl.

HTTP 429 от целевого сайта

Превышен лимит запросов на целевом сайте. Уменьшите частоту запросов с одного IP, добавьте задержки или распределите нагрузку между несколькими прокси.

Нет прокси? Купите индивидуальные прокси с автоматической активацией

Индивидуальные IPv4-прокси в 9 странах от 20.000₫/IP/месяц при покупке от 2.000 IP (39.000₫ за 1 IP), а также статические ISP-прокси Вьетнама и США. HTTP(S) и SOCKS5 с логином и паролем, безлимитный трафик, автоматическая выдача после оплаты. Прокси Вьетнама сейчас поддерживают только HTTP(S), без SOCKS5.

Купить прокси

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

Есть ли у прокси ONET ограничения по потокам или трафику?+

Безлимитный трафик. Количество запросов к целевому ресурсу регулируется самим сайтом; при превышении лимита вернется ошибка 429.

Можно ли использовать aiohttp?+

Да. Передавайте proxy="http://IP:PORT" и proxy_auth=aiohttp.BasicAuth(user, pass) при каждом запросе.