Playwright 代理身份认证:每个上下文独享独立静态 IP
由 ProxyV4 工程团队撰写 · Updated:
Playwright 代理通过包含 server、username 和 password 的 proxy 对象进行配置,Playwright 可自行响应代理的 407 质询,无需任何扩展或封装。您可以在 launch() 中设置以应用于整个浏览器,或在 newContext() 中设置,以便在单个浏览器进程内为每个隔离上下文分配不同的 ProxyV4 IP。无论是在 Node.js 还是 Python 中,相同的配置键均适用于 Chromium、Firefox 和 WebKit。
proxy={ server: 'http://ip:port', username: 'user', password: 'pass' }- 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$2.25
- 3+ 个 IPUS$2.10
- 10+ 个 IPUS$2.00
- 25+ 个 IPUS$1.90
- 50+ 个 IPUS$1.80
- 100+ 个 IPUS$1.70
- 200+ 个 IPUS$1.60
- 500+ 个 IPUS$1.50
代理对象各配置项详解
| 键 | 示例值 | 说明 |
|---|---|---|
server | 'http://ip:port' | 仅包含地址和端口;凭据不包含在此字符串中 |
username | 'user' | 来自您 ProxyV4 订单的用户名 |
password | 'pass' | 代理返回 407 时自动发送 |
bypass | 'localhost,127.0.0.1' | 可选的主机列表,用于跳过代理 |
整浏览器级别与单上下文配置
将 proxy 传递给 chromium.launch() 会让该浏览器的所有页面都通过同一个 IP 访问,适用于单一身份的单一任务。将其传递给 browser.newContext() 则是多账号模式:每个上下文都有独立的 Cookie、存储和代理,因此单个 Chromium 进程即可承载多个会话,且每个会话显示不同的出口地址。
由于每个 ProxyV4 独享 IPv4 仅租给单个客户且续费保持地址不变,您可以在配置中将上下文名称映射到特定 IP,并在每次运行时重复使用该映射;上周识别到账号 A 对应某 IP 的网站,今天仍会看到相同的 IP。
保持上下文一致性的注意事项
- 在 Windows 和 macOS 上,某些 Playwright 与 Chromium 组合会拒绝单上下文代理,除非启动浏览器时也配置了代理;此时可以使用占位符
proxy: { server: 'http://per-context' }启动,并在每个上下文中对其进行覆盖 - 在
newContext()中设置timezoneId和locale以匹配代理所在国家/地区(例如美国 IP 使用America/New_York,越南使用Asia/Ho_Chi_Minh),使系统时钟和Intl输出与 IP 保持一致 - 仅需要文本时,可通过
page.route()拦截图片和字体;页面加载速度更快,任务耗时更短 - 及时关闭不再需要的上下文;每个上下文都会保持各自的连接处于打开状态
操作步骤
- 1
解析代理信息格式
从您 ProxyV4 订单中的
ip:port:user:pass格式提取信息:将ip:port作为server,最后两个字段分别作为username和password。 - 2
创建带有代理的上下文
调用
const context = await browser.newContext({ proxy: { server: 'http://ip:port', username: 'user', password: 'pass' } })。 - 3
匹配时区与语言
在同一个
newContext()选项中添加对应代理所在位置的timezoneId和locale。 - 4
验证 IP 接口
打开
const page = await context.newPage(),访问https://proxyv4.com/api/my-ip并检查显示的地址是否为代理 IP。在同一上下文中运行 WebRTC 泄漏检测 也是非常有用的二次核验手段。
常见问题
Playwright 提示“Proxy is only supported when browser is launched with a proxy”,该如何解决?
在 Windows 和 macOS 上,Chromium 可能需要启动层级的代理后才能接受各个上下文的独立代理。启动时配置 chromium.launch({ proxy: { server: 'http://per-context' } }),然后在每个 browser.newContext({ proxy }) 中传入真实的地址和登录凭据。
相同的代理设置是否适用于 Firefox 和 WebKit?
是的。proxy: { server, username, password } 为三大内核以及 Node.js 和 Python API 所通用,因此只需更改启动器名称(firefox、webkit)即可。
无头浏览器会消耗流量配额吗?
在 ProxyV4 独享 IPv4 或静态 ISP 套餐上不会;这两种套餐的带宽均为不限量,因此加载资源繁重的页面不会产生额外费用。
页面无法加载并报隧道错误,我该检查什么?
请确认 server 使用了 http:// 和正确的端口,且代理在控制台中仍处于有效状态。隧道连接指南 涵盖了其他可能的原因。
来源
每个 Playwright 上下文独享一个独享 IP
覆盖 7 个国家/地区的 HTTP(S) 账号密码认证代理,无限流量,续费保持 IP 不变。
查看美国即时价格