Derrière ERR_TUNNEL_CONNECTION_FAILED : lire la réponse CONNECT du proxy
Updated:
ERR_TUNNEL_CONNECTION_FAILED apparaît lorsque Chrome demande à un proxy d'ouvrir un tunnel pour une page https:// et que le proxy refuse. Chrome envoie une requête CONNECT, attend une autorisation et reçoit un code d'erreur à la place. Comme Chrome masque ce statut, votre première tâche consiste à récupérer le code réel.
Causes probables, par ordre de fréquence
- Un script lance Chrome sans identifiants. Le paramètre
--proxy-servern'accepte que l'hôte et le port ; tout user:pass qui y est ajouté est ignoré. Puppeteer ou Selenium en mode headless reçoit alors un code 407 et signale un échec de tunnel. - Une application derrière un proxy Wi-Fi exigeant un mot de passe. Les applications n'affichent aucune invite de connexion, de sorte que leurs requêtes HTTPS échouent alors même que le navigateur du téléphone fonctionne.
- Le proxy ne peut pas joindre la destination. Il répond au CONNECT par une erreur 502. La page 502 Bad Gateway détaille ce cas particulier.
- Seuls certains sites échouent. Le site de destination est inaccessible ou refuse la connexion, alors que le même proxy ouvre d'autres sites sans problème.
Nos constats lors des tests
Nous avons reproduit ces deux cas fréquents sur un proxy de test, représenté ci-dessous par 203.0.113.10:8080 avec les identifiants user123:pass456. Pour chaque scénario, Chrome a affiché le même message, ce qui explique pourquoi cette erreur reste si peu explicite par elle-même.
| Réponse du proxy au CONNECT | Chrome | curl |
|---|---|---|
407, sans possibilité de saisir un mot de passe (Chrome headless) | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 407 |
502, le proxy n'a pas pu joindre le site | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 502 |
Récupérer le code de statut masqué
Exécutez curl -v -x http://user123:[email protected]:8080 https://example.com avec vos propres paramètres de proxy et lisez la réponse suivant > CONNECT example.com:443 HTTP/1.1. Une erreur 407 vous renvoie vers le guide sur l'erreur 407. Une erreur 502 signale un problème avec la destination ou le réseau en amont du proxy.
Vous préférez ne pas ouvrir de terminal ? Le testeur de proxy signale ces deux situations sous la forme auth failed (407) et HTTP 502.
Notez qu'une fenêtre Chrome classique et visible gère l'erreur 407 différemment : elle affiche une invite de connexion pour l'identifiant et le mot de passe du proxy au lieu de l'erreur de tunnel. C'est pourquoi les erreurs de tunnel liées au code 407 surviennent principalement dans les scripts d'automatisation et les applications dépourvues d'interface de saisie.
Solutions par environnement
- Puppeteer : lancez le navigateur avec
--proxy-server=http://host:port, puis appelezpage.authenticate({ username, password })avant la première navigation. Un exemple complet est disponible dans le guide de configuration Puppeteer. - Playwright : renseignez
proxy: { server, username, password }dans les options de lancement ; Playwright répond automatiquement au code 407. Consultez le guide de configuration Playwright. - Selenium : Chrome n'accepte pas user:pass sur sa ligne de commande. Le guide Selenium liste les solutions fonctionnelles.
- Chrome sur Windows : si la boîte de connexion ne s'affiche jamais, une extension la bloque peut-être. Réessayez dans une fenêtre où les extensions sont désactivées.
- Smartphones : les applications nécessitant un proxy authentifié fonctionnent mieux via une application de proxy compatible user:pass, comme décrit dans le guide de configuration Android.
Étape par étape
- 1
Déterminer la réponse du proxy
Utilisez
curl -v -xavec vos paramètres de proxy, ou le testeur, pour voir si la réponse au CONNECT est 407 ou 502. - 2
407 : transmettre correctement les identifiants
En automatisation, utilisez la fonction d'authentification de la bibliothèque plutôt que d'insérer user:pass dans
--proxy-server. - 3
502 : tester une autre destination
Ouvrez un site stable et reconnu comme example.com via le même proxy. S'il se charge, le site d'origine est en cause.
- 4
Confirmer l'adresse IP de sortie
Une fois le tunnel ouvert, chargez mon adresse IP dans ce même navigateur pour vérifier que le trafic passe bien par le proxy.
Foire aux questions
Pourquoi les pages http:// fonctionnent-elles alors que les pages https:// échouent ?
Les requêtes HTTP simples sont transmises directement sans nécessiter de CONNECT. Seul le protocole HTTPS demande un tunnel, de sorte qu'une erreur de tunnel ne peut survenir que sur des pages HTTPS.
Qu'est-ce qui provoque ERR_TUNNEL_CONNECTION_FAILED sur Android ?
Généralement une application incapable d'envoyer l'identifiant et le mot de passe à un proxy Wi-Fi. Ouvrez la même page dans Chrome pour Android : si Chrome affiche l'invite et charge la page, c'est l'application qui est en cause.
Peut-on mettre des identifiants dans --proxy-server ?
Non. Chrome les ignore, le proxy renvoie un code 407 et vous obtenez l'erreur de tunnel. Authentifiez-vous plutôt via Puppeteer, Playwright ou une extension.
Quel type de proxy choisir pour éviter cette erreur ?
Adaptez le type à votre commande : choisissez HTTP dans votre outil pour une commande HTTP ou double mode (l'erreur de tunnel n'apparaît qu'avec HTTP), ou SOCKS5 pour une commande SOCKS5, et renseignez vos identifiants via le paramètre d'authentification de l'outil.
Conçu pour les scripts d'automatisation
Les proxys ProxyV4 utilisent une authentification simple user:pass que Puppeteer et Playwright prennent en charge sans contournement.
Voir les tarifs en direct