1 步骤说明

1.在开通隧道代理IP后，单击网站右上角的【控制台】，进入后台管理面板，在左侧栏目里选择【代理IP】-【按时/按量业务】，找到已经开通的隧道代理业务；

2.隧道代理无须提取IP，接入隧道服务即可；

3.参考代码样例请求隧道代理；

4.在程序中通过调用API接口获取代理，然后请求目标网站。

（1）API调用需要验证，验证方式包括密钥验证和白名单验证，根据实际使用自主选择；

（2）密钥验证方式请求头带AuthKey和AuthPwd信息即可；

（3）添加白名单可以免密，添加白名单后大概在30s之后生效。

2 API列表

隧道不支持API的调用，只有白名单功能的API接口。

3 测试代理的可用性

隧道代理支持密钥验证和白名单两种验证方式，建议先在本机测试；
需要注意的是，隧道代理（动态请求）的请求不超过购买时选择的每秒并发数，支持短期高并发；
隧道代理（固定时长）的同时可用请求不超过购买时选择的通道数，测试OK后就可以正常使用了。

查看测试步骤 ＞

4 保持IP/IP打标记

如果用户需要多个请求在维持一个IP，比如：需要登录,获取数据两个请求在一个IP下,则可对IP进行打标记，通过标记请求在代理有效期内使用相同的代理IP。
隧道代理（固定时长）需要同时使用多IP，也需要对多个IP打标记，方便识别与使用。
查看代码示例 ＞

5 错误码一览表

6 代理请求数据统计

代理请求数据统计包括IP请求统计，提供了对请求量和请求错误的统计分析。方便随时关注采集程序的运行情况，及时发现错误并修正。

同时IP请求统计还提供几种常见的错误类型分析，如请求成功、授权失败、请求数超出、连接超时等，助力数据高效采集。

7 代码样例

• 调用API

• 隧道代理（动态请求）代码示例 ＞

1 步骤说明

1.在开通静态独享代理IP后，单击网站右上角的【控制台】，可进入后台管理面板，在左侧栏目里选择【代理IP】-【按时/按量业务】，找到已经开通的静态独享代理业务；

2.在业务列表选择【操作-提取IP】，或提取工具或调试工具上选择对应的key提取IP，先进行本地调试和验证；

3.参考代码样例请求静态独享代理；

4.在程序中通过调用API接口获取代理，然后请求目标网站。

（1）API调用需要验证，验证方式包括密钥验证和白名单验证，根据实际使用自主选择；

（2）密钥验证方式请求头带AuthKey和AuthPwd信息即可；

（3）添加白名单可以免密，添加完白名单，立即对已申请的IP生效。

2 API列表

IP数量和时长可自主控制，存活时长24小时起，24小后可释放申请新的IP，一周自主更换2次。

在线API链接提取 ＞

3 测试代理的可用性

静态独享代理支持密钥验证和白名单两种验证方式，建议先在本机测试，测试OK后就可以正常使用了。

查看测试步骤 ＞

4 错误码一览表

5 代理请求数据统计

代理请求数据统计包括IP请求统计、IP提取明细，提供了对请求量和请求提取的统计和记录。方便随时关注采集程序的运行情况，及时发现错误并修正。

同时IP请求统计还提供几种常见的错误类型分析，如请求成功、授权失败、请求数超出、连接超时等，助力数据高效采集。

6 代码样例

• 调用API

• 代码示例

1 步骤说明

开发者可以通过如下4个步骤使用动态独享代理

1. 在开通动态独享代理产品后，单击网站右上角的【控制台】，进入后台管理面板，在左侧栏目里选择【代理IP】-【按时/按量业务】，找到已经开通的动态独享代理业务；
   

2. 在业务列表选择【操作-提取IP】，或提取工具或调试工具上选择对应的key提取IP，进行本地调试和验证。
   

3. 参考代码样例请求动态独享代理。

4. 在程序中通过调用API接口获取代理，然后请求目标网站。

   1. API调用需要验证，验证方式包括密钥验证和白名单验证，根据实际使用自主选择。
   2. 密钥验证方式请求头带AuthKey和AuthPwd信息即可。
   3. 添加白名单可以免密，需要在未提取IP之前添加白名单。

2 API接口

3 测试代理的可用性

