指南 · Python

在 Python requests 與 httpx 中使用 Proxy

requests 是 Python 最受歡迎的 HTTP 函式庫,並內建支援需身分驗證的 Proxy。最常見的錯誤是在 proxies 字典中宣告錯誤的 https 鍵值,以及未對密碼中的特殊字元進行編碼。本指南將介紹正確的設定方式,包含逾時設定以及針對長時間運行腳本的錯誤處理機制。

作者:Bùi Toàn · 更新日期:19/11/2026

基本設定

  • 將 ip:port:user:pass 字串格式化為 URL:proxy_url = "http://user:pass@IP:PORT"。
  • 同時宣告兩個鍵值:proxies = {"http": proxy_url, "https": proxy_url}。其中 "https" 鍵值依然指向以 http:// 開頭的 URL,因為 ONET Proxy 是 HTTP Proxy;requests 會在存取 HTTPS 網站時自動使用 CONNECT 方法。
  • 發送請求:r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text)。回傳結果應為 Proxy IP。
  • 請勿寫成 "https": "https://IP:PORT"。ONET Proxy 不接受針對 Proxy 本身的 TLS 連線,否則會回傳 SSL 錯誤或中斷連線。

在 requests 中如何使用密碼包含特殊字元的 Proxy?

在組合 URL 前先對使用者名稱與密碼進行 URL 編碼:from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}"。若省略此步驟,密碼中的 @ 或 : 字元會導致 requests 解析 Proxy 位址錯誤。

使用 Session 與重試機制

  • 建立 s = requests.Session(); s.proxies.update(proxies)。透過 s 發送的所有請求都會共用該 Proxy 並保持連線,這比重複呼叫 requests.get 更快。
  • 掛載包含 Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) 的 HTTPAdapter,以在發生暫時性錯誤時自動重試。
  • 務必設定逾時時間(timeout)。若未設定逾時,掛起的連線可能會導致程式無限期停滯。
  • requests 也會讀取 HTTPS_PROXY 環境變數,除非您設定 s.trust_env = False。

搭配 httpx 使用

從 httpx 0.26 開始,請使用 proxy 參數傳入 Proxy:httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30)。較舊版本則使用 proxies={"all://": url}。若需要執行非同步並行請求,httpx 亦支援 async(httpx.AsyncClient)。

Python requests 常見的 Proxy 錯誤有哪些?

三種常見錯誤包括:因使用者名稱或密碼錯誤導致的 407、無法連線至 Proxy 所引起的逾時,以及目標網站頻率限制造成的 429。

ProxyError … 407 Proxy Authentication Required

使用者名稱或密碼錯誤,或是特殊字元未進行編碼。

ConnectTimeout 或 ProxyError … timed out

無法連線至 Proxy:IP 或連接埠錯誤,或是網路受阻。請使用 curl 進行驗證。

來自目標網站的 HTTP 429

受到目標網站的請求頻率限制。請降低每個 IP 的請求頻率、增加延遲時間,或將負載分散到多個 Proxy。

還沒有 Proxy 嗎?購買自動開通的專屬 Proxy

涵蓋 9 個國家的專屬 IPv4 Proxy,購買 2.000 個 IP 以上每月僅需 20.000₫/IP(購買 1 個 IP 為 39.000₫),並提供越南與美國靜態 ISP Proxy。支援帳號密碼驗證的 HTTP(S) 與 SOCKS5,不限流量,付款後自動開通。越南 Proxy 目前僅支援 HTTP(S),不支援 SOCKS5。

立即購買 Proxy

常見問題

ONET Proxy 有連線執行緒或流量限制嗎?+

提供不限流量。您可以發送到目標網站的請求數量取決於該網站的限制;超出限制將觸發 429 錯誤。

我可以使用 aiohttp 嗎?+

可以。在每次請求時傳入 proxy="http://IP:PORT" 與 proxy_auth=aiohttp.BasicAuth(user, pass) 即可。