문서
게이트웨이는 하나, 네트워크는 셋, IP는 전부 대한민국에 있습니다. 도시와 세션은 사용자명에 적어 지정하고, 나머지는 지금 쓰는 HTTP 클라이언트 그대로 두면 됩니다.
게이트웨이가 하는 일
ScalarData는 프록시 게이트웨이입니다. 클라이언트가 호스트 하나에 일반 프록시 연결을 열면, 게이트웨이가 요청 조건에 맞는 한국 출구 IP를 골라 그 IP로 요청을 내보냅니다. SDK나 별도 설치는 필요 없습니다. cURL부터 브라우저 자동화 프레임워크까지, HTTP나 SOCKS5 프록시를 지원하는 도구라면 그대로 쓸 수 있습니다.
네트워크, 프로토콜, 도시가 달라도 엔드포인트는 하나입니다. 요청마다 바뀌는 것은 접속 호스트가 아니라 사용자명입니다.
icn-01.gw.scalardata.ai:7777HTTP, HTTPS(CONNECT), SOCKS5 모두 같은 포트를 씁니다. 프로토콜별 차이는 프로토콜 문서에서 설명합니다.
세 가지 네트워크
프록시 유저를 만들 때 기본 네트워크를 하나 정합니다. 그 유저로 보낸 요청은 사용자명에서 따로 바꾸지 않는 한 기본 네트워크로 나갑니다. 어느 네트워크든 IP는 모두 대한민국에 있습니다. 네트워크마다 다른 것은 IP의 출처이고, 출처에 따라 한국 사이트가 그 IP를 어떻게 대하는지도 달라집니다.
타게팅은 사용자명에 적습니다
프록시 사용자명은 네트워크 접두어(선택), 계정 식별자, 프록시 유저 이름으로 시작하고, 그 뒤에 필요하면 parameter-value 쌍을 하이픈으로 이어 붙입니다. 같은 키는 한 번만 쓸 수 있습니다. 게이트웨이는 연결마다 사용자명을 새로 읽으므로, 엔드포인트는 그대로 두고 사용자명만 바꿔도 두 요청을 서로 다른 도시로 보내거나 별개의 세션으로 유지할 수 있습니다.
# 계정 = k7f3q2
# 유저 = acme
# 지역 = 대한민국, 서울
# 세션 = "a1b2"로 같은 IP 유지
k7f3q2-acme-country-kr-city-seoul-session-a1b2cURL에서는 이렇게 씁니다.
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입니다.
- 오류
게이트웨이가 돌려주는 상태 코드별 의미와 흔한 원인, 조치 방법을 정리했습니다.