海外動(dòng)態(tài)代理開發(fā)手冊(cè)
總覽
新手開發(fā)者可通過如下2個(gè)步驟使用海外動(dòng)態(tài)代理:
一、購買成功后,先在會(huì)員中心查看海外信息,進(jìn)行本地調(diào)試和驗(yàn)證。
二、海外動(dòng)態(tài)代理代碼使用方式和隧道代理一致,請(qǐng)參考隧道代碼樣例請(qǐng)求海外動(dòng)態(tài)代理訪問目標(biāo)網(wǎng)站。
隧道模式
ip地區(qū)、換ip周期設(shè)置
管理臺(tái)設(shè)置
您可以在會(huì)員中心-海外動(dòng)態(tài)代理訂單管理里查看和修改當(dāng)前的地區(qū)、周期配置,修改成功后一分鐘內(nèi)生效。
編碼設(shè)置
您可以在程序中通過如下兩種方式設(shè)置:
方式一:通過用戶名密碼設(shè)置地區(qū)、周期
- 按國(guó)家轉(zhuǎn)發(fā)
使用美國(guó)-紐約地區(qū)ip、換ip周期1分鐘。用如下代碼段驗(yàn)證串:
以這樣的格式{username}-region-{US}-area-{New York}-period-{1}:{password},將用戶名、國(guó)家編碼、地區(qū)編碼、換ip周期(分鐘)、密碼填入生成Proxy-Authorization。
例如用戶名為f2964279696,密碼為jkr369ry,使用美國(guó)-紐約地區(qū)ip、換ip周期1分鐘。用如下代碼段驗(yàn)證串:
f2964279696-region-US-area-New York-period-1:jkr369ry
- 按大洲轉(zhuǎn)發(fā)
使用美洲地區(qū)ip、換ip周期1分鐘,用如下代碼段驗(yàn)證串:
以這樣的格式{username}-cont-{nasa}-period-{1}:{password},將用戶名、大洲編碼、換ip周期(分鐘)、密碼填入生成Proxy-Authorization。
例如用戶名為f2964279696,密碼為jkr369ry,使用美洲地區(qū)ip、換ip周期1分鐘。用如下代碼段驗(yàn)證串:
f2964279696-cont-nasa-period-1:jkr369ry
按洲(cont)轉(zhuǎn)發(fā):美洲(nasa)、亞洲(as)、歐洲(eu)、非洲(af)、大洋洲(oa)
另外您也可以配置多個(gè)用戶名密碼,指定不同的地區(qū)、周期,根據(jù)業(yè)務(wù)不同靈活使用。
f2964279696-region-JP-area-Tokyo-period-0:jkr369ry # 日本東京地區(qū)、每次請(qǐng)求換ip
f2964279696-region-GB-period-1:jkr369ry # 英國(guó)地區(qū)、1分鐘換ip
方式二:通過Header設(shè)置地區(qū)、周期(只支持http)
以本次請(qǐng)求使用美國(guó)-紐約地區(qū)ip、換ip周期1分鐘為例,在發(fā)起http請(qǐng)求時(shí)攜帶如下Header(Header不區(qū)分大小寫):
Kdl-Region: US
Kdl-Area: New York
Kdl-Period: 1
同樣的您也可以配置多個(gè)header,指定不同的地區(qū)、周期,根據(jù)業(yè)務(wù)不同靈活使用。(使用提示:方式一的優(yōu)先級(jí)高于方式二)
國(guó)家編碼、地區(qū)名稱可以通過快代理提供的api獲取,GetFpsCountryCode 獲取國(guó)家編碼、GetFpsAreaCode 獲取地區(qū)編碼。
- 當(dāng)您通過編碼方式設(shè)置地區(qū)、周期,系統(tǒng)會(huì)忽略您在會(huì)員中心-海外動(dòng)態(tài)代理訂單管理里的地區(qū)、周期配置。
- 如果您目標(biāo)網(wǎng)站所在的國(guó)家屬于亞洲,建議您在
新加坡(或附近)租用請(qǐng)求源服務(wù)器,并且使用亞洲代理域名as.xxx.kdlfps.com,這樣可以達(dá)到最低延遲;如果您目標(biāo)網(wǎng)站所在的國(guó)家屬于美國(guó)或者非亞洲國(guó)家,建議您在圣佛蘭西斯科(或附近)租用請(qǐng)求源服務(wù)器,并且使用美洲代理域名us.xxx.kdlfps.com,這樣可以達(dá)到最低延遲
周期版使用多通道
對(duì)于需要周期性換IP的海外動(dòng)態(tài)代理,支持多通道使用,在同一換IP周期內(nèi)每個(gè)通道會(huì)轉(zhuǎn)發(fā)一個(gè)獨(dú)立的代理IP。
只支持通過用戶名設(shè)置通道
以本次請(qǐng)求使用美國(guó)-紐約地區(qū)ip、換ip周期1分鐘為例,設(shè)置參數(shù)sid,每個(gè)sid對(duì)應(yīng)一個(gè)通道,sid為長(zhǎng)度不超過6位的隨機(jī)字符串。
f2964279696-region-US-area-New York-period-1-sid-ss01:jkr369ry # 通道一
f2964279696-region-US-area-New York-period-1-sid-ss02:jkr369ry # 通道二
f2964279696-region-US-area-New York-period-1-sid-ss03:jkr369ry # 通道三
...
提取模式
您可以在會(huì)員中心-海外動(dòng)態(tài)代理IP提取里進(jìn)行調(diào)試和提取代理IP。
提取模式支持指定轉(zhuǎn)發(fā)地區(qū)和IP可用時(shí)長(zhǎng)

