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，可在「我的资产」里为它开启自动续费，或手动续费；续费一般会保留原 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），或选「指定地区 / 保持 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 MCP 走代理

Playwright MCP 让 Claude Code、Cursor、Codex 这类 AI 客户端去操作浏览器。给它加上 --proxy-server，这个浏览器的流量就会走你的代理。账号密码直接写在地址里，格式是 http://USER:PASS@HOST:PORT，没有单独的用户名选项。--proxy-bypass 后面写不想走代理的域名，用逗号隔开。

请用代理的 HTTP 入口（Proxy302 的端口是 2222）。README 里也出现了 socks5:// 的地址，但 Playwright 不支持带用户名密码的 SOCKS5：相关的需求已在 2026 年 10 月 31 日被关闭，官方不打算做。如果想让 AI agent 用自己的库去操作浏览器，请看 browser-use 代理指南。

proxy302-mcp 是 Proxy302 官方的 MCP 服务，在 GitHub 开源，由 Proxy302 团队维护。Proxy302 也在 https://proxy302.com/v1/mcp 托管了一份：Claude Code、Cursor、VS Code 这类能带 Authorization 请求头的客户端，填 API 密钥就能连，不用安装。安装命令见代理 MCP 服务器指南。

• browser-use 代理设置
• 代理 MCP 服务器指南

• 来源：
• Playwright MCP README
• Playwright issue 10567: Support socks5 proxy with authentication
• proxy302-mcp 的 README（Proxy302 官方 MCP 服务）

让 Playwright MCP 走代理: mcpServers

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

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--proxy-server",
        "http://USER:PASS@HOST:PORT",
        "--proxy-bypass",
        ".example.com"
      ]
    }
  }
}

把 USER、PASS、HOST、PORT 换成“我的资产”里的值。mcpServers 这一段写进你的 MCP 客户端的配置文件。

• 来源：
• Playwright MCP README

Proxy302 一览

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

价格按 PTC 从钱包扣，1 PTC = 1 美元。没有免费试用：最小一单是 1 GB 动态住宅流量，或一个 IP 用 1 天。核对于 2026-11-04。

• 来源：
• Proxy302 product facts and price list
• Proxy302 ISP for AI subscriptions: public catalog

常见问题速查

Playwright 代理常见问题

验证码识别服务：CaptchaAI

CaptchaAI 是面向自动化软件的付费验证码识别接口。它是独立的第三方服务，也是 Proxy302 的合作伙伴，不提供代理。仅在站点条款允许的场景下使用。

• 访问 CaptchaAI

相关场景

Selenium 代理 IP

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

查看配置与价格

地域测试代理 IP

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

查看配置与价格

数据中心代理（机房 IP）

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

查看配置与价格