集成

如何在 Playwright 中使用代理

为 Playwright 提供一个静态 ISP 地址，可以在启动时设置，也可以只用于单个浏览器上下文。这些示例在发布前已在 Chromium、Firefox 和 WebKit 中通过本地代理实际运行。

简而言之： 把包含 server、username 和 password 的 proxy 传给 chromium.launch，或传给 browser.new_context，使其只作用于一个上下文。通过 HTTP 时，三个引擎都会用这些字段完成身份验证。通过 SOCKS5 时，没有一个引擎接受用户名和密码：Playwright 会拒绝启动。请把您的 IP 加入代理的白名单，并只提供 socks5:// 的 server。

Playwright 通过一套 API 驱动 Chromium、Firefox 和 WebKit，而代理是创建浏览器或上下文的一部分。这让在一个脚本中运行多个地址变得容易，也正是它唯一硬性限制所在之处：带密码的 SOCKS5。

Python 中的 Playwright 代理

Python 示例为整个浏览器设置代理并启动 Chromium；按上下文的示例则把代理限定在一个上下文中。切换引擎只需把 chromium 改为 firefox 或 webkit，proxy 对象保持不变。

Playwright 代理身份验证

当代理使用 HTTP 时，三个引擎都会用 proxy 对象中的用户名和密码应答代理的 407。SOCKS5 代理则得不到任何引擎的这种应答，所以 SOCKS5 示例不带凭据，而是依赖白名单。

按页面设置 Playwright 代理，以及 bypass

代理无法附加到单个页面上。单位是上下文：为每个地址创建一个上下文，并在其中打开应当共用该地址的页面。在 Playwright 中创建上下文的开销很小，所以一个从三个国家检查同一家网店的脚本会持有三个上下文，每个都基于各自的订单。

proxy 对象还接受一个 bypass 字段，即一个以逗号分隔、应当直接访问的主机列表。可以把它用于您自己的内部服务或本地测试服务器，这样只有发往外部世界的流量才会通过您付费的地址发出。

分步说明

在 Playwright 中设置代理

复制主机、端口、用户名和密码
来自控制台的“我的代理”或 API 中的订单。每个地址都有自己的四个值。
选择作用范围
在 launch 时设置，整个浏览器都使用该代理。在 new_context 上设置，只有该上下文使用，因此一个脚本可以让多个上下文通过不同的地址运行。
传入 proxy 对象
{"server": "http://HOST:PORT", "username": "USERNAME", "password": "PASSWORD"}。凭据放在各自的字段中，绝不要写在 server URL 里。
要用 SOCKS5？去掉凭据
Playwright 无法登录 SOCKS5 代理，因此请把订单切换为 SOCKS5，用代码标签页中的白名单调用放行您机器的 IP，并只保留使用新端口的 socks5://HOST:PORT。设置白名单期间，代理只接受列表中的地址，该订单的用户名和密码将不再起作用；发送一个空列表即可关闭白名单，密码登录随即恢复。
确认出口地址
在正式运行之前，在该浏览器或上下文的一个页面中打开一次“我的 IP 是什么”。

# pip install playwright && playwright install chromium
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://HOST:PORT",
        "username": "USERNAME",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    page.goto("https://example.com/")
    print(page.title())
    browser.close()

// npm i playwright && npx playwright install chromium
const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch({
    proxy: {
      server: 'http://HOST:PORT',
      username: 'USERNAME',
      password: 'PASSWORD',
    },
  });
  const page = await browser.newPage();
  await page.goto('https://example.com/');
  console.log(await page.title());
  await browser.close();
})();

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    # The proxy belongs to this context only; another context can use
    # a different address, or none.
    context = browser.new_context(proxy={
        "server": "http://HOST:PORT",
        "username": "USERNAME",
        "password": "PASSWORD",
    })
    page = context.new_page()
    page.goto("https://example.com/")
    print(page.title())
    browser.close()

# Switch the proxy to SOCKS5 and put your machine's IP on its whitelist:
# Chromium cannot send a SOCKS5 username and password.
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={"server": "socks5://HOST:PORT"})
    page = browser.new_page()
    page.goto("https://example.com/")
    print(page.title())
    browser.close()

# Put the public IPv4 address your code runs from on the proxy's
# whitelist. Replaces the list; an empty list turns whitelisting off
# and the proxy falls back to username and password.
curl -X PUT "https://api.proxyjam.com/public/v1/orders/ORDER_ID/whitelist" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"whitelisted_ips": ["YOUR_IP"]}'

代码