跳到正文

pyppeteer、PuppeteerSharp 代理设置

代理写在启动参数里,账号密码交给页面;下面是 Python 和 C# 的代码。

两个库怎么接代理

pyppeteer 和 PuppeteerSharp 都是启动 Chromium,所以代理就是一个 Chromium 参数,写在启动参数里:pyppeteer 的 args,PuppeteerSharp 的 LaunchOptions.Args。Chromium 要求参数值是 URI,比如 http://HOST:PORT。

这个参数没有地方放用户名和密码。账号密码用 authenticate 交给页面,它负责应答代理的登录请求。

pyppeteer 和 PuppeteerSharp 对照

pyppeteer 和 PuppeteerSharp 对照
项目pyppeteer(Python)PuppeteerSharp(.NET)
安装pip install pyppeteer(Python 3.8 及以上)dotnet add package PuppeteerSharp
浏览器默认用自带的 ChromiumBrowserFetcher().DownloadAsync() 下载浏览器
代理参数launch(args=["--proxy-server=..."])LaunchOptions { Args = new[] { "--proxy-server=..." } }
账号密码await page.authenticate({"username", "password"})await page.AuthenticateAsync(new Credentials { ... })
项目状态README 写明已不再维护,并推荐 playwright-python开工前先看项目的发布记录

来自 2026-11-16 读到的 pyppeteer、PuppeteerSharp 文档和源码。

pyppeteer:代理参数和登录

import asyncio
from pyppeteer import launch

async def main():
    browser = await launch(
        headless=True,
        args=["--proxy-server=http://HOST:2222"],
    )
    page = await browser.newPage()
    await page.authenticate({"username": "LOGIN", "password": "PASSWORD"})
    await page.goto("https://ipinfo.io/json")
    print(await page.evaluate("document.body.innerText"))
    await browser.close()

asyncio.run(main())

仅为示例:HOST、LOGIN、PASSWORD 换成“我的资产”里的值。

PuppeteerSharp:代理参数和登录

using PuppeteerSharp;

await new BrowserFetcher().DownloadAsync();

await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = true,
    Args = new[] { "--proxy-server=http://HOST:2222" }
});
await using var page = await browser.NewPageAsync();
await page.AuthenticateAsync(new Credentials { Username = "LOGIN", Password = "PASSWORD" });
await page.GoToAsync("https://ipinfo.io/json");
Console.WriteLine(await page.EvaluateExpressionAsync<string>("document.body.innerText"));

仅为示例:HOST、LOGIN、PASSWORD 要替换;写法是 .NET 控制台项目的顶级语句。

HTTP 还是 SOCKS5

Chromium 文档写明 Chrome 里 SOCKSv5 不支持任何认证方式,所以带账号密码的 SOCKS5 代理通过 --proxy-server 用不了。请用同一组账号的 HTTP 地址:Proxy302 上是 2222 端口。

不一定要重新买。按 IP 租的静态 ISP IP 也能走 2222 端口的 HTTP;动态住宅和新买的按流量 Fixed ISP,同一组账号密码两个端口都能用。

代理是按浏览器设的,不是按页面

--proxy-server 是浏览器进程的参数,这个浏览器里打开的所有页面都用它。需要多个 IP,就每个代理启动一个浏览器,或者让一个浏览器连每个新连接换 IP 的轮换网关。

Puppeteer 文档说 authenticate 会在后台打开请求拦截,可能影响性能。这两个库沿用了这套接口,规模化之前先测一轮。

新项目还该用 pyppeteer 吗?

pyppeteer 的 README 称仓库已不再维护,并推荐 playwright-python。可以自由选择的话,Playwright 的启动选项里直接支持代理登录;必须沿用 pyppeteer 的话,锁定版本,每次升级都测一遍代理设置。

五步设置并证明出口

  1. 第 1 步:拿到 HTTP 代理

    买静态 ISP IP,或用动态住宅流量(不用选协议,走 HTTP 的 2222 端口),然后到“我的资产”复制地址、端口、账号、密码。

  2. 第 2 步:先用 curl 测

    动代码之前先运行 curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json。

    预期结果 返回代理 IP 和国家的 JSON。

  3. 第 3 步:加参数并 authenticate

    复制 pyppeteer 或 PuppeteerSharp 示例,填上你的值。

  4. 第 4 步:打开 ipinfo.io

    运行并读取页面文本。

    预期结果 和第 2 步是同一个 IP。

  5. 第 5 步:再打开真正的目标

    IP 对上之后才换成目标网址。

