> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/proxies/residential-proxies/whitelisted-ips.md).

# IP 白名单

IP 白名单的功能是允许通过列入白名单的 IP 地址通过简单连接访问住宅代理池。在本指南中，您将找到通过白名单进行身份验证使用 **Thordata动态住宅代理** 所需的所有基础信息。

{% stepper %}
{% step %}

### **注册登录**

访问[**Thordata官网**](https://www.thordata.com/)，完成账户注册并登录。

<div align="left"><figure><img src="/files/kXnKyNIsYAwAEzPE0KOv" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/FI3u9wfO94CpcvIgdRja" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **购买套餐**&#x20;

进入仪表板后，依次导航至 **代理 → 住宅代理 → 定价** ，根据业务需求选择适用套餐规格，完成支付即可开通服务。

<div align="left"><figure><img src="/files/678rafu0CsIKELRKAbuV" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **白名单 IP设置**

#### **添加白名单IP**

① **仪表板**中依次导航至 **代理 → 住宅代理 → 代理设置 → 白名单** ，点击 **批量添加** 按钮即可添加IP。

<div align="left"><figure><img src="/files/QMYLTs40pItH8W5Uz0zI" alt="" width="375"><figcaption></figcaption></figure></div>

② 点击 **批量添加** 后，按照格式输入正确的IP。

<div align="left"><figure><img src="/files/zPiH2RZhdK2I4R76Gy4r" alt="" width="375"><figcaption></figcaption></figure></div>

#### **管理白名单IP**

**①** 时间范围**筛选**

设定起止日期范围，检索该时段内添加的IP白名单记录

**②** 精确IP**定位**

输入完整IP地址，直接定位特定白名单条目

**③** 选择IP**状态**

服务器状态分为**启用和停用**

④ 账户信息**编辑**

点击 **编辑** 按钮，可更新IP地址、启用/禁用状态及备注&#x20;

⑤ 账户**删除**操作

单账户删除：点击编辑中 **删除** 按钮

批量删除：勾选多个账户后使用 **一键删除** 功能

{% hint style="success" %}
&#x20; 白名单添加规范

* 仅接受 IPv4 格式地址（示例：**`192.168.1.1`**）
* 必须添加**归属您本人**的IP地址，避免使用代理/VPN等第三方IP
* 白名单IP总数上限：10个
  {% endhint %}

<div align="left"><figure><img src="/files/o2TWbrj3Ywi6LXx30k3s" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **国家条目代理获取**

① 依此点击 **代理** → **住宅代理** → **端点生成器** 进入代理信息生成界面；

② **认证方式：** 选择白名单 ，如果您还未添加白名单，请点&#x51FB;**【立即新增】**&#x8FDB;行创建

③ **端点类型**：选择国家条目

④ **位置设定**：根据您需要的代理地区选择国家/地区，详细具体国家/地区的入口节点请参考[**国家/地区入口节点**](/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"
```

⑦ **输出格式**：

系统将根据您的配置生成单字符串代理凭证，格式为：`代理地址:代理端口`

按需选择输出格式、设置代理数量并指定连接[<mark style="color:blue;">**协议**</mark>](/doc/zh/proxies/residential-proxies/protocol.md)，即可生成并启用代

<div align="left"><figure><img src="/files/MJPotY5KHIHOGHD7q45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% 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 %}

<div align="left"><figure><img src="/files/nxjOMxrBkcb90dICVXlJ" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **使用情况统计**

您可以通过访问 Thordata仪表板查看动态住宅代理的使用情况统计。进入仪表板后，依次导航至 **代理 → 住宅代理 → 统计** 界面，可以按照时间、身份类型（账户或白名单）、**账户层级**：主账户或指定子账户、地区、目标等维度筛选流量使用数据。

<div align="left"><figure><img src="/files/HoACah3idNjNTh5SNgGb" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}