Playwright 启用无痕模式的正确方式是调用 browser.new_context() 创建独立上下文,而非在 launch() 中添加 --incognito 参数(该参数无效);每个新上下文默认隔离 Cookie、缓存、localStorage 等,等效于无痕会话,且需显式关闭以防止指纹累积。

Playwright 启动浏览器时如何启用无痕模式
Playwright 本身没有“无痕模式”这个开关,chromium.launch() 或 firefox.launch() 的 args 里加 --incognito 也**不会生效**——这是常见误解。真正起作用的是用 browser.new_context() 创建一个干净、隔离的上下文,它默认不共享 Cookie、缓存、扩展或本地存储,等效于无痕会话。
关键点:不是启动浏览器时加参数,而是每次新建上下文才获得“无痕”效果。
-
browser.new_context()是必须调用的步骤,直接page = browser.new_page()会复用默认上下文(可能残留状态) - 若需更彻底隔离,可配合
user_agent、viewport、locale等参数重置环境,避免指纹固化 - 不要在同一个
context中反复goto不同站点——这会累积 localStorage 和 canvas 指纹痕迹
为什么 new_context() 比 --incognito 更可靠
Chromium 的 --incognito 参数在 Playwright 中被忽略,是因为 Playwright 启动的是 headless 或 headed 的“专用实例”,而非复用用户 Chrome 安装。即使传入该参数,底层仍走 Playwright 自管的 Profile 路径,不触发传统无痕逻辑。
而 new_context() 是 Playwright 原生支持的沙箱机制:每个 context 有独立的网络栈、存储区和 JS 执行环境,且生命周期可控。关闭 context 即销毁全部痕迹,比依赖浏览器参数更确定。
立即学习“Python免费学习笔记(深入)”;
- 实测:两次
new_context()后分别访问https://amiunique.org,Canvas/Webrtc/WebGL 指纹值基本一致(因硬件/系统层无法掩盖),但navigator.plugins、localStorage、cookieStore完全隔离 - 若需进一步降低指纹相似度,可在创建 context 时传入
user_agent="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36"等通用 UA,避免暴露真实系统 - 注意:Firefox 的
new_context()默认启用隐私模式(类似无痕),Chromium/WebKit 则完全依赖 context 隔离
防止指纹泄露的关键配置项
仅靠 new_context() 不足以对抗高级指纹识别,还需主动抑制易暴露的 API 行为。Playwright 允许通过 page.add_init_script() 注入脚本覆盖敏感属性,或用 page.route() 拦截特征请求。
- 禁用 WebRTC IP 泄露:
page.add_init_script("Object.defineProperty(navigator, 'mediaDevices', {get: () => ({enumerateDevices: () => Promise.resolve([])})});") - 模糊 Canvas 指纹:注入 canvas 替换脚本(如 puppeteer-extra-plugin-stealth 的逻辑可移植),但需注意可能影响功能
- 禁用 WebGL:
args=["--disable-webgl", "--disable-gpu"]传给chromium.launch(),但会丢失部分渲染能力 - 避免使用
page.evaluate()读取navigator.plugins、navigator.permissions等高熵字段——脚本里调用它们本身就会触发探测
常见错误:误以为 launch 时设参数就万事大吉
很多用户在 chromium.launch(args=["--incognito"]) 后直接 browser.new_page(),结果发现多个页面间 Cookie 仍在共享,或 localStorage 没清空——这是因为 new_page() 默认复用浏览器的默认 context,而该 context 并未重置。
更隐蔽的问题是:用 browser.new_context() 创建了上下文,但没显式 context.close(),导致后续测试中 context 复用,指纹逐步“污染”。Playwright 不自动回收 context,这点和 Puppeteer 不同。
- 务必用
with browser.new_context() as context:或手动context.close(),尤其在循环或并发场景下 - 不要全局复用一个
context处理不同任务;每个任务应有自己的context实例 - 调试时用
context.tracing.start()查看是否真隔离:两个 context 的 trace 文件中,network requests 和 storage events 应完全不重叠


















