测试代理的可用性-文档中心-青果网络

## 1 概述
短效代理、独享代理和长效代理通过API获取代理IP后，您就可以在程序里通过代理服务器获取网页数据。

隧道代理无需调用API获取代理，在【[会员中心](https://www.qg.net/user)】查看隧道的IP和端口号，对接隧道服务即可。
独享代理（地区锁）则需要在业务操作列表通过【IP管理】去添加城市线路和拨号IP获取代理IP，并保持城市线路不变。

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

## 2 代理验证
使用短效代理、独享代理和长效代理的IP需要进行授权验证，购买后只有通过您的用户名密码或设置白名单验证后才能使用。

隧道代理则是接入青果隧道服务器即可，隧道服务验证方式同样支持用户名密码（Authkey和Authpwd）和白名单验证；

需要注意的是，白名单的添加需在未提取IP前添加；短效代理产品的不同key，不能添加相同的白名单IP。

我们支持两种验证方式：

### 2.1 绑定您机器的IP作为白名单
 
如果是办公室电脑，可以访问[https://ip.cn/api/index?ip=&type=0](https://ip.cn/api/index?ip=&type=0)查询您的外网IP；

如果是Linux服务器，可以通过如下命令查看机器外网IP：`curl https://d.qg.net/ip`

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

![image-20221118153336850](https://article.qg.net/Uploads/image/2022-11-18/153339f433560.png)

![image-20211026174620025](https://article.qg.net/Uploads/image/2021-10-29/11464279443ae.png)

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

![image-20221118153016258](https://article.qg.net/Uploads/image/2022-11-18/1530181f262b5.png)

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

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

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

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

**Socks代理**
```
curl -x socks5://{ip}:{port} {targetUrl}
```

curl返回的是未渲染的html内容，这属于正常现象，请参见[代码样例](https://www.qg.net/list/192.html)。

### 2.3 命令行测试
如果您的程序在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}
```

##3 代码样例

- [代码示例 - Java](https://www.qg.net/doc/1698.html "代码示例--Java")
- [代码示例 - PHP](https://www.qg.net/doc/1696.html "代码示例--PHP")
- [代码示例 - Python](https://www.qg.net/doc/1697.html "代码示例--Python")
- [代码示例 - GO](https://www.qg.net/doc/1695.html "代码示例--GO")
- [代码示例 - C语言](https://www.qg.net/doc/1694.html "代码示例--C语言")