Playwright代理IP配置怎么做？从 BrowserContext 到 407/429 排查

Playwright代理IP配置，适合动态网页采集、页面渲染检测、前端自动化巡检和登录流程测试。相比 requests 这类 HTTP 客户端，Playwright 会启动真实浏览器环境，能处理 JavaScript 渲染、跳转、Cookie、LocalStorage 和复杂表单，但也更容易遇到代理认证、会话保持和目标站频率限制问题。

很多报错并不是代理不可用，而是配置位置不对、账号会话和出口 IP 变化冲突，或者目标站已经用 403、429 提醒你访问节奏异常。正确做法是先把代理层、浏览器上下文和业务重试拆开。

先判断代理放在哪一层

Playwright 常见有两种代理配置方式：启动浏览器时配置全局代理，或者在 BrowserContext 里给不同任务分配不同代理。全局代理适合单任务脚本，Context 代理更适合多账号、多目标站或批量检测任务。

如果只是公开页面巡检，可以优先用隧道代理IP承接自动轮换；如果涉及登录、账号后台、长时间会话，应优先考虑住宅静态代理IP或独享出口。

Node.js 中的基础配置

下面是一个最小化示例，用于确认代理出口是否生效。真实项目里不要把账号密码写死在代码中，可以放在环境变量或本地配置文件里。

const { chromium } = require("playwright");

async function main() {
  const browser = await chromium.launch({
    headless: true,
    proxy: {
      server: "http://proxy.example.com:8888",
      username: "user",
      password: "pass"
    }
  });

  const page = await browser.newPage();
  await page.goto("https://httpbin.org/ip", { waitUntil: "domcontentloaded" });
  console.log(await page.textContent("body"));
  await browser.close();
}

main().catch(console.error);

如果同一个浏览器里要跑多个账号，建议按账号创建 context，并把 Cookie、UA、代理出口和任务队列绑定在一起，不要让账号 A 的 Cookie 跟账号 B 的出口混用。

const context = await browser.newContext({
  proxy: {
    server: "http://proxy.example.com:8888",
    username: "user",
    password: "pass"
  },
  userAgent: "Mozilla/5.0 ..."
});

const page = await context.newPage();
await page.goto("https://example.com", { waitUntil: "networkidle" });

407、403、429 分别怎么处理

Playwright代理IP配置最常见的三个状态是 407、403 和 429。它们代表的问题不同，处理方式也不能混在一起。

407 不要靠换 IP 解决，先查授权。403 也不一定是 IP 坏了，可能是 Header、Cookie、TLS 指纹或访问路径异常。429 更应先降速，而不是立刻开更多代理继续冲请求。

给动态网页采集加超时和重试

浏览器采集的重试成本比普通 HTTP 请求高。每次重试都可能重新打开页面、加载资源和执行脚本，所以要把超时、截图、错误分类和队列回写放进统一流程。

async function openWithRetry(page, url, maxRetry = 2) {
  for (let attempt = 1; attempt <= maxRetry + 1; attempt++) {
    try {
      const response = await page.goto(url, {
        timeout: 30000,
        waitUntil: "domcontentloaded"
      });

      const status = response ? response.status() : 0;
      if (status === 429) throw new Error("TARGET_429");
      if (status === 403) throw new Error("TARGET_403");
      return response;
    } catch (error) {
      if (attempt > maxRetry) throw error;
      await page.waitForTimeout(3000 * attempt);
    }
  }
}

建议把错误分成代理认证、代理连接、目标拒绝、目标限流、页面结构变化五类。只有代理连接失败才优先换出口；如果是 429，应先降低目标站并发和单账号频率。

悟空代理的配置建议

公开页面采集、价格监控和页面可用性巡检，可以用悟空代理的隧道代理入口简化出口轮换；账号登录、后台检查和需要稳定 Cookie 的流程，更适合使用住宅静态代理或独享代理 IP。企业内联调或固定机房环境，也可以评估云服务器代理IP。

上线前建议先跑一组小样本：记录代理连接成功率、页面成功率、403/429 占比、P95 加载时间、单条有效数据成本和每个 context 的失败原因。这样才能判断是代理质量问题、频率问题，还是 Playwright 脚本自身等待策略不合理。

总结

Playwright代理IP配置的关键，不是简单把代理地址塞进参数，而是把浏览器上下文、账号会话、出口类型和错误恢复一起设计。单任务用全局代理，多账号用 context 隔离；407 查授权，403 查环境，429 先降速。

如果你的 Playwright 任务正在出现认证失败、页面加载慢或 429 增多，可以先用悟空代理做小规模压测，把出口、账号和目标站分组记录清楚，再决定使用隧道代理、住宅静态代理还是独享出口。更多接入方式可访问悟空代理官网。