콘텐츠로 이동
로그인 가입하기

문제 해결

작동하지 않는 부분이 있습니까? 대부분의 문제는 아래 여덟 가지 패턴 중 하나에 해당합니다. 일치하는 증상을 찾아 진단을 따르고 해결책을 적용하세요.

게이트웨이에서 연결이 거부되거나 시간 초과됨

섹션 제목: “게이트웨이에서 연결이 거부되거나 시간 초과됨”

증상: p.shifter.io:443을 호출할 때 클라이언트가 “connection refused”, “connection timed out”, 또는 “no route to host”를 보고합니다.

진단:

  1. 새 게이트웨이인 p.shifter.io:443을 가리키고 있는지 확인하세요. 레거시 플랜은 apollo.p.shifter.io:<port>와 같은 포트별 서브도메인을 사용합니다.
  2. 소스 IP가 아웃바운드 443을 차단하는 방화벽 뒤에 있지 않은지 확인하세요.
  3. 원시 연결을 테스트하세요: nc -vz p.shifter.io 443.

해결책: 원시 연결은 작동하지만 프록시가 실패하는 경우, 문제는 인증입니다. 아래 407 섹션을 참조하세요. 원시 연결이 실패하는 경우, 이그레스 방화벽 규칙을 확인하고 다른 네트워크에서 다시 시도하세요.

HTTP 407 Proxy Authentication Required

섹션 제목: “HTTP 407 Proxy Authentication Required”

증상: 모든 요청이 407 Proxy Authentication Required를 반환합니다.

진단:

  • 잘못된 자격 증명: 사용자 이름이나 비밀번호의 오타.
  • 알 수 없는 플래그: 확장 사용자 이름에 잘못된 국가 코드, 도시 슬러그, 또는 세션 문자열.
  • 비밀번호 재발급: 패널에서 로테이션 후 이전 비밀번호가 더 이상 유효하지 않음. 해결책:
  1. 모든 플래그를 제거하고 먼저 순수 사용자 이름과 비밀번호로 다시 시도하세요. 이것이 작동하면 플래그를 하나씩 다시 추가하세요.
  2. shifter.io/panel의 Residential Proxies 항목에서 비밀번호를 확인하세요.
  3. 최근에 비밀번호를 재발급했다면, 새 값을 모든 클라이언트에 적용하세요.

레지덴셜 IP의 응답 속도가 느림

섹션 제목: “레지덴셜 IP의 응답 속도가 느림”

증상: 요청에 5-10초 이상 걸립니다. 이전에는 빨랐던 IP가 느려졌습니다.

진단: 레지덴셜 IP는 실제 ISP 연결에서 제공됩니다. 어느 정도의 지연 시간 변동은 정상입니다. 지속적인 느림은 보통 다음을 의미합니다:

  • 해당 IP의 최종 사용자가 연결을 많이 사용 중임(Netflix, 대용량 업로드).
  • 대상 사이트가 해당 IP를 제한(throttling)하고 있음.
  • 풀 필터가 너무 좁아서 처리 지연된 IP를 받고 있음.

해결책:

  • 더 적극적으로 로테이션하세요(고정 세션을 해제하거나 ttl을 단축).
  • 필터 범위를 넓히세요(도시를 제거하고 국가만 유지).
  • ISP 프록시의 경우: Managing IPs → Replace를 사용하여 느린 IP를 새 IP로 교체하세요.

IP 지리적 위치가 대상과 일치하지 않음

섹션 제목: “IP 지리적 위치가 대상과 일치하지 않음”

증상: country-us-city-new_york을 요청했는데 대상 사이트는 다른 곳으로 인식합니다.

진단:

  • 레지덴셜 IP는 타사 데이터베이스(MaxMind, IP2Location)로 지리적 위치가 지정됩니다. 이러한 데이터베이스는 대상 사이트 자체의 지리적 위치 소스와 항상 일치하지는 않습니다.
  • 모바일 통신사 IP와 신규 할당된 ISP 범위는 몇 주 동안 잘못 분류될 수 있습니다.

해결책:

  • 요청을 다시 시도하세요. Shifter는 모든 요청마다(또는 고정 세션마다) 새 IP를 할당하며, 다음 IP가 대상의 데이터베이스에서 더 정확한 지리적 위치를 가질 수 있습니다.
  • 특정 대상에 대해 보장된 지리적 위치가 필요한 경우, 대상 URL과 원하는 위치를 명시하여 지원팀에 문의하세요. 해당 대상에 대해 IP를 사전 검증해 드릴 수 있습니다.

