Посібник · Python

Використання проксі з Python requests та httpx

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

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

Базове налаштування

  • Сформуйте рядок ip:port:user:pass у форматі URL: 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) для кожного запиту.