Playwright 移动代理配置指南

export PROXY_URL="http://USERNAME-mbl-us-sid-pw01-rot-sticky:[email protected]:7000"

# 每个浏览器上下文一个 -sid-。并行 worker 需要使用不同的 sid。

import { chromium } from 'playwright';

const url = new URL(process.env.PROXY_URL);

const browser = await chromium.launch({
  proxy: {
    // 这里只写主机和端口。凭证不要放在这个字符串里。
    server: `http://${url.host}`,
    username: decodeURIComponent(url.username),
    password: decodeURIComponent(url.password),
  },
});

const page = await browser.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body'));   // 您的运营商出口 IP

await browser.close();

decodeURIComponent 很重要：用户名包含带连字符的参数，密钥可能经过百分号编码。

import { chromium } from 'playwright';

const base = new URL(process.env.PROXY_URL);

function proxyForSession(sid) {
  return {
    server: `http://${base.host}`,
    username: decodeURIComponent(base.username).replace(/-sid-[a-z0-9_]+/, `-sid-${sid}`),
    password: decodeURIComponent(base.password),
  };
}

// 只启动一次浏览器；通过各自的 sid 为每个上下文分配独立设备。
const browser = await chromium.launch();

const sids = ['job-a', 'job-b', 'job-c'];
const contexts = await Promise.all(
  sids.map((sid) => browser.newContext({ proxy: proxyForSession(sid) })),
);

for (const [i, ctx] of contexts.entries()) {
  const page = await ctx.newPage();
  await page.goto('https://api.ipify.org?format=json');
  console.log(sids[i], await page.textContent('body'));
}

await browser.close();

"一个上下文对应一个会话"是正确的思路：上下文隔离 cookie 和存储，sid 隔离设备。

const context = await browser.newContext({ proxy: proxyForSession('job-a') });

// 流量按 GB 计费，所以不要下载您不会用到的内容。
await context.route('**/*', (route) => {
  const type = route.request().resourceType();
  if (['image', 'media', 'font', 'stylesheet'].includes(type)) {
    return route.abort();
  }
  return route.continue();
});

const page = await context.newPage();
await page.goto('https://target.example/product/123', { waitUntil: 'domcontentloaded' });
console.log(await page.textContent('[data-testid="price"]'));

如果需要断言计算后的布局或截图，请把 stylesheet 从列表中移除。