Un proxy SOCKS5 avec cURL est le moyen le plus rapide de faire passer une requête HTTP dans un tunnel, et la syntaxe testée en une ligne reste valable des années dans les scripts de production. cURL gère SOCKS5 nativement : inutile d'installer une bibliothèque ou une extension juste pour vérifier qu'un endpoint répond.

Le piège n'est pas le flag mais le DNS. cURL connaît deux schémas presque identiques, socks5:// et socks5h://, et un seul garde votre position réelle hors de la requête. Le reste est de la plomberie : identifiants encodés, variables d'environnement, timeouts et une vérification avant le vrai travail.

Pourquoi router cURL via SOCKS5 plutôt qu'un proxy HTTP

  • Indépendance de protocole. Un tunnel transporte API, SMTP, IMAP, SSH et WebSocket, là où un proxy HTTP ne comprend que HTTP.
  • DNS distant avec socks5h. Le proxy résout le nom : ni le FAI ni la cible ne voient de requête DNS depuis votre réseau réel.
  • Authentification par connexion. Identifiant et mot de passe sont négociés dans le handshake SOCKS, pas dans un en-tête journalisable par le serveur cible.
  • Aucun en-tête injecté. Les proxys HTTP ajoutent X-Forwarded-For ou Via ; SOCKS5 transmet les octets tels quels.

Cinq vérifications avant la première requête

  1. Choisir le schéma volontairement : socks5h pour le public, socks5 pour l'interne uniquement.
  2. Confirmer hôte et port — 1080 est classique, mais les fournisseurs utilisent souvent 1081, 8080 ou une passerelle rotative.
  3. Encoder les identifiants : @ devient %40, : devient %3A, / devient %2F.
  4. Poser --connect-timeout 10 et --max-time 60 pour échouer vite sur un endpoint mort.
  5. Vérifier l'IP de sortie sur https://api.ipify.org avant toute tâche réelle.

Comparaison des flags

  • -x socks5h://host:port — DNS résolu par le proxy, le choix par défaut.
  • -x socks5://host:port — DNS local, réservé aux cibles internes.
  • --socks5-hostname host:port — forme longue de socks5h pour les arguments construits dynamiquement.
  • --preproxy socks5h://… — chaîne un proxy HTTP devant la sortie SOCKS5.

Configuration en quatre étapes

  1. Placer les identifiants dans des variables d'environnement, pas dans l'historique du shell.
  2. Construire l'URL : socks5h://user:p%40ss@host:1080.
  3. Vérifier l'IP de sortie avec curl -sS -x "$PROXY" https://api.ipify.org.
  4. Lancer la vraie requête avec -v pour lire le handshake, puis ajouter retries et timeouts au script.

FAQ

Quelle différence entre socks5 et socks5h ?

socks5 résout le nom en local puis envoie l'IP dans le tunnel, ce qui peut fuiter votre position ; socks5h transmet le nom et laisse le proxy résoudre. Pour toute cible publique, utilisez socks5h.

Pourquoi des erreurs de tunnel ou de connexion ?

Le plus souvent un mauvais port, un caractère non encodé dans les identifiants, ou socks5 alors que la forme hostname est attendue. Avec -v, vous voyez où le handshake s'arrête.

Branchez le flag une fois et vérifiez l'IP de sortie à chaque exécution : cURL avec SOCKS5 devient la commande la plus fiable de votre boîte à outils. Prenez un endpoint chez FTProxy residential proxies.