메인 콘텐츠로 건너뛰기
본 문서는 Ace Data Cloud 글로벌 에이전트의 연동 설명을 주로 다루며, 신청 방법, 사용 방법 등 구체적인 내용을 포함합니다.

신청 방법

글로벌 서비스를 사용하려면 먼저「신청 페이지」에서 신청할 수 있으며, 첫 신청 시 1 포인트 무료 한도가 제공됩니다. 로그인하지 않은 경우 자동으로 로그인 페이지로 이동하며, 로그인 후 계속 신청하면 됩니다.

사용 방법

신청이 완료된 후, 「콘솔」에서 본인의 신청 결과를 확인할 수 있습니다. 아래 그림과 같습니다: 「Credentials」를 클릭하면 글로벌 에이전트 서비스의 사용자 이름과 비밀번호를 확인할 수 있으며, 콜론으로 구분되어 있습니다. 사용자 이름은 8자리, 비밀번호는 32자리입니다. 아래 그림과 같습니다: 이 에이전트는 회전 프록시(Rotating Proxy)로, 사용 시 고정된 프록시 주소와 포트만 설정하면 됩니다. 프록시의 주소와 포트는 각각 global.proxy.acedata.cloud30007입니다. 이 프록시는 HTTP/HTTPS/SOCKS 프로토콜의 프록시로, HTTP 및 HTTPS 프로토콜 웹사이트 요청에 사용할 수 있습니다.
주의: 이 프록시는 중국 외부 네트워크 환경에서만 사용 가능합니다. 중국 본토 지역에서는 사용할 수 없습니다.

명령 테스트

프록시의 사용자 이름과 비밀번호를 얻은 후, 가장 간편한 방법은 curl 명령어를 통해 테스트하는 것입니다. 설치하지 않은 경우 https://curl.se/를 참조하여 설치하면 됩니다. 현재 프록시의 사용자 이름과 비밀번호가 1f78266a:eff0896726224fa2a99fe82dd1f07562라고 가정할 때, 다음과 같은 curl 명령어로 테스트할 수 있습니다:
curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io
여기서 curl의 -x 매개변수를 사용하여 프록시 주소를 지정했습니다. 프록시 프로토콜은 기본적으로 HTTP/HTTPS이며, 요청하는 URL은 https://ipinfo.io입니다. 이 사이트는 요청한 사이트의 실제 IP 주소와 IP가 위치한 지역을 반환합니다.
주의: 위의 사용자 이름과 비밀번호는 무효할 수 있으니, 본인의 사용자 이름과 비밀번호로 교체하시기 바랍니다.
실행 결과는 다음과 같습니다:
{
  "ip": "66.206.249.77",
  "hostname": "host-66-206-249-77.public.eastlink.ca",
  "city": "Kirkland Lake",
  "region": "Ontario",
  "country": "CA",
  "loc": "48.1446,-80.0377",
  "org": "AS11260 EastLink",
  "postal": "P2N",
  "timezone": "America/Toronto",
  "readme": "https://ipinfo.io/missingauth"
}
반환 결과의 country는 CA로, 캐나다를 나타냅니다. 다시 실행하면 다른 결과를 얻을 수 있으며, 매번 요청 시 무작위 IP 출구가 생성됩니다.

코드 연동

아래는 Python을 예로 들어 이 프록시의 설정 방법을 보여줍니다:
import requests

proxy = 'http://{proxy_username}:{proxy_password}@global.proxy.acedata.cloud:30007'

proxies = {
    'http': proxy,
    'https': proxy
}

for _ in range(3):
    resp = requests.get('https://ipinfo.io', proxies=proxies)
    print(resp.text)
