代理管理

對應頁面：左側選單裡的「代理管理」（ProxyManagement），以及新增/修改代理彈窗。用於集中管理公司或團隊使用的所有代理。

📌 這個頁面是做什麼的？

• 把公司/團隊的所有代理統一錄入系統集中管理。
• 給團隊成員一個統一的「代理位址通訊錄」，避免每個人自己保存一份。
• 支援快速測試代理是否可用、是否真的換了 IP。
• 支援按類型篩選、匯出列表、刪除（刪除後進入回收站，可在回收站裡再處理）。

你可以把「代理管理」理解為：公司代理伺服器的通訊錄 + 可用性檢測工具。

---

🚪 功能入口與頁面結構

• 功能入口：左側導覽中的 「代理管理」。
• 頂部：
  • 左側為 代理類型篩選；
  • 右側為 新增 和 匯出 按鈕。
• 中間：
  • 代理列表表格（每一行是一條代理配置）。
• 底部：
  • 分頁元件，用於翻頁查看更多代理。

列表中一條代理通常包含：代理類型、IP 查詢管道、主機、連接埠、帳號、備註、建立人/時間、更新人/時間等資訊。

---

⚡ 快速上手：新增一條代理

新增代理的入口是工具列右側的 「新增」 按鈕，對應新增/編輯彈窗。

步驟 1｜打開新增彈窗
在「代理管理」頁面右上角點擊 「新增」，彈出「新增代理管理」視窗。

步驟 2｜選擇代理類型
在「代理類型」下拉框中選擇公司提供的類型：HTTP / HTTPS / SOCKS5 / SSH 等。

• 不確定時，一般由運維或提供代理的同事告訴你類型。

步驟 3｜選擇 IP 查詢管道
在「IP 查詢管道」中選擇一個檢測 IP 的服務，用於後續「測試連線」。

• 這一步只是決定「用哪個網站來識別當前出口 IP」，不會影響代理本身。

步驟 4｜填寫連線資訊

• 代理位址：
  • 只需要填主機或網域，如 proxy.xxx.com 或 1.2.3.4；
  • 前綴 http://、https://、socks5:// 會依代理類型自動補齊。
• 連接埠：
  • 填寫代理服務的連接埠，例如 8080、1080 等。
• 代理帳號 / 代理密碼：
  • 如代理需要帳號密碼，這裡填你從運維處拿到的帳號資訊；
  • 不需要驗證的代理可留空。
• 刷新 URL（可選）：
  • 若供應商支援「刷新 IP」或「重置路線」，可將對應連結填在這裡，方便後續自動刷新。
• 備註：
  • 建議寫清楚「國家/地區 + 供應商 + 用途」，例如：
  • US-A 線路 / 某某代理商 / 投放用。

步驟 5｜測試連線
在彈窗底部點擊 「測試連線」 按鈕：

• 系統會先檢查表單必填欄位是否完整；
• 然後透過所選的「IP 查詢管道」實際發起訪問；
• 檢查是否能連通、回應是否正常、IP 是否有返回。
  如果測試失敗，介面會提示錯誤資訊，可依提示檢查：
• 代理位址是否寫錯；
• 連接埠是否正確；
• 帳號密碼是否匹配；
• 目前網路/公司防火牆是否允許訪問代理。

步驟 6｜儲存

• 測試通過後點擊 「確定」 儲存。
• 新增的代理會出現在列表中，供後續瀏覽器環境選擇使用。

---

🌐 IP 查詢管道說明

在新增/編輯彈窗中，你會看到「IP 查詢管道」的下拉選項，這些選項來自統一的設定檔（ip.test.channels.ts）。
可以簡單理解為：「用哪個網站來檢測當前代理的出口 IP」。

常見管道示例：

