# IP白名單
IP 白名單的功能是允許列入白名單的 IP 位址透過簡單連接訪問住宅代理池。在本指南中，您將找到通過白名單進行驗證使用 **Thordata 動態住宅代理** 所需的所有基礎信息。
{% stepper %}
{% step %}
### **注冊登錄**
請訪問[**Thordata官网**](https://www.thordata.com/)以完成帳戶註冊並登錄。
{% endstep %}
{% step %}
### **購買套餐**
進入儀表板後，依次導航至 **代理 → 住宅代理 → 定價**，根據業務需求選擇適用套餐規格，完成支付即可開通服務。
{% endstep %}
{% step %}
### **白名單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 %}
### **國家條目代理獲取**
① 依次點擊 **代理** → **住宅代理** → **端點生成器**，進入代理信息生成界面。
② **認證方式**：選擇白名單，若未添加白名單，請點擊 **【立即新增】** 進行創建
③ **端點類型**：選擇國家條目
④ **位置設定**：根據需要選擇代理地區的國家/地區，詳細請參考 [**國家/地區入口節點**](#guo-jia-tiao-mu-dai-li-huo-qu)
⑤ **會話設定**：
* **輪換會話**：每次請求自動切換 IP，適合需高匿名性的業務需求。
* **黏性會話**：可選1-90分鐘的會話保持時長，適合需會話連續性的業務需求。
⑥ **提出請求**：將 IP 地址添加到 Thordata 白名單，即可直接使用代理服務，無需每次請求中包含認證賬密。配置完成後，可透過指定的代理端點發送請求，快速存取目標服務。
```sh
curl -x "http://pr.thordata.net:10000" "https://ipinfo.thordata.com"
```
⑦ **輸出格式**：
系統將根據您的配置生成單字串代理憑證，格式為：`代理地址:代理端口`
按需選擇輸出格式、設置代理數量並指定連接[**協議**](https://doc.thordata.com/doc/zh-hk/dai-li/zhu-zhai-dai-li/xie-yi)，即可生成並啟用代理。
{% 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 %}
