ProxyV4

在 Node.js 中使用具身分驗證的代理:Axios、原生 fetch 與 Got

· 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。

Node.js (Axios / Undici) · HTTP
new HttpsProxyAgent('http://user:pass@ip:port')
獨享 IPv4(資料中心)
🇺🇸 美國
庫存充足
起
US$1.10 / IP / 月
數量級距折扣
  • 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
購買 美國
獨享 IPv4(資料中心)
🇸🇬 新加坡
庫存充足
起
US$1.10 / IP / 月
數量級距折扣
  • 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。

客戶端安裝代理設定
Axiosnpm i https-proxy-agentaxios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false })
原生 fetch (Node 18+)npm i undicifetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') })
Gotnpm i hpagentgot(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. 1

    安裝客戶端與 Agent

    在專案中執行 npm install axios https-proxy-agent(若使用原生 fetch 則執行 npm install undici)。

  2. 2

    建立一次 Agent 實例

    使用您 ProxyV4 訂單中的資料建立 const agent = new HttpsProxyAgent('http://user:pass@ip:port');。

  3. 3

    透過代理發送請求

    呼叫 const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });。

  4. 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。可購買單一或多個。

查看美國即時價格

Related articles

各平台代理 IP
網路爬蟲專用代理:固定 IP 池搭配無限流量
適用於 Python、Scrapy、Playwright 與 Selenium 的網路爬蟲代理:獨享 IPv4 與靜態 ISP 資源池,不限流量,採單一 IP 定額計費。
代理設定
Puppeteer 搭配需要驗證的代理伺服器:啟動參數加上登入設定
Puppeteer 代理驗證,先提供可用範例:以 --proxy-server 設定位址、page.authenticate() 登入,再介紹 SOCKS5、Context 與修復方法。
代理設定
Playwright 代理驗證:每個 Context 配置獨立靜態 IP
在 Node.js 或 Python 中為每個 Playwright 瀏覽器 Context 指派專屬驗證 HTTP(S) 代理,讓時區與語言環境符合 IP,並確認出口位址。
免費工具
將 Proxy 清單重寫為工具所需的格式
在瀏覽器批次轉換代理清單:支援 ip:port:user:pass、user:pass@ip:port、http:// URL、SOCKS5 URI、JSON 與 FoxyProxy 匯入檔。
各平台代理 IP
SEO 排名追蹤專用 Proxy:看見在地搜尋者眼中的真實搜尋結果頁
提供美國、英國、越南、日本及其他 4 個市場的專屬 IPv4 SEO 排名追蹤 Proxy,讓關鍵字排名、在地商家資訊與廣告內容,完全符合當地用戶所見的真實搜尋結果。
各平台代理 IP
專為多帳號運作打造的 Discord 代理,避免整組遭手機鎖定
為每個 Discord 帳號與 Token 配置獨立靜態 IP,避免一次邀請加入導致全組帳號遭手機鎖定。提供美國、新加坡與越南節點。
IPV4 · united states
美國獨享 IPv4 代理池:適用於資料抓取、排名追蹤與廣告驗證
購買美國獨享 IPv4 代理:靜態美國資料中心 IP,單一用戶專屬無共享,享不限流量頻寬。專為網路爬蟲、SERP 排名追蹤與美國廣告驗證所打造。
IPV4 · singapore
新加坡獨享 IPv4 代理:每個店鋪與廣告帳號享有單一固定 IP
新加坡專屬 IPv4 代理伺服器:由您獨享的靜態新加坡資料中心 IP,適用於 Lazada 與 Shopee 新加坡店家、新加坡廣告帳戶及區域自動化作業。