从指纹浏览器应用迁移
适用于通过代码自动化 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 加载到新文件夹:
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
打过补丁的驱动
例如 undetected-chromedriver、nodriver
其他 Chromium 分支
免费版与付费版构建
Clearcote Pro
r63,Chromium 158
公开的补丁数,截至 2026年10月。区间涵盖其他分支的免费版与付费版构建;Clearcote 的数字来自 Pro 版构建。