教學 · curl

在 curl 中使用 Proxy

curl 是檢查 Proxy 是否正常運作最快速的方法,且不依賴任何瀏覽器或擴充功能。Linux、macOS 以及 Windows 10、11 均已內建 curl 指令。本指南涵蓋指令範例、如何解讀輸出資訊以排查錯誤,以及如何為所有指令設定預設 Proxy。

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

基本指令

  • 使用 ip:port:user:pass 格式時,請執行:curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • 或合併為單一字串:curl -x http://user:pass@IP:PORT https://api.ipify.org
  • 輸出結果必須是 Proxy 的 IP。若顯示您原有的 ISP IP,表示請求並未透過 Proxy 發送。
  • 若要一併確認所在國家/地區:請將目標 URL 替換為 https://ipinfo.io/json。
  • 若 Proxy 運作於 SOCKS5 或 HTTP + SOCKS5 模式:curl -x socks5h://user:pass@IP:PORT https://api.ipify.org(socks5h 會由 Proxy 端解析網域名稱),或 curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org。

在 Windows 上

在 PowerShell 5.1 中,「curl」是 Invoke-WebRequest 的別名,並非真正的 curl。請使用 curl.exe 代替 curl:curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org。在命令提示字元(cmd)及 PowerShell 7 或更高版本中,curl 就是真正的 curl。

使用 curl 時,若 Proxy 密碼含有特殊字元該如何處理?

使用 user:pass@IP 格式時,密碼中的特殊字元(例如 @ : / # %)必須經過 URL 編碼——例如 @ 會轉為 %40,# 會轉為 %23。使用 -U "user:pass"(以雙引號括起)則無需編碼,並能減少錯誤發生。在 Linux 與 macOS 上,若密碼包含 $ 或 !,請使用單引號。

如何解讀 curl 輸出以診斷 Proxy 錯誤?

加入 -v 即可檢視每個步驟:"200 Connection established" 代表 Proxy 已接受連線,而下方的錯誤訊息則能顯示問題究竟來自憑據、連接埠、網路還是目標網站。

加上 -v 檢視詳細資訊

針對 HTTPS 網站,curl 會向 Proxy 發送 CONNECT 請求。顯示「< HTTP/1.1 200 Connection established」代表 Proxy 已接受連線;顯示「407 Proxy Authentication Required」則表示使用者名稱或密碼錯誤。

Failed to connect … Connection refused

連線至 IP:port 立即遭到拒絕:連接埠錯誤、Proxy 已過期或尚未啟用。請參閱 connection refused 錯誤的相關指南。

Connection timed out

未收到任何回應:IP 不正確、網路問題或防火牆封鎖了連接埠。可加上 --connect-timeout 10 以免等待過久。

CONNECT tunnel failed, response 502 or 503

Proxy 正常運作中,但無法與目標網站建立連線。請嘗試其他網站,以確認問題出在目標網站還是 Proxy。

設定預設 Proxy

設定環境變數即可讓所有 curl 指令(及許多其他工具)自動使用 Proxy:在 Linux 與 macOS 上執行 export https_proxy="http://user:pass@IP:PORT" 與 export http_proxy="$https_proxy"。若要針對單一指令跳過 Proxy,可使用 --noproxy "*"。此外,亦可在 ~/.curlrc 檔案中加入 proxy = "http://user:pass@IP:PORT"。

還沒有 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

常見問題

為什麼 https_proxy 的值仍然以 http:// 開頭?+

此前綴指定的是 curl 連線至 Proxy 的方式,而非連線至目標網站的方式。當透過 HTTP 與 ONET 的 Proxy 通訊時,仍可藉由 CONNECT 方法連線至 HTTPS 網站。若使用 SOCKS5,其值則以 socks5h:// 開頭。

我可以在 ONET Proxy 上使用 --socks5 嗎?+

可以,當 Proxy 運作於 SOCKS5 或 HTTP + SOCKS5 模式時:curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org,或 -x socks5h://user:pass@IP:PORT。請使用 socks5h 或 --socks5-hostname,以便由 Proxy 端解析網域名稱。請注意,越南 Proxy 目前僅支援 HTTP(S) 協定,尚未支援 SOCKS5。