프록시와 함께 net::ERR_TUNNEL_CONNECTION_FAILED 발생 원인 및 해결법

ERR_TUNNEL_CONNECTION_FAILED가 무엇을 의미하나요?

HTTP 프록시를 통해 HTTPS 페이지를 로드하려면 브라우저가 먼저 CONNECT host:443을 보냅니다. 프록시가 200으로 응답하면 터널 내부에서 TLS가 시작됩니다. 407, 403, 502 등 다른 응답은 시도를 종료하며 Chromium은 일반적인 오류를 보고합니다.

이 오류는 실패 위치가 터널임을 알려주나 이유는 알리지 않습니다. 이유는 프록시가 보낸 상태 코드이며 curl로 확인할 수 있습니다.

Python, curl, Node.js, 브라우저에서 ERR_TUNNEL_CONNECTION_FAILED는 어떻게 나타나나요?

같은 실패가 도구마다 다르게 출력됩니다. 로그에서 검색할 메시지들:

• Playwright: page.goto: net::ERR_TUNNEL_CONNECTION_FAILED at https://...
• Puppeteer: Error: net::ERR_TUNNEL_CONNECTION_FAILED at https://...
• Chrome 주소 표시줄: '이 사이트에 연결할 수 없음'이며 코드 ERR_TUNNEL_CONNECTION_FAILED가 표시됨
• Chrome에서 Selenium: WebDriverException 내 같은 코드

ERR_TUNNEL_CONNECTION_FAILED의 원인은 무엇인가요?

가장 가능성 높은 첫 번째 원인:

• 자격 증명 전송 안 됨 (숨은 407). Chrome은 --proxy-server 안에 있는 사용자 이름과 비밀번호를 무시합니다.
• 거부된 대상 (숨은 403), 예를 들어 프록시 사용 정책에 의해 차단된 카테고리.
• 도달 불가능한 대상 (숨은 502 또는 504): 죽은 호스트, 오타 또는 출구에서의 DNS 실패.
• 잘못된 포트: 브라우저에서 SOCKS5 포트를 HTTP인 것처럼 가리키거나 그 반대의 경우.

ERR_TUNNEL_CONNECTION_FAILED를 단계별로 진단하는 방법은?

1. 동일한 URL을 -v로 curl 실행(아래 명령 참고)하고, CONNECT 다음 줄을 확인하세요.
2. 407는 자격 증명 문제, 403은 거부된 대상, 502 또는 504는 대상 또는 출구 문제를 의미합니다.
3. http:// 프록시 서버에 HTTP 포트를 사용하는지 확인하세요.
4. 실제 대상 전에 https://api.ipify.org 같은 간단한 페이지를 테스트하세요.

# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:[email protected]:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL

ERR_TUNNEL_CONNECTION_FAILED를 어떻게 고치나요?

• Playwright: 브라우저나 컨텍스트별로 proxy 옵션에 server, username, password 전달. Playwright 가이드 참고.
• Puppeteer: --proxy-server=http://host:port 옵션으로 실행하고 첫 goto 전에 page.authenticate() 호출. Puppeteer 가이드 참고.
• Selenium: 자격 증명을 추가하는 작은 로컬 포워더 실행. Selenium 가이드 참고.
• 대상을 허용 사용 정책에 맞게 확인하세요.

ERR_TUNNEL_CONNECTION_FAILED 이후에 다시 시도해야 하나요?

숨은 상태를 알 때만 재시도하세요. 숨은 407이나 403은 무한 반복되니 설정을 수정해야 합니다. 숨은 502나 504는 게이트웨이 오류처럼 새 출구에서 재시도할 수 있습니다.

ERR_TUNNEL_CONNECTION_FAILED가 CrawlRelay에 어떻게 적용되나요?

CrawlRelay의 HTTP 포트는 CONNECT 터널을 통해 HTTPS를 전달하며, 모든 Chromium 기반 도구가 지원합니다. 브라우저에는 HTTP 포트를 사용하세요: Chromium은 사용자 이름과 비밀번호가 있는 SOCKS5를 지원하지 않습니다.

게이트웨이: gw.crawlrelay.com, 포트 7777 (CONNECT를 통한 HTTP, HTTPS) 및 포트 7778 (SOCKS5). 사용자 이름 형식: USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}. 관련: 407 Proxy Authentication Required · ERR_PROXY_CONNECTION_FAILED · Playwright 가이드.