跳到正文

从指纹浏览器应用迁移

适用于通过代码自动化 Multilogin、GoLogin、AdsPower、Dolphin Anty 或 Kameleo profile 的团队。使用 Clearcote 时,由脚本自己启动浏览器:无需一直运行桌面应用,也无需先调用本地 API。

改动

import requests
from playwright.sync_api import sync_playwright
from clearcote import launch_persistent_context

ws = requests.get("http://local.adspower.net:50325/api/v1/browser/start",
                  params={"user_id": "k1abc23"}).json()["data"]["ws"]["puppeteer"]
browser = sync_playwright().start().chromium.connect_over_cdp(ws)
page = browser.contexts[0].new_page()
context = launch_persistent_context(
    "profiles/acct-1",                       # cookies and storage live here
    fingerprint="acct-1",                    # the device: same seed, same device
    platform="windows",
    proxy={"server": "http://proxy.example:8080", "username": "user", "password": "pass"},
    geoip=True,                              # timezone, language and WebRTC follow the exit IP
)
page = context.new_page()
page.goto("https://example.com")

这里展示的是 AdsPower 的启动调用;每个应用都有自己的调用(Multilogin X:GET https://launcher.mlx.yt:45001/api/v2/profile/f/<folder>/p/<id>/start),而整个调用都可以删掉。如果你的其他工具需要像应用那样拿到一个 CDP 地址,serve(fingerprint="acct-1", user_data_dir="profiles/acct-1") 会启动同一个浏览器,并在 srv.cdp_url 提供端点;参见部署与 Docker。

一个 profile 变成一个种子和一个文件夹

应用的 profile 中Clearcote 中
指纹(操作系统、屏幕、GPU、字体、canvas)一个 fingerprint 种子(seed)和一个 platform。同一个种子每次都得到同一台设备
Cookie、存储、登录状态一个 profile 文件夹:launch_persistent_context("profiles/acct-1", ...)
代理及其位置proxy= 加上 geoip=True
传给本地 API 的 profile ID你自己起的名字。把它同时用作种子和文件夹名,二者就能对应起来

把 Cookie 带过来

最后一次通过应用的 API 启动旧 profile,保存它的存储,然后把 Cookie 加载到新文件夹:

python
import json
from playwright.sync_api import sync_playwright
from clearcote import launch_persistent_context

# 1. from the running app profile (ws = the address its start call returned)
with sync_playwright() as p:
    old = p.chromium.connect_over_cdp(ws)
    old.contexts[0].storage_state(path="acct-1.json")

# 2. into the Clearcote profile, once
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1")
context.add_cookies(json.load(open("acct-1.json"))["cookies"])
context.close()

对于托管浏览器,clearcote cloud profile sync acct-1 --from-cdp <address> --domain example.com 会把 Cookie 直接从正在运行的 profile 复制到云端 profile。参见Profile 与密钥。

指纹不会迁移过来:新种子就是一台新设备,所以网站会看到一次设备变更,就像换了一台新笔记本。此后请一直保留这个种子;对新设备反应敏感的账号,每次只迁移几个。

日常使用有哪些变化

  • 可在服务器上运行。无需图形会话、无需登录应用、无需本地 API 端口。Linux、Windows 和 Docker 镜像都能以无头模式运行。
  • 不按 profile 收费。种子和 profile 文件夹都是免费的;许可证按同时运行的浏览器数量计算。参见价格。
  • 可以阅读源码的引擎。开源版构建采用 BSD-3 许可,其中每个补丁都是公开的。
  • 还是想要一个窗口?Profile Manager 应用可以把一个身份作为普通浏览器窗口打开,供手动操作。

检查迁移结果

clearcote info 会打印 SDK 解析到的构建以及一次启动测试的结果。带用户名和密码的代理需要最新构建,用 GitHub 登录即可免费获取(clearcote login)。下一步:Profile 与持久化。对比:Multilogin、GoLogin、AdsPower、Dolphin Anty 和 Kameleo。

改得有多深

补丁数是我们比较过的任何分支的两倍以上。

按方案统计编译进 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

这个页面有帮助吗?