动态独享代理支持密钥验证和白名单两种验证方式，建议先在本机测试，测试OK后就可以正常使用了。

查看测试步骤 ＞

4 地区锁功能

地区锁指的是用户可以锁定地区IP进行切换，不会因为资源紧张而出现提取不到指定地区IP的情况。适合于需要使用固定地区家庭IP的场景。

启用地区锁后，提取速度会降低，使用方式也会改变。

1. 查看地区锁启用状态：在控制台中筛选“动态独享代理”产品，可通过地区锁字段查看当前业务是否启用地区锁功能
2. 启用或者停用地区锁：在业务列表中找到需要操作的业务，查看详情在详情页中，找到”地区锁”字段，进行启用或停用。切换地区锁功能，将强制释放已提取IP，并且12小时后才能切换地区锁。
3. 在控制台中使用地区锁模式：在业务列表找到已启用地区锁的业务，点击“地区锁”，进入管理页面。在管理页面中，先根据购买的通道数资源，添加需要锁定的城市资源，然后在IP管理中进行切换或者移除即可。
4. 当启用地区锁之后，所调用的API接口也会发生变化，查看详情

5 错误码一览表

6 代理请求数据统计

代理请求数据统计包括IP请求统计、IP提取明细，提供了对请求量和请求提取、使用的统计和记录。方便随时关注采集程序的运行情况，及时发现错误并修正。

同时IP请求统计还提供几种常见的错误类型分析，如请求成功、授权失败、请求数超出、连接超时等，助力数据高效采集。

7 代码样例&SDK下载

• 调用API

• 代码示例

• SDK下载 

1 步骤说明

1.在购买动态共享代理产品后，单击网站右上角的【控制台】，进入后台管理面板，在左侧栏目里选择【代理IP】-【按时/按量业务】，找到已经开通的动态共享代理业务；

2.在业务列表选择【操作】-【提取IP】，或【提取工具】或【调试工具】上选择对应的key提取IP，进行本地调试和验证；

需要注意的是，按量动态共享提取IP不收费，使用IP才收费。IP的初始免费提取额度为1000个，之后每使用一个IP，新增5个提取额度，每10分钟后重置一次免费提取额度；
IP有效时长从提取时开始计算，提取后需尽快使用，以免IP过期；

3.参考代码样例请求动态共享代理；

4.在程序中通过调用API接口获取代理，然后请求目标网站。

(1) API调用需要验证，验证方式包括密钥验证和白名单验证，根据使用自主选择；

(2) 密钥验证方式请求头带AuthKey和AuthPwd信息即可；

(3) 添加白名单可以免密，需要在未提取IP之前添加白名单。需要注意的是，动态共享产品的不同key，不能添加相同的白名单IP。

2 API列表

动态共享代理（按时）API接口一览

动态共享代理（按量）API接口一览

在线API链接提取 ＞

3 测试代理的可用性

动态共享代理支持密钥验证和白名单两种验证方式，建议先在本机测试，测试OK后就可以正常使用了。

查看测试步骤 ＞

4 错误码一览表

5 代理请求数据统计

代理请求数据统计包括IP请求统计、IP提取明细和IP使用记录，提供了对请求量和请求提取和使用的统计与记录。方便随时关注采集程序的运行情况，及时发现错误并修正。

同时请求统计还提供几种常见的错误类型分析，如请求成功、授权失败、请求数超出、连接超时等，助力数据高效采集。

6 代码样例

• 调用API

• 代码示例

1.设置代理步骤详解

1.1 进入会员中心

飞网账号登录，进入会员中心，选择“代理IP”模块，根据购买的按量业务或按时业务，查看您的所有代理业务；

1.2 设置白名单

通过添加白名单IP，业务可以免帐密使用代理IP，方便快捷。
需要注意的是每个业务的白名单需要单独设置，同时需要在使用代理IP前设置白名单才能有效应用与业务；

1.2.1 查询您将使用代理的机器的外网IP；

• 如果是办公室电脑，可以访问https://ip.cn/api/index?ip=&type=0查询您的外网IP ；

• 如果是Linux服务器，可以通过如下命令查看机器外网IP：curl myipip.net

1.2.2 在会员中心—代理IP—按时业务/按量业务—操作点击“白名单”，进行白名单管理，如下图：

