海外動(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ū)、周期
- 按國家轉(zhuǎn)發(fā)
使用美國-紐約地區(qū)ip、換ip周期1分鐘
。用如下代碼段驗(yàn)證串:
以這樣的格式{username}-region-{US}-area-{New York}-period-{1}:{password}
,將用戶名、國家編碼、地區(qū)編碼、換ip周期(分鐘)、密碼填入生成Proxy-Authorization。
例如用戶名為f2964279696
,密碼為jkr369ry
,使用美國-紐約地區(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
# 英國地區(qū)、1分鐘換ip
方式二:通過Header設(shè)置地區(qū)、周期(只支持http)
以本次請(qǐng)求使用美國-紐約地區(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í)高于方式二)
國家編碼、地區(qū)名稱可以通過快代理提供的api獲取,GetFpsCountryCode 獲取國家編碼、GetFpsAreaCode 獲取地區(qū)編碼。
- 當(dāng)您通過編碼方式設(shè)置地區(qū)、周期,系統(tǒng)會(huì)忽略您在會(huì)員中心-海外動(dòng)態(tài)代理訂單管理里的地區(qū)、周期配置。
- 如果您目標(biāo)網(wǎng)站所在的國家屬于亞洲,建議您在
新加坡(或附近)
租用請(qǐng)求源服務(wù)器,并且使用亞洲代理域名as.xxx.kdlfps.com
,這樣可以達(dá)到最低延遲;如果您目標(biāo)網(wǎng)站所在的國家屬于美國或者非亞洲國家,建議您在圣佛蘭西斯科(或附近)
租用請(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)求使用美國-紐約地區(qū)ip、換ip周期1分鐘
為例,設(shè)置參數(shù)sid,每個(gè)sid對(duì)應(yīng)一個(gè)通道,sid為長度不超過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í)長
手動(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)代理國家編碼 |
GetFpsAreaCode | 獲取海外地區(qū)(省/州)編碼 |
GetIpWhitelist | 獲取IP白名單 |
SetIpWhitelist | 設(shè)置IP白名單 |
AddWhiteIP | 添加白名單IP |
DelWhiteIP | 刪除白名單IP |
GetProxyAuthorization | 獲取鑒權(quán)信息 |
測試海外動(dòng)態(tài)代理可用性
海外動(dòng)態(tài)代理支持白名單和用戶名密碼兩種驗(yàn)證方式,建議您先在本機(jī)測試,測試OK后就可以正常使用了。
關(guān)于IP白名單數(shù)量
如果您選擇設(shè)置白名單訪問海外,最多可設(shè)置200個(gè)白名單IP。
只要請(qǐng)求不超過購買時(shí)選擇的每秒并發(fā)數(shù),通過用戶名密碼訪問海外的IP數(shù)量沒有限制。
錯(cuò)誤碼一覽
HTTP返回碼 | Response body 內(nèi)容 | 說明 |
---|---|---|
407 | 情況一:Proxy Authentication Failed:%auth 情況二:White IP Failed:$client_ip |
情況一:用戶名密碼驗(yàn)證失敗 情況二:白名單驗(yàn)證失敗 |
440 | Bandwidth Over Limit | 帶寬超限 |
441 | Request Rate Over Limit | HTTP請(qǐng)求/TCP連接超頻 |
442 | Authentication Type Error | 認(rèn)證方式檢測失敗 |
446 | Host DNS Failed | DNS解析錯(cuò)誤 |
447 | Real-name Authentication Required | 需要實(shí)名認(rèn)證 |
451 | Miss Host | 代理請(qǐng)求格式不正確 |
452 | Public Host Required | 目標(biāo)地址不是公網(wǎng)IP |
453 | Proxy Port Error | 使用了錯(cuò)誤的端口號(hào) |
456 | CN Client Forbidden | 中國大陸客戶端禁止 |
459 | Insufficient Traffic | 剩余流量不足 |
503 | Proxy Connect Error | 連接目標(biāo)網(wǎng)站失敗 |
海外動(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ù)可顯著提升訪問速度,方法非常簡單:
只需在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)參考隧道代碼樣例