手動(dòng)提取海外動(dòng)態(tài)代理IP
在線生成API鏈接
API接口
海外動(dòng)態(tài)代理API接口一覽
| 接口名稱 | 接口功能 |
|---|---|
| GetFps | 獲取海外動(dòng)態(tài)代理隧道 |
| GetFpsIp | 獲取海外動(dòng)態(tài)代理IP |
| Getfpsflow | 獲取海外動(dòng)態(tài)代理使用流量 |
| GetFpsCountryCode | 獲取海外動(dòng)態(tài)代理國(guó)家編碼 |
| GetFpsAreaCode | 獲取海外地區(qū)(省/州)編碼 |
| GetIpWhitelist | 獲取IP白名單 |
| SetIpWhitelist | 設(shè)置IP白名單 |
| AddWhiteIP | 添加白名單IP |
| DelWhiteIP | 刪除白名單IP |
| GetProxyAuthorization | 獲取鑒權(quán)信息 |
測(cè)試海外動(dòng)態(tài)代理可用性
海外動(dòng)態(tài)代理支持白名單和用戶名密碼兩種驗(yàn)證方式,建議您先在本機(jī)測(cè)試,測(cè)試OK后就可以正常使用了。
關(guān)于IP白名單數(shù)量
如果您選擇設(shè)置白名單訪問海外,最多可設(shè)置200個(gè)白名單IP。
只要請(qǐng)求不超過購買時(shí)選擇的每秒并發(fā)數(shù),通過用戶名密碼訪問海外的IP數(shù)量沒有限制。
錯(cuò)誤碼一覽
參見海外代理動(dòng)態(tài)住宅相關(guān)錯(cuò)誤碼
海外動(dòng)態(tài)代理使用統(tǒng)計(jì)
隧道模式統(tǒng)計(jì)功能提供了對(duì)請(qǐng)求量和請(qǐng)求錯(cuò)誤的統(tǒng)計(jì)分析。
您可以隨時(shí)關(guān)注采集程序的運(yùn)行走勢(shì),了解發(fā)生的錯(cuò)誤并及時(shí)修正。我們還為幾種常見的錯(cuò)誤提供了分析和提示,幫助您提升采集程序運(yùn)行的成功率。


流量統(tǒng)計(jì)方便您跟蹤流量的使用詳情。通過流量統(tǒng)計(jì)折線圖,您可以更好地把控帶寬使用情況。

開發(fā)建議
參考如下開發(fā)建議,可以幫助您更加順利地完成開發(fā)和調(diào)試:
- 控制好請(qǐng)求頻率,用同一IP請(qǐng)求同一網(wǎng)站建議不超過1秒1次,避免IP被目標(biāo)網(wǎng)站屏蔽。
- 建議關(guān)閉HTTP協(xié)議的keep-alive功能,避免因連接復(fù)用導(dǎo)致海外不能切換IP
- 盡可能采用gzip壓縮加速訪問,在header里添加:Accept-Encoding: gzip
- 關(guān)注海外代理動(dòng)態(tài)住宅返回碼可協(xié)助您排查錯(cuò)誤。
使用gzip詳解
使用gzip壓縮傳輸數(shù)據(jù)可顯著提升訪問速度,方法非常簡(jiǎn)單:
只需在http請(qǐng)求的header里加上:
Accept-Encoding: gzip
收到HTTP Response后檢查header里是否包含:
Content-Encoding: gzip
如果包含,則對(duì)body進(jìn)行gzip解壓,就能得到原始內(nèi)容。
代碼樣例
海外動(dòng)態(tài)代理代碼使用方式和隧道代理一致,請(qǐng)參考隧道代碼樣例