Guide · curl

Utiliser un proxy avec curl

curl est le moyen le plus rapide de vérifier si un proxy fonctionne, indépendamment de tout navigateur ou extension. La commande curl est intégrée sous Linux, macOS et Windows 10, 11. Ce guide présente des exemples de commandes, la lecture des retours pour résoudre les erreurs et la configuration d'un proxy par défaut pour toutes vos commandes.

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

Commandes de base

  • À partir du format ip:port:user:pass, exécutez : curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • Ou combinez le tout en une seule chaîne : curl -x http://user:pass@IP:PORT https://api.ipify.org
  • La sortie doit afficher l'IP du proxy. Voir l'IP de votre FAI signifie que la requête n'est pas passée par le proxy.
  • Pour vérifier également le pays : remplacez l'URL de destination par https://ipinfo.io/json.
  • Si le proxy fonctionne en mode SOCKS5 ou HTTP + SOCKS5 : curl -x socks5h://user:pass@IP:PORT https://api.ipify.org (socks5h permet au proxy de résoudre les noms de domaine), ou curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org.

Sous Windows

Dans PowerShell 5.1, "curl" est un alias pour Invoke-WebRequest et non le véritable curl. Utilisez curl.exe au lieu de curl : curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org. Dans l'Invite de commandes (cmd) et PowerShell 7 ou supérieur, curl correspond bien au vrai curl.

Comment utiliser curl avec des caractères spéciaux dans le mot de passe du proxy ?

Avec le format user:pass@IP, les caractères spéciaux comme @ : / # % dans le mot de passe doivent être encodés en URL — par exemple, @ devient %40 et # devient %23. L'utilisation de -U "user:pass" (entre guillemets doubles) ne nécessite aucun encodage et réduit les erreurs. Sous Linux et macOS, utilisez des guillemets simples si le mot de passe contient $ ou !.

Comment lire la sortie de curl pour diagnostiquer les erreurs de proxy ?

Ajoutez -v pour inspecter chaque étape : la ligne "200 Connection established" indique que le proxy a accepté la connexion, tandis que les messages d'erreur ci-dessous précisent si le problème provient des identifiants, des ports, du réseau ou du site de destination.

Ajouter -v pour afficher les détails

Pour les sites HTTPS, curl envoie une requête CONNECT au proxy. La ligne "< HTTP/1.1 200 Connection established" signifie que le proxy a accepté la connexion. La ligne "407 Proxy Authentication Required" indique un nom d'utilisateur ou un mot de passe incorrect.

Failed to connect … Connection refused

La connexion à IP:port a été immédiatement refusée : port incorrect, proxy expiré ou inactif. Consultez le guide sur les erreurs connection refused.

Connection timed out

Aucune réponse reçue : IP incorrecte, problèmes réseau ou pare-feu bloquant le port. Ajoutez --connect-timeout 10 pour éviter d'attendre trop longtemps.

CONNECT tunnel failed, response 502 or 503

Le proxy fonctionne mais n'a pas pu établir la connexion avec le site de destination. Essayez un autre site web pour déterminer si le problème vient du site cible ou du proxy.

Définir un proxy par défaut

Définissez des variables d'environnement afin que toutes les commandes curl (et de nombreux autres outils) utilisent automatiquement le proxy : export https_proxy="http://user:pass@IP:PORT" et export http_proxy="$https_proxy" sous Linux et macOS. Contournez le proxy pour une seule commande avec --noproxy "*". Vous pouvez également ajouter la ligne proxy = "http://user:pass@IP:PORT" dans votre fichier ~/.curlrc.

Pas encore de proxy ? Achetez des proxys dédiés avec activation automatique

Proxys IPv4 dédiés dans 9 pays à partir de 20.000₫/IP/mois dès 2.000 IP achetées (39.000₫ pour 1 IP), plus proxys ISP statiques au Vietnam et aux États-Unis. HTTP(S) et SOCKS5 avec utilisateur et mot de passe, bande passante illimitée, activés automatiquement après paiement. Les proxys au Vietnam utilisent actuellement le protocole HTTP(S) ; SOCKS5 n'est pas encore disponible.

Acheter des proxys maintenant

Foire aux questions

Pourquoi la valeur https_proxy commence-t-elle quand même par http:// ?+

Ce préfixe spécifie la manière dont curl se connecte au proxy, et non au site de destination. Lors de la communication avec le proxy ONET en HTTP, les sites HTTPS restent accessibles via la méthode CONNECT. Avec SOCKS5, la valeur commence par socks5h://.

Puis-je utiliser --socks5 avec les proxys ONET ?+

Oui, lorsque le proxy fonctionne en mode SOCKS5 ou HTTP + SOCKS5 : curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org, ou -x socks5h://user:pass@IP:PORT. Utilisez socks5h ou --socks5-hostname pour que les noms de domaine soient résolus du côté du proxy. Notez que les proxys au Vietnam utilisent actuellement uniquement le protocole HTTP(S) ; SOCKS5 n'est pas encore disponible.