1.2.3 输入您的外网IP，点击“添加”即可；

1.3 提取IP

1.3.1 进入会员中心，在代理IP业务列表中选择要使用的业务，点击“提取IP”；

1.3.2 选择提取的IP数量、存活周期、地区等要素，默认随机，数量和存活周期不可超过业务最大值；

1.4.设置代理IP

复制提取的IP与端口号，根据您的使用场景和设备，选择合适的设置代理方式。

2.代理设置常见问题

2.1 提示输入用户名和密码

飞网代理IP使用验证包括帐密验证和白名单，帐密验证需要每次使用进行验证，建议用户优先使用白名单；

帐密验证具体流程如下：

2.1.1 进入会员中心，在代理IP业务列表中选择要使用的业务，点击“管理”查看业务密钥，如下图：

2.1.2 使用代理IP进行帐密身份验证，根据提示对应输入用户名（Authkey）和密码（Authpwd），如下图：

2.2 全局代理和局部代理

全局代理：设置全局代理后，电脑的整个网络都使用的是代理。

局部代理：只是针对指定的浏览器或软件使用代理，其他软件不受影响。

静态独享、动态共享和动态独享通过API获取代理IP列表后，您就可以在程序里通过代理服务器获取网页数据。
隧道代理无需调用API获取代理，在会员中心查看隧道的IP和端口号。

您获取的代理IP是这样的：122.96.59.105:23068
122.96.59.105 是代理服务器的IP地址；
23068 是代理服务器的端口号。

代理验证

使用静态独享、动态独享和动态共享的IP需要进行授权验证，购买后只有通过您的用户名密码或设置您的IP白名单后才能使用。

隧道共享则是通过访问飞网隧道服务器，服务器访问只对您的业务授权使用，同时支持用户名密码（Authkey和Authpwd）和IP白名单。

我们支持两种验证方式：

1.绑定您机器的IP作为白名单

如果是办公室电脑，可以访问https://ip.cn/api/index?ip=&type=0查询您的外网IP；

如果是Linux服务器，可以通过如下命令查看机器外网IP：curl myipip.net

进入会员中心，找到您所在的业务，管理白名单(包括添加删除白名单)，白名单设置详情如下图：

2.帐密验证

进入会员中心，在您所在的代理IP业务找到用于代理IP验证的用户名密钥信息（Authkey和Authpwd）。

(1).HTTP代理

通过用户名密码的进行身份认证，格式如下：

curl -x http://{key}:{passwd}@{ip}:{port} {targetUrl}

http/https代理，-x 填写的协议头只能是http，不能是https，如果填写下面那样的格式，将无法访问

curl -x https://{ip}:{port} {targetUrl}

(2).SOCKS代理

curl -x socks5://{ip}:{port} {targetUrl}

curl返回的是未渲染的html内容，这属于正常现象。

命令行测试

如果您的程序在Linux上运行，我们非常推荐您在命令行下先通过curl命令测试代理服务器的可用性，然后再进行编程。

例如您的用户名是authkey，密码是authpwd，提取到的代理IP是118.92.69.112:32105，IP白名单是36.90.191.92：32140，可执行如下命令测试代理可用性：

http/https代理，帐密模式

curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}

http/https代理，白名单模式

curl -x http://{36.90.191.92}:{32140} {targetUrl}

此示例Python使用Selenium调用Chrome浏览器并通过代理进行自动化测试。

• 代码示例

