Puppeteer 代理设置：认证、SOCKS5 与轮换 IP | Proxy302

开跑之前要准备什么

一个装好 Puppeteer 的 Node.js 项目，外加一个能启动浏览器的脚本。

一个买了动态住宅流量的 Proxy302 账号。Budget 线任意数量都是 US$1.50/GB（100 GB 档 US$1.35/GB），最低买 1 GB；价格看价格页。

你的 Proxy302 代理用户名和密码。控制台「我的资产」页能查到你买的每项资产的 HOST、PORT、USERNAME 和 PASSWORD。

• 价格页

• 来源：
• Proxy302 价格页
• Proxy302 指南：代理地址、端口与登录

连接参数逐字段说清

网关地址: proxy.proxy302.com — HTTP 和 SOCKS5 共用这一个网关

HTTP 端口: 2222 — Puppeteer 推荐走的入口

SOCKS5 端口: 3333

启动参数: --proxy-server=http://proxy.proxy302.com:2222

认证方式: await page.authenticate({ username, password })，放在第一次 page.goto() 之前

这些值从哪来: Proxy302 控制台「我的资产」

• 来源：
• Proxy302 指南：代理地址、端口与登录

一个能直接跑通的完整脚本

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    args: ['--proxy-server=http://proxy.proxy302.com:2222'],
  });

  const page = await browser.newPage();
  await page.authenticate({
    username: 'YOUR_PROXY_USERNAME',
    password: 'YOUR_PROXY_PASSWORD',
  });

  await page.goto('https://ipinfo.io/json');
  console.log('出口:', await page.$eval('body', (el) => el.textContent));

  await browser.close();
})();

按原样可运行：填入你的 Proxy302 凭据后用 Node.js 执行。

• 来源：
• Puppeteer API 文档：LaunchOptions
• Puppeteer API 文档：page.authenticate()
• Proxy302 指南：代理地址、端口与登录

启动参数干了什么

--proxy-server 是 Chromium 的命令行开关，Chromium 源码里的注释是 "Uses a specified proxy server, overrides system settings."（使用指定的代理服务器，覆盖系统设置）。Puppeteer 通过 puppeteer.launch() 的 args 选项把它转交给浏览器，API 文档对 args 的说明是 "Additional command line arguments to pass to the browser instance."（传给浏览器实例的额外命令行参数）。浏览器默认以无头模式运行。

Chromium 认 http、https、socks4、socks5 四种代理协议，所以同一个参数两种入口都能带：--proxy-server=http://proxy.proxy302.com:2222 或 --proxy-server=socks5://proxy.proxy302.com:3333。

• 来源：
• Chromium 源码：chrome/common/chrome_switches.h
• Chromium 源码：net/base/proxy_server.cc
• Puppeteer API 文档：LaunchOptions

page.authenticate() 干了什么

Puppeteer API 文档写明 page.authenticate() 为页面提供 "credentials for HTTP authentication"（HTTP 认证凭据），并注明 "Request interception will be turned on behind the scenes to implement authentication."（后台会打开请求拦截来实现认证）。在第一次 page.goto() 之前调用；传 null 即可关闭。

这也是推荐走 HTTP 2222 端口的原因：Proxy302 每条连接都要用户名密码登录，而这条路径让浏览器在页面内部就把登录完成。用户名密码跟你其他工具用的是同一套，都显示在「我的资产」里。

• 来源：
• Puppeteer API 文档：page.authenticate()
• Proxy302 指南：代理地址、端口与登录

确认出口 IP

在页面里加载 https://ipinfo.io/json。ip 和 country 字段应该属于代理出口，而不是你本机的连接。如果打出来的是自己的 IP，说明启动参数没传到这个脚本驱动的浏览器实例：先打印出口 IP，再检查脚本启动和配置的到底是哪个浏览器。各字段怎么看，代理归属指南里有讲。

• 怎么查代理的 IP 和国家

流量、价格和有效期

动态住宅按 GB 计费，分两条线：Budget 线 US$1.50/GB 起（100 GB 档 US$1.35/GB），Premium 线 US$5.00/GB 起。最低买 1 GB。预付费、用多少付多少、没有订阅，买到的 GB 永不过期。

• 来源：
• Proxy302 价格页
• Proxy302：动态住宅代理页

Puppeteer 里的轮换 IP 与粘性会话

动态住宅产品页写明了两种行为：每个请求走一条不同的真实住宅 IP；粘性（sticky）会话在一串请求里保持同一条住宅 IP。按请求轮换适合大批量翻页采集、比价这类不想让单个 IP 积累访问历史的任务；粘性会话适合登录流程、购物车这类带会话状态的操作。

你不用维护代理列表：一个网关、一套账号密码就承载全部流量。一条线怎么在这两种行为之间切换，产品页没有写，所以别想当然——直接在脚本里连发两次 https://ipinfo.io/json 对比出口 IP：每次地址都不同就是按请求轮换，两次相同就是会话正抓着同一条 IP。

