Dietro ERR_TUNNEL_CONNECTION_FAILED: leggere la risposta CONNECT del proxy
Updated:
ERR_TUNNEL_CONNECTION_FAILED compare quando Chrome richiede a un proxy di aprire un tunnel per una pagina https:// e il proxy rifiuta. Chrome invia una richiesta CONNECT, si aspetta l'autorizzazione e riceve invece uno stato di errore. La difficoltà sta nel fatto che Chrome nasconde tale stato, quindi il primo passo è recuperare il codice reale.
Cause più probabili, in ordine
- Uno script avvia Chrome senza credenziali. Il flag
--proxy-serveraccetta solo host e porta; qualsiasi user:pass inserito lì viene ignorato. Puppeteer o Selenium in modalità headless riceve quindi un 407 e lo segnala come errore del tunnel. - Un'app dietro un proxy Wi-Fi che richiede una password. Le app non mostrano richieste di accesso, quindi le loro richieste HTTPS falliscono anche se il browser dello smartphone funziona.
- Il proxy non riesce a raggiungere la destinazione. Risponde al CONNECT con un 502. La pagina 502 Bad Gateway approfondisce questo caso.
- Solo alcuni siti non funzionano. La destinazione è offline o rifiuta la connessione, mentre lo stesso proxy apre altri siti senza problemi.
Cosa abbiamo osservato nei test
Abbiamo riprodotto entrambi i casi tipici su un proxy di prova, indicato di seguito come 203.0.113.10:8080 con credenziali user123:pass456. In ciascuna riga Chrome ha mostrato lo stesso messaggio, motivo per cui l'errore di per sé fornisce pochissime informazioni.
| Risposta del proxy a CONNECT | Chrome | curl |
|---|---|---|
407, senza possibilità di inserire una password (Chrome headless) | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 407 |
502, il proxy non è riuscito a raggiungere il sito | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 502 |
Recuperare il codice di stato nascosto
Esegui curl -v -x http://user123:[email protected]:8080 https://example.com con i parametri del tuo proxy e leggi la risposta successiva a > CONNECT example.com:443 HTTP/1.1. Un 407 rimanda alla guida al 407. Un 502 indica un problema con la destinazione o con la rotta oltre il proxy.
Preferisci non aprire il terminale? Il proxy checker segnala le stesse due situazioni come auth failed (407) e HTTP 502.
Nota che una normale finestra visibile di Chrome gestisce il 407 diversamente: mostra una finestra di accesso per inserire nome utente e password del proxy invece dell'errore di tunnel. Ecco perché gli errori di tunnel causati dal 407 compaiono soprattutto nell'automazione e nelle app prive di prompt di autenticazione.
Soluzioni per ciascun ambiente
- Puppeteer: avvia con
--proxy-server=http://host:port, poi richiamapage.authenticate({ username, password })prima della prima navigazione. Un esempio completo è disponibile nella guida proxy per Puppeteer. - Playwright: imposta
proxy: { server, username, password }nelle opzioni di avvio; Playwright gestirà automaticamente la risposta al 407. Consulta la configurazione di Playwright. - Selenium: Chrome non accetta user:pass da riga di comando. La guida a Selenium elenca le soluzioni funzionanti.
- Desktop Chrome su Windows: se la finestra di accesso non compare mai, un'estensione potrebbe bloccarla. Riprova in una finestra con le estensioni disabilitate.
- Smartphone: le app che richiedono un proxy con autenticazione funzionano meglio tramite un'app proxy che supporta user:pass, come descritto nella guida alla configurazione su Android.
Guida passo-passo
- 1
Scopri la risposta del proxy
Usa
curl -v -xcon i dati del tuo proxy oppure il checker per verificare se la risposta a CONNECT è 407 o 502. - 2
407: trasmetti correttamente le credenziali
Nell'automazione, utilizza la funzione di autenticazione della libreria invece di inserire user:pass all'interno di
--proxy-server. - 3
502: prova una destinazione diversa
Apri un sito stabile e di grandi dimensioni come example.com tramite lo stesso proxy. Se si carica, il problema è del sito originale.
- 4
Verifica l'IP di uscita
Una volta aperto il tunnel, apri il mio IP nello stesso browser per verificare che il traffico passi effettivamente attraverso il proxy.
Domande frequenti
Perché le pagine http:// funzionano mentre le pagine https:// falliscono?
Le normali richieste HTTP vengono inoltrate direttamente senza richiedere CONNECT. Solo HTTPS richiede un tunnel, quindi l'errore del tunnel può verificarsi unicamente sulle pagine HTTPS.
Cosa causa ERR_TUNNEL_CONNECTION_FAILED su Android?
Di solito un'app che non riesce a inviare nome utente e password a un proxy Wi-Fi. Apri la stessa pagina in Chrome per Android: se Chrome richiede le credenziali e la carica, il problema riguarda l'app.
È possibile inserire le credenziali in --proxy-server?
No. Chrome le ignora, il proxy risponde con un 407 e si ottiene l'errore del tunnel. Autenticati invece tramite Puppeteer, Playwright o un'estensione.
Quale tipo di proxy dovrei selezionare per evitare questo problema?
Fai corrispondere il tipo al tuo ordine: seleziona HTTP nel tuo strumento per un ordine HTTP o dual-mode (l'errore del tunnel compare solo con HTTP), oppure SOCKS5 per un ordine SOCKS5, e inserisci il login tramite le impostazioni di autenticazione dello strumento.
Creato per gli script di automazione
I proxy ProxyV4 utilizzano una semplice autenticazione user:pass compatibile con Puppeteer e Playwright senza bisogno di soluzioni alternative.
Vedi i prezzi in tempo reale