여기서 우리는 먼저 프록시의 URL을 선언하고 proxy 변수로 정의했습니다. 프로토콜은 http 프로토콜이며, 뒤에 터널 프록시의 사용자 이름과 비밀번호(즉, 콘솔에 표시된 사용자 이름과 비밀번호, 두 개는 콜론으로 구분됨)를 따릅니다. 그 뒤에 @ 기호를 추가하고 프록시의 주소와 포트를 추가하면 됩니다.
주의: 위 코드에서 {proxy_username}:{proxy_password}를 본인의 프록시 사용자 이름과 비밀번호로 교체해야 하며, 최종 결과는 proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007'와 유사해야 하며, {} 문자는 포함되지 않아야 합니다.
그 다음 proxies 변수를 선언하고 두 개의 키-값 쌍을 구성했습니다. 키 이름은 각각 http와 https이며, 그 값은 모두 proxy로, HTTP 및 HTTPS 프로토콜 웹사이트에 대해 proxy 변수로 정의된 프록시를 사용하여 요청합니다. 이후 세 번의 루프를 정의하여 프록시 테스트를 진행합니다. 실행 결과는 다음과 같습니다:
{
  "ip": "103.190.205.165",
  "hostname": "assigned-for-client.adnsl.com",
  "city": "Paltan",
  "region": "Dhaka Division",
  "country": "BD",
  "loc": "23.7362,90.4143",
  "org": "AS38203 ADN Telecom Ltd.",
  "postal": "1000",
  "timezone": "Asia/Dhaka",
  "readme": "https://ipinfo.io/missingauth"
}
{
  "ip": "74.111.25.181",
  "hostname": "pool-74-111-25-181.syrcny.fios.verizon.net",
  "city": "Syracuse",
  "region": "New York",
  "country": "US",
  "loc": "43.0481,-76.1474",
  "org": "AS701 Verizon Business",
  "postal": "13201",
  "timezone": "America/New_York",
  "readme": "https://ipinfo.io/missingauth"
}
{
  "ip": "207.113.168.248",
  "city": "LaPorte",
  "region": "Indiana",
  "country": "US",
  "loc": "41.6106,-86.7225",
  "org": "AS13428 Surf Air Wireless, LLC",
  "postal": "46350",
  "timezone": "America/Chicago",
  "readme": "https://ipinfo.io/missingauth"
}
각 실행 결과에서 얻은 프록시 IP는 무작위이며, IP가 위치한 지역이 실제로 전 세계의 다양한 국가와 도시에서 유래한 것을 확인할 수 있습니다. 물론, 위의 프록시 설정 방법은 상대적으로 간단한 설정 방법입니다. 실제로 위 코드는 요청 시 추가적인 헤더 - Proxy Authorization을 설정한 것과 동일하므로, 위 코드는 다음과 같이 수정할 수 있습니다:
import requests
import base64

proxy_host = 'global.proxy.acedata.cloud'
proxy_port = '30007'
proxy_username = '{proxy_username}' # 8자리 사용자 이름
proxy_password = '{proxy_password}' # 32자리 비밀번호

credentials = base64.b64encode(
    f'{proxy_username}:{proxy_password}'.encode()).decode()

proxies = {
    'http': f'http://{proxy_host}:{proxy_port}',
    'https': f'http://{proxy_host}:{proxy_port}'
}

headers = {
    'Proxy-Authorization': f'Basic {credentials}'
}

for _ in range(3):
    resp = requests.get('https://ipinfo.io',
                        proxies=proxies, headers=headers)
    print(resp.text)

여기서 우리는 Proxy-Authorization이라는 요청 헤더를 통해 프록시의 사용자 이름과 비밀번호(기본적으로 Base64 인코딩 필요)를 추가로 설정했습니다. 이렇게 작성된 코드의 실행 효과도 동일합니다. 다른 언어, 예를 들어 JavaScript의 axios에서도 유사한 설정 방법을 사용할 수 있습니다:
const axios = require("axios");
const base64 = require("base64");

const proxy_host = "global.proxy.acedata.cloud";
const proxy_port = "30007";
const proxy_username = "{proxy_username}"; // 8자리 사용자 이름
const proxy_password = "{proxy_password}"; // 32자리 비밀번호

const credentials = base64.encode(`${proxy_username}:${proxy_password}`);

const proxies = {
  http: `http://${proxy_host}:${proxy_port}`,
  https: `http://${proxy_host}:${proxy_port}`,
};

const headers = {
  "Proxy-Authorization": `Basic ${credentials}`,
};

for (let i = 0; i < 3; i++) {
  axios
    .get("https://ipinfo.io", { proxies, headers })
    .then((resp) => console.log(resp.data))
    .catch((err) => console.error(err));
}
실행 결과는 모두 동일합니다. 다른 언어의 설정 방법에 대해서는 위 내용을 참고하여 스스로 수정하시면 됩니다.

지역 필터링