1. import time
2. import string
3. import zipfile
4. from selenium import webdriver
5. from selenium.webdriver.chrome.service import Service
7. targetURL = "http://myip.ipip.net" # 访问的目标站点
8. proxyHost = "61.171.76.145" # 代理IP地址
9. proxyPort = "50353" # 代理IP端口号
10. authKey = "x" # 代理IP的AuthKey
11. password = "x" # 代理IP的AuthPwd
14. def create_proxy_auth_extension(proxy_host, proxy_port, proxy_username, proxy_password, scheme='http',
15. plugin_path=None):
16. if plugin_path is None:
17. plugin_path = r'./{}_{}_qgnet_proxyauth_plugin.zip'.format(proxy_username, proxy_password)
19. manifest_json = """
20. {
21. "version": "1.0.0",
22. "manifest_version": 2,
23. "name": "Chrome Proxy",
24. "permissions": [
25. "proxy",
26. "tabs",
27. "unlimitedStorage",
28. "storage",
29. "",
30. "webRequest",
31. "webRequestBlocking"
32. ],
33. "background": {
34. "scripts": ["background.js"]
35. },
36. "minimum_chrome_version":"22.0.0"
37. }
38. """
40. background_js = string.Template(
41. """
42. var config = {
43. mode: "fixed_servers",
44. rules: {
45. singleProxy: {
46. scheme: "${scheme}",
47. host: "${host}",
48. port: parseInt(${port})
49. },
50. bypassList: ["localhost"]
51. }
52. };
54. chrome.proxy.settings.set({value: config, scope: "regular"}, function() {});
56. function callbackFn(details) {
57. return {
58. authCredentials: {
59. username: "${username}",
60. password: "${password}"
61. }
62. };
63. }
65. chrome.webRequest.onAuthRequired.addListener(
66. callbackFn,
67. {urls: [""]},
68. ['blocking']
69. );
70. """
71. ).substitute(
72. host=proxy_host,
73. port=proxy_port,
74. username=proxy_username,
75. password=proxy_password,
76. scheme=scheme,
77. )
79. with zipfile.ZipFile(plugin_path, 'w') as zp:
80. zp.writestr("manifest.json", manifest_json)
81. zp.writestr("background.js", background_js)
83. return plugin_path
86. if __name__ == '__main__':
87. # 此处指定您的webdriver路径，版本需要跟您所使用的Chrome版本一致，
88. # 下载地址https://registry.npmmirror.com/binary.html?path=chromedriver/
89. driver_location = "./chromedriver/chromedriver_v106_win.exe"
90. proxy_auth_plugin_path = create_proxy_auth_extension(
91. proxy_host=proxyHost,
92. proxy_port=proxyPort,
93. proxy_username=authKey,
94. proxy_password=password)
95. option = webdriver.ChromeOptions()
97. option.add_argument("--start-maximized") # 窗口最大化运行
98. option.add_extension(proxy_auth_plugin_path) # 添加proxy插件
100. # 此处selenium版本为4.8.0
101. driver = webdriver.Chrome(service=Service(driver_location), options=option)
102. driver.get(targetURL)
103. time.sleep(100)
104. driver.quit()

• 运行结果
  

此示例Python使用Selenium调用Chrome浏览器并通过代理进行自动化测试。

• 代码示例

1. from selenium import webdriver
2. from selenium.webdriver.chrome.service import Service
4. targetURL = "http://myip.ipip.net" #访问的目标站点
5. proxyAddr = "您的代理IP:端口号"
7. if __name__ == '__main__':
8. browser_location = r".\Chrome\chrome.exe" #指定浏览器路径位置
9. driver_location = r".\Chrome\chromedriver.exe" #指定Driver路径位置
11. option = webdriver.ChromeOptions()
12. option.binary_location = browser_location #设置浏览器位置
13. option.add_argument("--start-maximized") #窗口最大化运行
14. option.add_argument('--proxy-server=%(server)s' % {"server": proxyAddr})
16. driver = webdriver.Chrome(service=Service(driver_location), options=option)
17. driver.get(targetURL)
18. print(driver.page_source)

• 运行结果

