# IP 白名单
IP 白名单的功能是允许通过列入白名单的 IP 地址通过简单连接访问住宅代理池。在本指南中，您将找到通过白名单进行身份验证使用 **Thordata动态住宅代理** 所需的所有基础信息。
{% stepper %}
{% step %}
### **注册登录**
访问[**Thordata官网**](https://www.thordata.com/)，完成账户注册并登录。
{% endstep %}
{% step %}
### **购买套餐**
进入仪表板后，依次导航至 **代理 → 住宅代理 → 定价** ，根据业务需求选择适用套餐规格，完成支付即可开通服务。
{% endstep %}
{% step %}
### **白名单 IP设置**
#### **添加白名单IP**
① **仪表板**中依次导航至 **代理 → 住宅代理 → 代理设置 → 白名单** ，点击 **批量添加** 按钮即可添加IP。
② 点击 **批量添加** 后，按照格式输入正确的IP。
#### **管理白名单IP**
**①** 时间范围**筛选**
设定起止日期范围，检索该时段内添加的IP白名单记录
**②** 精确IP**定位**
输入完整IP地址，直接定位特定白名单条目
**③** 选择IP**状态**
服务器状态分为**启用和停用**
④ 账户信息**编辑**
点击 **编辑** 按钮，可更新IP地址、启用/禁用状态及备注
⑤ 账户**删除**操作
单账户删除：点击编辑中 **删除** 按钮
批量删除：勾选多个账户后使用 **一键删除** 功能
{% hint style="success" %}
白名单添加规范
* 仅接受 IPv4 格式地址（示例：**`192.168.1.1`**）
* 必须添加**归属您本人**的IP地址，避免使用代理/VPN等第三方IP
* 白名单IP总数上限：10个
{% endhint %}
{% endstep %}
{% step %}
### **国家条目代理获取**
① 依此点击 **代理** → **住宅代理** → **端点生成器** 进入代理信息生成界面；
② **认证方式：** 选择白名单 ，如果您还未添加白名单，请点击**【立即新增】**进行创建
③ **端点类型**：选择国家条目
④ **位置设定**：根据您需要的代理地区选择国家/地区，详细具体国家/地区的入口节点请参考[**国家/地区入口节点**](/doc/zh/proxies/residential-proxies/location-settings/region-entry.md)
⑤ **会话设定** ：
**轮换会话**：即每次请求自动切换IP，适合需要高匿名性的业务需求
**黏性会话**：可以选择1-90分钟的会话保持时长，适合需要会话连续性的业务需求
⑥ **提出请求**：通过将你的 IP 地址添加到 Thordata 的白名单，你可以直接使用代理服务而无需在每次请求中包含认证账密。配置完成后，可通过指定的代理端点直接发送请求，快速访问目标服务
```sh
curl -x "http://pr.thordata.net:10000" "https://ipinfo.thordata.com"
```
⑦ **输出格式**：
系统将根据您的配置生成单字符串代理凭证，格式为：`代理地址:代理端口`
按需选择输出格式、设置代理数量并指定连接[**协议**](/doc/zh/proxies/residential-proxies/protocol.md)，即可生成并启用代
{% endstep %}
{% step %}
### **API链接获取**
① 依此点击 **代理** → **住宅代理** → **端点生成器** 进入代理信息生成界面；
② **认证方式：** 选择白名单 ，如果您还未添加白名单，请点击【立即新增】进行创建
③ **端点类型**：选择**API链接**
④ **参数设定：选择您需要的数量及国家/地区**
若需要调整提取的IP数量，请修改`number`参数。若需要调整提取的国家/地区，请修改`country`参数。
⑤ **会话设定** ：
**轮换会话**：即每次请求自动切换IP，适合需要高匿名性的业务需求
**黏性会话**：可以选择1-90分钟的会话保持时长，适合需要会话连续性的业务需求
如需要调整会话类型，请修改`sessid`参数，1代表黏性会话、2代表轮换会话。例如，需要使用轮换会话，将`sessid`参数修改为`sessid=2`
链接示例：提取10个会话类型为轮换的加拿大IP，生成链接为：
```
https://get-ip.thordata.net/api?td-customer=Thor46155928&sesstype=2&number=10&country=ca
```
⑥提取使用：
点击**生成结果**生成IP列表或复制API链接配置使用
{% hint style="info" %}
在配置代理时，你选择的会话模式（固定 IP 或动态 IP）会生成入口节点地址，请注意，该页面显示的 IP 只是系统对接 ID，并非真实使用的IP，你最终使用的不同真实出口 IP 会在你实际访问网站时，根据选择的端口动态分配。
{% endhint %}
{% endstep %}
{% step %}
### **使用情况统计**
您可以通过访问 Thordata仪表板查看动态住宅代理的使用情况统计。进入仪表板后，依次导航至 **代理 → 住宅代理 → 统计** 界面，可以按照时间、身份类型（账户或白名单）、**账户层级**：主账户或指定子账户、地区、目标等维度筛选流量使用数据。
{% endstep %}
{% endstepper %}
---
# 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://doc.thordata.com/doc/zh/proxies/residential-proxies/whitelisted-ips.md?ask=
```
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.