# CloakBrowser - C++源码级补丁的隐身Chromium，30/30反检测测试通过

> Playwright/Puppeteer无痛替换，49处C++源码级指纹补丁，reCAPTCHA v3得分0.9，Cloudflare自动通过

## 核心特性

- **49 处 C++ 源码级指纹补丁** — canvas、WebGL、音频、字体、GPU、屏幕、WebRTC、网络时序、自动化信号、CDP 输入行为等，全部在 Chromium 二进制层面修改，非 JS 注入、非配置级 hack
- **Drop-in Playwright/Puppeteer 替换** — Python / JavaScript 双端支持，3 行代码即可迁移，API 完全兼容
- **`humanize=True`** — 一键启用人类级鼠标轨迹、键盘时序、滚动模式，行为检测自动通过
- **reCAPTCHA v3 得分 0.9** — 服务器端验证的人类级分数
- **Cloudflare Turnstile 自动通过** — 非交互式自动解决，托管式单次点击通过
- **30+ 反检测站点全通过** — FingerprintJS、BrowserScan、ShieldSquare 等
- **零配置开箱即用** — 首次启动自动下载 stealth Chromium 二进制（~200MB，本地缓存）
- **SOCKS5/HTTP 代理原生支持** — 含 WebRTC IP 伪装、时区/语言自动从代理 IP 检测

## 安装

**Python:**
```bash
pip install cloakbrowser
```

**JavaScript / Node.js:**
```bash
npm install cloakbrowser
```

## 快速开始

```python
from cloakbrowser import launch

browser = launch()
page = browser.new_page()
page.goto("https://protected-site.com")  # 不再被拦截
browser.close()
```

## 横向对比

| 特性 | Playwright | playwright-stealth | undetected-chromedriver | Camoufox | **CloakBrowser** |
|---|---|---|---|---|---|
| reCAPTCHA v3 得分 | 0.1 | 0.3-0.5 | 0.3-0.7 | 0.7-0.9 | **0.9** |
| Cloudflare Turnstile | 失败 | 偶尔通过 | 偶尔通过 | 通过 | **通过** |
| 补丁层级 | 无 | JS 注入 | 配置补丁 | C++ (Firefox) | **C++ (Chromium)** |
| Chrome 更新存活 | — | 经常失效 | 经常失效 | 是 | **是** |
| Playwright API | 原生 | 原生 | 否 (Selenium) | 否 | **原生** |

## Browser Profile Manager

自托管的多账户浏览器管理方案，替代 Multilogin / GoLogin / AdsPower：
```bash
docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager
```

→ 详见 [CloakBrowser-Manager](https://github.com/CloakHQ/CloakBrowser-Manager)

## 适用场景

- 网页自动化与爬虫开发
- 反检测浏览器指纹研究
- AI Agent 浏览器工具集成（browser-use、Crawl4AI、Scrapling、Stagehand、LangChain 等）
- 多账户管理与会话持久化

---

**分类**：源码
**标签**：自动 · C++ · 补丁
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1656