1. import base64
2. import time
3. import requests
4. from requests.adapters import HTTPAdapter
5. auth_key = "请改成您的Key"
6. password = "请改成您的AuthPwd"
7. tunnel_server = "http://请改成您的隧道地址" # 如：tunnel3.qg.net:19263
8. target_url = "https://ip.cn/api/index?ip=&type=0" # 要访问的目标地址
9. proxy_headers = {}
10. proxy = {
11. "http": tunnel_server,
12. "https": tunnel_server
13. }
14. def encode_authorization(key, passwd):
15. # python 使用 bytes 类型进行 base64 编码
16. basic_str = bytes("%s:%s" % (key, passwd), "ascii")
17. # 得到的返回值也是 bytes 类型，所以需要再 decode 为字符串
18. return "Basic %s" % base64.b64encode(basic_str).decode("utf-8")
19. def reset_tunnel_proxy_headers():
20. global proxy_headers
21. proxy_headers = {
22. tunnel_server: {
23. "Proxy-Authorization": encode_authorization(auth_key, password)
24. }
25. }
26. def update_tunnel_proxy_headers(key, val):
27. global proxy_headers
28. proxy_headers[tunnel_server][key] = val
29. def new_session():
30. adapter = TunnelProxyAdapter()
31. se = requests.Session()
32. se.mount('https://', adapter)
33. se.mount('http://', adapter)
34. return se
35. class TunnelProxyAdapter(requests.adapters.HTTPAdapter):
36. def proxy_headers(self, p):
37. if p in proxy_headers:
38. print("session with headers:", proxy_headers[p])
39. return proxy_headers[p]
40. else:
41. return None
42. def multi_channel_tunnel():
43. """
44. 结果类似：
45. request on multi channel
46. request id: 1 , channel id: channel-1, code: 200, result: 183.155.88.224
47. request id: 2 , channel id: channel-2, code: 200, result: 125.112.38.153
48. request id: 3 , channel id: channel-3, code: 200, result: 183.155.89.125
49. request id: 4 , channel id: channel-4, code: 200, result: 49.71.121.169
50. request id: 5 , channel id: channel-5, code: 200, result: 115.210.67.220
51. request id: 6 , channel id: channel-6, code: 200, result: 36.25.41.178
52. request id: 7 , channel id: channel-7, code: 200, result: 180.125.162.116
53. request id: 8 , channel id: channel-8, code: 200, result: 140.250.150.158
54. request id: 9 , channel id: channel-9, code: 200, result: 121.227.102.227
55. request id: 10, channel id: channel-10, code: 200, result: 49.88.106.198
56. request id: 1 , channel id: channel-1, code: 200, result: 183.155.88.224
57. request id: 2 , channel id: channel-2, code: 200, result: 125.112.38.153
58. request id: 3 , channel id: channel-3, code: 200, result: 183.155.89.125
59. request id: 4 , channel id: channel-4, code: 200, result: 49.71.121.169
60. request id: 5 , channel id: channel-5, code: 200, result: 115.210.67.220
61. request id: 6 , channel id: channel-6, code: 200, result: 36.25.41.178
62. request id: 7 , channel id: channel-7, code: 200, result: 180.125.162.116
63. request id: 8 , channel id: channel-8, code: 200, result: 140.250.150.158
64. request id: 9 , channel id: channel-9, code: 200, result: 121.227.102.227
65. request id: 10, channel id: channel-10, code: 200, result: 49.88.106.198
66. """
67. print("request on multi channel")
68. reset_tunnel_proxy_headers()
69. for i in range(1, 11):
70. se = new_session()
71. chan_id = "channel-%s" % i
72. update_tunnel_proxy_headers("Proxy-TunnelID", chan_id)
73. resp = se.get(target_url, proxies=proxy, headers={"Connection": "close"})
74. print("request id: %-2s, channel id: %s, code: %s, result: %s" % (i, chan_id, resp.status_code, resp.text))
75. time.sleep(10)
76. # 因为固定时长为1分钟，所以在1分钟内继续使用已有通道，仍是之前的IP
77. for i in range(1, 11):
78. se = new_session()
79. chan_id = "channel-%s" % i
80. update_tunnel_proxy_headers("Proxy-TunnelID", chan_id)
81. resp = se.get(target_url, proxies=proxy, headers={"Connection": "close"})
82. print("request id: %-2s, channel id: %s, code: %s, result: %s" % (i, chan_id, resp.status_code, resp.text))
83. if __name__ == "__main__":
84. multi_channel_tunnel()

