# IP 白名单

本指南介绍如何在 Rapidproxy 中为动态（轮换）住宅代理配置**IP 白名单**。IP 白名单允许您通过批准特定 IP 地址来验证代理访问，而无需使用用户名和密码进行验证。

***

#### 什么是IP白名单？ <a href="#what-is-ip-whitelisting" id="what-is-ip-whitelisting"></a>

IP白名单是一种身份验证方法，它只允许经过批准的IP地址访问您的代理资源。

启用 IP 白名单后：

* 允许**来自白名单 IP 地址的**请求。
* **来自非白名单 IP 的**请求将被拒绝
* 身份验证无需用户名或密码。

这种方法通常用于具有固定出站 IP 的**服务器、云实例和基于 API 的集成**。

***

#### 如何配置IP白名单 <a href="#how-to-configure-ip-whitelisting" id="how-to-configure-ip-whitelisting"></a>

请按照以下步骤将您的IP地址添加到白名单中。

**第一步：登录用户中心**

1. [登录您的 Rapidproxy 帐户](https://docs.rapidproxy.io/proxies/dynamic-residential-proxy/get-proxy/api/ip-whitelisting#how-to-configure-ip-whitelisting)。
2. 进入**用户中心（UCenter）**&#x63A7;制面板。

***

**步骤 2：导航至轮换住宅代理**

从仪表盘菜单：

1. 前往**轮换住宅代理**
2. 点&#x51FB;**“使用代理”**

本节包含动态住宅代理使用的配置选项。

***

**步骤 3：打开白名单设置**

**在 Use Proxy （使用代理）**&#x9875;面中：

1. 找到 **WhiteList（白名单）**&#x90E8;分
2. 您将看到当前已加入白名单的 IP 地址列表（如有）。

<figure><img src="https://docs.rapidproxy.io/~gitbook/image?url=https%3A%2F%2F3714437495-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYesC7FUvYuYg4WiqU6o7%252Fuploads%252F391Kgcyvfvz5YDSS23Xq%252Fwhitelist.png%3Falt%3Dmedia%26token%3D61a0d665-2c2c-4929-9060-00b7d9e22809&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=4db44e01&#x26;sv=2" alt=""><figcaption></figcaption></figure>

***

**步骤 4：添加您当前的 IP 地址**

Rapidproxy 会自动检测您**当前的公网 IP 地址**。

将其添加到白名单：

1. 在白名单部分查找检测到的 IP 地址
2. 点击当前 IP 地址旁边&#x7684;**“+”图标**
3. IP地址将立即添加到您的白名单中。

<figure><img src="https://docs.rapidproxy.io/~gitbook/image?url=https%3A%2F%2F3714437495-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYesC7FUvYuYg4WiqU6o7%252Fuploads%252F5MALoN0oa9BqvTCsDoQf%252Fcurrentip.png%3Falt%3Dmedia%26token%3D036e3516-d562-4105-a430-6e24714a9f3a&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=4a9cc014&#x26;sv=2" alt=""><figcaption></figcaption></figure>

添加当前 IP 地址无需手动输入。

> **注意：**&#x5982;果您从动态网络访问控制面板，您的 IP 地址可能会发生变化。请确保白名单中的 IP 地址与您的服务器或应用程序的出站 IP 地址匹配。

***

#### 管理白名单IP <a href="#managing-whitelisted-ips" id="managing-whitelisted-ips"></a>

在**白名单**部分，您可以：

* 根据需要添加多个 IP 地址
* 删除不再使用的IP地址
* 无需重启服务即可随时更新白名单

更改保存后立即生效。

***

#### 何时使用 IP 白名单 <a href="#when-to-use-ip-whitelisting" id="when-to-use-ip-whitelisting"></a>

如果出现以下情况，建议将 IP 地址加入白名单：

* 您正在从**固定服务器或云 IP运行代理。**
* 您应该避免将凭据嵌入代码中。
* **您正在通过基于 API 的系统**访问代理。
* 您的环境不支持安全的用户名/密码身份验证。

如果您的 IP 地址经常变化（例如，住宅网络或移动网络），则用户名/密码验证可能更合适。

***

#### 故障排除 <a href="#troubleshooting" id="troubleshooting"></a>

如果在启用 IP 白名单后代理连接失败：

* 请确保将您**当前的出站 IP**地址添加到白名单中。
* 确认请求来自您已加入白名单的同一 IP 地址。
* 删除未使用或过时的 IP 地址

如果问题仍然存在，请联系 Rapidproxy 技术支持寻求帮助。

***

#### 需要帮助吗？ <a href="#need-help" id="need-help"></a>

如果您对 IP 白名单或代理身份验证有任何疑问：

* 请使用Rapidproxy 网站上的**在线实时聊天**功能
* 请发送电子邮件**至 <support@rapidproxy.io>**

技术支持可以帮助您验证配置并解决访问问题。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rapidproxy.io/simplified-mandarin/dai-li/dong-tai-zhu-zhai-dai-li/huo-qu-dai-li/api/ip-bai-ming-dan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