HTTPS 오류, SSL/TLS 실패

섹션 제목: “HTTPS 오류, SSL/TLS 실패”

증상: SSL handshake failed, certificate verify failed, 또는 tls: bad record MAC.

진단:

  • 게이트웨이의 암호 스위트(cipher suite)를 거부하는 오래된 OpenSSL 또는 Node 버전을 사용 중입니다.
  • 기업용 프록시의 신뢰 체인(chain-of-trust)이 손상되었습니다.

해결책:

  • 클라이언트의 TLS 라이브러리를 업데이트하세요. Node 18+, Python requests 2.28+, curl 7.80+가 정상 작동하는 것으로 확인되었습니다.
  • 환경에서 엄격한 호스트가 필요한 경우 체인 문제를 우회하기 위해 게이트웨이 인증서를 고정(pin)하세요.
  • 디버깅 전용: curl의 --proxy-insecure는 프록시 구간의 인증서 검증을 비활성화합니다. 이 플래그를 프로덕션에는 절대 사용하지 마세요.

대상 사이트가 여전히 차단함

섹션 제목: “대상 사이트가 여전히 차단함”

증상: 로테이션이 적용된 레지덴셜 프록시를 사용해도 특정 대상이 CAPTCHA, 403, 또는 빈 응답 본문을 반환합니다.

진단: 대상 사이트가 IP를 넘어서는 지문(fingerprint)을 수집하는 계층화된 안티봇(Cloudflare, Akamai, DataDome)을 사용하고 있습니다. 흔한 징후:

  • User-Agent가 TLS 지문과 일치하지 않음(JA3/JA4 불일치).
  • 헤더가 실제 브라우저와 다른 순서로 전송됨.
  • 브라우저 API(WebDriver 탐지, navigator.webdriver 플래그)가 자동화를 노출함.
  • IP 로테이션이 대상의 세션 모델에 비해 너무 공격적임.

해결책:

  • 원시 프록시 대신 스텔스 모드와 CAPTCHA 해결 기능이 포함된 Web Scraping API로 전환하세요.
  • 또는: 대상 URL을 포함하여 티켓을 개설하세요. 많은 경우 저희 쪽에서 조정 가능합니다.

Web Scraping API가 509 Bandwidth Limit Exceeded를 반환함

섹션 제목: “Web Scraping API가 509 Bandwidth Limit Exceeded를 반환함”

증상: 플랜에 크레딧이 남아 있음에도 불구하고 Scraping API가 509를 반환합니다.

진단: 509는 플랜 할당량이 소진되었음을 의미합니다. 대시보드에 크레딧이 남아 있다면 다음을 확인하세요:

  • 올바른 API 키(이전 플랜의 키가 아닌)를 사용 중인지.
  • 초과분을 종량제로 전환하려는 경우 Extra Traffic이 활성화되어 있는지.

해결책:

  • Web Scraping API → API Keys에서 키가 활성 플랜과 일치하는지 확인하세요.
  • Billing → Extra Traffic을 활성화하여 초과분을 크레딧당 요금으로 자동 전환하세요.
  • 정기적으로 한도가 소진된다면 플랜을 업그레이드하세요.

결제가 실패했거나 구독이 활성화되지 않음

섹션 제목: “결제가 실패했거나 구독이 활성화되지 않음”

증상: 결제했지만 플랜이 비활성 상태로 표시되거나 갱신이 조용히 실패했습니다.

진단:

  • 카드 발급사가 거래를 차단함(국제 카드 미제시 거래에서 흔함).
  • 카드가 만료되었거나 3DS 인증이 완료되지 않음.
  • 암호화폐 결제가 아직 확인되지 않음(6회 확인 필요).

해결책:

  1. 은행 앱에서 카드의 거래 내역을 확인하세요. 결제가 거부된 경우, 다른 카드로 다시 시도하세요.
  2. 암호화폐의 경우, 결제는 처리업체가 블록체인 6회 확인 시 감지합니다. BTC/ETH의 경우 보통 15-60분 소요됩니다.
  3. 결제가 완료되었지만 30분 후에도 플랜이 여전히 비활성 상태라면, 청구서 ID를 첨부하여 hi@shifter.io로 이메일을 보내세요.

See also

섹션 제목: “See also”