页面显示的是你自己的 IP
检查 参数是不是写在启动参数里,写成了 --proxy-server=http://HOST:PORT,带上了协议头。
处理 改好参数并重新启动浏览器;已经在运行的浏览器会保留旧设置。
停止条件 仍是自己的 IP:用 curl 测同一个地址。
代理写在启动参数里,账号密码交给页面;下面是 Python 和 C# 的代码。
pyppeteer 和 PuppeteerSharp 都是启动 Chromium,所以代理就是一个 Chromium 参数,写在启动参数里:pyppeteer 的 args,PuppeteerSharp 的 LaunchOptions.Args。Chromium 要求参数值是 URI,比如 http://HOST:PORT。
这个参数没有地方放用户名和密码。账号密码用 authenticate 交给页面,它负责应答代理的登录请求。
| 项目 | pyppeteer(Python) | PuppeteerSharp(.NET) |
|---|---|---|
| 安装 | pip install pyppeteer(Python 3.8 及以上) | dotnet add package PuppeteerSharp |
| 浏览器 | 默认用自带的 Chromium | BrowserFetcher().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 文档和源码。
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 换成“我的资产”里的值。
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 控制台项目的顶级语句。
Chromium 文档写明 Chrome 里 SOCKSv5 不支持任何认证方式,所以带账号密码的 SOCKS5 代理通过 --proxy-server 用不了。请用同一组账号的 HTTP 地址:Proxy302 上是 2222 端口。
不一定要重新买。按 IP 租的静态 ISP IP 也能走 2222 端口的 HTTP;动态住宅和新买的按流量 Fixed ISP,同一组账号密码两个端口都能用。
--proxy-server 是浏览器进程的参数,这个浏览器里打开的所有页面都用它。需要多个 IP,就每个代理启动一个浏览器,或者让一个浏览器连每个新连接换 IP 的轮换网关。
Puppeteer 文档说 authenticate 会在后台打开请求拦截,可能影响性能。这两个库沿用了这套接口,规模化之前先测一轮。
pyppeteer 的 README 称仓库已不再维护,并推荐 playwright-python。可以自由选择的话,Playwright 的启动选项里直接支持代理登录;必须沿用 pyppeteer 的话,锁定版本,每次升级都测一遍代理设置。
买静态 ISP IP,或用动态住宅流量(不用选协议,走 HTTP 的 2222 端口),然后到“我的资产”复制地址、端口、账号、密码。
动代码之前先运行 curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json。
预期结果 返回代理 IP 和国家的 JSON。
复制 pyppeteer 或 PuppeteerSharp 示例,填上你的值。
运行并读取页面文本。
预期结果 和第 2 步是同一个 IP。
IP 对上之后才换成目标网址。
检查 参数是不是写在启动参数里,写成了 --proxy-server=http://HOST:PORT,带上了协议头。
处理 改好参数并重新启动浏览器;已经在运行的浏览器会保留旧设置。
停止条件 仍是自己的 IP:用 curl 测同一个地址。
检查 地址和端口,以及你的网络能不能连到代理端口。
处理 改正,或换个网络试。
停止条件 地址端口都对:看“连接失败”那篇指南。
检查 authenticate 是否在首次跳转之前调用,账号密码是否完整复制。
处理 把 authenticate 调用放到 goto 之前,重新复制账号密码。
停止条件 curl 也一样:带订单号提交工单。
检查 Chrome 不支持 SOCKS5 认证。
处理 用 HTTP 地址,端口 2222。
停止条件 别在这里反复试 SOCKS5,改用 HTTP 的 2222 端口。
检查 executablePath 或 ExecutablePath 会替换自带的 Chromium,pyppeteer 提醒这样有风险。
处理 先去掉,用自带浏览器。
停止条件 必须用自己的 Chrome:选库支持的 Chrome 版本。
给 launch() 传 args=["--proxy-server=http://HOST:PORT"],首次 goto 之前再 await page.authenticate({"username": ..., "password": ...})。
把 "--proxy-server=http://HOST:PORT" 放进 LaunchOptions.Args,再调用 page.AuthenticateAsync(new Credentials { Username = ..., Password = ... })。
在 Chrome 里不行,它不支持 SOCKS5 认证。用 HTTP 地址,端口 2222。
官方文档 · 确认日期:
2026-11-16 读到:launch() 的 args 是传给浏览器进程的额外参数列表;executablePath 用来替换自带的 Chromium,页面提醒这样有风险;Page.authenticate(credentials) 接收含 username 和 password 的字典。
官方文档 · 确认日期:
2026-11-16 读到:自称是 puppeteer 的非官方 Python 移植;状态说明写着仓库已不再维护,长期只有小改动,并推荐 playwright-python;要求 Python 3.8 及以上。
官方文档 · 确认日期:
2026-11-16 读到:LaunchOptions.Args 是传给浏览器实例的额外参数字符串数组;Headless 默认 true;ExecutablePath 替换自带的 Chromium。文档首页给出安装命令 dotnet add package PuppeteerSharp。
官方文档 · 确认日期:
2026-11-16 读到:IPage 上的 Task AuthenticateAsync(Credentials credentials),Credentials 类有 Username 和 Password;传 null 表示关闭认证。
官方文档 · 确认日期:
2026-11-16 读到:为 HTTP 认证提供凭据;实现时会在后台打开请求拦截,可能影响性能。
官方文档 · 确认日期:
2026-11-16 读到:--proxy-server 这类命令行参数要求 URI 格式的代理标识;Chrome 里 SOCKSv5 不支持任何认证方式。
产品观察 · 确认日期:
站内产品事实表,2026-11-16 核对:价格(US$,1 PTC = US$1)、租期、协议与端口(HTTP 2222、SOCKS5 3333)、各产品能用哪种协议连接、国家与城市定向、无免费试用。
注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。