隧道代理（固定时长）使用指南-文档中心-青果网络

## 1 步骤说明

1. 在开通隧道代理IP后，单击网站右上角的【控制台】，进入后台管理面板，在左侧栏目里选择【代理IP】-【按时/按量业务】，找到已经开通的隧道代理业务；
   ![image-20221119161844905](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/161846b898eee.png)![image-20230608102558525](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-06-08/102607639526b.png)

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

3. 参考[代码样例](https://www.qg.net/list/192.html)请求隧道代理；

4. 在程序中通过调用API接口获取代理，然后请求目标网站。
   1. API调用需要验证，验证方式包括密钥验证和白名单验证，根据实际使用自主选择；
   2. 密钥验证方式请求头带Authkey和Authpwd信息即可；
   3. 添加白名单可以免密，添加白名单后大概在30s之后生效。

## 2 API列表

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

| 接口类型 | 接口 |
| ---------- | ------------------------------------------------------------ |
| 白名单管理 | [添加白名单IP](https://www.qg.net/doc/178.html "添加白名单IP") [删除白名单IP](https://www.qg.net/doc/179.html "删除白名单IP") [查询白名单IP](https://www.qg.net/doc/180.html "[查询白名单IP]") |

## 3 测试代理的可用性

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

[查看测试步骤 ＞](https://www.qg.net/doc/1574.html "查看测试步骤 ＞")

## 4 使用模式

隧道代理（固定时长）可以切换两种使用模式：云端模式、客户端模式。

云端模式指的是直接使用青果网络提供的隧道代理服务器，简单易用。

客户端模式指的是使用青果网络提供的隧道代理程序，部署在自己的机器上，适用性更好。

### 4.1 云端模式
云端模式支持在请求参数中指定自定义的通道名称。
通道的IP在有效期内保持不变，如果短时间内需要使用相同的IP，请使用相同的通道名称即可。
以下为简单的python代码示例：
```python
proxyUrl = "http://%(user)s:%(password)s:%(channel)s@%(server)s" % {
    "user": authKey,
    "password": password,
    "channel": "channel-1",
    "server": proxyAddr,
}
```

### 4.2 客户端模式

#### 4.2.1 安装并启用客户端

1. 使用SSH连接工具，连接到您的Linux服务器。[如何连接？](https://www.qg.net/doc/1801.html)
2. 根据系统执行相应命令开始安装
   1. Centos安装脚本：`rpm -Uvh https://d.qg.net/qgproxy-client-1.0.0-release.x86_64.rpm`
   2. Ubuntu安装脚本：`dpkg -i https://d.qg.net/qgproxy-client_1.0.0-release_amd64.deb`
   3. 安装结果：![](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-02-24/191441a309a53.png)
3. 将自己Authkey和Authpwd写入到配置文件中并保存。`vi /etc/qgproxy-client/qgproxy-client.toml`![image-20230224180018515](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-02-24/191441b11a379.png)
4. 重新加载配置文件并启动服务：`systemctl daemon-reload && systemctl start qgproxy-client`
5. 查看服务状态：`systemctl status qgproxy-client.service`![image-20230224181319409](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-02-24/1914410cb122f.png)
6. 查看端口监听是否开启：`netstat -atnp |grep LISTEN`![image-20230224181420945](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-02-24/19144108cc127.png)

#### 4.2.2 使用线程池模式获取IP

每个爬虫线程访问固定的本地代理端口（默认30000端口起），由客户端来管理和绑定该端口对应的出口IP，每个端口绑定的出口IP在IP有效期内固定不变。详情如图所示：
![image-20230608134006330](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-06-08/134007d162258.png)

执行命令，测试查看出口IP地址：`curl -x 127.0.0.1:30000 d.qg.net/ip`

通过下图可以看到，30000端口和30001的出口IP不同，且在IP有效期内保持不变。

![image-20230224190127491](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-02-24/191441bb0a941.png)

#### 4.2.3 使用隧道模式获取IP

爬虫只需访问唯一的本地代理端口（默认20000端口），每个请求将随机分发到该端口映射的多个出口IP的其中之一。

![image-20230608134035701](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-06-08/1340378413a6d.png)

执行命令，测试查看出口IP地址：`curl -x 127.0.0.1:20000 d.qg.net/ip`

通过下图可以看到，每次请求获取到的IP是不同的。但是这个IP池的大小取决于您所购买的通道数数量。

![image-20230224185853571](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-02-24/191441356e8fe.png)

## 5 错误码一览表

| HTTP返回码 | 说明 |
| :--------- | :----------------------------------------------------------- |
| 400 | 客户端错误。客户端协议无法被识别； |
| 431 | 请求头过大。出现在http代理中，header头部信息过多导致； |
| 302 | 出现302一般有两种情况： （1）.客户端IP为海外IP，服务器会重定向到预警页面； （2）.客户端访问的目标站被拦截，比如银行网站、邮箱、社交软件等，服务器返回重定向到预警页面； |
| 407 | 授权错误，出现407一般有两种情况： (1).白名单模式，可能是用户有多出口IP，没有全部添加到白名单；或可能连接使用IP资源，是添加白名单前获取的，白名单未对其生效； (2).账密模式，可能是账密信息错误； （3）共享IP产品中可能是IP已过期； |
| 408 | 目标站不可达。服务端与目标站建连失败，服务端不可达或者当前代理IP掉线； |
| 429 | 请求数超出。隧道产品中用户QPS大于购买的请求数；独享和共享产品中，用户当前的代理tcp连接超出限制数； |
| 508 | 代理目标站为代理IP地址导致死循环。一般不出现； |
| 503 | 当前代理协议不支持，比如ss代理协议； |

## 6 代理请求数据统计

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

同时IP请求统计还提供几种常见的错误类型分析，如请求成功、授权失败、请求数超出、连接超时等，助力数据高效采集。
![image-20221108103607172](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-08/103608ff884e9.png)

青果云

电商云

云代付

服务器租用

服务器托管

整机柜托管

动态共享

动态独享

隧道代理

静态独享

云电脑

拨号VPS

融合CDN

电商浏览器

云手机

实名认证

堡垒机

励销云搜客宝

励销云CRM

励销云SCRM

励销云电话机器人

产品介绍

隧道代理（固定时长）使用指南