# IP白名单

### 1024Proxy 添加 IP 白名单功能是什么？

IP 白名单（IP Whitelist） 是 1024Proxy 提供的一种免账号密码认证的代理使用方式。 除了常见的账密认证（Username & Password Authentication）模式外，IP 白名单为用户提供了更加便捷、高效的授权方案。

通过将可信任的本地出口 IP添加至 IP 白名单，系统会自动识别请求来源。只要请求来自白名单内的 IP，即可直接调用 API 接口并使用代理 IP，无需在请求中再填写用户名和密码，从而简化了配置流程。

#### IP 白名单的核心优势

免账密认证：无需在代码或工具中暴露用户名和密码

配置更简单：适合固定服务器或云主机环境

安全可控：仅允许白名单 IP 访问代理资源

更适合自动化：减少参数配置，降低出错概率

对于有固定出口 IP 的用户来说，IP 白名单是一种更稳定、更安全的使用方式。

### 适用应用场景

IP 白名单模式特别适合以下场景：

自动化脚本与爬虫程序 避免在代码中硬编码账号密码，提高安全性

企业级或多项目调用 多个服务通过同一出口 IP 调用代理，统一管理更方便

API 高并发调用场景 减少认证步骤，提高请求效率与稳定性

对安全性要求较高的业务 防止账号密码泄露或被滥用

### 如何使用 IP 白名单？

{% stepper %}
{% step %}

### 获取本地出口 IP

在使用 IP 白名单前，请先确认你当前设备或服务器的公网出口 IP。 你可以通过访问 IP 查询网站或在服务器中执行相关命令获取。
{% endstep %}

{% step %}

### 添加 IP 至白名单

登录 1024Proxy 用户后台，在 IP 白名单 页面中，将你的公网 IP 添加到白名单列表中并保存设置。

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2FYSYP8qDKwJ1PPE33KU1D%2F1.png?alt=media&#x26;token=2fb88999-7415-4d16-a616-a70bf464eed9" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
仅支持添加 公网 IP

如 IP 发生变更，需要及时更新白名单，否则将无法正常使用代理
{% endhint %}

{% endstep %}

{% step %}

### 直接调用代理或 API

成功添加白名单后，即可在API模式中调用API，省略用户名和密码参数，系统会根据请求来源 IP 自动完成身份校验。

<figure><img src="https://724087567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlZfA4dcwPR9HllRofHVl%2Fuploads%2F6RLPsm9pe1QHn4lg9mKW%2F2.png?alt=media&#x26;token=81404331-15c0-45db-bcce-246616e30b96" alt=""><figcaption></figcaption></figure>

这种方式特别适合长期运行的程序和服务端业务，能显著降低配置复杂度。
{% endstep %}
{% endstepper %}

#### 使用建议与注意事项

* 建议仅将可信任的固定 IP加入白名单
* 不要随意添加动态 IP 或公共网络 IP
* 定期检查并清理不再使用的白名单 IP
* 如使用多台服务器，可分别添加对应出口 IP