Puppeteer 移动代理配置指南

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

# 每个会话一个浏览器实例。Chrome 在整个进程范围内应用代理参数，
# 所以第二个身份就需要第二个浏览器。

import puppeteer from 'puppeteer';

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

const browser = await puppeteer.launch({
  headless: 'new',
  args: [
    // 这里只写主机和端口——Chrome 会忽略写在这里的凭证。
    `--proxy-server=http://${url.host}`,
  ],
});

const page = await browser.newPage();

// 大多数示例都漏掉了这一步。
await page.authenticate({
  username: decodeURIComponent(url.username),
  password: decodeURIComponent(url.password),
});

await page.goto('https://api.ipify.org?format=json', { waitUntil: 'domcontentloaded' });
console.log(await page.evaluate(() => document.body.innerText));

await browser.close();

page.authenticate 是按页面生效的。每个新页面或弹窗都需要单独调用——见下文。

const creds = {
  username: decodeURIComponent(url.username),
  password: decodeURIComponent(url.password),
};

// 捕获网站自行打开的页面，否则它们会遇到一个您看不到的 407。
browser.on('targetcreated', async (target) => {
  if (target.type() !== 'page') return;
  const p = await target.page();
  if (p) await p.authenticate(creds);
});

const page = await browser.newPage();
await page.authenticate(creds);

没有 targetcreated 钩子时，目标网站的一次 window.open 就会让任务悄悄中断。

await page.setRequestInterception(true);

page.on('request', (req) => {
  if (['image', 'media', 'font', 'stylesheet'].includes(req.resourceType())) {
    return req.abort();
  }
  return req.continue();
});

// 使用移动端视口，让网站向您的移动 IP 返回移动版页面。
await page.setViewport({ width: 390, height: 844, isMobile: true, deviceScaleFactor: 3 });
await page.goto('https://target.example/product/123', { waitUntil: 'domcontentloaded' });

必须在 goto 之前启用拦截，并且每个请求都必须恰好调用一次 abort 或 continue。