隧道代理Pro開發手冊
總覽
新手開發者可通過如下2個步驟使用隧道代理Pro：
一、購買成功后，先在會員中心查看隧道信息，進行本地調試和驗證。
二、參考代碼樣例請求隧道代理訪問目標網站。
三、隧道代理Pro使用非常靈活，可以設置ip地區、換ip周期、質量優先、速度優先等，設置方式點擊查看。
API接口
隧道代理ProAPI接口一覽
| 接口名稱 | 接口功能 |
|---|---|
| TpsProCurrentIp | 查詢隧道當前IP |
| GetTpsPro | 獲取隧道代理Pro IP |
| GetIpWhitelist | 獲取隧道IP白名單 |
| SetIpWhitelist | 設置隧道IP白名單 |
| AddWhiteIP | 添加白名單IP |
| DelWhiteIP | 刪除白名單IP |
| GetProxyAuthorization | 獲取隧道鑒權信息 |
| GetTpsProvCode | 獲取隧道代理Pro省份編碼 |
| GetTpsCityCode | 獲取隧道代理Pro城市編碼 |
測試隧道可用性
隧道代理支持白名單和用戶名密碼兩種驗證方式，建議您先在本機測試，測試OK后就可以正常使用了。
關于IP白名單數量
如果您選擇設置白名單訪問隧道，最多可設置200個白名單IP。
只要請求不超過購買時選擇的每秒并發數，通過用戶名密碼訪問隧道的IP數量沒有限制。
ip地區、換ip周期、自定義資源調度策略
管理臺設置
您可以在會員中心-隧道代理訂單管理里查看和修改當前的地區、周期配置、自主選擇ip資源池、自定義資源調度策略，修改成功后一分鐘內生效。
編碼設置
您可以在用戶名后面添加不同參數來控制隧道的轉發，例如您的用戶名為t2964279696，密碼為jkr369ry，參數說明如下：
period 指定換ip周期
以這樣的格式{username}-period-{1}:{password}傳入period參數(單位：分鐘)，取值范圍0.25、0.5、1-30之間的整數，沒有傳入period參數即每次請求更換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
對于換ip周期，可以配合參數
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可以設置多條通道
area、prov、city 指定出口ip地區
area 七大自然地理分區：
華北地區 NC（North China 包含：北京，天津，河北，山西，內蒙古）
華東地區 EC（East China 包含：上海，江蘇，浙江，山東，安徽）
東北地區 NEC（Northeast China 包含：遼寧，吉林，黑龍江）
華中地區 CC（Central China 包含：湖北，湖南，河南，江西）
華南地區 SC（South China 包含：廣東，廣西，海南，福建）
西南地區 SWC（Southwest China 包含：四川，重慶，貴州，云南，西藏）
西北地區 NWC（Northwest China 包含：陜西，甘肅，新疆，青海，寧夏）
t2964279696-area-NC:jkr369ry # 指定華北地區
t2964279696-area-CC:jkr369ry # 指定華中地區
prov 省份編碼, city 城市編碼，可以通過快代理提供的api獲取，GetTpsProvCode 獲取省份編碼、GetTpsCityCode 獲取城市編碼。t2964279696-prov-44:jkr369ry # 指定廣東省
t2964279696-city-420100:jkr369ry # 指定湖北省武漢市
當同時設置多個地區參數時，以精度最高的地區參數為準，即設置
area-CC-prov-41-city-130900時，只有city參數生效。地區參數僅支持換ip周期在5分鐘內的請求，即period>=6時，不支持設置地區參數。
type 自主選擇ip資源池
type取值說明：1. type-std使用企業ip池，包含多種ip資源，兼容性強的優質ip池 2. type-enh使用星辰ip池，包含稀缺資源，規模更大的旗艦ip池。不傳值則默認使用星辰ip池。
t2964279696-type-std:jkr369ry
t2964279696-type-enh:jkr369ry
t2964279696-type-std-xx-xx:jkr369ry
t2964279696-type-enh-xx-xx:jkr369ry
pool 自定義資源調度策略
pool取值范圍：1. ip資源調度以速度優先(s1-10)，其中s10>s1 2. ip資源調度以質量優先(q1-10)，其中q10>q1。不傳入pool參數則使用系統的智能轉發策略。
t2964279696-pool-s2:jkr369ry
t2964279696-pool-s8:jkr369ry
t2964279696-pool-q2:jkr369ry
t2964279696-pool-q10:jkr369ry
您可以根據使用場景，靈活組合參數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，且速度優先調度
t2964279696-period-3-area-CC:jkr369ry # 華中地區每3分鐘換ip
...
當您通過編碼方式設置地區、周期，資源調度策略時，系統會忽略您在會員中心-隧道代理訂單管理里的地區、周期，資源調度策略。
頻率限制
隧道代理的請求頻率在購買時選擇的并發數決定，默認的并發數是1秒5次。
請求超過頻率可能收到441錯誤。
建議經常關注隧道使用統計的頻率提示，把握好請求頻率。
并發數不夠用可在隧道管理頁升級并發數。
頻率控制提示
隧道代理采用彈性頻率控制，允許短期超出并發規格，使更多使用場景得以順利運行。
如果您持續請求超頻，超出部分的請求將被拒絕。
錯誤碼一覽
| HTTP返回碼 | Response body 內容 | 說明 |
|---|---|---|
| 407 | Proxy Authentication Required | 情況一：代理密鑰驗證失敗 情況二：白名單驗證失敗 ? |
| 440 | Bandwidth Over Limit | 帶寬超限 ? |
| 441 | Request Rate Over Limit | 請求 / 連接超頻 ? |
| 442 | Authentication Type Error | 鑒權方式不匹配 ? |
| 443 | Foreign Client Forbidden | 海外客戶端禁用代理 ? |
| 444 | Download Not Allowed | 本代理無法用于下載 ? |
| 445 | Illegal Request | 非法域名請求 ? |
| 446 | Host DNS Failed | DNS解析錯誤 |
| 447 | Real-name Authentication Required | 實名認證 ? |
| 448 | Target Port Forbidden | 禁止訪問指定端口 ? |
| 449 | Foreign Host Forbidden | 禁止訪問未備案境外域名 ? |
| 450 | IP As Host Forbidden | 禁止訪問IP ? |
| 451 | Miss Host | 請求格式不正確 |
| 452 | Public Host Required | 內網地址 ? |
| 453 | Proxy Port Error | 代理端口號錯誤 |
| 454 | Proxy Authentication Expired | 無法使用此IP ? |
| 455 | Risk Host Forbidden | 禁止訪問風險域名 ? |
| 460 | Proxy Authentication Invalid | 無法使用此IP ? |
| 462 | Target Domain WhiteList Not Match | 禁止訪問單外域名 ? |
| 463 | Target Domain BlackList Forbidden | 禁止訪問黑單域名 ? |
| 464 | Invalid Param | 帶參錯誤 ? |
| 465 | Null Proxy | 無可用IP ? |
| 466 | Real-name Verify Required | 實名核驗 ? |
| 515 | Target Unavailable | 請求失敗 ? |
| 516 | Proxy Failed | 請求失敗 ? |
| 517 | Proxy Setup Failed | 請求失敗 ? |
隧道使用統計
隧道使用統計功能提供了對請求量和請求錯誤的統計分析。
您可以隨時關注采集程序的運行走勢，了解發生的錯誤并及時修正。我們還為幾種常見的錯誤提供了分析和提示，幫助您提升采集程序運行的成功率。
隧道帶寬監控方便您跟蹤平均帶寬和峰值帶寬占用。 通過帶寬監控折線圖，您可以更好地把控帶寬使用情況。
開發建議
參考如下開發建議，可以幫助您更加順利地完成開發和調試：
- 控制好請求頻率，用同一IP請求同一網站建議不超過1秒1次，避免IP被目標網站屏蔽。
- 建議關閉HTTP協議的keep-alive功能，避免因連接復用導致隧道不能切換IP
- 盡可能采用gzip壓縮加速訪問，在header里添加：Accept-Encoding: gzip
- 關注隧道返回碼可協助您排查錯誤。
使用gzip詳解
使用gzip壓縮傳輸數據可顯著提升訪問速度，方法非常簡單：
只需在http請求的header里加上：
Accept-Encoding: gzip
收到HTTP Response后檢查header里是否包含：
Content-Encoding: gzip
如果包含，則對body進行gzip解壓，就能得到原始內容。