프록시를 통한 SSL WRONG_VERSION_NUMBER 오류: 해결법

SSL: WRONG_VERSION_NUMBER가 무엇을 의미하나요?

TLS는 핸드셰이크 레코드로 시작합니다. 응답이 HTTP라면 TLS 라이브러리는 이상한 버전 번호를 읽고 중단하며, Python은 WRONG_VERSION_NUMBER 오류를 발생합니다; OpenSSL 버전과 클라이언트에 따라 다릅니다.

프록시 URL 스킴이 클라이언트와 프록시 간 통신 방식을 결정합니다. http://는 프록시에 일반 HTTP로 접속하여 CONNECT 터널 후 사이트와 TLS를 진행합니다. https://는 프록시 자체와 TLS로 연결하는 방식이며, 프록시 포트가 이를 지원해야 합니다.

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

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

• Python requests / urllib3 2.x: SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number'))가 ProxyError로 감싸짐
• httpx: httpx.ConnectError: [SSL: WRONG_VERSION_NUMBER] wrong version number
• curl: 일반 프록시에 -x https://를 쓸 때 curl: (35) ... wrong version number
• Node.js: 오류 메시지 내 EPROTO ... wrong version number

SSL: WRONG_VERSION_NUMBER의 원인은 무엇인가요?

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

• 프록시 주소 앞에 https://가 있는 경우(평문 HTTP 포트). 가장 흔한 사례입니다.
• TLS를 요구하는 프록시 포트 제공자의 설정 복사 붙여넣기
• 포트 80에서 https:// 사용하거나 TLS 요구하는 사이트 포트에 http:// 사용, 프록시가 아닌 경우
• 코드가 상속받은 환경 변수 HTTPS_PROXY=https://...

SSL: WRONG_VERSION_NUMBER를 단계별로 진단하는 방법은?

1. 코드가 사용하는 프록시 URL과 스킴 확인
2. 환경 변수 HTTPS_PROXY, ALL_PROXY 점검
3. 아래 curl 테스트에서 -x http://로 정상 동작 확인
4. curl은 작동하는데 코드가 안 된다면 코드나 환경에 https://가 남아 있음

# 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

SSL: WRONG_VERSION_NUMBER를 어떻게 고치나요?

• 프록시 URL에 http:// 사용: 모든 키에 {"http": "http://...", "https": "http://..."}
• TLS 검증은 켠 상태 유지: 문제는 스킴이며 verify=False가 아님
• 환경 변수 수정: 스크립트 내에서 덮어쓰기보다 환경 변수 정리가 필요

SSL: WRONG_VERSION_NUMBER 이후에 다시 시도해야 하나요?

이 오류는 재시도하지 마세요: 시도 때마다 동일한 실패입니다. 한 글자만 수정하면 해결되는 구성 오류입니다.

SSL: WRONG_VERSION_NUMBER가 CrawlRelay에 어떻게 적용되나요?

CrawlRelay의 HTTP 포트는 HTTPS 사이트를 CONNECT 터널로 전달하는 평문 HTTP 프록시 포트입니다. TLS는 터널 내부에서 클라이언트와 사이트 간 종단 간 암호화로 이루어지므로 게이트웨이에는 https:// 프록시 URL이 필요 없습니다.

게이트웨이: gw.crawlrelay.com, 포트 7777 (CONNECT를 통한 HTTP, HTTPS) 및 포트 7778 (SOCKS5). 사용자 이름 형식: USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}. 관련: SSL 인증서 검증 실패 · 프록시 연결 불가](/docs/errors/cannot-connect-to-proxy/) · Python 가이드](/docs/python/).