Poradnik · Python

Korzystanie z proxy w Python requests i httpx

requests to najpopularniejsza biblioteka HTTP w Pythonie z wbudowaną obsługą proxy wymagających uwierzytelnienia. Najczęstsze błędy to nieprawidłowe deklarowanie klucza https w słowniku proxies oraz brak kodowania znaków specjalnych w haśle. Ten poradnik omawia poprawną konfigurację, w tym timeouty i obsługę błędów dla długo działających skryptów.

Autor: Bùi Toàn · Zaktualizowano: 19/11/2026

Podstawowa konfiguracja

  • Sformatuj ciąg ip:port:user:pass w adres URL: proxy_url = "http://user:pass@IP:PORT".
  • Zadeklaruj oba klucze: proxies = {"http": proxy_url, "https": proxy_url}. Klucz "https" nadal wskazuje adres URL zaczynający się od http://, ponieważ proxy ONET to proxy HTTP; biblioteka requests automatycznie używa metody CONNECT dla witryn HTTPS.
  • Wyślij żądanie: r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). Wynikiem powinien być adres IP proxy.
  • Nie wpisuj "https": "https://IP:PORT". Proxy ONET nie akceptują bezpośrednich połączeń TLS ze sobą i zwrócą błąd SSL lub zamkną połączenie.

Jak używać proxy ze znakami specjalnymi w haśle w requests?

Zakoduj nazwę użytkownika i hasło (URL-encode) przed ich złożeniem: from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". Bez tego kroku znaki @ lub : w haśle spowodują, że biblioteka requests błędnie zinterpretuje adres proxy.

Używanie Session i ponawianie prób

  • Utwórz s = requests.Session(); s.proxies.update(proxies). Wszystkie żądania wysyłane przez s korzystają ze wspólnego proxy i utrzymują aktywne połączenia, co jest szybsze niż wielokrotne wywoływanie requests.get.
  • Podepnij HTTPAdapter z Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]), aby automatycznie ponawiać próby przy chwilowych błędach.
  • Zawsze ustawiaj parametr timeout. Bez limitu czasu zawieszone połączenie może zablokować działanie programu w nieskończoność.
  • Zmienna środowiskowa HTTPS_PROXY jest również odczytywana przez requests, chyba że ustawisz s.trust_env = False.

Z biblioteką httpx

Począwszy od httpx 0.26, przekazuj proxy za pomocą parametru proxy: httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). Starsze wersje używają proxies={"all://": url}. httpx obsługuje asynchroniczność (httpx.AsyncClient), jeśli musisz wykonywać żądania współbieżne.

Jakie błędy proxy najczęściej występują w Python requests?

Trzy najczęstsze błędy to 407 z powodu niepoprawnej nazwy użytkownika lub hasła, przekroczenie limitu czasu przy próbie połączenia z proxy oraz 429 wynikający z limitów na docelowej stronie.

ProxyError … 407 Proxy Authentication Required

Nieprawidłowa nazwa użytkownika lub hasło albo brak zakodowania znaków specjalnych.

ConnectTimeout lub ProxyError … timed out

Brak połączenia z proxy: niepoprawny adres IP, port lub blokada sieciowa. Zweryfikuj połączenie za pomocą curl.

HTTP 429 z witryny docelowej

Limit zapytań (rate limit) narzucony przez witrynę docelową. Zmniejsz liczbę żądań na IP, dodaj opóźnienia lub rozłóż obciążenie na wiele proxy.

Nie masz proxy? Kup dedykowane proxy z automatyczną aktywacją

Dedykowane proxy IPv4 w 9 krajach od 20.000₫/IP/miesiąc przy zakupie co najmniej 2.000 IP (39.000₫ za 1 IP) oraz statyczne proxy ISP w Wietnamie i USA. HTTP(S) i SOCKS5 z loginem i hasłem, nielimitowany transfer, automatyczne uruchomienie po opłaceniu. Proxy w Wietnamie obsługują obecnie wyłącznie HTTP(S), bez SOCKS5.

Kup proxy teraz

Najczęściej zadawane pytania

Czy proxy ONET mają limity wątków lub transferu danych?+

Nielimitowany transfer danych. Liczba zapytań, jakie możesz wysłać do witryny docelowej, zależy od limitów tej witryny – ich przekroczenie wywoła błąd 429.

Czy mogę używać aiohttp?+

Tak. Przy każdym żądaniu przekaż proxy="http://IP:PORT" oraz proxy_auth=aiohttp.BasicAuth(user, pass).