> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/cn/dai-li/residential-proxies/whitelisting-ips.md).

# IP 白名单

IP 白名单机制可让您只需通过白名单 IP 连接，即可访问我们的住宅代理池。 

{% hint style="info" %}
您只能添加 IPv4 格式（xx.xx.xx.xx）的 IP。请确保您要添加的 IP 属于您自己，并且您 **当前没有使用 代理 或 VPN 服务** 。
{% endhint %}

#### 创建 IP 白名单

要将 IP 地址加入白名单，请登录 [**仪表板**](https://dashboard.oxylabs.io/)，在左侧选择 **住宅代理** → **白名单**，点击 **编辑白名单**。输入 **最多 10 个 IP** ，使用文本格式并点击提交。

{% hint style="info" %}
如果需要区分代理用户之间的流量统计，我们建议不要使用白名单 IP 功能，尤其是在同一个公网 IP 可能会被多个服务用户（团队、部门等）共享的情况下。 

**注意：** 如果使用浏览器或无头浏览器，它会尝试在不使用常规认证的情况下使用代理，并且只有在收到一个 `407`.
{% endhint %}

如果您想删除或更新列表，请将其作为文本文档进行编辑，然后点击 **提交**。如果您需要更多 IP，请通过以下方式联系我们的客服团队： [**support@oxylabs.io**](mailto:support@oxylabs.io) ，或通过我们 [**网站**](https://oxylabs.io/) 或您的 Oxylabs 仪表板。IP 白名单机制可让您只需通过白名单 IP 连接，即可访问我们的住宅代理池。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/cn/dai-li/residential-proxies/whitelisting-ips.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.