# 스크래퍼용 프록시 오류 참고

> 스크래퍼용 프록시 오류 참고: 407, 403, 429, 502, 503, 504, 터널, TLS, 타임아웃, SOCKS5 오류, 누가 보내는지와 해결 방법

- URL: https://crawlrelay.com/ko/docs/errors/
- 마지막 업데이트: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

모든 페이지는 오류를 보낸 주체, 도구 내 에러 모양, 발생 원인, 재시도가 도움이 되는지 네 가지 질문에 답합니다.

**빠른 답변 — 프록시 요청 실패 원인은 어떻게 확인하나요?**

먼저 **누가** 응답했는지 파악하세요: 프록시 게이트웨이(407, CONNECT 실패, 일부 502 및 504), 웹사이트(401, 403, 429, 대부분 503), 또는 본인의 클라이언트(TLS 및 타임아웃 오류). 그런 다음 아래 페이지에서 정확한 메시지와 일치하는 항목을 찾으세요. 이 참고자료는 15 오류들을 다루며, 스크래퍼가 **CrawlRelay** 레지덴셜 프록시 또는 모든 HTTP 또는 SOCKS5 프록시와 함께 만나는 문제와 각각에 대한 해결 코드를 제공합니다.

## 어떤 오류를 보고 있나요?

증상을 찾아 전체 진단을 위해 해당 페이지를 열어보세요.

