隧道代理（全球HTTP）使用指南-文档中心-青果网络

## 1 步骤说明

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

![image-20230613163430496](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-06-13/1634397bf99ea.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 测试代理的可用性

隧道代理（全球HTTP）支持密钥验证和白名单两种验证方式，建议先在本机测试；

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

## 4 使用方法

此处的隧道代理（全球HTTP）以curl为例，解释使用方法。

### 4.1 白名单模式

在使用了白名单模式时，不需要添加authkey和authpwd。

```
curl -x {隧道服务器} {目标url}
// 例子
curl -x overseas.tunnel.qg.net:15561 www.baidu.com
```

### 4.2 账密模式

账密模式下需要在请求中加入authkey和authkey，authkey和authkey可以在控制台中查看。

```
curl -x {authkey}:{authkey}@{隧道服务器} {目标url}
// 例子
curl -x HBRMO154:4799868CE54@@overseas.tunnel.qg.net:15561 www.baidu.com
```

### 4.3 指定使用某个国家的IP

因为隧道代理每次请求都会随机更换IP，如果你希望随机范围限定在某个国家，可以通过添加国家编码参数来指定使用某个国家的IP。具体编码请查看 [区域编码表](https://www.qg.net/doc/1975.html)
```curl
curl -x {authkey}:{authpwd}:A{国家编码}@{隧道服务器} {目标url}
// 例子，指定使用美国IP
curl -x HBRMO154:4799868CE54:A990100@overseas.tunnel.qg.net:15561 www.baidu.com
```
### 4.4 保持IP不变
如果用户需要多个请求在维持一个IP，比如：需要登录,获取数据两个请求在一个IP下,则可对IP进行打标记，通过标记请求在代理有效期内使用相同的代理IP，并且可以支持设定该通道的存活时间。
```curl
curl -x {authkey}:{authpwd}:C{自定义通道名}:T{存活时间}:A{国家编码}@{隧道服务器} {目标url}
// 例子，通道名自定义为100，存活时间设为60秒
curl -x HBRMO154:4799868CE54:Cchannel-1:T60:A990100@overseas.tunnel.qg.net:15561 www.baidu.com
```
**注意：如果需要保持IP不变一段时间，那么不可以使用通用的overseas.tunnel.qg.net域名，需要使用特定地区的服务器域名，比如：overseas-us.tunnel.qg.net/overseas-hk.tunnel.qg.net等!!!否则服务器无法保证是否可以保持IP不变。**

### 4.5 指定隧道服务器
为了降低使用隧道服务的延迟，青果网络为隧道代理（全球HTTP）提供了多个隧道服务器，用户可根据自身的使用情况就近选择隧道服务器。隧道服务器的地址可在控制台中查看。
```curl
curl -x {authkey}:{authpwd}:C{自定义通道名}:T{存活时间}:A{国家编码}@{隧道服务器} {目标url}
// 例子，更换隧道服务器为美国的隧道服务器
curl -x HBRMO154:4799868CE54:Cchannel-1:T60:A990100@overseas-us.tunnel.qg.net:15561 www.baidu.com
```

## 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)

## 7 代码样例

- [调用API ＞ ](https://www.qg.net/doc/1940.html )

- [隧道代理（全球HTTP）代码示例 ＞](https://www.qg.net/doc/sdk/9_230/1879.html )

青果云

电商云

云代付

服务器租用

服务器托管

整机柜托管

动态共享

动态独享

隧道代理

静态独享

云电脑

拨号VPS

融合CDN

电商浏览器

云手机

实名认证

堡垒机

励销云搜客宝

励销云CRM

励销云SCRM

励销云电话机器人

使用指南

隧道代理（全球HTTP）使用指南