隧道代理Pro開發(fā)手冊(cè)
總覽
新手開發(fā)者可通過如下2個(gè)步驟使用隧道代理Pro：
一、購買成功后，先在會(huì)員中心查看隧道信息，進(jìn)行本地調(diào)試和驗(yàn)證。
二、參考代碼樣例請(qǐng)求隧道代理訪問目標(biāo)網(wǎng)站。
三、隧道代理Pro使用非常靈活，可以設(shè)置ip地區(qū)、換ip周期、質(zhì)量優(yōu)先、速度優(yōu)先等，設(shè)置方式點(diǎn)擊查看。
API接口
隧道代理ProAPI接口一覽
| 接口名稱 | 接口功能 |
|---|---|
| TpsProCurrentIp | 查詢隧道當(dāng)前IP |
| GetTpsPro | 獲取隧道代理Pro IP |
| GetIpWhitelist | 獲取隧道IP白名單 |
| SetIpWhitelist | 設(shè)置隧道IP白名單 |
| AddWhiteIP | 添加白名單IP |
| DelWhiteIP | 刪除白名單IP |
| GetProxyAuthorization | 獲取隧道鑒權(quán)信息 |
| GetTpsProvCode | 獲取隧道代理Pro省份編碼 |
| GetTpsCityCode | 獲取隧道代理Pro城市編碼 |
測試隧道可用性
隧道代理支持白名單和用戶名密碼兩種驗(yàn)證方式，建議您先在本機(jī)測試，測試OK后就可以正常使用了。
關(guān)于IP白名單數(shù)量
如果您選擇設(shè)置白名單訪問隧道，最多可設(shè)置200個(gè)白名單IP。
只要請(qǐng)求不超過購買時(shí)選擇的每秒并發(fā)數(shù)，通過用戶名密碼訪問隧道的IP數(shù)量沒有限制。
ip地區(qū)、換ip周期、自定義資源調(diào)度策略
管理臺(tái)設(shè)置
您可以在會(huì)員中心-隧道代理訂單管理里查看和修改當(dāng)前的地區(qū)、周期配置、自主選擇ip資源池、自定義資源調(diào)度策略，修改成功后一分鐘內(nèi)生效。
編碼設(shè)置
您可以在用戶名后面添加不同參數(shù)來控制隧道的轉(zhuǎn)發(fā)，例如您的用戶名為t2964279696，密碼為jkr369ry，參數(shù)說明如下：
period 指定換ip周期
以這樣的格式{username}-period-{1}:{password}傳入period參數(shù)(單位：分鐘)，取值范圍0.25、0.5、1-30之間的整數(shù)，沒有傳入period參數(shù)即每次請(qǐng)求更換ip。
t2964279696-period-0.25:jkr369ry # 每15s更換ip
t2964279696-period-0.5:jkr369ry # 每30s更換ip
t2964279696-period-1:jkr369ry # 每1min更換ip
t2964279696-period-2:jkr369ry # 每2min更換ip
對(duì)于換ip周期，可以配合參數(shù)
sid使用，即傳入不同的period+sid能指定多條通道，例如您的使用場景，需要30s換ip、1min換ip等多種不同周期的ip。sid為長度不超過6的任意字符。
t2964279696-period-0.5-sid-s01:jkr369ry # 每30s更換ip通道
t2964279696-period-1-sid-s02:jkr369ry # 每1min更換ip通道
... # Pro可以設(shè)置多條通道
area、prov、city 指定出口ip地區(qū)
area 七大自然地理分區(qū)：
華北地區(qū) NC（North China 包含：北京，天津，河北，山西，內(nèi)蒙古）
華東地區(qū) EC（East China 包含：上海，江蘇，浙江，山東，安徽）
東北地區(qū) NEC（Northeast China 包含：遼寧，吉林，黑龍江）
華中地區(qū) CC（Central China 包含：湖北，湖南，河南，江西）
華南地區(qū) SC（South China 包含：廣東，廣西，海南，福建）
西南地區(qū) SWC（Southwest China 包含：四川，重慶，貴州，云南，西藏）
西北地區(qū) NWC（Northwest China 包含：陜西，甘肅，新疆，青海，寧夏）
t2964279696-area-NC:jkr369ry # 指定華北地區(qū)
t2964279696-area-CC:jkr369ry # 指定華中地區(qū)
prov 省份編碼, city 城市編碼，可以通過快代理提供的api獲取，GetTpsProvCode 獲取省份編碼、GetTpsCityCode 獲取城市編碼。t2964279696-prov-44:jkr369ry # 指定廣東省
t2964279696-city-420100:jkr369ry # 指定湖北省武漢市
當(dāng)同時(shí)設(shè)置多個(gè)地區(qū)參數(shù)時(shí)，以精度最高的地區(qū)參數(shù)為準(zhǔn)，即設(shè)置
area-CC-prov-41-city-130900時(shí)，只有city參數(shù)生效。地區(qū)參數(shù)僅支持換ip周期在5分鐘內(nèi)的請(qǐng)求，即period>=6時(shí)，不支持設(shè)置地區(qū)參數(shù)。
type 自主選擇ip資源池
type取值說明：1. type-std使用企業(yè)ip池，包含多種ip資源，兼容性強(qiáng)的優(yōu)質(zhì)ip池 2. type-enh使用星辰ip池，包含稀缺資源，規(guī)模更大的旗艦ip池。不傳值則默認(rèn)使用星辰ip池。
t2964279696-type-std:jkr369ry
t2964279696-type-enh:jkr369ry
t2964279696-type-std-xx-xx:jkr369ry
t2964279696-type-enh-xx-xx:jkr369ry
pool 自定義資源調(diào)度策略
pool取值范圍：1. ip資源調(diào)度以速度優(yōu)先(s1-10)，其中s10>s1 2. ip資源調(diào)度以質(zhì)量優(yōu)先(q1-10)，其中q10>q1。不傳入pool參數(shù)則使用系統(tǒng)的智能轉(zhuǎn)發(fā)策略。
t2964279696-pool-s2:jkr369ry
t2964279696-pool-s8:jkr369ry
t2964279696-pool-q2:jkr369ry
t2964279696-pool-q10:jkr369ry
您可以根據(jù)使用場景，靈活組合參數(shù)period、sid、area、prov、city、pool，例如
t2964279696-period-1-sid-s01-city-420100:jkr369ry # 武漢市每分鐘換ip
t2964279696-period-1-sid-s01-city-420100-pool-s10:jkr369ry # 武漢市每分鐘換ip，且速度優(yōu)先調(diào)度
t2964279696-period-3-area-CC:jkr369ry # 華中地區(qū)每3分鐘換ip
...
當(dāng)您通過編碼方式設(shè)置地區(qū)、周期，資源調(diào)度策略時(shí)，系統(tǒng)會(huì)忽略您在會(huì)員中心-隧道代理訂單管理里的地區(qū)、周期，資源調(diào)度策略。
頻率限制
隧道代理的請(qǐng)求頻率在購買時(shí)選擇的并發(fā)數(shù)決定，默認(rèn)的并發(fā)數(shù)是1秒5次。
請(qǐng)求超過頻率可能收到441錯(cuò)誤。
建議經(jīng)常關(guān)注隧道使用統(tǒng)計(jì)的頻率提示，把握好請(qǐng)求頻率。
并發(fā)數(shù)不夠用可在隧道管理頁升級(jí)并發(fā)數(shù)。
頻率控制提示
隧道代理采用彈性頻率控制，允許短期超出并發(fā)規(guī)格，使更多使用場景得以順利運(yùn)行。
如果您持續(xù)請(qǐng)求超頻，超出部分的請(qǐng)求將被拒絕。
錯(cuò)誤碼一覽
隧道使用統(tǒng)計(jì)
隧道使用統(tǒng)計(jì)功能提供了對(duì)請(qǐng)求量和請(qǐng)求錯(cuò)誤的統(tǒng)計(jì)分析。
您可以隨時(shí)關(guān)注采集程序的運(yùn)行走勢，了解發(fā)生的錯(cuò)誤并及時(shí)修正。我們還為幾種常見的錯(cuò)誤提供了分析和提示，幫助您提升采集程序運(yùn)行的成功率。
隧道帶寬監(jiān)控方便您跟蹤平均帶寬和峰值帶寬占用。 通過帶寬監(jiān)控折線圖，您可以更好地把控帶寬使用情況。
開發(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)注隧道返回碼可協(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)容。