Socks5Proxy

代理連接指南：各語言與工具的 SOCKS5 和 HTTP 設定方法

Socks5Proxy 連接指南提供 Python requests、Node.js、cURL、Selenium、Puppeteer、Playwright、Scrapy 七種工具連接 SOCKS5 和 HTTP 代理的實際運作代碼與說明。

開始使用查看價格
Python requests以實際程式碼整理Python requests連接HTTP代理與SOCKS5代理(socks5h)、認證、IP輪替、重試與會話管理。Node.js整理Node.js中透過ProxyAgent連接HTTP代理、socks-proxy-agent連接SOCKS5代理的方法與IP輪替程式碼。cURL整理如何使用 cURL 連接 HTTP 代理（-x）和 SOCKS5 代理（--socks5-hostname），包括認證、回應時間測量、批次測試清單的腳本。Selenium整理在 Selenium 中為 Chrome 和 Firefox 設定 HTTP·SOCKS5 代理的方法、Chrome 使用 IP 授權的原因與設定，以及多瀏覽器平行執行。Puppeteer整理Puppeteer以--proxy-server連接HTTP·SOCKS5代理、用page.authenticate傳送帳密，以及瀏覽器獨立IP配置方法。Playwright整理Playwright以proxy選項連接HTTP·SOCKS5代理、上下文獨立IP配置，與Python/Node.js範例。Scrapy整理 Scrapy 中使用 HttpProxyMiddleware 和 meta proxy 連接代理的方法、輪換 IP 的下載器中間件，以及速度設定。

建立代理連接需要哪些資訊？

每行代理資訊包含 IP 地址、HTTP 端口、SOCKS5 端口、帳號與密碼。您可在儀表板的「我的代理」頁面查看列表，或下載指定格式，也能透過 API 獲取相同列表。

本指南所有範例使用IP 198.51.100.23、HTTP端口8000、SOCKS5端口1080、帳號spx_user、密碼spx_pass。198.51.100.0/24為文檔專用保留位址，實際使用請替換為您的代理列表值。

有兩種認證方式：使用用戶名和密碼，或在儀表板中註冊最多10個您的伺服器IPv4地址，使用ip:port連接的IP認證。對於無法接收密碼的工具（例如Chrome啟動參數），IP認證更方便。

項目範例值說明
IP198.51.100.23代理伺服器地址
HTTP 端口8000HTTP 與 HTTPS(CONNECT) 連接
SOCKS5 埠1080SOCKS5 TCP 連接
帳號spx_user帳號密碼驗證
密碼spx_pass帳號密碼驗證

使用 HTTP 還是 SOCKS5 連接？

多數網頁與API請求任務使用HTTP端口即可。HTTPS網址同樣透過CONNECT方式加密傳輸，代理不會修改內容。

SOCKS5 不僅能轉發 HTTP，還能轉發 TCP 連接，並可讓代理端進行域名解析。Python 使用 socks5h，cURL 使用 --socks5-hostname，這樣您伺服器的 DNS 請求就不會外洩。每個 IP 都同時提供兩種端口，可根據工具支援的方式選擇。

如何透過代碼接收並使用列表？

API金鑰於儀表板的API金鑰頁面建立，僅首次顯示，請妥善保存。所有請求需包含Authorization: Bearer標頭。以下程式碼為以user:pass@ip:port格式獲取SOCKS5列表的Python範例。各指南將繼續說明如何將此列表連接至工具。

import requests

API = "https://socks5proxy.io/api/v1"
KEY = "YOUR_API_KEY"

# Download the proxy list as plain text, one proxy per line
r = requests.get(
    API + "/proxies/download",
    params={"format": "user:pass@ip:port", "protocol": "socks5"},
    headers={"Authorization": "Bearer " + KEY},
    timeout=30,
)
r.raise_for_status()
proxies = [line.strip() for line in r.text.splitlines() if line.strip()]
print(len(proxies), "proxies loaded")

該從哪篇指南開始閱讀？

選擇適合您語言和工具的指南。所有指南均包含連接確認方法、錯誤排查步驟和IP分配使用方式。

  • Python requests：最簡HTTP·SOCKS5連接與IP輪替
  • Node.js: undici ProxyAgent(HTTP)與socks-proxy-agent(SOCKS5)
  • cURL：命令列連線測試與回應時間測量
  • Selenium：Chrome 與 IP 授權，Firefox 設定
  • Puppeteer: --proxy-server與page.authenticate
  • Playwright: 瀏覽器與上下文獨立代理
  • Scrapy：為每個請求使用 meta proxy 與輪換中間件

應該選擇哪種清單格式？

不同工具接受的格式不同，下載列表時可以選擇格式。大多數函式庫直接接受地址格式(http://user:pass@ip:port或socks5://user:pass@ip:port)。設置欄位分為IP、端口、用戶名、密碼的程式使用ip:port:user:pass格式更容易拆分輸入。

若使用 IP 授權，可選擇 ip:port 格式。在試算表或管理文件中貼上時，CSV 格式較為方便。相同的清單可分別獲取 HTTP 與 SOCKS5 版本，僅端口不同。

格式範例適用場景
ip:port:user:pass198.51.100.23:8000:spx_user:spx_pass分欄設定的坎城頁面
user:pass@ip:portspx_user:spx_pass@198.51.100.23:8000在程式中組裝地址
http://user:pass@ip:porthttp://spx_user:spx_pass@198.51.100.23:8000requests, cURL, Scrapy
socks5://user:pass@ip:portsocks5://spx_user:spx_pass@198.51.100.23:1080SOCKS5 函式庫
ip:port198.51.100.23:8000IP 授權、瀏覽器執行參數
CSVip,http_port,socks_port,user,pass,country表格計算、管理文件

如何安全儲存代理資訊？

請勿將代理帳號密碼和 API 金鑰上傳至程式碼庫，應存放於環境變數或密碼管理工具。若意外上傳，請立即在儀表板重新生成 API 金鑰使舊金鑰失效。

若伺服器使用固定IP，IP授權是最安全的選擇。即使代理列表外洩，未經註冊的IP也無法連接。最多可設置10個允許IP，並可隨時更改。

若團隊成員較多，建議讓每位成員通過API獲取列表，而不是將文件放在共享資料夾中，這樣管理更方便。下載記錄也會保留，方便出現問題時進行檢查。

無法連線時該檢查哪些項目？

先用cURL測試一行指令確認代理是否正常響應。407錯誤代表帳號密碼錯誤，若使用IP認證，請確認發送請求的伺服器IP已加入白名單。若連線逾時，請檢查端口是否正確（如HTTP 8000、SOCKS5 1080等每行可能不同）。

如果問題仍未解決，您可以在儀表板的客服中心提交查詢。請提供使用的行號、工具和錯誤訊息，以便快速確認。

代理連接指南：Python、Node.js、Selenium 設定 | Socks5Proxy