Guide · Python

Utiliser des proxys avec Python requests et httpx

requests est la bibliothèque HTTP la plus populaire de Python et intègre la prise en charge native des proxys authentifiés. Les erreurs les plus courantes consistent à mal déclarer la clé https dans le dictionnaire proxies et à ne pas encoder les caractères spéciaux dans les mots de passe. Ce guide détaille la configuration correcte, y compris les timeouts et la gestion des erreurs pour les scripts longue durée.

Auteur : Bùi Toàn · Mis à jour : 19/11/2026

Configuration de base

  • Formatez la chaîne ip:port:user:pass en URL : proxy_url = "http://user:pass@IP:PORT".
  • Déclarez les deux clés : proxies = {"http": proxy_url, "https": proxy_url}. La clé "https" pointe toujours vers une URL commençant par http:// car les proxys ONET sont des proxys HTTP ; requests utilise automatiquement CONNECT pour les sites HTTPS.
  • Envoyez la requête : r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). Le résultat doit être l'IP du proxy.
  • N'écrivez pas "https": "https://IP:PORT". Les proxys ONET n'acceptent pas les connexions TLS vers eux-mêmes et renverront une erreur SSL ou fermeront la connexion.

Comment utiliser des proxys avec des caractères spéciaux dans le mot de passe avec requests ?

Encodez l'identifiant et le mot de passe au format URL avant l'assemblage : from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". Sans cette étape, les caractères @ ou : dans le mot de passe entraîneront une mauvaise analyse de l'adresse du proxy par requests.

Utiliser Session et les réessais

  • Créez s = requests.Session(); s.proxies.update(proxies). Toutes les requêtes effectuées via s partagent le proxy et maintiennent les connexions, ce qui est plus rapide que d'appeler requests.get à répétition.
  • Montez un HTTPAdapter avec Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) pour retenter automatiquement lors d'erreurs temporaires.
  • Définissez toujours un timeout. Sans timeout, une connexion bloquée peut figer votre programme indéfiniment.
  • La variable d'environnement HTTPS_PROXY est également lue par requests, sauf si vous définissez s.trust_env = False.

Avec httpx

À partir de httpx 0.26, transmettez le proxy via le paramètre proxy : httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). Les versions antérieures utilisent proxies={"all://": url}. httpx prend en charge l'asynchrone (httpx.AsyncClient) si vous devez exécuter des requêtes simultanées.

Quelles erreurs de proxy rencontre-t-on fréquemment avec Python requests ?

Les trois erreurs courantes sont l'erreur 407 due à un identifiant ou un mot de passe incorrect, les dépassements de délai (timeouts) lorsque le proxy est injoignable, et l'erreur 429 liée aux limites de débit du site cible.

ProxyError … 407 Proxy Authentication Required

Identifiant ou mot de passe incorrect, ou caractères spéciaux non encodés.

ConnectTimeout ou ProxyError … timed out

Impossible de joindre le proxy : IP ou port incorrect, ou blocage réseau. Vérifiez avec curl.

HTTP 429 depuis le site de destination

Limite de requêtes atteinte sur le site de destination. Réduisez le nombre de requêtes par IP, ajoutez des délais ou répartissez la charge sur plusieurs proxys.

Vous n'avez pas de proxy ? Achetez des proxys dédiés avec activation automatique

Proxys IPv4 dédiés dans 9 pays dès 20.000₫/IP/mois à partir de 2.000 IP (39.000₫ pour 1 IP), plus proxys ISP statiques au Vietnam et aux États-Unis. HTTP(S) et SOCKS5 avec identifiant et mot de passe, bande passante illimitée, activés automatiquement après le paiement. Les proxys au Vietnam prennent actuellement en charge uniquement HTTP(S), sans SOCKS5.

Acheter des proxys maintenant

Foire aux questions

Les proxys ONET ont-ils des limites de threads ou de données ?+

Bande passante illimitée. Le nombre de requêtes que vous pouvez envoyer vers un site cible est limité par ce site ; le dépasser déclenchera une erreur 429.

Puis-je utiliser aiohttp ?+

Oui. Transmettez proxy="http://IP:PORT" et proxy_auth=aiohttp.BasicAuth(user, pass) à chaque requête.