集成 · 中级

在 Playwright 中使用代理:每个浏览器或上下文使用独立出口

Playwright 可在启动时或按浏览器上下文接收代理和凭据,因此无需重启浏览器,每个上下文就能在各自的国家/地区使用独立的粘性会话。

阅读约需 3 分钟 5 个章节 审核日期 编辑团队 Proxy Cyber

启动级代理#

Python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://res.proxy-cyber.com:9000",
        "username": "USER-cc-us-sid-run1-ttl-30m",
        "password": "PASS",
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org")
    print(page.inner_text("body"))
    browser.close()

如果交付的网关支持会话标识,请为每个独立流程使用不同标识。允许的持续时间和地区参数应以连接信息为准。住宅设备可能提前离线,因此持续会话不保证数日使用同一 IP。需要固定地址时,应比较独享静态产品。

按上下文配置代理#

若要在同一浏览器中运行多个国家/地区或会话,请先使用占位代理启动,再为每个上下文分别指定代理。Chromium 必须设置启动级代理,按上下文代理才会生效。

Python
browser = p.chromium.launch(proxy={"server": "http://per-context"})

de = browser.new_context(proxy={"server": "http://res.proxy-cyber.com:9000", "username": "USER-cc-de-city-berlin-sid-de1-ttl-30m", "password": "PASS"})
us = browser.new_context(proxy={"server": "http://res.proxy-cyber.com:9000", "username": "USER-cc-us-state-tx-sid-us1-ttl-30m", "password": "PASS"})

让上下文与出口保持一致#

为每个上下文设置出口所在国家/地区的区域设置和时区,确保 IP、语言与时钟一致。例如,柏林上下文应使用 locale=\"de-DE\", timezone_id=\"Europe/Berlin\"。这些信息不一致时,暴露自动化行为的风险甚至高于 IP 本身。

节省流量:屏蔽不需要的资源#

Python
def block(route):
    if route.request.resource_type in {"image", "media", "font", "stylesheet"}:
        return route.abort()
    return route.continue_()

page.route("**/*", block)

完整渲染的页面大小可达 3 至 5 MB,而其 HTML 和 API 调用通常只有几百 KB。在按 GB 计费的网络上,仅这一条规则就能减少 80% 至 90% 的费用。

验证与故障排查#

  • 先打开 IP 回显服务检查国家/地区,再使用地理位置查询服务核对城市。
  • 启动时出现 net::ERR_TUNNEL_CONNECTION_FAILED 或 ERR_PROXY_CONNECTION_FAILED,表示凭据或某个参数有误;使用 cURL 测试同一个 URL,以读取网关状态码。
  • 只有主动屏蔽 WebRTC,Playwright 上下文才不会使用它。若隐私很重要,请添加类似 --disable-webrtc 的加固参数或屏蔽 STUN。

大家常问的问题#

每个标签页都可以使用不同的代理吗?

每个上下文可以使用不同代理;同一上下文内的标签页(页面)共享其代理。请为每个会话或国家/地区创建一个上下文。

Playwright 支持需要身份验证的 SOCKS5 代理吗?

Chromium 不接受 SOCKS5 凭据;请通过用户名和密码使用 9000 端口的 HTTP 代理,或将服务器 IP 加入白名单,再使用无需凭据的 socks5://res.proxy-cyber.com:9001。

您的账户

在一个账户中管理代理服务

在同一控制台比较网络、下单并查看余额与支持请求。团队人工核验付款,交付后提供连接信息。

创建账户