ProxyV4

Puppeteer 搭配需要驗證的代理伺服器:啟動參數加上登入設定

· Updated:

Puppeteer 的代理伺服器驗證分為兩個部分:代理伺服器位址需填入 --proxy-server=http://ip:port 啟動參數,而使用者名稱與密碼則填入 await page.authenticate({ username, password })。Chrome 會透過 DevTools Protocol 使用這些憑證回應代理伺服器的 407 驗證請求,讓您的 Node.js 腳本無須安裝瀏覽器擴充功能即可直接使用 ProxyV4 IP。

Puppeteer · HTTP
--proxy-server=http://ip:port + page.authenticate({ username, password })
獨享 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
購買 新加坡

Puppeteer 代理驗證:完整範例

在首次導航前,於 --proxy-server 傳入代理位址,並透過 page.authenticate() 傳入登入資訊。以下腳本完整示範此流程並印出出口 IP,讓您執行一次即可確認代理狀態:

// npm i puppeteer
const puppeteer = require('puppeteer');

const PROXY = { host: 'IP', port: 'PORT', username: 'USER', password: 'PASS' };

(async () => {
  const browser = await puppeteer.launch({
    args: [`--proxy-server=http://${PROXY.host}:${PROXY.port}`],
  });
  try {
    const page = await browser.newPage();
    await page.authenticate({ username: PROXY.username, password: PROXY.password });
    const res = await page.goto('https://proxyv4.com/api/my-ip', { waitUntil: 'domcontentloaded' });
    console.log(res.status(), await page.evaluate(() => document.body.innerText));
  } finally {
    await browser.close();
  }
})();

輸出結果應顯示狀態碼 200 與該代理的 IP。若出現 407、ERR_TUNNEL_CONNECTION_FAILED 或顯示您自己的 IP,代表這兩個步驟其中之一有所缺失;代理無法連線 列出了各工具的常見成因。

為什麼登入資訊不能寫在參數中

Chrome 不接受在 --proxy-server 中包含認證資訊。若寫成 --proxy-server=http://user:pass@ip:port,瀏覽器將無法使用該數值且請求會失敗,通常會出現 ERR_NO_SUPPORTED_PROXIES。請讓參數僅保留位址與連接埠,並將登入資訊交給頁面處理。

順序呼叫方式作用說明
1puppeteer.launch({ args: ['--proxy-server=http://ip:port'] })告訴 Chrome 每個請求應該使用哪個代理
2await page.authenticate({ username, password })當代理回傳 407 時提供認證資訊
3await page.goto(url, { waitUntil: 'domcontentloaded' })透過已驗證的代理載入目標網頁

分頁、Context 與多 IP 設定

  • page.authenticate() 是針對每個頁面設定的:由 browser.newPage() 開啟的每個分頁,在首次執行 goto() 前都需要呼叫一次
  • 啟動參數會為整個瀏覽器固定單一代理。若要在同一個 Chrome 行程中為每個 Context 指定不同的 IP,可將每個 http://user:pass@ip:port 傳入 proxy-chain 套件的 anonymizeProxy() 處理,並將結果作為 proxyServer 傳入 browser.createBrowserContext({ proxyServer })
  • 此設定方式同樣適用於 puppeteer-extra 與 puppeteer-extra-plugin-stealth
  • 請務必以 browser.close() 結束(包含錯誤處理流程),否則 headless Chrome 行程會在伺服器上不斷累積

在 Puppeteer 中使用 SOCKS5 代理

Chrome 可以使用 SOCKS5 代理(--proxy-server=socks5://IP:PORT),但無法直接進行登入驗證,且 page.authenticate() 不適用於 SOCKS。使用 ProxyV4 代理時(越南以外地區提供 SOCKS5;越南 IP 僅支援 HTTP),您有兩種簡潔的解法:將訂單切換為 HTTP 或雙模式並採用上述範例,或是讓 proxy-chain 開啟一個無密碼的本機轉發器代為登入:

const proxyChain = require('proxy-chain');
const local = await proxyChain.anonymizeProxy('socks5://USER:PASS@IP:PORT');
const browser = await puppeteer.launch({ args: [`--proxy-server=${local}`] });
// ... when done:
await browser.close();
await proxyChain.closeAnonymizedProxy(local, true);

IP 白名單登入是第三種方式:將機器的公網 IP 加入訂單,Chrome 即可在無需任何認證憑證的情況下連線。

為 Puppeteer 叢集選擇 IP

Headless Chrome 會下載完整網頁、腳本與圖片,因此計量流量會快速消耗。ProxyV4 專屬 IPv4 與靜態 ISP 代理皆不計頻寬流量,每個 IP 僅供單一客戶使用,且續約時會保留相同位址;當連線階段或允許清單綁定特定位址時這點格外重要。若目標網站對資料中心 IP 網段有不同限制,可比較 專屬 IPv4 產品 與 靜態 ISP 產品。

步驟說明

  1. 1

    使用代理伺服器位址啟動 Chrome

    使用您 ProxyV4 訂單中的 IP 與連接埠,透過 const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] }); 啟動瀏覽器。

  2. 2

    為分頁進行身分驗證

    使用 const page = await browser.newPage(); 開啟頁面,並在任何導覽前呼叫 await page.authenticate({ username: 'USER', password: 'PASS' });。

  3. 3

    讀取出口 IP

    使用 await page.goto('https://proxyv4.com/api/my-ip'); 前往網頁,並確認回應顯示代理伺服器位址。

  4. 4

    關閉瀏覽器

    最後使用 await browser.close(); 結束,確保沒有任何殘留的 Chrome 程序在背景運行。