管道名稱	用途說明
ip.sb	免費 IP 地理位置查詢，快速查看當前 IP 與地區。
freeipapi	免費 IP 地理位置服務，可返回較詳細的國家/城市資訊。
ip2location	IP 歸屬地查詢服務，偏向地理位置辨識。
ipapi.co	IP 位址 API 服務，返回 IP 位置及網路資訊。
ipinfo.io	IP 資訊服務，包含地區、組織等資訊。

選哪個管道沒有絕對標準，一般建議：

• 只需要確認 IP 是否變了：任選一個常用管道即可；
• 經常做風控驗證：可固定使用一兩個你最熟悉的管道，減少結果差異帶來的困惑。

---

📋 列表頁：日常管理操作

在「代理管理」主頁面，你可以對已配置的代理做日常管理。

• 篩選

  • 頂部「代理類型」篩選框可快速切換 HTTP / HTTPS / SOCKS5 / SSH 等類型；
  • 清空篩選可看到所有類型的代理。

• 查看欄位

  • 代理類型：會以標籤高亮顯示 HTTP / HTTPS / SOCKS5 等。
  • IP 查詢管道：顯示你保存時選擇的檢測管道名稱。
  • 主機 / 連接埠：代理伺服器位址與連接埠。
  • 代理帳號：帳號資訊（如有）。
  • 代理密碼：以 ****** 形式遮罩顯示，避免洩露。
  • 刷新 URL / 備註：輔助說明，方便營運與運維溝通。
  • 建立人 / 建立時間：誰錄入的這條代理。
  • 更新人 / 更新時間：最近一次修改的操作者與時間。

• 修改

  • 在操作欄點擊 「修改」，會彈出與新增相同的表單，帶出當前資料；
  • 調整後可再次點擊「測試連線」，確認無誤再儲存。

• 刪除

  • 在操作欄點擊 「刪除」，系統會進行二次確認；
  • 確認後，該代理從列表中移除，同時進入回收站；
  • 如需徹底清理，可在「回收站」中進行永久刪除。

• 匯出

  • 點擊工具列中的 「匯出」 按鈕；
  • 會依目前篩選條件匯出代理列表，支援做稽核、歸檔或對帳使用。

---

💡 使用建議

• 不要隨便自己編代理資訊

  • 建議由運維或負責對接代理供應商的同事給出「標準填法」，你只需依規填寫。

• 統一命名規範

  • 建議在備註中統一寫法，例如：國家-城市-供應商-用途；
  • 方便後續篩選和匯出統計。

• 代理與業務地區保持一致

  • 若瀏覽器指紋配置在「美國」，盡量選擇美國代理；
  • 代理地區、語言、時區不一致，會增加被網站風控的機率。

• 養成「測試連線」習慣

  • 新錄入或剛修改完的代理，一定先用「測試連線」確認可用；
  • 避免在正式環境臨時發現「代理連不上」。

• 定期檢查和清理

  • 對長期不用或已失效的代理，可匯出記錄歸檔後刪除；
  • 刪除後會進入回收站，需要時還能查到是誰在什麼時間刪除的。

---

❓ 常見問題

• Q：分不清 HTTP / HTTPS / SOCKS5，怎麼辦？
  A：直接問負責提供代理的同事，讓對方告訴你「類型 + 位址 + 連接埠 + 帳號密碼」，你照填即可。

• Q：測試連線失敗，但同事說代理是好的？
  A：先核對是否抄錯資訊（特別是連接埠和密碼），再確認目前電腦網路或公司防火牆有沒有攔截；必要時請運維一起看。

• Q：為什麼要選「IP 查詢管道」？
  A：這是用來「驗 IP」的工具，選誰都可以，只是用不同網站告訴你「你現在看起來來自哪裡」。

• Q：代理刪除後還能恢復嗎？
  A：可以在「回收站」中看到刪除記錄，依權限決定是否恢復或永久刪除。

---

完成代理集中管理後，建議配合以下頁面一起使用：

• 參數說明：讓瀏覽器指紋參數與代理地區保持一致。
• 建立第一個瀏覽器：在建立環境時選擇合適的代理。