带认证代理的 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' })通过已认证的代理加载目标页面

标签页、上下文与多 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. 1

    使用代理地址启动 Chrome

    使用 const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] }); 启动浏览器,其中填入你 ProxyV4 订单中的 IP 和端口。

  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 将每个带认证的代理转换为本地地址,并为每个浏览器上下文分配独立的 proxyServer,或者为每个代理单独启动一个浏览器实例。

在配置给 Puppeteer 之前,如何批量测试多个代理?

可以将它们粘贴到代理检测工具中;该工具支持单次最多测试 100 个代理,且不会存储密码。

为什么 page.authenticate() 对我的 SOCKS5 代理不起作用?

Chrome 本身不支持 SOCKS5 的用户名和密码认证,因此 Puppeteer 无法响应认证请求。你可以切换订单至 HTTP 模式、使用 proxy-chain 建立本地转发,或采用 IP 白名单认证方式。

来源

适用于无头 Chrome 的不限量 IP

覆盖 7 个国家的独享 IPv4 以及美国和越南的静态 ISP 代理,付款后自动开通,一客一 IP 独享保障。

查看美国实时价格

Related articles

按平台选择代理
网页抓取专属代理:不限流量的固定 IP 池
适用于 Python、Scrapy、Playwright 和 Selenium 的网页抓取代理:独享 IPv4 与静态 ISP 地址池,无限流量,按 IP 统一定价。
代理配置
Playwright 代理身份认证:每个上下文独享独立静态 IP
在 Node.js 或 Python 中为每个 Playwright 浏览器上下文配置独立的 HTTP(S) 认证代理,使时区与语言环境匹配对应 IP,并验证实际出口地址。
代理配置
Node.js 中的身份验证代理:Axios、原生 fetch 与 Got
通过认证HTTP(S)代理路由Node.js与TypeScript请求:Axios使用https-proxy-agent,fetch使用undici ProxyAgent,Got使用hpagent。
免费工具
将代理列表转换为工具所需的格式
在浏览器中批量转换代理列表,支持 ip:port:user:pass、user:pass@ip:port、http:// URL、SOCKS5 URI、JSON 数组与 FoxyProxy 导入格式。
按平台选择代理
用于SEO排名监控的代理:还原当地搜索者的真实结果页
提供美国、英国、越南、日本等7个市场的独享IPv4 SEO排名监控代理,确保自然排名、本地搜索包(Local Pack)和广告投放与当地搜索结果完全一致。
按平台选择代理
YouTube 专用代理:防止单频道违规警告波及矩阵
面向多频道创作者与团队的 YouTube 代理:单频道独享静态 ISP 或 IPv4,避免单频道违规警告或封号牵连其他频道,实现资产安全隔离。
IPV4 · united states
美国独享 IPv4 代理池:适用于数据抓取、排名追踪与广告核查
购买美国独享 IPv4 代理:静态美国数据中心 IP,单人专享,无限流量。专为数据采集、SERP 排名追踪与美国广告投放检查打造。
IPV4 · singapore
新加坡独享 IPv4 代理:每个店铺与广告账户专享一个固定 IP
新加坡独享 IPv4 代理:由您独享的静态新加坡数据中心 IP,适用于 Lazada 和 Shopee 新加坡店铺、新加坡广告账户及区域自动化业务。