CloakBrowser
在C++源码层修改Chromium指纹,兼容Playwright/Puppeteer,零门槛让AI爬
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
在C++源码层修改Chromium指纹,兼容Playwright/Puppeteer,零门槛让AI爬
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象一下:你派出的 AI 爬虫程序刚刚抵达某个网站大门,门禁系统立刻警觉——「检测到机器人访问」,然后无情地把门关上。这不是程序出了 bug,而是现代网站的标配防御:指纹识别。如今 Cloudflare、DataDome 等反爬系统已经能通过浏览器的 canvas 渲染、WebGL 显卡指纹、音频哈希、鼠标轨迹甚至 DNS 解析时间,精准识别出自动化工具的「机器味道」。
CloakBrowser 就是来解决这个问题的。它不是给浏览器戴个面具(JavaScript 注入方案),而是从根本上把浏览器的「生物特征」改掉——在 C++ 源代码层直接修改 Chromium,让它生成的每一个指纹都和真实用户的浏览器一模一样。截至 2026 年,它在 30 个主流反爬测试网站上全部通过,包括 Cloudflare Turnstile、reCAPTCHA v3(得分 0.9)、FingerprintJS 和 BrowserScan。
传统的反检测方案(例如 playwright-stealth、undetected-chromedriver)采用 JavaScript 注入或浏览器配置修改的方式——每次 Chrome 更新,这些补丁就会失效,因为反爬系统专门检测这些已知的补丁特征。
CloakBrowser 的思路完全不同:它直接 fork Chromium 源码,在 C++ 层打入了 58 个补丁,覆盖以下维度:
这意味着:CloakBrowser 不是「假装」成真浏览器,它本质上就是一个真浏览器——只是把「机器人特征」全部抹去了。
开发者最关心的其实是:迁移成本有多高?
CloakBrowser 提供了 Python 和 JavaScript 两套 SDK,均为 Playwright / Puppeteer 的直接替代品。以 Python 为例,只需改 3 行导入代码:
# 原来的 Playwright 代码
from playwright.sync_api import sync_playwright
pw = sync_playwright().start()
browser = pw.chromium.launch()
# 迁移到 CloakBrowser(只改导入)
from cloakbrowser import launch
browser = launch()
page = browser.new_page()
page.goto("https://protected-site.com")
# 后续代码完全不变
JavaScript/TypeScript 同理,直接替换 import 即可。npm 包 cloakbrowser 配合 playwright-core 或 puppeteer-core 使用,依赖体积可控。
首次运行时,工具会自动从 GitHub Releases 下载预编译的隐蔽 Chromium 二进制文件(约 200MB),缓存在本地,后续使用无需重复下载。
光有指纹还不够——反爬系统还会检测行为模式。机器人的鼠标移动是线性的,键盘输入是匀速的,滚动行为是机械的。这些「行为指纹」同样会暴露自动化本质。
CloakBrowser 提供了一个开关——humanize=True,启用后:
这个功能对于 AI Agent 场景尤为关键。如今主流 AI 编程工具(如 browser-use、Crawl4AI、Stagehand、LangChain)都在依赖浏览器自动化执行任务,行为检测正好是这类工具的薄弱环节。开启 humanize 后,即使是 AI 驱动的自动化流程,也能通过行为层面的检测。
CloakBrowser 还提供了 Browser Profile Manager,这是一个 Web 界面,类比于 Multilogin、GoLogin、AdsPower 等商业指纹浏览器,但完全免费开源。
核心能力:
部署方式极为简单,一条 Docker 命令搞定:
docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager
打开 http://localhost:8080 即可使用。
CloakBrowser 对硬件要求极为友好:
部署方式有三种:
docker run --rm cloakhq/cloakbrowser cloaktest,零配置验证是否可用pip install cloakbrowser,自动下载二进制,本地使用npm install cloakbrowser playwright-core,用于 Node.js 项目官方 Dockerfile 基于 python:3.12-slim,集成了 Chromium 所需的全部系统依赖(含 Xvfb 支持无头模式),构建镜像时预下载二进制,运行时开箱即用。
必须诚实说明 CloakBrowser 的局限性:
随着大模型能力的爆发式提升,AI Agent 正在成为 Web 自动化主流范式——让 AI 直接操控浏览器完成复杂任务。但反爬系统的进化速度同样惊人,传统的 JS 注入方案已越来越难以生存。
CloakBrowser 的出现代表了一种更深层的技术路线:在二进制层面改写真浏览器的「灵魂」,而不是在表面涂脂抹粉。它将反爬对抗从「配置层面」提升到了「源代码层面」,这是一个质的跃迁。
对于 AI 开发者而言,CloakBrowser 提供了一个可靠的网络访问通道——让 AI Agent 能够真正触达那些被传统爬虫拒之门外的数据源;对于安全研究者和数据工程师,它是一个绕过反爬限制的合规工具;而对于反爬系统的开发者,它也是一个值得研究的对手。
在 AI 与反爬的军备竞赛中,CloakBrowser 代表了当前开源社区给出的最高水位答案。
本报告基于 GitHub 开源项目 CloakHQ/CloakBrowser(MIT 协议)分析生成,数据截止 2026-05-26。