带认证代理的 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' }) | 通过已认证的代理加载目标页面 |
标签页、上下文与多 IP 配置
page.authenticate()是按页面独立设置的:由browser.newPage()创建的每个标签页在首次调用goto()前都需要单独调用一次- 启动参数为整个浏览器固定配置一个代理。若想在单个 Chrome 进程中为不同上下文分配不同的 IP,可使用
proxy-chain库中的anonymizeProxy()处理每个http://user:pass@ip:port,并将返回的地址作为proxyServer传递给browser.createBrowserContext({ proxyServer }) - 该配置方式同样适用于
puppeteer-extra和puppeteer-extra-plugin-stealth - 务必在结束时调用
browser.close()(包括错误处理路径),否则无头 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
无头 Chrome 会完整下载网页、脚本和图片,因此按量计费的流量消耗极快。ProxyV4 独享 IPv4 与静态 ISP 代理不限带宽流量,每个 IP 仅供单一客户使用,且续费可保留相同地址,这在会话或白名单绑定时尤为重要。如果目标网站对数据中心 IP 段有特殊限制,可以对比独享 IPv4 产品与静态 ISP 产品。
操作步骤
- 1
使用代理地址启动 Chrome
使用
const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] });启动浏览器,其中填入你 ProxyV4 订单中的 IP 和端口。 - 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 将每个带认证的代理转换为本地地址,并为每个浏览器上下文分配独立的 proxyServer,或者为每个代理单独启动一个浏览器实例。
在配置给 Puppeteer 之前,如何批量测试多个代理?
可以将它们粘贴到代理检测工具中;该工具支持单次最多测试 100 个代理,且不会存储密码。
为什么 page.authenticate() 对我的 SOCKS5 代理不起作用?
Chrome 本身不支持 SOCKS5 的用户名和密码认证,因此 Puppeteer 无法响应认证请求。你可以切换订单至 HTTP 模式、使用 proxy-chain 建立本地转发,或采用 IP 白名单认证方式。
来源
适用于无头 Chrome 的不限量 IP
覆盖 7 个国家的独享 IPv4 以及美国和越南的静态 ISP 代理,付款后自动开通,一客一 IP 独享保障。
查看美国实时价格