Guida · Python

Utilizzo dei proxy con Python requests e httpx

requests è la libreria HTTP più popolare di Python e include il supporto integrato per proxy autenticati. Gli errori più comuni consistono nel dichiarare in modo errato la chiave https nel dizionario proxies e nel lasciare i caratteri speciali nelle password non codificati. Questa guida illustra la configurazione corretta, inclusi timeout e gestione degli errori per script a lunga esecuzione.

Autore: Bùi Toàn · Aggiornato: 19/11/2026

Configurazione di base

  • Formatta la stringa ip:port:user:pass in un URL: proxy_url = "http://user:pass@IP:PORT".
  • Dichiara entrambe le chiavi: proxies = {"http": proxy_url, "https": proxy_url}. La chiave "https" punta comunque a un URL che inizia con http:// perché i proxy ONET sono proxy HTTP; requests utilizza automaticamente CONNECT per i siti HTTPS.
  • Invia la richiesta: r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). Il risultato dovrebbe essere l'IP del proxy.
  • Non scrivere "https": "https://IP:PORT". I proxy ONET non accettano connessioni TLS verso se stessi e restituiranno un errore SSL o chiuderanno la connessione.

Come gestire caratteri speciali nella password in requests?

Codifica con URL-encode username e password prima dell'assemblaggio: from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". Senza questo passaggio, i caratteri @ o : nella password causeranno un errore di parsing dell'indirizzo proxy da parte di requests.

Utilizzo di Session e tentativi di retry

  • Crea s = requests.Session(); s.proxies.update(proxies). Tutte le richieste effettuate tramite s condividono il proxy e mantengono le connessioni, risultando più veloci rispetto a chiamare ripetutamente requests.get.
  • Collega un HTTPAdapter con Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) per ripetere automaticamente le richieste in caso di errori temporanei.
  • Imposta sempre un timeout. Senza un timeout, una connessione bloccata può bloccare indefinitamente il programma.
  • Anche la variabile d'ambiente HTTPS_PROXY viene letta da requests, a meno che non si imposti s.trust_env = False.

Con httpx

A partire da httpx 0.26, passa il proxy utilizzando il parametro proxy: httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). Le versioni precedenti utilizzano proxies={"all://": url}. httpx supporta le operazioni asincrone (httpx.AsyncClient) se hai bisogno di eseguire richieste simultanee.

Quali errori proxy compaiono spesso in Python requests?

I tre errori principali sono 407 per username o password errati, timeout se il proxy non è raggiungibile e 429 dovuto ai limiti di frequenza del sito di destinazione.

ProxyError … 407 Proxy Authentication Required

Username o password errati, oppure i caratteri speciali non sono stati codificati.

ConnectTimeout o ProxyError … timed out

Impossibile raggiungere il proxy: IP o porta errati, oppure blocco di rete. Verifica utilizzando curl.

HTTP 429 dal sito di destinazione

Limite di frequenza superato sul sito di destinazione. Riduci le richieste per IP, aggiungi ritardi o distribuisci il carico su più proxy.

Non hai un proxy? Acquista proxy dedicati con attivazione automatica

Proxy IPv4 dedicati in 9 paesi da 20.000₫/IP/mese acquistando 2.000 o più IP (39.000₫ per 1 IP), oltre a proxy statici ISP per Vietnam e USA. HTTP(S) e SOCKS5 con username e password, larghezza di banda illimitata, erogati automaticamente dopo il pagamento. I proxy per il Vietnam attualmente supportano solo HTTP(S), senza SOCKS5.

Acquista proxy ora

Domande frequenti

I proxy ONET hanno limiti di thread o di dati?+

Larghezza di banda illimitata. Il numero di richieste inviabili a un sito di destinazione è limitato dal sito stesso; superarlo genererà un errore 429.

Posso usare aiohttp?+

Sì. Passa proxy="http://IP:PORT" e proxy_auth=aiohttp.BasicAuth(user, pass) con ogni richiesta.