> 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-hk/dai-li/gao-dai-kuan-dai-li/bai-ming-dan-ip.md).
# 白名單IP
IP 白名單的功能是允許列入白名單的 IP 位址透過簡單連接訪問住宅代理池。在本指南中，您將找到通過白名單進行驗證使用 **Thordata 高帶寬代理** 所需的所有基礎信息。
{% stepper %}
{% step %}
### **注冊登錄**
請訪問 [**Thordata官网**](https://www.thordata.com/) 以完成帳戶註冊並登錄。
{% endstep %}
{% step %}
### 獲取報價
進入儀表板後，依次導航至 **代理 → 高帶寬代理 → 定價** ，檢視您需要的配置，聯絡銷售獲取報價。
{% 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 %}
### **國家條目代理獲取**
① 依次點擊 **代理** → **高帶寬代理** → **端點生成器**，進入代理信息生成界面。
② **選擇服務器：請選擇你要使用的服務器**
③ **認證方式**：選擇白名單，若未添加白名單，請點擊 **【立即新增】** 進行創建
④ **端點類型**：選擇國家條目
⑤ **會話設定**：
* **輪換會話**：每次請求自動切換 IP，適合需高匿名性的業務需求。
* **黏性會話**：可選1-90分鐘的會話保持時長，適合需會話連續性的業務需求。
⑥ **提出請求**：將 IP 地址添加到 Thordata 白名單，即可直接使用代理服務，無需每次請求中包含認證賬密。配置完成後，可透過指定的代理端點發送請求，快速存取目標服務。
```sh
curl -x "https://t.thordata.online:20000" "https://ipinfo.thordata.com"
```
⑦ **輸出格式**：
系統將根據您的配置生成單字串代理憑證，格式為：`代理地址:代理端口`
按需選擇輸出格式、設置代理數量並指定連接[**協議**](broken://pages/FEYZOcq8WAT3TXgRnYF2)，即可生成並啟用代理。
{% endstep %}
{% step %}
### **API鏈接獲取**
① 點擊 **代理** → **高帶寬代理** → **端點生成器** 進入代理信息生成界面。
② **選擇服務器：請選擇你要使用的服務器**
③ **認證方式：** 選擇白名單，如果您還未添加白名單，請點擊**【立即新增】**進行創建。
④ **端點類型**：選擇**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 %}
{% endstep %}
{% step %}
### **使用情況統計**
您可以透過訪問 Thordata 儀表板查看高帶寬代理的使用情況統計。進入儀表板後，依次導航至 **代理 → 高帶寬代理 → 統計** 界面，可以按照時間、配置、身份類型（賬戶或白名單）、**賬戶層級**：主賬戶或指定子賬戶、地區、目標、時區等維度篩選流量使用數據。
{% endstep %}
{% endstepper %}