1. package main
3. import (
4. "fmt"
5. "io/ioutil"
6. "net/http"
7. "net/url"
8. "sync"
9. "time"
10. )
12. /** 返回内容
13. 第一次循环
14. 当前 IP：121.230.91.188 来自于：中国 江苏 泰州 电信
15. 当前 IP：60.184.205.115 来自于：中国 浙江 丽水 电信
16. 当前 IP：125.112.205.149 来自于：中国 浙江 金华 电信
17. 当前 IP：60.184.108.175 来自于：中国 浙江 丽水 电信
18. 当前 IP：58.214.87.31 来自于：中国 江苏 无锡 电信
19. 当前 IP：183.143.131.24 来自于：中国 浙江 湖州 电信
20. 当前 IP：42.53.99.119 来自于：中国 辽宁 锦州 联通
21. 当前 IP：59.60.142.70 来自于：中国 福建 漳州 电信
22. 当前 IP：114.226.175.159 来自于：中国 江苏 常州 电信
23. 当前 IP：123.162.194.223 来自于：中国 河南 驻马店 电信
24. max channel reached
25. 第二次循环
26. 当前 IP：114.226.175.159 来自于：中国 江苏 常州 电信
27. 当前 IP：60.184.205.115 来自于：中国 浙江 丽水 电信
28. 当前 IP：121.230.91.188 来自于：中国 江苏 泰州 电信
29. 当前 IP：125.112.205.149 来自于：中国 浙江 金华 电信
30. 当前 IP：123.162.194.223 来自于：中国 河南 驻马店 电信
31. 当前 IP：58.214.87.31 来自于：中国 江苏 无锡 电信
32. 当前 IP：183.143.131.24 来自于：中国 浙江 湖州 电信
33. 当前 IP：60.184.108.175 来自于：中国 浙江 丽水 电信
34. 当前 IP：59.60.142.70 来自于：中国 福建 漳州 电信
35. 当前 IP：42.53.99.119 来自于：中国 辽宁 锦州 联通
36. 第二次循环返回的IP与第一次循环相同，因为goroutine是异步的，所以返回顺序和第一次不一致
37. myip.ipip.net服务器可能比较容易失败，用户可以自己找一个其他获取客户端IP的服务器来测试
38. */
39. // 固定时长多通道隧道模式
40. func main() {
41. authKey := "请改成您的Key" //固定时长1分钟的隧道，通道数10
42. password := "请改成您的AuthPwd"
43. proxyServer := "请改成您的隧道地址" //如：tunnel3.qg.net:19263
44. targetURL := "https://ip.cn/api/index?ip=&type=0"
45. rawURL := fmt.Sprintf("http://%s:%s@%s", authKey, password, proxyServer)
46. proxyUrl, _ := url.Parse(rawURL)
47. wg := sync.WaitGroup{}
48. wg.Add(11)
49. // 十个通道分别使用不同的十个IP，第十一次会返回错误，通道数超出
50. for i := 0; i < 11; i++ {
51. go func(index int) {
52. defer wg.Done()
53. client := http.Client{
54. Transport: &http.Transport{
55. ProxyConnectHeader: http.Header{
56. "Proxy-TunnelID": []string{fmt.Sprintf("channel-%d", index)}, // 指定通道ID
57. },
58. Proxy: http.ProxyURL(proxyUrl),
59. },
60. }
61. req, _ := http.NewRequest("GET", targetURL, nil)
62. rsp, err := client.Do(req)
63. if err != nil {
64. fmt.Printf("request failed: %s\n", err)
65. return
66. }
67. defer rsp.Body.Close()
68. body, err := ioutil.ReadAll(rsp.Body)
69. if err != nil {
70. fmt.Println(err)
71. } else {
72. fmt.Println(string(body))
73. }
74. }(i)
75. }
76. wg.Wait()
77. // 因为固定时长为1分钟，所以在1分钟内继续使用已有通道，仍是之前的IP
78. time.Sleep(time.Second * 10)
79. wg.Add(10)
80. for i := 0; i < 10; i++ {
81. go func(index int) {
82. defer wg.Done()
83. client := http.Client{
84. Transport: &http.Transport{
85. ProxyConnectHeader: http.Header{
86. "Proxy-TunnelID": []string{fmt.Sprintf("channel-%d", index)}, // 指定通道ID
87. },
88. Proxy: http.ProxyURL(proxyUrl),
89. },
90. }
91. req, _ := http.NewRequest("GET", targetURL, nil)
92. rsp, err := client.Do(req)
93. if err != nil {
94. fmt.Printf("request failed: %s\n", err)
95. return
96. }
97. defer rsp.Body.Close()
98. body, err := ioutil.ReadAll(rsp.Body)
99. if err != nil {
100. fmt.Println(err)
101. } else {
102. fmt.Println(string(body))
103. }
104. }(i)
105. }
106. wg.Wait()
107. }