C++ 源码级修改的隐身 Chromium，通过所有主流反爬检测，Playwright/Puppeteer 直接替换，3 行代码解除封锁。
概述
CloakBrowser 是 CloakHQ 开发的隐身浏览器，当前版本 v0.3.28（Chromium 146.0.7680.177.4）。
核心差异：不是 JS 注入，不是配置 patch，而是在 C++ 源码层面修改 Chromium 指纹，编译进二进制。反爬系统看到的是真实浏览器，因为它本身就是真实浏览器。
检测通过率（2026年4月，Chromium 146 实测）
| 检测服务 | 标准 Playwright | CloakBrowser |
|---|---|---|
| reCAPTCHA v3 | 0.1（bot） | 0.9（human） |
| Cloudflare Turnstile（非交互） | FAIL | PASS |
| Cloudflare Turnstile（managed） | FAIL | PASS |
| FingerprintJS bot detection | DETECTED | PASS |
| BrowserScan bot detection | DETECTED | NORMAL (4/4) |
navigator.webdriver | true | false |
| CDP 检测 | Detected | Not detected |
| TLS 指纹 | 不匹配 | 与 Chrome 完全一致 |
通过 30+ 检测站点测试。
安装
# Python
pip install cloakbrowser
# JavaScript / Node.js（Playwright）
npm install cloakbrowser playwright-core
# JavaScript / Node.js（Puppeteer）
npm install cloakbrowser puppeteer-core
# Docker 快速测试
docker run --rm cloakhq/cloakbrowser cloaktest首次运行自动下载隐身 Chromium 二进制（~200MB，本地缓存）。
使用方式
Python（Playwright 替换）：
from cloakbrowser import launch
browser = launch()
page = browser.new_page()
page.goto("https://protected-site.com")
browser.close()JavaScript（Playwright）：
import { launch } from 'cloakbrowser';
const browser = await launch();
const page = await browser.newPage();
await page.goto('https://protected-site.com');
await browser.close();从 Playwright 迁移：
- from playwright.sync_api import sync_playwright
- pw = sync_playwright().start()
- browser = pw.chromium.launch()
+ from cloakbrowser import launch
+ browser = launch()核心特性
- 57 个 C++ 源码 patch：canvas、WebGL、audio、fonts、GPU、screen、WebRTC、network timing、CDP input behavior、WebAuthn、AAC audio、window position 等
humanize=True：人类鼠标曲线、键盘时序、滚动模式，一个参数通过行为检测- WebRTC IP 欺骗：
--fingerprint-webrtc-ip=auto自动解析代理出口 IP - 代理信号清除：DNS/connect/SSL 时序归零，代理缓存头剥离
- 持久化 Profile：
launch_persistent_context()跨会话保持 cookies 和 localStorage - 自动更新：后台检查更新，始终使用最新隐身构建
Browser Profile Manager
自托管的 Multilogin/GoLogin/AdsPower 替代品：
docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager访问 http://localhost:8080，创建 Profile，点击 Launch。
适用场景
- AI Agent 的 Web 自动化（browser-use、Crawl4AI、Scrapling、Stagehand、LangChain）
- 数据采集（绕过 Cloudflare、FingerprintJS 等反爬）
- 多账号管理（Browser Profile Manager）
- 自动化测试（需要真实浏览器行为）
注意：CloakBrowser 不解决 CAPTCHA，而是防止 CAPTCHA 出现。不内置代理轮换，需自带代理。
相关链接
- GitHub: https://github.com/CloakHQ/CloakBrowser
- Browser Manager: https://github.com/CloakHQ/CloakBrowser-Manager
- 本地克隆:
/Users/zhaoweiguo/6ai/opensources/CloakBrowser
关联页面
- daily-stock-analysis — 股票分析系统，可用 CloakBrowser 采集数据
- agent-harness-anatomy — Agent Harness 中的 Web 工具组件