> 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/gao-dai-kuan-dai-li/bai-ming-dan-ip.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 %}

### **获取报价**

进入仪表板后，依次导航至 **代理 → 高带宽代理 → 定价** ，查看您需要的配置，联系销售获取报价

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

{% step %}

### **服务器列表**

① 购买完成后，请前往**代理 → 高带宽代理 → 代理设置 → 服务器**查看已激活的服务器。

② 可通过以下方式筛选特定服务器：

* 选择服务器配置、带宽或状态
* 点击【搜索】

③ 服务器详细信息包括：配置、带宽、类型、到期时间与状态

④ 操作项目说明：

* 监控：点击跳转至服务器监控详情页
* 升级：点击修改并升级服务器配置
* 重启：点击重新启动服务器
* 续费：点击打开服务器续费对话框

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

{% step %}

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

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

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

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

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

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

**管理白名单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/0dAUeFfOGZW4jzklNVgQ" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

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

① 依此点击 **代理** → **高带宽代理**  → **代理设置**  →**端点生成器** 进入代理信息生成界面；

② **选择服务器：**&#x8BF7;选择你要使用服务器

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

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

⑤ **会话设定** ：

**轮换会话**：即每次请求自动切换IP，适合需要高匿名性的业务需求

**黏性会话**：可以选择1-90分钟的会话保持时长，适合需要会话连续性的业务需求

⑥ **提出请求**：通过将你的 IP 地址添加到 Thordata 的白名单，你可以直接使用代理服务而无需在每次请求中包含认证账密。配置完成后，可通过指定的代理端点直接发送请求，快速访问目标服务

```sh
curl -x "https://t.thordata.online:20000" "https://ipinfo.thordata.com"
```

⑦ **输出格式**：

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

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

<figure><img src="/files/ofKqmv3phTvJFmCbfsz0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **API链接获取**

① 依此点击 **代理** → **高带宽代理** → **代理设置**  → **端点生成器** 进入代理信息生成界面；

② **选择服务器：**&#x8BF7;选择你要使用服务器

③ **认证方式：** 选择白名单 ，如果您还未添加白名单，请点击【立即新增】进行创建

④**端点类型**：选择**API链接**

⑤ **参数设定：选择您需要的数量及国家/地区**

若需要调整提取的IP数量，请修改`number`参数。

⑥ **会话设定** ：

**轮换会话**：即每次请求自动切换IP，适合需要高匿名性的业务需求

**黏性会话**：可以选择1-90分钟的会话保持时长，适合需要会话连续性的业务需求

如需要调整会话类型，请修改`sessid`参数，1代表黏性会话、2代表轮换会话。例如，需要使用轮换会话，将`sessid`参数修改为`sessid=2`

链接示例：提取10个会话类型为轮换的IP，生成链接为：

```
https://get-ip.thordata.net/unlimited_api?td-customer=Thor55584636&sesstype=2&number=10&servers=t
```

⑦提取使用：

点击**生成结果**生成IP列表或复制API链接配置使用

{% hint style="info" %}
在配置代理时，你选择的会话模式（固定 IP 或动态 IP）会生成入口节点地址，请注意，该页面显示的 IP 只是系统对接 ID，并非真实使用的IP，你最终使用的不同真实出口 IP 会在你实际访问网站时，根据选择的端口动态分配。
{% endhint %}

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

{% step %}

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

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

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