网站的"火眼金睛"

想象你开着一辆车去商场。商场门口有个保安，他不仅看你的脸，还检查你的车牌号、轮胎花纹、后视镜角度、甚至你握方向盘的姿势。只要任何一项和他数据库里的"可疑清单"匹配，他就拦住你。

网站也在做同样的事——它们检查你的浏览器的浏览器指纹、自动化痕迹、鼠标轨迹，来判断你是一个真人还是一个机器人（Bot）。

CloakBrowser 是什么

CloakBrowser 是一个"隐身浏览器"——它基于 Chromium（Chrome 的内核），但对底层代码做了 57 处修改，让自动化程序看起来完全像一个真人在操作浏览器。

只需三行代码

如果你已经在用 Playwright，换成 CloakBrowser 只需要改一行导入：

from cloakbrowser import launch

browser = await launch(headless=True)
page = await browser.new_page()
await page.goto("https://example.com")
            

启动时发生了什么？

当你写下 launch() 时，背后发生了一场精心编排的"伪装派对"：

检验理解

一场永不停歇的军备竞赛

想象你在玩捉迷藏。藏的人（Bot）每次被发现，都会想出新的藏法；找的人（网站）每次被蒙混过关，都会升级搜索策略。这就是 Bot 检测和反检测之间的军备竞赛。

网站的"安检清单"

网站通过以下方式检测你是不是 Bot。每一项都像一个"检查站"：

C++ 补丁 vs JS 注入

CloakBrowser 的核心创新在于它的修补方式。其他工具在网页层面做伪装，CloakBrowser 在浏览器引擎层面做修改：

// 在网页里插入一段 JS 来骗检测
Object.defineProperty(navigator, 'webdriver', {
  get: () => undefined
});
            

// 直接在 Chromium 源码里改
// third_party/blink/renderer/...
if (IsAutomationEnabled()) {
  return false;  // 永远返回"不是机器人"
}
            

当网站尝试检测时

网站执行一段 JavaScript 来检查你的浏览器。看看 CloakBrowser 是怎么拦截这个检查的：

检验理解

启动就像发射火箭

发射一枚火箭不是按一个按钮就完事了——需要检查燃料、校准轨道、加载载荷、倒计时。CloakBrowser 的启动过程也一样精密：

定制浏览器的下载管理

CloakBrowser 不用普通的 Chrome——它用的是经过 57 处 C++ 修改的定制版 Chromium。这个文件大约 200MB，下载和管理工作全靠 download.py：

def ensure_binary() -> Path:
    if local := os.environ.get("CLOAKBROWSER_BIN"):
        return Path(local)
    cached = _cache_dir() / _binary_name()
    if cached.exists() and _sha256_ok(cached):
        return cached
    return _download_binary(cached)
            

隐身参数是怎么生成的

每次启动时，CloakBrowser 都会生成一套全新的"假身份"。这个身份从哪来？答案是一个随机种子（Seed）：

def get_default_stealth_args() -> list[str]:
    seed = random.randint(10000, 99999)
    args = [
      f"--fingerprint-seed={seed}",
      f"--fingerprint-platform={platform}",
    ]
    return args
            

完整启动流程

从你写下 launch() 到浏览器窗口打开，中间经历了这些步骤：

检验理解

用种子编织一个"虚拟人"

想象你有一个"角色生成器"——输入一个数字（种子），它就能自动生成一个完整的人物档案：身高、体重、发色、声音特征、行走姿态...所有属性都从这一个数字推导出来，而且同一个数字永远生成同一个角色。

CloakBrowser 的种子就是这么工作的。种子 42871 生成的是：

平台伪装：Linux 变 Windows

这是指纹系统最巧妙的部分之一。大多数自动化程序运行在 Linux 服务器上，但普通用户很少用 Linux 浏览网页。所以 CloakBrowser 会把 Linux 伪装成 Windows：

if sys.platform == "darwin":
    platform = "macos"
else:
    platform = "windows"

# macOS 保留真实平台
# Linux/Windows 都伪装成 Windows
            

一致性是关键

伪装最怕的不是某个指纹不对，而是指纹之间互相矛盾。想象一个人说他来自海南，但口音像东北的、身份证号是北京的——矛盾太多了。

CloakBrowser 的种子系统确保所有指纹参数来自同一个"世界"：

检验理解

指纹只是第一关

想象你伪造了一张完美的身份证，通过了门口的安检。但进去之后，你的行为暴露了你——你走路太快、从不眨眼、每次都走完全相同的路线。

高级 Bot 检测不仅检查"你是谁"（指纹），还检查"你怎么动"（行为）。CloakBrowser 的 humanize 模式就是专门应对这类检测的。

三大行为模拟引擎

怎么开启人类行为模拟

只需要在 launch 时加上一个参数：

browser = await launch(
    headless=True,
    humanize=True,
    human_preset="default",
)
            

CloakBrowser 内部会对 Playwright 的鼠标和键盘方法做猴子补丁（Monkey Patch），把原本"机器人式"的操作替换成"人类式"的操作：

贝塞尔曲线：鼠标的"人类弧度"

Bot 的鼠标从 A 点到 B 点走直线（下左）。真人的鼠标走曲线，路径带有自然的弧度和微偏（下右）：

检验理解