우리는 username에 region을 추가하여 지역 필터링을 할 수 있습니다. 예를 들어 미국의 프록시를 선택하고 싶다면 원래의 username이 1f78266a라면 username을 1f78266a-region-us로 변경하면 위의 curl을 다음과 같이 수정할 수 있습니다:
curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io
지역 목록:
국가 또는 지역 이름국가/지역 코드
미국us
홍콩hk
안도라ad
아랍에미리트ae
아프가니스탄af
앤티가 바부다ag
앵귈라ai
알바니아al
아르메니아am
앙골라ao
남극 대륙aq
아르헨티나ar
미국령 사모아as
오스트리아at
호주au
아루바aw
올란드 제도ax
아제르바이잔az
보스니아 헤르체고비나ba
바바도스bb
방글라데시bd
벨기에be
부르키나파소bf
불가리아bg
바레인bh
부룬디bi
베냉bj
생바르텔레미bl
버뮤다bm
브루나이bn
볼리비아bo
네덜란드 카리브해bq
브라질br
바하마bs
부탄bt
부베 섬bv
보츠와나bw
벨라루스by
벨리즈bz
캐나다ca
코코스 제도cc
중앙 아프리카cf
스위스ch
칠레cl
카메룬cm
콜롬비아co
코스타리카cr
쿠바cu
카보베르데cv
크리스마스 섬cx
사이프러스cy
체코cz
독일de
지부티dj
덴마크dk
도미니카dm
도미니카 공화국do
알제리dz
에콰도르ec
에스토니아ee
이집트eg
서사하라eh
에리트레아er
스페인es
핀란드fi
피지 제도fj
미크로네시아 연방fm
페로 제도fo
프랑스fr
가봉ga
그레나다gd
조지아ge
프랑스령 기아나gf
가나gh
지브롤터gi
그린란드gl
기니gn
과들루프gp
적도 기니gq
그리스gr
과테말라gt
gu
기니비사우gw
가이아나gy
허드 섬과 맥도날드 제도hm
온두라스hn
크로아티아hr
아이티ht
헝가리hu
인도네시아id
아일랜드ie
이스라엘il
맨 섬im
인도in
영국령 인도양 지역io
이라크iq
이란ir
아이슬란드is
이탈리아it
저지 섬je
자메이카jm
요르단jo
일본jp
캄보디아kh
키리바스ki
코모로km
쿠웨이트kw
케이맨 제도ky
레바논lb
리히텐슈타인li
스리랑카lk
라이베리아lr
레소토ls
리투아니아lt
룩셈부르크lu
라트비아lv
리비아ly
모로코ma
모나코mc
몰도바md
몬테네그로me
프랑스령 생마르탱mf
마다가스카르mg
마셜 제도mh
마케도니아mk
말리ml
미얀마mm
마카오mo
마르티니크mq
모리타니아mr
몬트세랫ms
몰타mt
몰디브mv
말라위mw
멕시코mx
말레이시아my
나미비아na
니제르ne
노퍽 섬nf
나이지리아ng
니카라과ni
네덜란드nl
노르웨이no
네팔np
나우루nr
오만om
파나마pa
페루pe
프랑스령 폴리네시아pf
파푸아뉴기니pg
필리핀ph
파키스탄pk
폴란드pl
피터케인 제도pn
푸에르토리코pr
팔레스타인ps
팔라우pw
파라과이py
카타르qa
레위니옹re
루마니아ro
세르비아rs
러시아ru
르완다rw
솔로몬 제도sb
세이셸sc
수단sd
스웨덴se
싱가포르sg
슬로베니아si
슬로바키아sk
시에라리온sl
산마리노sm
세네갈sn
소말리아so
수리남sr
남수단ss
상투메 프린시페st
엘살바도르sv
시리아sy
스와질란드sz
터크스 케이커스 제도tc
차드td
토고tg
태국th
토켈라우tk
동티모르tl
튀니지tn
통가to
터키tr
투발루tv
탄자니아tz
우크라이나ua
우간다ug
우루과이uy
바티칸va
베네수엘라ve
영국령 버진 제도vg
미국령 버진 제도vi
베트남vn
왈리스 푸투나wf
사모아ws
예멘ye
마요트yt
남아프리카za
잠비아zm
짐바브웨zw
콩고(브라자빌)cg
콩고(킨샤사)cd
모잠비크mz
건지 섬gg
감비아gm
북마리아나 제도mp
에티오피아et
뉴칼레도니아nc
바누아투vu
프랑스령 남부 영토tf
니우에nu
미국 본토 외 작은 섬um
쿡 제도ck
영국gb
트리니다드 토바고tt
세인트빈센트 그레나딘vc
###tw
뉴질랜드nz
사우디아라비아sa
라오스la
북한kp
한국kr
포르투갈pt
키르기스스탄kg
카자흐스탄kz
타지키스탄tj
투르크메니스탄tm
우즈베키스탄uz
세인트키츠 네비스kn
생피에르 미클롱pm
세인트헬레나sh
세인트루시아lc
모리셔스mu
코트디부아르ci
케냐ke
몽골mn

IP 고정

위의 내용과 마찬가지로, username에 session을 추가하고 5자리 고정 숫자를 추가하여 일정 시간 동안 IP 고정을 구현할 수 있으며, 유효 기간은 약 10분입니다. 예를 들어 일정 시간 동안 IP 고정을 구현하려면 원래의 username이 1f78266a인 경우, username을 1f78266a-session-12345로 수정할 수 있습니다. 여기서 12345가 변하지 않으면 일정 시간 동안 IP는 변하지 않으며, 위의 curl은 다음과 같이 수정할 수 있습니다:
curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io

더 구매하기

패키지가 이미 소진된 경우, 계속해서 해당 프록시 서비스를 사용하려면 더 구매해야 합니다. 더 구매하려면 「신청 페이지」로 가서 「더 구매하기」 버튼을 클릭하여 선택하면 되며, 단일 구매 시 단가가 더 저렴합니다.