Playwright 代理设置：一个浏览器上下文一条带账号密码的 IP

为什么 Playwright 要配代理

Playwright 驱动的是真实浏览器，但每个页面请求仍然从你机器的 IP 发出。一台服务器同时跑很多上下文，网站看到的是同一个地址在干很多访客的活，常见结果是 HTTP 429（请求过多，要求你降速）或直接拦截。

Playwright 自带代理支持：可以给整个浏览器设一条，也可以给每个浏览器上下文（context）单独设，并发任务各走各的 IP。官方文档说明 HTTP 代理可以填用户名和密码。

国内开发者常踩两个坑。一是 Chromium 不支持 SOCKS5 代理认证，也不会使用写在代理设置里的账号密码，带密码的代理请用 HTTP 地址。二是国内网络无法直接连接海外代理：在 Windows / macOS 上先打开 控制台 → 连接工具 → 辅助工具；脚本跑在服务器上时，用香港、新加坡等境外服务器。

• MDN：429 Too Many Requests
• Playwright 文档：网络 — HTTP 代理
• Playwright API：browserType.launch() 的 proxy 选项
• Chromium：Chrome 的代理支持说明
• Proxy302 控制台 → 连接工具 → 辅助工具

Playwright 推荐配置

可使用方向键横向滚动，阅读完整内容。

下面的按钮会打开「静态机房代理」并选好「AI 与自动化」场景，付款前选好地区、租期、协议和「数量」（一次最多 100 个 IP）。

• Proxy302 控制台 — 静态机房代理

买哪种 Proxy302 代理

可使用方向键横向滚动，阅读完整内容。

价格以美元计。钱包充值一次，各类线路都从钱包付款；不会自动续费，想保留 IP 请在「我的资产」里续费。

• Proxy302 价格页

5 步配好 Playwright 代理

1. 先开海外网络环境

   国内网络无法直接连接海外代理：在 Windows / macOS 上打开 控制台 → 连接工具 → 辅助工具 并保持开启；脚本跑在服务器上时，用香港、新加坡等境外服务器。

   • 辅助工具使用教程

2. 选地区和租期

   点下面的按钮，打开「静态机房代理」（按 IP 和租期），场景已选「AI 与自动化」。在「连接配置」里选「地区」和「租期」，「协议」选 HTTP，「数量」按并发任务数填（一次最多 100 个），然后点「确认费用并生成」。

3. 复制每条 IP

   在「我的资产」点「复制」，得到「地址:端口:用户名:密码」连接串。地址和端口填进 PROXY_HOST、PROXY_PORT，用户名和密码填进 PROXY_USER、PROXY_PASS，密码不写进代码。也可以点「复制给 AI」，选 Playwright，把生成的说明交给 Cursor、Claude Code 等工具，让它帮你配好并验证出口 IP。

4. 写进 Playwright 并验证

   用下面的代码：proxy 写在 newContext() 上，一个上下文一条 IP；写在 launch() 上，整个浏览器共用一条。server 必须是 http://地址:端口。

   预期结果 脚本打开 api.ipify.org，打印出的是代理 IP，不是你本机的 IP。

5. 网站封机房 IP 时

   改用「动态住宅代理」：「线路」选「低价线路」，在「补充流量」买 1 GB 起的套餐，「出口模式」选「全球轮换」（新连接可换出口），或选「指定地区 / 保持 IP」固定在某个国家、城市。动态住宅的 HTTP 入口是 proxy.proxy302.com:2222。

Playwright 带账号密码的代理（Node.js）

可使用方向键横向滚动，阅读完整内容。

// npm i playwright   then   npx playwright install chromium
import { chromium } from 'playwright'

// From Proxy302 → My assets → Copy (host:port:user:password)
const { PROXY_HOST, PROXY_PORT, PROXY_USER, PROXY_PASS } = process.env

const browser = await chromium.launch()
// One proxy per browser context: each parallel worker gets its own exit IP
const context = await browser.newContext({
  proxy: {
    server: `http://${PROXY_HOST}:${PROXY_PORT}`, // HTTP: Chromium can't send a SOCKS5 password
    username: PROXY_USER,
    password: PROXY_PASS,
  },
})
const page = await context.newPage()
await page.goto('https://api.ipify.org?format=json')
console.log(await page.textContent('body')) // {"ip":"..."}: the proxy's exit IP, not your server's
await browser.close()

2026-10-18 用 Playwright 1.63.0 + Chromium 153 在本地带密码的代理上实测：凭据正确时页面能打开，密码错误时打不开。把检测 IP 的地址换成你的目标网站即可。

• 本地代理夹具实测
• Playwright API：browserType.launch() 的 proxy 选项

Python 写法

可使用方向键横向滚动，阅读完整内容。

# pip install playwright   then   playwright install chromium
import os
from playwright.sync_api import sync_playwright

# From Proxy302 → My assets → Copy (host:port:user:password)
proxy = {
    "server": f"http://{os.environ['PROXY_HOST']}:{os.environ['PROXY_PORT']}",
    "username": os.environ["PROXY_USER"],
    "password": os.environ["PROXY_PASS"],
}

with sync_playwright() as p:
    browser = p.chromium.launch(proxy=proxy)  # or browser.new_context(proxy=proxy) per worker
    page = browser.new_page()
    page.goto("https://api.ipify.org?format=json")
    print(page.text_content("body"))  # the proxy's exit IP
    browser.close()

Playwright Python 版在 launch() 或 new_context() 里传同样的 proxy 字典。本段只做了语法检查，上面的 Node.js 版做了完整实测。

• Playwright 文档：网络 — HTTP 代理

常见问题速查

Playwright 代理常见问题

相关场景

Selenium 代理 IP

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

查看配置与价格

地域测试代理 IP

模拟不同国家访问网站：用指定国家、城市的家庭宽带 IP 查看价格、语言、横幅等本地化内容，同时匹配浏览器语言和时区。

查看配置与价格

给 API、测试和监控用的高速固定 IP

高速数据中心代理：固定 IP、低延迟、高并发，单 IP 成本最低，适合 API、测试和批量任务。可选国家，按 IP 和租期付费。

查看配置与价格