跳轉到主要內容
本文檔主要介紹 Ace Data Cloud 全球代理的對接說明，包括申請方法、實用方法等具體內容。

​
申請方法

要使用全球服務，可以首先到「申請頁面」進行申請，首次申請有 1 積分免費額度。 如果您尚未登錄，則會自動跳轉到登錄頁面，登錄之後繼續申請即可。

​
使用方法

申請完畢之後，可以到「控制台」中查看本人的申請結果，如圖所示： 點擊 「Credentials」，即可查看使用全球代理服務的用戶名及密碼，以冒號分隔，其中用戶名是 8 位，密碼是 32 位，如圖所示： 本代理是一種輪換代理（Rotating Proxy），因此使用的時候只需要設置一個固定的代理地址和端口即可，代理的地址和端口分別是 global.proxy.acedata.cloud 和 30007，本代理是 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 所在地域確實是來源於全球不同國家不同城市。 當然，上述的代理設置方式實際上是一個相對簡潔的設置方式。 實際上上述代碼等價於在請求的時候設置了一個額外的 Headers - 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

​
購買更多

如您的套餐已經耗尽，您需要購買更多才能繼續使用該代理服務。 要購買更多，請到「申請頁面」直接點擊「購買更多」按鈕即可選購，單次購買更多，單價越便宜。