• 动态住宅代理页

• 来源：
• Proxy302：动态住宅代理页

跑完一轮 URL，再确认出口行为

// 网关和账号密码在任务之间不变。
for (const url of urls) {
  await page.goto(url, { waitUntil: 'domcontentloaded' });
  // ...提取你要的内容
}

// 确认你这条线的行为：连开两次 IP 回显页，对比出口 IP。
for (let i = 0; i < 2; i++) {
  await page.goto('https://ipinfo.io/json', { waitUntil: 'domcontentloaded' });
  console.log('出口:', await page.$eval('body', (el) => el.textContent));
}

按原样可运行：填入你的 Proxy302 凭据后用 Node.js 执行。

Puppeteer 里用 SOCKS5

SOCKS5 入口在同一网关的 3333 端口。但浏览器本身有个坑：Chromium——也就是 Puppeteer 驱动的那套引擎——的 SOCKS5 客户端在握手问候里只提供一种方法："no authentication"（无认证），而且只有服务器选中它握手才继续。Chromium 永远不会提供 SOCKS5 的用户名密码认证，而 Proxy302 每条连接都要求用户名密码。

实际可行的路子有三条。一：走 HTTP 2222 端口——认证由 page.authenticate() 端到端完成（见上文示例），其余什么都不用改。二：在本机跑一个小型转发器，接收浏览器不带认证的连接，再转发到带认证的 SOCKS5 入口——只有任务非 SOCKS5 不可才值得这么做，普通网页流量走 HTTP 效果一样。三：在浏览器之外用自己实现了 SOCKS5 用户名密码认证的工具走 SOCKS5。

• 来源：
• Chromium 源码：net/socket/socks5_client_socket.cc
• Proxy302 指南：代理地址、端口与登录

浏览器外的 SOCKS5：curl

curl -x socks5h://USERNAME:[email protected]:3333 https://ipinfo.io/json

按原样可运行：填入你的 Proxy302 凭据后用 Node.js 执行。

• 来源：
• libcurl 文档：CURLOPT_PROXY
• Proxy302 指南：代理地址、端口与登录

为什么写 socks5h 而不是 socks5

保留 socks5h:// 里的那个 h。libcurl 文档对 socks5h:// 的定义是 "SOCKS5 Proxy. Proxy resolves URL hostname"（SOCKS5 代理，由代理端解析 URL 主机名），而普通的 socks5:// 是先在你本机解析域名再去连代理。把解析留在代理端，网站看到的 DNS 才和你的出口 IP 对得上。同一份文档也确认了上条命令里的凭据写法 scheme://username:password@hostname。

• 来源：
• libcurl 文档：CURLOPT_PROXY

常见报错和排查

net::ERR_NO_SUPPORTED_PROXIES: Chromium 错误表的原话是 "There are no supported proxies in the provided list."（提供的列表里没有受支持的代理）。检查 --proxy-server 的值：协议要在支持范围内（http:// 或 socks5://），host:port 要写对。

net::ERR_PROXY_CONNECTION_FAILED: 按 Chromium 错误表的原文："Could not create a connection to the proxy server. An error occurred either in resolving its name, or in connecting a socket to it"（无法建立到代理服务器的连接，错误出在域名解析或套接字连接）。检查网关拼写 proxy.proxy302.com、端口 2222（HTTP）或 3333（SOCKS5），以及你的网络放不放行到网关的出站连接。

HTTP 407 或反复弹认证: page.authenticate() 必须在第一次 page.goto() 之前执行。重新抄一遍用户名密码，别带上多余的空格或换行。

页面能打开，但显示的是自己的 IP: 启动参数没传到这个浏览器实例。先打印出口 IP，再确认脚本配置和启动的是同一个浏览器。

目标站慢、超时: 给这个任务的 page.goto() 调大超时，并确认账号里还有流量。

• 来源：
• Chromium 源码：net/base/net_error_list.h
• Proxy302 指南：代理地址、端口与登录

常见问题

延伸阅读

Playwright 代理

Playwright 代理设置：账号密码认证，一个上下文一条 IP；测试用静态机房 IP，网站封服务器 IP 时用动态住宅，US$1.50/GB 起。

查看配置与价格

Selenium 代理 IP

Selenium 设置带用户名密码的代理：ChromeOptions 填 HTTP 代理，再用 Selenium 自带的 BiDi 认证处理，不装插件。测试用静态机房 IP，实测可用。

查看配置与价格

代理的地址、端口、账号和密码怎么填

每个可用的代理都由五个基本字段构成：协议、地址、端口、账号和密码。

价格与计费

动态住宅 US$1.50/GB 起，静态 ISP 固定 IP US$7.99/月，数据中心 IP US$3.99/月，按量付费，无订阅。