본문으로 바로 가기

빠른 시작

계정을 만들고 한국 주거용 IP로 첫 요청을 보내기까지 다섯 단계면 충분합니다. 몇 분 걸리지 않습니다.

1. 계정 만들기

이메일 주소로 가입하세요. 새 계정에는 주거용 트래픽에 쓸 수 있는 $3 무료 크레딧이 들어 있고, 결제 메뉴에서 계정을 인증하면 쓸 수 있습니다. 카드로 $1를 결제하면(그 $1는 충전 크레딧으로 들어갑니다) 또는 암호화폐로 $5 이상 결제하면 인증됩니다. 그전에는 게이트웨이가 402 verification_required로 응답합니다.

2. 프록시 유저 만들기

대시보드에서 프록시 유저 메뉴를 열고 새로 하나 만드세요. 짧은 이름을 정하고(이 문서에서는 acme를 씁니다) 기본 네트워크로 주거용을 고르세요. 비밀번호는 대시보드가 16자로 자동 생성하며, 보기를 눌러 복사할 수 있습니다. 클라이언트가 보내는 사용자명은 계정 식별자 뒤에 이 이름을 붙인 값(여기서는 k7f3q2-acme)이고, 비밀번호는 이렇게 생성된 값입니다. 대시보드 로그인 계정은 프록시 트래픽에 쓰이지 않습니다.

프록시 유저는 계정당 100개까지 만들 수 있으니 프로젝트나 환경별로 나누고, 사용량도 각각 따로 확인하세요. 자세한 내용은 인증 문서를 참고하세요.

3. 엔드포인트 복사

네트워크와 프로토콜이 무엇이든 요청은 모두 같은 호스트와 포트로 보냅니다.

icn-01.gw.scalardata.ai:7777

4. 요청 보내기

클라이언트의 프록시를 이 엔드포인트로 설정하고, 사용자명은 계정 식별자와 프록시 유저 이름 뒤에 -country-kr 파라미터를 붙여 한국 IP를 요청합니다. 예시의 계정 식별자(k7f3q2)는 본인 것으로, PASSWORD는 2단계에서 복사한 비밀번호로 바꾸세요.

curl -x icn-01.gw.scalardata.ai:7777 \
  -U "k7f3q2-acme-country-kr:PASSWORD" \
  https://ipinfo.io/json

대부분의 라이브러리와 프레임워크는 proxy 설정이나 HTTPS_PROXY 환경 변수에 http://user:pass@host:port 형식의 프록시 URL을 그대로 받습니다.

5. 출구 IP 확인

ipinfo.io는 요청이 들어온 주소를 알려 줍니다. 요청이 게이트웨이를 거쳤다면 응답에 찍힌 IP는 원래 쓰던 IP가 아니고, 국가 필드는 KR입니다.

{
  "ip": "203.0.113.42",
  "city": "Seoul",
  "region": "Seoul",
  "country": "KR",
  "org": "AS64496 Example Broadband",
  ...
}

두 번 실행해 보세요. 세션 파라미터가 없으면 게이트웨이가 IP를 로테이션하므로 두 번째 응답은 대개 다른 IP에서 옵니다. 요청 사이에 같은 IP를 유지하려면 세션 ID를 붙이면 됩니다. 세션 문서를 참고하세요.

다음 단계

  • 타게팅 문법: 출구 IP를 대한민국 안의 특정 도시나 ASN으로 좁힙니다.
  • 세션: 로그인 과정이나 여러 페이지에 걸친 크롤링 동안 IP 하나를 유지합니다.
  • 프로토콜: SOCKS5를 쓰는 방법과, HTTPS에서 게이트웨이가 볼 수 있는 것과 볼 수 없는 것을 설명합니다.
  • API 레퍼런스: 코드에서 프록시 유저를 만들고 사용량을 조회합니다.