CloakBrowser

在自动化爬虫和 AI 智能体领域，最大的痛点莫过于反机器人检测。传统的“隐身”方案（如 playwright-stealth、undetected-chromedriver）大多依赖 JavaScript 注入或配置补丁，不仅容易被识破，而且随着 Chrome 更新频繁失效。

CloakBrowser 带来了革命性的解决方案：它不是一个配置插件，而是一个在 C++ 源代码层面经过深度修改的 Chromium 二进制文件。

对于反机器人系统而言，CloakBrowser 就是一个真实的普通浏览器。因为它本质上就是——只是去除了所有自动化的“指纹”，并加上了拟人化的行为特征。

核心突破：为什么它能通过所有检测？

三大杀手锏

1. 33 个 C++ 源码补丁：直接在浏览器内核中修改了 Canvas、WebGL、Audio、字体、GPU、屏幕属性等底层指纹。没有 JS 注入的痕迹，检测脚本看到的都是“原生”数据。
2. humanize=True 拟人化引擎：只需一个标志，即可让鼠标轨迹（贝塞尔曲线）、键盘输入（逐字符延迟）、滚动行为完全模仿真人。甚至能欺骗基于行为分析的检测模型。
3. CDP 输入行为模仿：即使通过 CDP (Chrome DevTools Protocol) 发送指令，生成的底层事件信号也与真实物理设备操作无异，彻底消除 isAutomatedWithCDP 标记。

极速上手：3 行代码，30 秒解封

CloakBrowser 完美兼容 Playwright 和 Puppeteer API。你不需要学习新语法，只需替换导入语句。

🐍 Python 示例

# 传统方式 (容易被封)
# from playwright.sync_api import sync_playwright

# CloakBrowser 方式 (隐形)
from cloakbrowser import launch

# 启动隐形浏览器 (自动下载 ~200MB 二进制文件)
browser = launch(humanize=True) 
page = browser.new_page()

# 访问高防站点 (Cloudflare, reCAPTCHA 等)
page.goto("https://protected-site.com") 

# 此时 reCAPTCHA v3 分数约为 0.9，被视为真实人类
print(page.title())

browser.close()

🟨 JavaScript (Playwright/Puppeteer) 示例

import { launch } from 'cloakbrowser';

const browser = await launch({ humanize: true });
const page = await browser.newPage();

await page.goto('https://protected-site.com');
// 自动通过 Cloudflare Turnstile 验证

await browser.close();

🛠️ 安装与部署

支持 Python 和 Node.js，二进制文件自动管理，零配置。

Python:

pip install cloakbrowser
# 可选：安装地理定位支持 (根据代理 IP 自动设定时区/区域)
pip install cloakbrowser[geoip]

Node.js:

npm install cloakbrowser playwright-core
# 或用于 Puppeteer
npm install cloakbrowser puppeteer-core

Docker 一键测试:

docker run --rm cloakhq/cloakbrowser cloaktest

实测战绩：30/30 项检测通过

基于 Chromium 145 (v0.3.17) 的最新测试结果（2026 年 3 月）：

高级功能：浏览器配置文件管理器

除了 SDK，CloakBrowser 还提供了一个自托管的 Profile Manager（类似 Multilogin/GoLogin 的开源替代品）：

• 唯一指纹：为每个配置文件生成独立的硬件指纹。
• 持久会话：保存 Cookie 和 LocalStorage，绕过无痕检测。
• noVNC 远程交互：直接在浏览器中查看和操作隐形浏览器实例。

docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager
# 访问 http://localhost:8080 管理配置文件

为什么 AI 智能体需要它？

对于 LangChain, Crawl4AI, Browser-use, Stagehand 等 AI 智能体框架：

• 稳定性：不再因为网站突然弹出验证码而导致任务中断。
• 真实性：AI 生成的操作（鼠标移动、点击）配合 humanize=True，在服务器看来就是真实用户在浏览。
• 无缝集成：无需修改智能体的核心逻辑，直接替换浏览器启动器即可。

注意事项

• 代理自备：CloakBrowser 专注于浏览器指纹隐身，不提供代理服务。请配合高质量住宅代理使用以达到最佳效果。
• 验证码解决：它的目标是防止验证码出现（通过高信任分），而不是自动解决复杂的图像验证码。如果遇到必须人工介入的验证码，仍需结合其他服务。
• 开源免费：MIT 协议，无订阅费，无用量限制。