隧道代理开发者指南（动态请求）-使用指南-青果网络

青果隧道代理与其他形式的代理IP不同，不需要API接口即可连接使用代理IP，因此省去了获取IP和管理IP池等动作。以下介绍如何用代码方式，快速使用隧道代理。

## 步骤总览

![image-20240506110951591](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-05-06%2F110951e2b8889.png)

## 一、获取隧道地址

1.在青果完成产品购买后，就会自动进入控制后台，看到如以下的页面，产品列中就有隧道地址；

![image-20240429165920934](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-29%2F165921b79228f.png)
**请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。

## 二、授权验证

获取到隧道地址之后，还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式，可自主选择使用。

白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；

账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。

![image-20240429170736889](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-29%2F170736df1d19c.png)
详细步骤可查看[代理验证 ＞](https://www.qg.net/doc/use/8_244/1574.html)

## 三、代理测试

在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。

以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。

`curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`

![image-20240429171647434](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-29%2F171647213d98a.png)

若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。

## 四、编写采集程序

测试代理可用后，便可开始编写代理采集程序了。

青果提供了多种编程语言的代码示例以及SDK下载包供开发者参考，

详情查看
- [SDK下载](https://www.qg.net/doc/sdk/9_230/1745.html)
- [隧道代理 Go 语言接入指南](https://www.qg.net/doc/1872.html)
- [隧道代理 Python 语言接入指南](https://www.qg.net/doc/1879.html)

**注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。

青果云

电商云

云代付

服务器租用

服务器托管

整机柜托管

动态共享

动态独享

隧道代理

静态独享

云电脑

拨号VPS

融合CDN

电商浏览器

云手机

实名认证

堡垒机

使用指南

隧道代理开发者指南（动态请求）