> 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/)，完成账户注册并登录。
{% 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 %}