常見問題

Puppeteer 出現 ERR_NO_SUPPORTED_PROXIES 的原因為何?

代表認證資訊直接寫在參數中,例如 --proxy-server=http://user:pass@ip:port。請改用 --proxy-server=http://ip:port,並透過 page.authenticate() 傳入使用者名稱與密碼。

為什麼第一個分頁正常,但新分頁卻出現 HTTP 407?

身分驗證是針對每個頁面獨立儲存的。在開啟的每個新頁面進行導航之前,都必須先呼叫 await newTab.authenticate({ username, password })。

單一 Puppeteer 瀏覽器可以同時使用多個代理嗎?

無法僅透過啟動參數達成。您可以使用 proxy-chain 將各個已驗證的代理轉換為本機端位址,並為每個瀏覽器 Context 分配專屬的 proxyServer,或者為每個代理啟動一個獨立的瀏覽器。

在提供給 Puppeteer 使用前,該如何批次測試多個代理?

將它們貼入 代理檢測工具;該工具一次最多可處理 100 個代理,且不會儲存密碼。

為什麼 page.authenticate() 無法與我的 SOCKS5 代理搭配使用?

Chrome 不支援 SOCKS5 的使用者名稱與密碼登入,因此 Puppeteer 無法回應驗證。請使用訂單的 HTTP 模式、透過 proxy-chain 建立本機轉發器,或使用 IP 白名單登入。

資料來源

適用於 headless Chrome 的不計流量 IP

提供 7 個國家的專用 IPv4 以及美國與越南的靜態 ISP,付款後自動發放,每個 IP 僅供單一客戶使用。

查看美國即時價格

Related articles

各平台代理 IP
網路爬蟲專用代理:固定 IP 池搭配無限流量
適用於 Python、Scrapy、Playwright 與 Selenium 的網路爬蟲代理:獨享 IPv4 與靜態 ISP 資源池,不限流量,採單一 IP 定額計費。
代理設定
Playwright 代理驗證:每個 Context 配置獨立靜態 IP
在 Node.js 或 Python 中為每個 Playwright 瀏覽器 Context 指派專屬驗證 HTTP(S) 代理,讓時區與語言環境符合 IP,並確認出口位址。
代理設定
在 Node.js 中使用具身分驗證的代理:Axios、原生 fetch 與 Got
透過身分驗證HTTP(S)代理轉發Node.js與TypeScript請求:Axios用https-proxy-agent、fetch用undici ProxyAgent、Got用hpagent。
免費工具
將 Proxy 清單重寫為工具所需的格式
在瀏覽器批次轉換代理清單:支援 ip:port:user:pass、user:pass@ip:port、http:// URL、SOCKS5 URI、JSON 與 FoxyProxy 匯入檔。
各平台代理 IP
SEO 排名追蹤專用 Proxy:看見在地搜尋者眼中的真實搜尋結果頁
提供美國、英國、越南、日本及其他 4 個市場的專屬 IPv4 SEO 排名追蹤 Proxy,讓關鍵字排名、在地商家資訊與廣告內容,完全符合當地用戶所見的真實搜尋結果。
各平台代理 IP
YouTube 專用代理:防止單一頻道違規連帶波及其他帳號
專為多頻道創作者與團隊打造的 YouTube 代理:每頻道配置獨立靜態 ISP 或專屬 IPv4,確保單一頻道遭警告或停權時不會波及其他頻道,徹底防範帳號連帶處分。
IPV4 · united states
美國獨享 IPv4 代理池:適用於資料抓取、排名追蹤與廣告驗證
購買美國獨享 IPv4 代理:靜態美國資料中心 IP,單一用戶專屬無共享,享不限流量頻寬。專為網路爬蟲、SERP 排名追蹤與美國廣告驗證所打造。
IPV4 · singapore
新加坡獨享 IPv4 代理:每個店鋪與廣告帳號享有單一固定 IP
新加坡專屬 IPv4 代理伺服器:由您獨享的靜態新加坡資料中心 IP,適用於 Lazada 與 Shopee 新加坡店家、新加坡廣告帳戶及區域自動化作業。