Por trás do ERR_TUNNEL_CONNECTION_FAILED: lendo a resposta CONNECT do proxy
Updated:
O ERR_TUNNEL_CONNECTION_FAILED aparece quando o Chrome solicita ao proxy a abertura de um túnel para uma página https:// e o proxy recusa. O Chrome envia uma requisição CONNECT, aguarda permissão e recebe um status de erro. A dificuldade é que o Chrome oculta esse status; portanto, sua primeira tarefa é identificar o código real.
Causas prováveis, ordenadas
- Um script inicia o Chrome sem credenciais. A flag
--proxy-serveraceita apenas host e porta; qualquer usuário:senha inserido nela é descartado. O Puppeteer ou Selenium em modo headless recebe um 407 e o relata como falha de túnel. - Um aplicativo atrás de um proxy Wi-Fi que exige senha. Aplicativos não têm tela de login, portanto suas requisições HTTPS falham mesmo que o navegador do celular funcione.
- O proxy não consegue alcançar o destino. Ele responde ao CONNECT com 502. A página de 502 Bad Gateway detalha esse caso.
- Apenas certos sites falham. O destino está fora do ar ou recusando conexões, enquanto o mesmo proxy abre outros sites sem problemas.
O que observamos nos testes
Reproduzimos ambos os casos comuns em um proxy de teste, representado abaixo como 203.0.113.10:8080 com o login user123:pass456. Em cada linha, o Chrome exibiu a mesma mensagem, e é por isso que ela diz tão pouco por si só.
| Resposta do proxy ao CONNECT | Chrome | curl |
|---|---|---|
407, e sem como digitar uma senha (Chrome headless) | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 407 |
502, o proxy não conseguiu alcançar o site | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 502 |
Recupere o código de status oculto
Execute curl -v -x http://user123:[email protected]:8080 https://example.com com os dados do seu proxy e leia a resposta após > CONNECT example.com:443 HTTP/1.1. Um 407 direciona você ao guia do 407. Um 502 aponta para o destino ou para a rota além do proxy.
Prefere não abrir o terminal? O verificador de proxy relata essas mesmas duas situações como auth failed (407) e HTTP 502.
Observe que uma janela comum e visível do Chrome lida com o 407 de forma diferente: ela exibe uma caixa de login para o usuário e a senha do proxy em vez do erro de túnel. É por isso que erros de túnel causados pelo 407 aparecem principalmente em automações e aplicativos sem interface de autenticação.
Soluções para cada ambiente
- Puppeteer: inicie com
--proxy-server=http://host:porte chamepage.authenticate({ username, password })antes da primeira navegação. Um exemplo completo está no guia de proxy para Puppeteer. - Playwright: forneça
proxy: { server, username, password }nas opções de inicialização; o Playwright responde ao 407 automaticamente. Consulte a configuração do Playwright. - Selenium: o Chrome não aceita usuário:senha em sua linha de comando. O guia do Selenium lista as abordagens que funcionam.
- Chrome no Windows para desktop: se a caixa de login nunca aparecer, uma extensão pode estar bloqueando-a. Tente novamente em uma janela com as extensões desativadas.
- Celulares: aplicativos que precisam de proxy autenticado funcionam melhor usando um app de proxy compatível com usuário:senha, conforme descrito no guia de configuração para Android.
Passo a passo
- 1
Descubra o que o proxy respondeu
Use
curl -v -xcom a linha do seu proxy, ou o verificador, para ver se a resposta ao CONNECT é 407 ou 502. - 2
407: forneça as credenciais corretamente
Na automação, use o recurso de autenticação da biblioteca em vez de colocar usuário:senha dentro de
--proxy-server. - 3
502: teste um destino diferente
Abra um site grande e estável como example.com usando o mesmo proxy. Se ele carregar, o problema é o site original.
- 4
Confirme o IP de saída
Quando o túnel abrir, acesse meu IP no mesmo navegador para confirmar que o tráfego realmente passa pelo proxy.
Perguntas frequentes
Por que páginas http:// funcionam e páginas https:// falham?
Requisições HTTP comuns são encaminhadas diretamente e não precisam de CONNECT. Apenas o HTTPS solicita um túnel, portanto o erro de túnel só ocorre em páginas HTTPS.
O que causa o ERR_TUNNEL_CONNECTION_FAILED no Android?
Geralmente um aplicativo que não consegue enviar o nome de usuário e a senha para um proxy Wi-Fi. Abra a mesma página no Chrome para Android: se o Chrome solicitar o login e carregar o site, a falha é do aplicativo.
As credenciais podem ficar dentro de --proxy-server?
Não. O Chrome as descarta, o proxy responde 407 e você recebe o erro de túnel. Em vez disso, faça a autenticação pelo Puppeteer, Playwright ou por uma extensão.
Qual tipo de proxy devo escolher para evitar isso?
Combine o tipo com o seu pedido: escolha HTTP na sua ferramenta para pedidos HTTP ou de modo duplo (o erro de túnel só ocorre com HTTP), ou SOCKS5 para pedidos SOCKS5, e insira os dados de acesso na opção de autenticação da ferramenta.
Criado para scripts de automação
Os proxies ProxyV4 utilizam autenticação direta por usuário:senha aceita pelo Puppeteer e Playwright sem truques.
Ver preços em tempo real