白名单设置-开发者指南-青果网络

## 1 概述
为了保证您购买的代理业务只有您的服务器才能使用，我们采用了IP白名单验证方式，通过设置IP白名单IP，除了您指定的服务器IP外，其他IP不能使用。

白名单可以免密钥验证，免费IP白名单鉴权数量高达256个，也就是说购买后您有256台独立外网IP的机器可以使用。不限制同时使用的终端设备数量，满足多业务需求。

需要注意的是，要在未提取IP之前添加白名单；
同个账号内不同key的白名单IP若有冲突可联系售前或售后处理。

## 2 步骤说明

### 2.1 先查到您要使用的机器的外网IP。

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

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

### 2.2 绑定您机器的IP作为白名单

根据您购买的代理业务，您可以在【会员中心-列表操作-白名单】或调试工具添加IP白名单，完成设置后，这些IP对应的机器就可以正常使用了。

**2.2.1 白名单管理**

进入控制台，点击【代理IP】菜单，找到您所要使用的业务，点击其右侧【更多】下的【业务设置】-【白名单管理】，进入设置；

![image-20251027171122062](https://article.qg.net/Uploads%2Fimage%2F2025-10-27%2F171122de96453.png)

你可以在该页面方框中对白名单IP进行增加、删除、修改，设置完毕后点击【提交】。
详情如下图：
![image-20251027171346450](https://article.qg.net/Uploads%2Fimage%2F2025-10-27%2F1713469e3aa6a.png)

** 2.2.2 调试工具**

在调试工具上勾选要使用的业务key，选择【IP白名单】模块相关操作接口，包括添加、删除和查询，输入您的机器外网IP，点击测试即可完成设置。详情如下图：

![image-20221020170632560](https://article.qg.net/Uploads/image/2022-10-20/170634d6feace.png)

![image-20221020173708797](https://article.qg.net/Uploads/image/2022-10-20/173710aa4f23f.png)

### 2.3 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＞")