从 Camoufox 迁移
Camoufox 和 Clearcote 的工作方式相同:两者都给引擎打补丁,并交给你一个 Playwright 对象。迁移基本上就是改名,从 Firefox 换到 Chromium。
改动
from camoufox.sync_api import Camoufox
from clearcote import launch
with Camoufox(
browser = launch(
headless=True,
os="windows",
platform="windows",
fingerprint="acct-1", # new: one seed per account, the same device every run
geoip=True,
proxy={"server": "http://proxy.example:8080", "username": "user", "password": "pass"},
humanize=True,
) as browser:
page = browser.new_page()
page.goto("https://example.com")
)
page = browser.new_page()
page.goto("https://example.com")
browser.close()逐项对照选项
| Camoufox | Clearcote |
|---|---|
headless="virtual" | headless=True(默认值):无头模式本身就有真实尺寸的屏幕 |
传入系统列表的 os= | platform="windows"、"macos" 或 "linux";每个账号选一个 |
| 每次启动都生成新指纹 | fingerprint="<seed>":同一个种子就是同一台设备,新种子则是一台毫不相关的设备 |
locale="de-DE" | accept_language="de-DE,de",或交给 geoip 自动设置 |
persistent_context=True, user_data_dir=... | launch_persistent_context(user_data_dir, ...) |
addons=[path](Firefox 附加组件) | extensions=[path]:解压后的 Chrome 扩展 |
block_images=True | Playwright 的 page.route,见下文 |
config={...}, firefox_user_prefs | 没有对应项。指纹值来自种子,或来自采集的设备 profile |
python
# instead of block_images=True
page.route("**/*", lambda route: route.abort() if route.request.resource_type == "image" else route.continue_())从 Firefox 到 Chromium
- 你的 Playwright 代码可以原样运行。Locator、
evaluate、路由和等待在两种引擎上都是同一套 API。 - 你会获得 Chromium 独有的能力:
page.pdf()、CDP 会话,以及任何工具都能通过serve()连接的 CDP 端点。 - Profile 无法迁移。Chromium 打不开 Firefox 的 profile。在 Camoufox 中用
context.storage_state(path="state.json")保存 Cookie,再用context.add_cookies(state["cookies"])加载。网站只会看到一次新设备。 - 不只是 Python。Node 和 .NET SDK 中也有同样的
launch(),另外还有 Docker 镜像。
检查迁移结果
clearcote info 会打印 SDK 解析到的构建以及一次启动测试的结果。没有许可证密钥时,这就是开源版构建(BSD-3);带用户名和密码的代理需要最新构建,用 GitHub 登录即可免费获取。下一步:推荐设置。对比:Clearcote vs Camoufox。
改得有多深
补丁数是我们比较过的任何分支的两倍以上。
按方案统计编译进 Chromium 的补丁。基于脚本的工具完全不改动引擎。
隐身插件
例如 puppeteer-extra-plugin-stealth
0
打过补丁的驱动
例如 undetected-chromedriver、nodriver
0
其他 Chromium 分支
免费版与付费版构建
35–87
Clearcote Pro
r63,Chromium 158
266
公开的补丁数,截至 2026年10月。区间涵盖其他分支的免费版与付费版构建;Clearcote 的数字来自 Pro 版构建。