代理列表下載，支援txt·CSV·API等多種格式

什麼是代理列表？

代理列表是您購買的代理IP清單（每行一個），爬蟲、自動化工具、反偵測瀏覽器和帳號管理程式大多支援直接載入此類清單輪換使用或分配給各帳號。

不同工具接受的行格式不同，即使是相同代理也需要格式匹配才能直接使用。Socks5Proxy預設常用格式，下載列表後無需再次編輯。

手動修改列表時，少一個冒號就會導致工具無法讀取整行。從一開始就以工具所需的格式下載，可以避免這種錯誤，即使購買新計劃導致列表變更，只需以相同格式重新下載即可。

代理清單提供哪些格式？

在儀表板「我的代理」頁面或API中選擇以下任一格式。選擇HTTP協議將包含HTTP端口，選擇SOCKS5則包含SOCKS5端口。

格式可隨時變更並重新下載。即使將同一個方案的清單分別以爬蟲用的http://檔案和瀏覽器用的socks5://檔案下載兩次，IP和帳戶資訊也會完全相同。

從何處下載代理列表？

付款完成後，「我的代理」畫面會立即顯示IP列表。上方可選擇格式、協議、國家和方案，並以.txt或.csv下載。若購買多個方案，可合併下載或按方案/國家分開下載。

畫面中的清單會在固定高度的表格內滾動，每行都有複製按鈕，若只需少量IP可不需下載檔案直接複製使用。

檔案名稱包含格式和接收日期，即使多次下載也能輕鬆識別最新檔案。CSV 檔案的第一行包含欄位名稱，在試算表中開啟時會立即顯示為表格。

在清單畫面中，可以按國家、方案、到期日篩選，並將篩選結果下載為文件。例如，選擇美國專用ISP IP並下載為CSV，就能立即製作帳戶匹配表。

如何透過API獲取代理列表？

在儀表板API金鑰頁面建立金鑰。金鑰僅在建立時顯示完整內容，請妥善保存。遺失時需重新建立，新金鑰生效後舊金鑰將立即失效。

清單有兩種獲取方式。/proxies返回JSON清單，包含IP、端口、用戶名、密碼、國家、城市、到期日；/proxies/download返回指定格式的文本，按行返回。兩個地址都可以按國家(country)和協議(protocol)篩選。

API請求使用API金鑰而非帳戶令牌。帳戶令牌僅用於儀表板登入，API金鑰僅用於程式作業如列表查詢，即使金鑰外洩帳戶登入仍安全。僅接受HTTPS請求。

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://socks5proxy.io/api/v1/proxies/download?protocol=http&format=ip:port:user:pass"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://socks5proxy.io/api/v1/proxies?country=us"

import itertools, requests

API = "https://socks5proxy.io/api/v1/proxies/download"
lines = requests.get(API, params={"protocol": "http", "format": "url"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}, timeout=20).text.split()
pool = itertools.cycle(lines)

for url in ["https://example.com/a", "https://example.com/b"]:
    p = next(pool)
    print(requests.get(url, proxies={"http": p, "https": p}, timeout=20).status_code)

使用 IP 授權後清單有何變化？

IP 授權是將您伺服器的公共 IPv4 地址註冊到儀表板，僅允許來自該地址的連接無需密碼。最多可註冊 10 個地址。

使用 IP 授權後，即使以 ip:port 格式獲取清單，也能立即連接。清單文件中不包含密碼，因此即使多人共用設定文件或代碼庫，帳號資訊也不會外洩。對於經常變更位置的筆記本電腦，建議同時使用用戶名與密碼方式。

註冊的位址是指連接代理端（您的伺服器或電腦）的公網IPv4，請注意勿與代理IP混淆。您的公網IP可直接在儀表板的IP授權欄位查看並新增。

將代理列表導入工具時有什麼技巧？

• 帳號管理工具可導入CSV檔案，將帳號與IP配對表格化便於管理。
• 爬蟲接收 http:// 格式，設定每次請求輪換使用不同代理。
• 反偵測瀏覽器支援socks5://格式，每個設定檔可單獨配置一行。
• 如果按國家分開任務，可以應用國家過濾器，分別下載各國文件。
• 購買新方案後，相同 API 地址會新增 IP，因此每次開始工作時需重新下載列表。

代理列表包含哪些資訊？

單行包含 IP、HTTP 端口、SOCKS5 端口、用戶名和密碼，CSV 和 JSON 中還包含國家代碼、城市和方案到期日。可選擇的國家數：數據中心 47，ISP 19。

所有IP都是IPv4，且在方案期間保持不變。因此，一次下載的清單在方案結束前都可以繼續使用。

JSON列表各項目包含方案類型，可程式化區分共享/私人/專用IP。例如專用IP用於帳號登入，共享IP僅用於公開頁面採集。

如果使用的是長期使用的工具，請在計劃到期後更換新列表，因為舊列表中的 IP 將無法連接。使用 API 接收的方式則無需進行此類整理。

如何安全儲存代理列表檔案？

包含用戶名和密碼的清單檔案等同帳號憑證。請勿直接公開於儲存庫或群組聊天，建議存放在伺服器設定目錄或密碼管理工具中。

若需在程式庫保存代理資訊，請啟用IP授權並以ip:port格式獲取。即使文件外洩，未註冊的伺服器也無法連接，因無需密碼。

請以相同方式處理API金鑰。若懷疑金鑰外洩，可於儀表板建立新金鑰，舊金鑰將立即封鎖。

收到列表後如何一次性確認連接是否正常？

最簡單的方法是向IP檢查地址發送請求。如果返回的IP與該行的IP相同，則連接正常。如下面的cURL循環腳本，可以在幾分鐘內檢查數百個IP。

測試時請勿同時開啟過多連線，若使用共享方案，請在500個同時連線內分配測試。若發現無法連線，請先確認是否正確切換HTTP端口與SOCKS5端口，以及驗證方式是否正確。

while read p; do
  echo "$p $(curl -s -m 15 -x "$p" https://api.ipify.org)"
done < proxies.txt

要下載代理列表需要先購買什麼？

清單下載和API包含在所有方案中。共享數據中心從100個起，1個IP的月起始單價為$0.0179，ISP、私人、專用方案也以相同方式下載清單。

使用帳戶權杖註冊並充值後即可購買方案，IP列表將立即生成。最低充值金額：$30。

不同方案可合併下載為單一清單。若需分別取得共享資料中心與專用ISP代理列表，請使用方案篩選功能；若需整併為單一檔案，請直接下載未篩選的清單。