不好用时

页面显示的是你自己的 IP

检查 参数是不是写在启动参数里,写成了 --proxy-server=http://HOST:PORT,带上了协议头。

处理 改好参数并重新启动浏览器;已经在运行的浏览器会保留旧设置。

停止条件 仍是自己的 IP:用 curl 测同一个地址。

ERR_PROXY_CONNECTION_FAILED

检查 地址和端口,以及你的网络能不能连到代理端口。

处理 改正,或换个网络试。

停止条件 地址端口都对:看“连接失败”那篇指南。

407 或弹出登录框

检查 authenticate 是否在首次跳转之前调用,账号密码是否完整复制。

处理 把 authenticate 调用放到 goto 之前,重新复制账号密码。

停止条件 curl 也一样:带订单号提交工单。

带账号的 SOCKS5 地址连不上

检查 Chrome 不支持 SOCKS5 认证。

处理 用 HTTP 地址,端口 2222。

停止条件 别在这里反复试 SOCKS5,改用 HTTP 的 2222 端口。

设了路径之后浏览器起不来

检查 executablePath 或 ExecutablePath 会替换自带的 Chromium,pyppeteer 提醒这样有风险。

处理 先去掉,用自带浏览器。

停止条件 必须用自己的 Chrome:选库支持的 Chrome 版本。

pyppeteer 和 PuppeteerSharp 代理常见问题

pyppeteer 怎么设置代理?

给 launch() 传 args=["--proxy-server=http://HOST:PORT"],首次 goto 之前再 await page.authenticate({"username": ..., "password": ...})。

PuppeteerSharp 怎么设置代理?

把 "--proxy-server=http://HOST:PORT" 放进 LaunchOptions.Args,再调用 page.AuthenticateAsync(new Credentials { Username = ..., Password = ... })。

账号密码能直接写在 --proxy-server 里吗?

别指望它:这个参数要的是代理标识,账号密码由库提供的 authenticate 负责。

SOCKS5 能带账号密码用吗?

在 Chrome 里不行,它不支持 SOCKS5 认证。用 HTTP 地址,端口 2222。

pyppeteer 还在维护吗?

它的 README 写明仓库已不再维护,并推荐 playwright-python。

参考资料

7
  1. pyppeteer 参考文档:launch() 与 Page.authenticate

    官方文档 · 确认日期:

    2026-11-16 读到:launch() 的 args 是传给浏览器进程的额外参数列表;executablePath 用来替换自带的 Chromium,页面提醒这样有风险;Page.authenticate(credentials) 接收含 username 和 password 的字典。

  2. pyppeteer 的 GitHub 页面

    官方文档 · 确认日期:

    2026-11-16 读到:自称是 puppeteer 的非官方 Python 移植;状态说明写着仓库已不再维护,长期只有小改动,并推荐 playwright-python;要求 Python 3.8 及以上。

  3. PuppeteerSharp API:LaunchOptions

    官方文档 · 确认日期:

    2026-11-16 读到:LaunchOptions.Args 是传给浏览器实例的额外参数字符串数组;Headless 默认 true;ExecutablePath 替换自带的 Chromium。文档首页给出安装命令 dotnet add package PuppeteerSharp。

  4. PuppeteerSharp 源码:IPage.AuthenticateAsync

    官方文档 · 确认日期:

    2026-11-16 读到:IPage 上的 Task AuthenticateAsync(Credentials credentials),Credentials 类有 Username 和 Password;传 null 表示关闭认证。

  5. Puppeteer 文档:Page.authenticate

    官方文档 · 确认日期:

    2026-11-16 读到:为 HTTP 认证提供凭据;实现时会在后台打开请求拦截,可能影响性能。

  6. Chromium 文档:Chrome 的代理支持

    官方文档 · 确认日期:

    2026-11-16 读到:--proxy-server 这类命令行参数要求 URI 格式的代理标识;Chrome 里 SOCKSv5 不支持任何认证方式。

  7. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站内产品事实表,2026-11-16 核对:价格(US$,1 PTC = US$1)、租期、协议与端口(HTTP 2222、SOCKS5 3333)、各产品能用哪种协议连接、国家与城市定向、无免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。