Playwright 代理身份认证:每个上下文独享独立静态 IP

· Updated:

Playwright 代理通过包含 server、username 和 password 的 proxy 对象进行配置,Playwright 可自行响应代理的 407 质询,无需任何扩展或封装。您可以在 launch() 中设置以应用于整个浏览器,或在 newContext() 中设置,以便在单个浏览器进程内为每个隔离上下文分配不同的 ProxyV4 IP。无论是在 Node.js 还是 Python 中,相同的配置键均适用于 Chromium、Firefox 和 WebKit。

Playwright · HTTP
proxy={ server: 'http://ip:port', username: 'user', password: 'pass' }
独享 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
购买 美国
静态住宅 ISP
🇻🇳 越南
有货
起
US$1.50 / IP / 月
批量阶梯折扣
  • 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. 1

    解析代理信息格式

    从您 ProxyV4 订单中的 ip:port:user:pass 格式提取信息:将 ip:port 作为 server,最后两个字段分别作为 username 和 password。

  2. 2

    创建带有代理的上下文

    调用 const context = await browser.newContext({ proxy: { server: 'http://ip:port', username: 'user', password: 'pass' } })。

  3. 3

    匹配时区与语言

    在同一个 newContext() 选项中添加对应代理所在位置的 timezoneId 和 locale。

  4. 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 不变。

查看美国即时价格

Related articles

按平台选择代理
网页抓取专属代理:不限流量的固定 IP 池
适用于 Python、Scrapy、Playwright 和 Selenium 的网页抓取代理:独享 IPv4 与静态 ISP 地址池,无限流量,按 IP 统一定价。
代理配置
带认证代理的 Puppeteer 配置:启动参数加登录验证
Puppeteer 代理认证实践示例:使用 --proxy-server 设置地址,通过 page.authenticate() 验证登录,并介绍 SOCKS5、多上下文配置与错误修复。
代理配置
Selenium WebDriver 与代理认证:切实可行的解决方案
ChromeDriver的Selenium代理认证:为何--proxy-server忽略user:pass,如何用selenium-wire或onAuthRequired扩展解决并验证IP。
代理配置
分步指南:通过带认证的代理发送 Python requests 请求
通过带认证的 HTTP(S) 代理发送 Python 请求:构建 proxies 字典、绑定至 Session、对特殊密码编码、轮询代理列表并验证出口 IP。
按平台选择代理
用于SEO排名监控的代理:还原当地搜索者的真实结果页
提供美国、英国、越南、日本等7个市场的独享IPv4 SEO排名监控代理,确保自然排名、本地搜索包(Local Pack)和广告投放与当地搜索结果完全一致。
按平台选择代理
面向越南与新加坡多店铺卖家的 Shopee 代理
专为在越南或新加坡运营多家店铺的卖家打造的 Shopee 代理:每店独享静态 ISP 或独享 IPv4,防止卖家中心关联多店。
IPV4 · united states
美国独享 IPv4 代理池:适用于数据抓取、排名追踪与广告核查
购买美国独享 IPv4 代理:静态美国数据中心 IP,单人专享,无限流量。专为数据采集、SERP 排名追踪与美国广告投放检查打造。
ISP · vietnam
越南静态 ISP 代理:专为主店铺与广告账户打造
基于越南本地民用运营商注册IP的越南静态ISP代理。为Shopee主力店铺、TikTok Shop、Facebook广告账户和Zalo OA提供专属固定IP。