启动级代理#
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()import { chromium } from "playwright";
const browser = await chromium.launch({
proxy: { server: "http://res.proxshift.com:9000", username: "USER-cc-us-sid-run1-ttl-30m", password: "PASS" },
});
const page = await browser.newPage();
await page.goto("https://api.ipify.org");
console.log(await page.innerText("body"));
await browser.close();浏览器会保持连接,因此启动时应使用粘性会话 ID:在你选择的有效期内,整个浏览器都会表现为来自同一家庭住宅的同一位访问者。
按上下文配置代理#
若要在同一浏览器中运行多个国家/地区或会话,请先使用占位代理启动,再为每个上下文分别指定代理。Chromium 必须设置启动级代理,按上下文代理才会生效。
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"})const browser = await chromium.launch({ proxy: { server: "http://per-context" } });
const de = await browser.newContext({ proxy: { server: "http://res.proxshift.com:9000", username: "USER-cc-de-city-berlin-sid-de1-ttl-30m", password: "PASS" } });
const us = await browser.newContext({ 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 本身。
节省流量:屏蔽不需要的资源#
def block(route):
if route.request.resource_type in {"image", "media", "font", "stylesheet"}:
return route.abort()
return route.continue_()
page.route("**/*", block)await page.route("**/*", (route) => {
const t = route.request().resourceType();
return ["image", "media", "font", "stylesheet"].includes(t) ? route.abort() : route.continue();
});完整渲染的页面大小可达 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.proxshift.com:9001。