본문으로 바로 가기

문서

게이트웨이는 하나, 네트워크는 셋, IP는 전부 대한민국에 있습니다. 도시와 세션은 사용자명에 적어 지정하고, 나머지는 지금 쓰는 HTTP 클라이언트 그대로 두면 됩니다.

게이트웨이가 하는 일

ScalarData는 프록시 게이트웨이입니다. 클라이언트가 호스트 하나에 일반 프록시 연결을 열면, 게이트웨이가 요청 조건에 맞는 한국 출구 IP를 골라 그 IP로 요청을 내보냅니다. SDK나 별도 설치는 필요 없습니다. cURL부터 브라우저 자동화 프레임워크까지, HTTP나 SOCKS5 프록시를 지원하는 도구라면 그대로 쓸 수 있습니다.

네트워크, 프로토콜, 도시가 달라도 엔드포인트는 하나입니다. 요청마다 바뀌는 것은 접속 호스트가 아니라 사용자명입니다.

icn-01.gw.scalardata.ai:7777

HTTP, HTTPS(CONNECT), SOCKS5 모두 같은 포트를 씁니다. 프로토콜별 차이는 프로토콜 문서에서 설명합니다.

세 가지 네트워크

프록시 유저를 만들 때 기본 네트워크를 하나 정합니다. 그 유저로 보낸 요청은 사용자명에서 따로 바꾸지 않는 한 기본 네트워크로 나갑니다. 어느 네트워크든 IP는 모두 대한민국에 있습니다. 네트워크마다 다른 것은 IP의 출처이고, 출처에 따라 한국 사이트가 그 IP를 어떻게 대하는지도 달라집니다.

주거용
업스트림 풀에서 공급받는 한국 주거용 출구 IP입니다. 연결마다 로테이션하거나 스티키 세션으로 최대 30분까지 같은 IP를 유지할 수 있고, 도시 단위 타게팅을 지원합니다.
ISP
한국 ISP 명의로 등록된 IP를 서버에서 운영합니다. 요금제를 유지하는 동안 할당된 고정 IP를 계속 쓰고, GB당 요금이 붙지 않습니다.
데이터센터
차단이 까다롭지 않은 사이트에 알맞은 한국 데이터센터 IP입니다. 내 계정 전용으로 쓰고, IP당 비용이 가장 낮습니다.

타게팅은 사용자명에 적습니다

프록시 사용자명은 네트워크 접두어(선택), 계정 식별자, 프록시 유저 이름으로 시작하고, 그 뒤에 필요하면 parameter-value 쌍을 하이픈으로 이어 붙입니다. 같은 키는 한 번만 쓸 수 있습니다. 게이트웨이는 연결마다 사용자명을 새로 읽으므로, 엔드포인트는 그대로 두고 사용자명만 바꿔도 두 요청을 서로 다른 도시로 보내거나 별개의 세션으로 유지할 수 있습니다.

# 계정 = k7f3q2
# 유저 = acme
# 지역 = 대한민국, 서울
# 세션 = "a1b2"로 같은 IP 유지
k7f3q2-acme-country-kr-city-seoul-session-a1b2

cURL에서는 이렇게 씁니다.

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

게이트웨이가 지금 받는 국가 값은 country-kr 하나뿐이고, 도시와 ASN은 대한민국 안에서 후보 IP를 좁히는 역할을 합니다. 파라미터 전체 목록과 규칙은 타게팅 문법 문서에 정리했습니다.

이어서 읽기

  • 빠른 시작

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

  • 결제

    카드와 암호화폐로 결제할 수 있는 상품, 암호화폐 인보이스의 동작 방식, 결제가 반영되지 않을 때의 조치를 설명합니다.

  • 인증

    사용자명·비밀번호 방식과 서버 IP 화이트리스트 방식이 있습니다. 둘 다 프록시 유저 단위로 설정하며, 프록시 유저는 계정당 100개까지 만들 수 있습니다.

  • 타게팅 문법

    국가, 도시, ASN, 세션은 모두 프록시 사용자명에 파라미터로 적습니다. 이 문서에서 전체 문법을 설명합니다.

  • 세션

    연결마다 출구 IP를 새로 받거나, 직접 정한 세션 ID로 IP 하나를 최대 30분까지 유지할 수 있습니다.

  • 프로토콜

    HTTP, HTTPS(CONNECT), SOCKS5를 같은 호스트와 포트에서 지원합니다. 프로토콜별로 TLS와 DNS가 어떻게 처리되는지 설명합니다.

  • API 레퍼런스

    프록시 유저 생성, 사용량 조회, 화이트리스트 관리처럼 대시보드에서 클릭으로 하던 일을 코드로 처리하는 간단한 REST API입니다.

  • 오류

    게이트웨이가 돌려주는 상태 코드별 의미와 흔한 원인, 조치 방법을 정리했습니다.