Puppeteer 搭配需要驗證的代理伺服器:啟動參數加上登入設定
由 ProxyV4 工程團隊撰寫 · Updated:
Puppeteer 的代理伺服器驗證分為兩個部分:代理伺服器位址需填入 --proxy-server=http://ip:port 啟動參數,而使用者名稱與密碼則填入 await page.authenticate({ username, password })。Chrome 會透過 DevTools Protocol 使用這些憑證回應代理伺服器的 407 驗證請求,讓您的 Node.js 腳本無須安裝瀏覽器擴充功能即可直接使用 ProxyV4 IP。
--proxy-server=http://ip:port + page.authenticate({ username, password })- 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
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。請讓參數僅保留位址與連接埠,並將登入資訊交給頁面處理。
| 順序 | 呼叫方式 | 作用說明 |
|---|---|---|
| 1 | puppeteer.launch({ args: ['--proxy-server=http://ip:port'] }) | 告訴 Chrome 每個請求應該使用哪個代理 |
| 2 | await page.authenticate({ username, password }) | 當代理回傳 407 時提供認證資訊 |
| 3 | await 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
使用代理伺服器位址啟動 Chrome
使用您 ProxyV4 訂單中的 IP 與連接埠,透過
const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] });啟動瀏覽器。 - 2
為分頁進行身分驗證
使用
const page = await browser.newPage();開啟頁面,並在任何導覽前呼叫await page.authenticate({ username: 'USER', password: 'PASS' });。 - 3
讀取出口 IP
使用
await page.goto('https://proxyv4.com/api/my-ip');前往網頁,並確認回應顯示代理伺服器位址。 - 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 僅供單一客戶使用。
查看美國即時價格