| 증상 | 전송 주체 | 재시도? | 페이지 |
| --- | --- | --- | --- |
| `407`, '터널 연결 실패: 407' | 프록시 | 아니요 | [407 프록시 인증 필요](https://crawlrelay.com/ko/docs/errors/407-proxy-authentication-required/) |
| `401`, `WWW-Authenticate`와 함께 발생 | 웹사이트 | 아니요 | [401 vs 407](https://crawlrelay.com/ko/docs/errors/401-unauthorized/) |
| `403` 페이지 또는 방화벽 메시지 | 웹사이트 | 한 번만, 그 후 중지 | [403 금지됨](https://crawlrelay.com/ko/docs/errors/403-forbidden/) |
| `429`, 종종 `Retry-After`와 함께 발생 | 웹사이트 | 예, 나중에 재시도 | [429 요청 과다](https://crawlrelay.com/ko/docs/errors/429-too-many-requests/) |
| `502`, 'CONNECT 터널 실패, 응답 502' | 프록시 또는 CDN | 예, 새 출구 IP로 재시도 | [502 잘못된 게이트웨이](https://crawlrelay.com/ko/docs/errors/502-bad-gateway/) |
| `503`, 점검 또는 챌린지 페이지 | 웹사이트 또는 CDN | 예, 지연 후 재시도 | [503 서비스 사용 불가](https://crawlrelay.com/ko/docs/errors/503-service-unavailable/) |
| `504` | 프록시 또는 CDN | 한두 번 재시도 | [504 게이트웨이 타임아웃](https://crawlrelay.com/ko/docs/errors/504-gateway-timeout/) |
| `net::ERR_TUNNEL_CONNECTION_FAILED` | 브라우저(프록시가 CONNECT 거부) | 원인 해결 후 시도 | [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/ko/docs/errors/err-tunnel-connection-failed/) |
| `net::ERR_PROXY_CONNECTION_FAILED` | 브라우저(프록시 접속 불가) | 아니요 | [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/ko/docs/errors/err-proxy-connection-failed/) |
| `ProxyError: Unable to connect to proxy` | Python 클라이언트 | 원인에 따라 다름 | [프록시 연결 불가](https://crawlrelay.com/ko/docs/errors/cannot-connect-to-proxy/) |
| `[SSL: WRONG_VERSION_NUMBER]` | 귀하의 TLS 라이브러리 | 아니요 | [SSL: 잘못된_버전_번호](https://crawlrelay.com/ko/docs/errors/ssl-wrong-version-number/) |
| `CERTIFICATE_VERIFY_FAILED` | 귀하의 TLS 라이브러리 | 아니요 | [인증서 검증 실패](https://crawlrelay.com/ko/docs/errors/ssl-certificate-verify-failed/) |
| `ReadTimeout`, '읽기 시간 초과' | 귀하의 클라이언트 | 예, 새 출구 IP로 재시도 | [읽기 시간 초과](https://crawlrelay.com/ko/docs/errors/read-timeout/) |
| `ECONNRESET`, '소켓 연결 종료', '피어에 의한 연결 재설정' | 네트워크 | 예, 안전한 요청입니다 | [연결 재설정](https://crawlrelay.com/ko/docs/errors/connection-reset/) |
| 'SOCKS 지원에 필요한 종속성 누락', curl 오류 97 | 클라이언트 또는 SOCKS 서버 | 상황에 따라 다름 | [SOCKS5 오류](https://crawlrelay.com/ko/docs/errors/socks5-proxy-errors/) |

## 오류 유형별 전체 목록

- [401 Unauthorized vs 407](https://crawlrelay.com/ko/docs/errors/401-unauthorized/)
- [403 Forbidden](https://crawlrelay.com/ko/docs/errors/403-forbidden/)
- [407 Proxy Authentication Required](https://crawlrelay.com/ko/docs/errors/407-proxy-authentication-required/)
- [429 Too Many Requests](https://crawlrelay.com/ko/docs/errors/429-too-many-requests/)
- [502 Bad Gateway](https://crawlrelay.com/ko/docs/errors/502-bad-gateway/)
- [503 Service Unavailable](https://crawlrelay.com/ko/docs/errors/503-service-unavailable/)
- [504 Gateway Timeout](https://crawlrelay.com/ko/docs/errors/504-gateway-timeout/)
- [Cannot connect to proxy (ProxyError)](https://crawlrelay.com/ko/docs/errors/cannot-connect-to-proxy/)
- [Connection reset by peer (ECONNRESET)](https://crawlrelay.com/ko/docs/errors/connection-reset/)
- [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/ko/docs/errors/err-proxy-connection-failed/)
- [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/ko/docs/errors/err-tunnel-connection-failed/)
- [Read timed out (ReadTimeout)](https://crawlrelay.com/ko/docs/errors/read-timeout/)
- [SOCKS5 proxy errors](https://crawlrelay.com/ko/docs/errors/socks5-proxy-errors/)
- [SSL: CERTIFICATE_VERIFY_FAILED](https://crawlrelay.com/ko/docs/errors/ssl-certificate-verify-failed/)
- [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/ko/docs/errors/ssl-wrong-version-number/)

## 스크레이퍼가 자동으로 재시도해야 하는 오류는 무엇인가요?

변경될 수 있는 것은 재시도하고, 변경 불가능한 것은 중단하세요:

- **새 연결로 재시도:** 502, 504, 연결 재설정 및 읽기 시간 초과. 새 연결은 보통 다른 레지덴셜 프록시 출구를 가집니다.
- **나중에, 느리게 재시도:** 429 및 503. `Retry-After` 동안 대기하거나 지터와 함께 지수적으로 백오프하고 해당 호스트에서 동시성을 줄이세요.
- **한 번만 재시도 후 중단:** 403. 새로운 IP에서 한 번 재시도하면 차단된 주소와 사이트 규칙을 구분할 수 있습니다.
- **무분별한 재시도 금지:** 407, 401, TLS 오류 및 도달 불가능한 프록시. 이들은 설정 문제입니다.

[Python 가이드](https://crawlrelay.com/ko/docs/python/)에서는 urllib3의 `Retry`를 이용해 이 규칙에 따른 재시도 정책을 보여줍니다.

## 어떻게 오류 로그를 쉽게 디버깅할 수 있게 기록하나요?

실패한 요청마다 다섯 가지 필드를 기록하세요: URL 호스트, 상태 코드 또는 예외 클래스, 세션 ID가 있다면, 첫 바이트 수신 시간, 그리고 응답 본문 첫 200자. 본문으로 CDN, 방화벽 또는 프록시가 오류 페이지를 작성했는지 알 수 있습니다. 매 분 호스트 및 상태별 오류를 집계하세요: 한 호스트에서 급증하면 그 사이트가 변경된 것이고, 모든 호스트에서 급증하면 설정이나 네트워크 문제입니다.

## 오류 참조: 질문들

### 오류가 프록시에서 온 것인지 웹사이트에서 온 것인지 어떻게 구분하나요?

어디에서 발생했는지 보세요. curl `-v`으로 표시되는 CONNECT 단계에서의 오류는 TLS 핸드셰이크 전이며 프록시에서 발생합니다: 407, 또는 CONNECT 시 502나 504. TLS 핸드셰이크 후 사이트 헤더와 HTML이 포함된 상태 코드는 웹사이트에서 온 것입니다. 타임아웃이나 TLS 실패 같은 클라이언트 오류는 자신의 코드나 네트워크 문제입니다.

### 실패한 요청도 청구되나요?

트래픽은 게이트웨이를 통해 이동한 바이트 단위로 계산하므로, 407 같은 웹사이트에 도달하지 못한 오류 응답은 거의 트래픽이 발생하지 않습니다. 웹사이트의 차단 페이지는 정상 응답이며 다른 페이지와 크기가 비슷합니다. 설정 오류를 초기에 수정하고 403 및 429에서 속도를 줄이세요.

### 레지덴셜 프록시를 사용할 때 정상적인 오류율은 얼마인가요?

대상에 따라 다릅니다. Proxyway의 2026년 연구는 레지덴셜 프록시 네트워크에서 성공률 중위값이 99.28%였고, Amazon, Google, Instagram 같은 보호된 실제 대상에서는 74.43%였습니다. 자신만의 대상을 측정하고 시간 경과에 따른 비율 변화를 추적하세요: 갑작스러운 변화가 절대 숫자보다 더 중요합니다.

---

CrawlRelay: CrawlRelay는 개발자 중심의 회전형 레지덴셜 프록시 및 4G/5G 모바일 프록시 서비스로, 스크래퍼와 AI 데이터 파이프라인을 위한 비만료 선불 과금 트래픽을 US$0.50/GB부터 암호화폐로 결제하며 신분증 업로드가 없습니다. KYC 없이 — 신분증, 셀카, 문서 없이 이용 가능. 암호화폐로 결제하세요.
