在 Node.js 中使用具身分驗證的代理:Axios、原生 fetch 與 Got
由 ProxyV4 工程團隊撰寫 · Updated:
在 Axios 中穩定使用 Node.js 代理的方法,是將 HttpsProxyAgent 傳入 httpsAgent 並搭配 proxy: false。Axios 自帶的 proxy: { host, port } 設定不會建立 HTTP CONNECT 通道,因此在 https:// 網址上會失效;原生 fetch() 則需要改用 undici 的 ProxyAgent。本頁將示範各個客戶端如何搭配 ProxyV4 的 http://user:pass@ip:port 網址運作,以及如何確認出口 IP。
new HttpsProxyAgent('http://user:pass@ip:port')- 1 個 IPUS$1.85
- 3+ 個 IPUS$1.70
- 10+ 個 IPUS$1.60
- 25+ 個 IPUS$1.50
- 50+ 個 IPUS$1.40
- 100+ 個 IPUS$1.30
- 200+ 個 IPUS$1.20
- 500+ 個 IPUS$1.10
- 1 個 IPUS$1.85
- 3+ 個 IPUS$1.70
- 10+ 個 IPUS$1.60
- 25+ 個 IPUS$1.50
- 50+ 個 IPUS$1.40
- 100+ 個 IPUS$1.30
- 200+ 個 IPUS$1.20
- 500+ 個 IPUS$1.10
選擇適合您 HTTP 客戶端的程式碼片段
這三種客戶端都支援相同的代理網址。請根據您訂單中的 ip:port:user:pass 格式進行組合;通訊協定維持 http://,因為客戶端與代理伺服器之間採用 HTTP 通訊,並透過通道傳輸 TLS。
| 客戶端 | 安裝 | 代理設定 |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
原生 fetch (Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
為什麼在 Axios 中 `proxy: false` 至關重要
Axios 會自動讀取 HTTP_PROXY 與 HTTPS_PROXY 環境變數。若機器上已設定其中之一(在 CI runner 與容器中很常見)且您同時傳入了 agent,兩種設定就會產生衝突。proxy: false 能讓 Axios 忽略環境變數及內建的代理邏輯,確保完全由該 agent 來決定請求的轉發路徑。
在多個請求間重複使用 Agent
- 請在請求迴圈外為每個代理 IP 建立一個 agent;agent 會維持 keep-alive 通訊端(socket),若每次呼叫都新建 agent 則會失去此優勢
- 若使用多個代理,建議維護一個 IP 對應 agent 的
Map並從中取用,而非即時動態建立 agent - 為每次呼叫設定
timeout(例如 Axios 中的timeout: 10000),避免單一卡住的目標無休止地占用 worker - 需要將代理清單轉換為資料格式?代理格式轉換器可將
ip:port:user:pass逐行內容轉為能直接require或import的 JSON 陣列
穩定 IP 能為 Node.js 任務帶來哪些優勢
ProxyV4 專屬 IPv4 在整個租用期間均由單一客戶獨享,且續費時仍保持相同位址;因此在多次部署之間,繫結至該 IP 的允許清單 API、登入工作階段或請求速率配額都能持續有效。流量不計費,能確保長時間運行的 worker 穩定可預測。如需爬蟲模式與節奏設定的詳細資訊,請參閱網路爬蟲應用場景。
步驟說明
- 1
安裝客戶端與 Agent
在專案中執行
npm install axios https-proxy-agent(若使用原生fetch則執行npm install undici)。 - 2
建立一次 Agent 實例
使用您 ProxyV4 訂單中的資料建立
const agent = new HttpsProxyAgent('http://user:pass@ip:port');。 - 3
透過代理發送請求
呼叫
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });。 - 4
比對 IP 位址
console.log(res.data)應輸出該代理 IP。如果顯示的是您伺服器本身的位址,表示 agent 未生效。
常見問題
為什麼 Axios 的 proxy: { host, port, auth } 在 HTTPS 網站上會失效?
該選項會向代理發送普通的 HTTP 請求,而非先請求建立 HTTP CONNECT 通道,導致無法與目標建立正確的 TLS 連線。請改用 httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') 並設定 proxy: false。
如何在 Node 18、20 或 22 的原生 fetch() 中加入代理?
Node 的 fetch 是基於 undici 運作,因此請從 undici 匯入 ProxyAgent,並在 fetch() 的選項中傳入 { dispatcher: new ProxyAgent('http://user:pass@ip:port') }。
我的密碼包含 @ 或 :,網址會出錯嗎?
有可能,因為這些字元在網址中具有特殊意義。在建立 http://user:pass@ip:port 之前,請使用 encodeURIComponent(password) 對密碼進行百分比編碼。
請求回傳 407 錯誤,是哪裡出錯了?
代理伺服器已有回應但拒絕了登入。請重新確認訂單中的使用者名稱與密碼;407 排錯指引頁面列出了常見原因。
資料來源
專為 Node.js Worker 打造的靜態 IPv4
提供 7 個國家的專屬 IPv4,以及美國與越南的靜態 ISP,不限流量,單一客戶獨享 IP。可購買單一或多個。
查看美國即時價格