取消
最近搜索
清空历史

海外动态代理开发手册

总览

新手开发者可通过如下2个步骤使用海外动态代理:

一、购买成功后,先在会员中心查看海外信息,进行本地调试和验证

二、海外动态代理代码使用方式和隧道代理一致,请参考隧道代码样例请求海外动态代理访问目标网站。

隧道模式

ip地区、换ip周期设置

管理台设置

您可以在会员中心-海外动态代理订单管理里查看和修改当前的地区、周期配置,修改成功后一分钟内生效。

编码设置

您可以在程序中通过如下两种方式设置:

方式一:通过用户名密码设置地区、周期

  1. 按国家转发使用美国-纽约地区ip、换ip周期1分钟。用如下代码段验证串:
    以这样的格式{username}-region-{US}-area-{New York}-period-{1}:{password},将用户名、国家编码、地区编码、换ip周期(分钟)、密码填入生成Proxy-Authorization。
    例如用户名为f2964279696,密码为jkr369ry,使用美国-纽约地区ip、换ip周期1分钟。用如下代码段验证串:
    f2964279696-region-US-area-New York-period-1:jkr369ry
    
  2. 按大洲转发使用美洲地区ip、换ip周期1分钟,用如下代码段验证串:
    以这样的格式{username}-cont-{nasa}-period-{1}:{password},将用户名、大洲编码、换ip周期(分钟)、密码填入生成Proxy-Authorization。
    例如用户名为f2964279696,密码为jkr369ry,使用美洲地区ip、换ip周期1分钟。用如下代码段验证串:
    f2964279696-cont-nasa-period-1:jkr369ry
    

    按洲(cont)转发:美洲(nasa)、亚洲(as)、欧洲(eu)、非洲(af)、大洋洲(oa)

另外您也可以配置多个用户名密码,指定不同的地区、周期,根据业务不同灵活使用。
f2964279696-region-JP-area-Tokyo-period-0:jkr369ry # 日本东京地区、每次请求换ip
f2964279696-region-GB-period-1:jkr369ry # 英国地区、1分钟换ip

方式二:通过Header设置地区、周期(只支持http)

以本次请求使用美国-纽约地区ip、换ip周期1分钟为例,在发起http请求时携带如下Header(Header不区分大小写):

Kdl-Region: US    
Kdl-Area: New York
Kdl-Period: 1

同样的您也可以配置多个header,指定不同的地区、周期,根据业务不同灵活使用。(使用提示:方式一的优先级高于方式二)

国家编码、地区名称可以通过快代理提供的api获取,GetFpsCountryCode 获取国家编码、GetFpsAreaCode 获取地区编码。

  1. 当您通过编码方式设置地区、周期,系统会忽略您在会员中心-海外动态代理订单管理里的地区、周期配置。
  2. 如果您目标网站所在的国家属于亚洲,建议您在新加坡(或附近)租用请求源服务器,并且使用亚洲代理域名as.xxx.kdlfps.com,这样可以达到最低延迟;如果您目标网站所在的国家属于美国或者非亚洲国家,建议您在圣佛兰西斯科(或附近)租用请求源服务器,并且使用美洲代理域名us.xxx.kdlfps.com,这样可以达到最低延迟

周期版使用多通道

对于需要周期性换IP的海外动态代理,支持多通道使用,在同一换IP周期内每个通道会转发一个独立的代理IP。

只支持通过用户名设置通道

以本次请求使用美国-纽约地区ip、换ip周期1分钟为例,设置参数sid,每个sid对应一个通道,sid为长度不超过6位的随机字符串。

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  # 通道三
...

提取模式

您可以在会员中心-海外动态代理IP提取里进行调试和提取代理IP。
提取模式支持指定转发地区和IP可用时长

ip提取

手动提取海外动态代理IP
在线生成API链接

API接口

海外动态代理API接口一览

接口名称 接口功能
GetFps 获取海外动态代理隧道
GetFpsIp 获取海外动态代理IP
Getfpsflow 获取海外动态代理使用流量
GetFpsCountryCode 获取海外动态代理国家编码
GetFpsAreaCode 获取海外地区(省/州)编码
GetIpWhitelist 获取IP白名单
SetIpWhitelist 设置IP白名单
AddWhiteIP 添加白名单IP
DelWhiteIP 删除白名单IP
GetProxyAuthorization 获取鉴权信息

测试海外动态代理可用性

海外动态代理支持白名单和用户名密码两种验证方式,建议您先在本机测试,测试OK后就可以正常使用了。

查看测试步骤

关于IP白名单数量

如果您选择设置白名单访问海外,最多可设置200个白名单IP。
只要请求不超过购买时选择的每秒并发数,通过用户名密码访问海外的IP数量没有限制。

错误码一览

HTTP返回码 Response body 内容 说明
407 情况一:Proxy Authentication Failed:$auth
情况二:White IP Failed:$client_ip
情况一:用户名密码验证失败
情况二:白名单验证失败
440 Bandwidth Over Limit 带宽超限
441 Request Rate Over Limit 请求 / 连接超频
442 Authentication Type Error 认证方式检测失败
446 Host DNS Failed DNS解析错误
447 Real-name Authentication Required 需要实名认证
451 Miss Host 请求格式不正确
452 Public Host Required 内网地址
453 Proxy Port Error 代理端口号错误
456 CN Client Forbidden 中国⼤陆客户端被禁⽌访问
459 Insufficient Traffic 订单流量不足
466 Real-name Verify Required 实名核验
515 Target Unavailable 连接目标地址网络异常
516 Proxy Failed 获取上级代理失败
517 Proxy Setup Failed 设置上级代理失败

海外动态代理使用统计

隧道模式统计功能提供了对请求量和请求错误的统计分析。
您可以随时关注采集程序的运行走势,了解发生的错误并及时修正。我们还为几种常见的错误提供了分析和提示,帮助您提升采集程序运行的成功率。

IP使用统计
状态统计

流量统计方便您跟踪流量的使用详情。通过流量统计折线图,您可以更好地把控带宽使用情况。

隧道模式统计

开发建议

参考如下开发建议,可以帮助您更加顺利地完成开发和调试:

  1. 控制好请求频率,用同一IP请求同一网站建议不超过1秒1次,避免IP被目标网站屏蔽。
  2. 建议关闭HTTP协议的keep-alive功能,避免因连接复用导致海外不能切换IP
  3. 尽可能采用gzip压缩加速访问,在header里添加:Accept-Encoding: gzip
  4. 关注海外代理动态住宅返回码可协助您排查错误。

使用gzip详解

使用gzip压缩传输数据可显著提升访问速度,方法非常简单:
只需在http请求的header里加上:
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含:
Content-Encoding: gzip
如果包含,则对body进行gzip解压,就能得到原始内容。

代码样例

海外动态代理代码使用方式和隧道代理一致,请参考隧道代码样例

SDK下载

SDK下载

联系我们