跳到正文

从 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()

逐项对照选项

CamoufoxClearcote
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=TruePlaywright 的 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 版构建。

测一测

365 项检查,免费,在你自己的浏览器上

这是每个 Clearcote 构建都要接受的指纹检测。在你现在用的浏览器上运行一下,对比看看。

运行检测
读一读

开源版构建的补丁全部公开

免费的开源版构建采用 BSD-3,可从源码复现,无需账号。Pro 版构建在此之上加入了私有补丁。

在 GitHub 上打开
看它发布

63 次引擎发布,9 个 Chromium 主版本

每个补丁都会带到每个新的 Chromium 版本。最新构建在新主版本发布当天跟进。

查看发布

更新于 2026年10月20日 · SDK 0.70.5 · 浏览器 r63

这个页面有帮助吗?