集成 · 中级

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

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

阅读约需 3 分钟 5 个章节 更新于 发布于

启动级代理#

Python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://res.proxshift.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()

浏览器会保持连接,因此启动时应使用粘性会话 ID:在你选择的有效期内,整个浏览器都会表现为来自同一家庭住宅的同一位访问者。

按上下文配置代理#

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

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

de = browser.new_context(proxy={"server": "http://res.proxshift.com:9000", "username": "USER-cc-de-city-berlin-sid-de1-ttl-30m", "password": "PASS"})
us = browser.new_context(proxy={"server": "http://res.proxshift.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_FAILEDERR_PROXY_CONNECTION_FAILED,表示凭据或某个参数有误;使用 cURL 测试同一个 URL,以读取网关状态码。
  • 只有主动屏蔽 WebRTC,Playwright 上下文才不会使用它。若隐私很重要,请添加类似 --disable-webrtc 的加固参数或屏蔽 STUN。

大家常问的问题#

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

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

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

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

准备好即可开始

立即投入实际使用。

创建账户,充值 $20,然后将本指南中的端点粘贴到您的工具中。您购买的流量永不过期。