CloakHQ/CloakBrowser

CloakBrowser – Playwright / Puppeteer 用的隐身 Chromium

是什么

• 一个在 C++ 源码级别应用了 87 个补丁的定制构建 Chromium 二进制文件。目标是让浏览器在反机器人服务眼中看起来完全像一个普通的非无头 Chrome。
• 二进制文件被封装在 Python、JavaScript/Node 和 .NET 的轻量级库中，暴露与 Playwright（及 Puppeteer）相同的 API。你可以直接使用 import { launch } from 'cloakbrowser'（或 from cloakbrowser import launch），无需修改现有自动化代码。

对 AI 代理 / 自动化的重要性

• 许多现代 AI 代理（LangChain、Crawl4AI 等）依赖浏览器获取动态页面。这些代理经常被 reCAPTCHA、Cloudflare Turnstile、FingerprintJS 等服务拦截。CloakBrowser 通过防止挑战出现，消除了对独立 CAPTCHA 求解服务的需求。
• 由于隐身功能已内置于二进制文件中，它能抵御 Chrome 更新；你无需反复应用基于 JavaScript 的“隐身插件”。

主要功能（如 README 所述）

功能	详情
源码级隐身	87 个 C++ 补丁，覆盖 canvas、WebGL、音频、字体、GPU、屏幕尺寸、WebRTC、网络延迟、自动化标志、CDP 输入行为等
人性化模式	humanize=True 使鼠标移动、输入和滚动遵循现实的贝塞尔曲线和时间间隔
高 reCAPTCHA v3 分数	最新版本报告为 0.9（人类水平）
通过 Cloudflare Turnstile、FingerprintJS、BrowserScan 检测	在 30 多个检测站点上测试通过
自动下载正确二进制文件	pip install cloakbrowser / npm install cloakbrowser 会拉取合适的 Chromium 构建（免费或 Pro）并本地缓存
代理与地理 IP 支持	支持 HTTP 或 SOCKS5 代理；geoip=True 可同步时区/区域设置，并伪造 WebRTC ICE 候选者以匹配代理出口 IP
跨语言封装	Python、Node（Playwright 与 Puppeteer）、.NET（NuGet 包）
Docker 就绪	docker run --rm cloakhq/cloakbrowser cloaktest 可运行快速自检；二进制文件在容器中可无头运行
持久化配置文件与扩展	launch_persistent_context() 可保持 cookies/localStorage；extension_paths 支持加载 Chrome 扩展
CloakBrowser Manager（GUI）	独立开源 GUI（MIT 许可证），可创建无限数量的隔离配置文件，每个配置文件拥有独立指纹、代理和 CDP 端点

典型用法（Python）

from cloakbrowser import launch

browser = launch(
    proxy="http://user:pass@residential-proxy:8080",
    geoip=True,
    headless=False,
    humanize=True,
)
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()

典型用法（Node – Playwright）

import { launch } from 'cloakbrowser';

const browser = await launch({
  proxy: 'http://user:pass@residential-proxy:8080',
  geoip: true,
  headless: false,
  humanize: true,
});
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

安装

• Python: pip install cloakbrowser
• Node: npm install cloakbrowser playwright-core（Puppeteer 用为 ... puppeteer-core）
• .NET: dotnet add package CloakBrowser
• 首次运行时会自动下载合适的 Chromium 二进制文件（约 200 MiB）并使用 Ed25519 签名验证。

许可与定价

• 仓库采用 MIT 许可证；二进制文件采用独立许可证分发。
• 免费密钥（GitHub 登录）提供一个并发会话，使用最新构建版本。
• CloakBrowser Pro 提供无限并发会话、优先更新和官方支持。密钥可通过 CLOAKBROWSER_LICENSE_KEY 环境变量或 license_key 参数设置。

内部工作原理

1. 二进制构建 – 团队 fork Chromium，应用 87 个补丁，为每个平台构建二进制文件，对归档文件签名并托管。
2. 封装层 – Python/JS/.NET 包是轻量级代理，下载二进制文件，通过 Playwright/Puppeteer 启动，并注入少量启动参数（如 --fingerprint-webrtc-ip=auto）。
3. 验证机制 – 下载内容通过公开的 Ed25519 校验和进行比对，防止篡改。

可能需要它的情况

• 抓取对无头浏览器进行严格检测的网站。
• 运行需要浏览但无需人工干预且必须隐蔽的 AI 代理。
• QA 或监控流水线，必须像真实用户一样渲染页面。
• 当前依赖脆弱“隐身插件”解决方案的任何自动化任务。

局限性

• CloakBrowser 无法解决已出现的 CAPTCHA；其目标是防止它们出现。
• 为获得最高成功率，仍需自行提供住宅代理。
• 免费版仅限单个并发会话；大规模使用需 Pro 许可证。

---

以上所有信息均直接来自项目 README；未推断任何额外功能。