ERR_TUNNEL_CONNECTION_FAILED의 이면: 프록시의 CONNECT 응답 확인하기
Updated:
ERR_TUNNEL_CONNECTION_FAILED는 Chrome이 https:// 페이지 접속을 위해 프록시에 터널 생성을 요청했으나 프록시가 이를 거부할 때 발생합니다. Chrome은 CONNECT 요청을 보내고 승인을 기다리지만 대신 오류 상태 코드를 받게 됩니다. 문제는 Chrome이 이 상태 코드를 숨기기 때문에, 숨겨진 실제 코드를 확인하는 것이 가장 우선입니다.
발생 가능한 원인 순위
- 스크립트가 인증 정보 없이 Chrome을 실행한 경우.
--proxy-server플래그는 호스트와 포트만 전달하며, 여기에 입력된 user:pass는 무시됩니다. 그 결과 헤드리스 모드의 Puppeteer나 Selenium이 407 응답을 받아 터널 실패로 보고합니다. - 비밀번호가 필요한 Wi-Fi 프록시 환경의 앱. 앱에는 로그인 입력창이 뜨지 않으므로, 스마트폰 브라우저는 정상 작동하더라도 앱의 HTTPS 요청은 실패합니다.
- 프록시가 대상 서버에 연결할 수 없는 경우. CONNECT 요청에 502로 응답합니다. 자세한 내용은 502 Bad Gateway 페이지를 참고하세요.
- 특정 사이트만 접속에 실패하는 경우. 동일한 프록시로 다른 사이트는 문제없이 접속되지만, 대상 사이트가 다운되었거나 연결을 거부하는 상태입니다.
테스트 결과
테스트 프록시(203.0.113.10:8080, 로그인 정보 user123:pass456)에서 두 가지 일반적인 사례를 재현했습니다. 표의 각 상황에서 Chrome은 동일한 메시지를 표시하므로, 해당 에러 메시지만으로는 원인을 파악하기 어렵습니다.
| 프록시의 CONNECT 응답 | Chrome | curl |
|---|---|---|
407, 비밀번호를 입력할 수 없음(헤드리스 Chrome) | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 407 |
502, 프록시가 사이트에 연결할 수 없음 | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 502 |
숨겨진 상태 코드 확인하기
보유한 프록시 정보를 입력하여 curl -v -x http://user123:[email protected]:8080 https://example.com 명령어를 실행한 뒤, > CONNECT example.com:443 HTTP/1.1 뒤에 이어지는 응답을 확인하세요. 407인 경우 407 가이드를 참조하세요. 502는 대상 서버나 프록시 이후의 네트워크 경로에 문제가 있음을 나타냅니다.
터미널을 사용하지 않으려면 프록시 체커를 이용하세요. 동일한 두 상황을 auth failed (407) 및 HTTP 502로 표시해 줍니다.
일반적인 GUI 환경의 Chrome 창은 407을 다르게 처리합니다. 터널 오류 대신 프록시 사용자 이름과 비밀번호를 입력하는 로그인 창이 표시됩니다. 이 때문에 407로 인한 터널 오류는 주로 자동화 환경이나 입력창을 띄울 수 없는 앱에서 발생합니다.
환경별 해결 방법
- Puppeteer:
--proxy-server=http://host:port옵션으로 실행한 뒤, 첫 탐색 전에page.authenticate({ username, password })를 호출하세요. 전체 예제는 Puppeteer 프록시 가이드에서 확인할 수 있습니다. - Playwright: 실행 옵션에
proxy: { server, username, password }를 지정하세요. Playwright가 자동으로 407 응답을 처리합니다. 자세한 내용은 Playwright 설정을 참고하세요. - Selenium: Chrome 명령줄에서는 user:pass를 지원하지 않습니다. 작동 가능한 해결 방법은 Selenium 가이드에 안내되어 있습니다.
- Windows용 데스크톱 Chrome: 로그인 창이 나타나지 않는다면 확장 프로그램이 이를 차단하고 있을 수 있습니다. 확장 프로그램을 사용 중지한 창에서 다시 시도해 보세요.
- 스마트폰: 인증이 필요한 프록시를 사용하는 앱은 Android 설정 가이드에 설명된 대로 user:pass를 지원하는 프록시 앱을 통해 사용하는 것이 가장 안정적입니다.
단계별 안내
- 1
프록시 응답 코드 확인하기
프록시 정보를 사용해
curl -v -x명령어를 실행하거나 체커를 사용하여 CONNECT에 대한 응답이 407인지 502인지 확인합니다. - 2
407: 인증 정보를 올바르게 전달하기
자동화 환경에서는
--proxy-server내에 user:pass를 넣지 말고, 해당 라이브러리의 인증 기능을 사용하세요. - 3
502: 다른 대상 사이트 테스트하기
동일한 프록시를 통해 example.com과 같이 규모가 크고 안정적인 사이트에 접속해 보세요. 정상 로드된다면 기존 대상 사이트에 문제가 있는 것입니다.
- 4
출구 IP 확인하기
터널이 열리면 해당 브라우저에서 내 IP 확인을 열어 트래픽이 프록시를 통해 정상적으로 나가는지 확인합니다.
자주 묻는 질문
http:// 페이지는 접속되는데 https:// 페이지는 왜 실패하나요?
일반 HTTP 요청은 CONNECT 없이 바로 전달됩니다. 터널 생성을 요청하는 것은 HTTPS뿐이므로, 터널 오류는 HTTPS 페이지에서만 발생합니다.
Android에서 ERR_TUNNEL_CONNECTION_FAILED가 발생하는 원인은 무엇인가요?
주로 앱에서 Wi-Fi 프록시로 사용자 이름과 비밀번호를 전달하지 못하기 때문입니다. Android용 Chrome에서 동일한 페이지를 열어보세요. Chrome에서 로그인 창이 뜨고 정상 로드된다면 앱 자체의 문제입니다.
--proxy-server 안에 인증 정보를 넣을 수 있나요?
불가능합니다. Chrome이 이를 삭제하여 프록시가 407로 응답하고 터널 오류가 발생합니다. 대신 Puppeteer, Playwright 또는 확장 프로그램을 통해 인증하세요.
이 오류를 방지하려면 어떤 프록시 유형을 선택해야 하나요?
구매한 주문 유형에 맞추세요. HTTP 또는 듀얼 모드 주문의 경우 도구에서 HTTP를 선택하고(터널 오류는 HTTP에서만 발생함), SOCKS5 주문의 경우 SOCKS5를 선택한 뒤 도구의 인증 설정을 통해 로그인 정보를 전달하세요.
자동화 스크립트에 최적화된 프록시
ProxyV4 프록시는 Puppeteer와 Playwright에서 별도의 우회 작업 없이 바로 사용할 수 있는 일반 user:pass 인증을 지원합니다.
실시간 요금 확인