**作者**: Manus AI
**日期**: 2026年5月15日

## 摘要

本报告针对开源爬虫浏览器项目 **Nanobrowser** 进行了深度调研，重点分析了其性能、防风控能力以及开源协议。同时，结合 downly.cn 文章中介绍的 **CloakBrowser**，对两款工具在技术架构、反检测机制、适用场景及授权模式等方面进行了横向对比。Nanobrowser 侧重于构建基于大语言模型（LLM）的浏览器自动化多智能体（Multi-agent）系统，而 CloakBrowser 则专注于在底层 Chromium 源码级别提供极致的隐身和反风控能力。

## 1. Nanobrowser 调研分析

### 1.1 项目概述与定位

Nanobrowser 是一个运行在浏览器中的开源 AI 网页自动化工具，定位为 OpenAI Operator 的免费替代方案 [1]。它以 Chrome 扩展程序的形式存在，允许用户使用自己的 LLM API 密钥（支持 OpenAI、Anthropic、Gemini、Ollama 等）来运行多智能体工作流。

### 1.2 性能表现

Nanobrowser 的性能主要取决于其背后的多智能体架构和所连接的 LLM 模型：
- **多智能体协作**：系统内置了 Planner（规划者）和 Navigator（导航者）等专门的 AI 智能体。Planner 负责高级推理和规划，Navigator 负责具体的网页导航任务。这种分工协作模式提高了复杂任务的执行效率 [1]。
- **模型灵活性**：用户可以为不同的智能体配置不同的模型以平衡性能和成本。例如，官方推荐使用 Claude Sonnet 4 作为 Planner 以获得更好的推理能力，使用 Claude Haiku 3.5 作为 Navigator 以提高导航效率 [1]。
- **本地运行**：作为 Chrome 扩展，其核心逻辑在本地浏览器中运行，减少了云端通信的延迟，同时也支持连接本地模型（如 Ollama）以实现零 API 成本和完全隐私 [1]。

### 1.3 防风控能力

Nanobrowser 的防风控能力相对基础，主要依赖于其作为标准 Chrome 扩展的运行环境：
- **真实浏览器环境**：由于它直接在用户日常使用的 Chrome 或 Edge 浏览器中作为扩展运行，其底层指纹（如 Canvas、WebGL、User-Agent 等）就是用户真实的浏览器指纹，这在一定程度上降低了被识别为无头浏览器（Headless Browser）的风险 [1]。
- **局限性**：Nanobrowser 并没有在底层对 Chromium 进行防检测修改。如果目标网站使用高级的机器人检测技术（如分析鼠标轨迹、按键延迟或检测自动化扩展特征），Nanobrowser 可能会被识别。它更适合用于常规的网页自动化和数据提取，而非对抗强风控的爬虫场景。

### 1.4 开源方式与协议

- **开源协议**：Nanobrowser 采用 **Apache License 2.0** 协议完全开源 [1]。
- **开源方式**：代码托管在 GitHub 上，包含扩展程序的完整源代码。用户可以自由地查看、修改、分发和用于商业用途，只需保留原始版权声明。
- **限制条款**：项目在 README 中明确声明，不支持且不参与任何基于该代码库的加密货币、代币、NFT 或其他区块链相关应用的衍生项目 [1]。

## 2. Nanobrowser 与 CloakBrowser 对比分析

downly.cn 文章中介绍的 **CloakBrowser** 是一款旨在提供高度隐身能力的 Chromium 浏览器项目 [2]。以下是两款工具的深度对比：

### 2.1 技术架构与修改层次

| 特性 | Nanobrowser | CloakBrowser |
| :--- | :--- | :--- |
| **产品形态** | Chrome 浏览器扩展程序 | 深度修改的 Chromium 二进制文件及 Python/JS 封装 |
| **修改层次** | 应用层（扩展注入） | 底层（C++ 源码级编译） |
| **核心驱动** | LLM 多智能体系统（Planner/Navigator） | Playwright / Puppeteer 自动化框架 |
| **部署方式** | 浏览器插件安装 / 源码构建 | Docker 部署 / 二进制文件下载 |

**分析**：Nanobrowser 是建立在现有浏览器之上的“大脑”，通过 AI 驱动操作；而 CloakBrowser 是重构了浏览器“躯体”，使其在自动化操作时看起来像真实人类。

### 2.2 防风控与隐身能力

| 防风控维度 | Nanobrowser | CloakBrowser |
| :--- | :--- | :--- |
| **自动化信号消除** | 依赖真实浏览器环境，无底层修改 | 源码级移除 `navigator.webdriver`，禁用自动化启动参数，模拟 CDP 行为 [2] |
| **指纹伪装** | 使用当前真实浏览器指纹 | 基于种子的确定性指纹噪声化（Canvas, WebGL, Audio, GPU 等） [2] |
| **代理与网络特征** | 依赖浏览器全局代理或扩展代理 | 深度清理代理特征，GeoIP 自动对齐时区和语言，防 WebRTC 泄露 [2] |
| **行为拟人化** | 依赖 AI 生成的操作指令 | 内置 `humanize=True` 参数，模拟真实鼠标轨迹、按键延迟和物理滚动 [2] |
| **检测通过率** | 面对高级检测（如 Cloudflare Turnstile）可能受限 | 宣称通过 reCAPTCHA v3 (0.9分)、Cloudflare Turnstile、FingerprintJS 等 30/30 项测试 [2] [3] |

**分析**：在防风控能力上，**CloakBrowser 具有压倒性优势**。它通过 57 个 C++ 源码级补丁彻底消除了自动化特征，是专门为对抗高级机器人检测而设计的。Nanobrowser 则不具备这种底层的反检测能力。

### 2.3 开源协议与商业模式

| 授权维度 | Nanobrowser | CloakBrowser |
| :--- | :--- | :--- |
| **开源协议** | Apache License 2.0（完全开源） [1] | 混合授权：封装代码 MIT，核心二进制文件闭源/专有协议 [3] [4] |
| **代码可见性** | 100% 源码可见 | 仅 Python/JS 封装层可见，核心 C++ 修改不可见 |
| **使用限制** | 免费商用，禁止用于区块链/加密货币项目 [1] | 免费使用，但**严禁重新分发、转售、逆向工程或修改二进制文件** [4] |
| **云端/CI 使用** | 无限制 | 允许内部 Docker/CI 使用，但禁止作为 SaaS 提供给第三方 [4] |

**分析**：Nanobrowser 是真正的开源项目，赋予开发者极大的自由度。CloakBrowser 采取了“核心闭源、接口开源”的策略，其编译好的 Chromium 二进制文件受到严格的专有协议（Binary License）保护，限制了其被二次打包或商业化分发的可能。

## 3. 总结与建议

**Nanobrowser** 和 **CloakBrowser** 虽然都涉及浏览器自动化，但解决的是完全不同的痛点：

1. **选择 Nanobrowser 如果您需要**：
   - 构建基于 LLM 的智能工作流（如自动总结新闻、智能购物比价）。
   - 一个免费的、本地运行的 OpenAI Operator 替代品。
   - 完全开源的代码库以便进行深度二次开发。
   - 目标网站没有极其严苛的反爬虫机制。

2. **选择 CloakBrowser 如果您需要**：
   - 极高的防风控能力，需要绕过 Cloudflare、reCAPTCHA v3、Kasada 等高级检测。
   - 稳定的、基于 Playwright/Puppeteer 的大规模数据抓取。
   - 确定性的浏览器指纹管理（用于账号矩阵、社交媒体自动化）。
   - 能够接受其核心二进制文件闭源的授权限制。

**综合建议**：如果您关注的重点是**防风控能力**，那么 **CloakBrowser** 是更专业的选择。但如果您希望在完全开源的框架下探索 **AI 驱动的自动化**，**Nanobrowser** 则提供了优秀的平台。在某些高级场景下，甚至可以考虑将两者的优势结合：使用 CloakBrowser 作为底层驱动，结合 LLM 智能体来实现既智能又隐蔽的自动化操作。

## 参考文献

[1] GitHub - nanobrowser/nanobrowser. https://github.com/nanobrowser/nanobrowser
[2] CloakBrowser 技术调研 | Downly. https://www.downly.cn/articles/bba61f3e-4033-4ebd-8ab7-71e45cd8e42b
[3] GitHub - CloakHQ/CloakBrowser. https://github.com/CloakHQ/CloakBrowser
[4] CloakBrowser Binary License. https://github.com/CloakHQ/CloakBrowser/blob/main/BINARY-LICENSE.md


Nanobrowser AI 浏览器调研分析

# CloakBrowser 技术调研报告

**作者**: Manus AI

**日期**: 2026年5月14日

## 摘要

CloakBrowser 是一个旨在提供高度隐身能力的 Chromium 浏览器项目，其核心是一个经过深度修改的 **Chromium 二进制文件**，而 Python 和 JavaScript 代码仅作为其薄层封装。该项目通过在 C++ 源码层面修改浏览器指纹，实现了对 Playwright 和 Puppeteer 自动化框架的无缝替代。最新版本包含多达 57 个源码级补丁，能够有效消除自动化信号、注入指纹噪声并清理代理特征。尽管其核心机制采取闭源策略，但项目在 reCAPTCHA v3、Cloudflare Turnstile 等主流反机器人测试中表现卓越，并提供了灵活的 Docker 部署方案，是网络爬虫、社交媒体自动化及 AI Agent 场景下的领先工具。

## 1. 技术原理与架构

CloakBrowser 的技术架构不同于传统的自动化增强工具。其核心竞争力源于对 **Chromium 源码的深度重构**，而非简单的配置调整或脚本注入。

### 1.1 架构层次

CloakBrowser 采用分层架构设计。底层是经过 C++ 源码级修改并编译的 Chromium 二进制文件，直接在内核层面处理指纹生成和信号隐藏。中间层是针对 Playwright 和 Puppeteer 开发的隐身驱动，负责消除 CDP（Chrome DevTools Protocol）层面的自动化特征。最上层则是为 Python 和 Node.js 提供的薄层封装接口，确保开发者能够以极低的成本进行迁移 [1]。

### 1.2 与主流方案对比

在浏览器自动化领域，CloakBrowser 通过更深层次的修改解决了现有方案的局限性：

| 方案 | 修改层次 | 核心问题 | 隐身效果 |
| :--- | :--- | :--- | :--- |
| **playwright-stealth** | JS 注入 | 补丁本身特征明显，易被高级检测系统识别 | 中 |
| **undetected-chromedriver** | 启动参数 | 依赖配置调整，Chrome 版本更新后极易失效 | 中 |
| **Multilogin/GoLogin** | 闭源修改版浏览器 | 费用高昂（$24-$199+/月），依赖第三方云服务 | 高 |
| **CloakBrowser** | **C++ 源码编译** | 行为与真实浏览器在内核层面保持一致，免费自托管 | **极高** |

## 2. 反风控能力深度解析

CloakBrowser 的反风控能力建立在多维度的伪装策略之上，目前在 Linux 和 Windows 平台包含 **57 个 C++ 源码级补丁**，在 macOS 平台包含 26 个补丁 [1]。

### 2.1 自动化信号的彻底消除

CloakBrowser 在内核层面彻底移除了自动化标志。它不仅将 `navigator.webdriver` 强制设为 `false`（源码级，不可检测），还禁用了 `--enable-automation` 等常规自动化参数（Playwright 默认会加，被覆盖屏蔽）。通过对 CDP 输入行为的模拟，它实现了 `isAutomatedWithCDP: false` 的效果。此外，它还确保了 `window.chrome` 对象的存在以及 `navigator.plugins.length = 5` 的真实性，使其在环境检测中表现得如同一个完全由人工操作的浏览器 [1] [2]。

### 2.2 确定性指纹噪声化

针对 Canvas、WebGL 和 Audio 等常见的硬件指纹采集技术，CloakBrowser 采取了“基于种子的噪声注入”策略。通过 `--fingerprint=seed` 参数，浏览器可以确定性地生成随机噪声。这意味着对于同一个种子，浏览器会产生稳定且唯一的硬件身份（如 `hardwareConcurrency=8`，`deviceMemory=8`，屏幕分辨率 1920×1080），这对于模拟“回头客”行为、提高账号权重至关重要。同时，GPU 信息（`UNMASKED_VENDOR_WEBGL` / `UNMASKED_RENDERER_WEBGL`）也会按种子伪造 [1]。

### 2.3 代理信号清理与 GeoIP 对齐

在最新的版本中，CloakBrowser 引入了针对代理特征的深度清理功能。它能够将 DNS 解析、连接建立及 SSL 握手的时序特征归零，剥离代理缓存相关的 Header，并移除 `Proxy-Connection` 头的泄漏。

通过 `geoip=True` 功能，浏览器能自动通过代理访问 ipify.org/checkip.amazonaws.com 获取出口 IP，然后：
1. 设置 `--fingerprint-timezone` 和 `--lang` 二进制参数，对齐时区和语言。
2. 自动注入 `--fingerprint-webrtc-ip=auto` 防止 WebRTC 泄露真实 IP，从而构建一个地理位置逻辑自洽的访问环境 [1]。

### 2.4 平台伪装策略

为了提高指纹的通用性，CloakBrowser 在 Linux 服务器环境下默认伪装为 **Windows 桌面版**（通过 `--fingerprint-platform=windows`）。而在 macOS 上则采取原生运行策略，以避免因字体库或 GPU 驱动不匹配而产生的可检测差异。此外，其 TLS 指纹（ja3n/ja4/akamai）与真实 Chrome 完全一致 [1]。

## 3. 行为伪装技术 (Humanize)

通过 `humanize=True` 参数，CloakBrowser 能够将枯燥的自动化指令转化为拟人化的交互行为 [1]：
*   **鼠标交互**: 模拟贝塞尔曲线移动轨迹，并包含真实的停留时长。
*   **键盘输入**: 实现逐字符延迟输入，并模拟随机的拼写错误及自我更正过程。
*   **滚动行为**: 模拟加速、巡航、减速的微步滚动物理特性。

## 4. 代理与认证支持

CloakBrowser 对代理的支持不仅全面，而且针对自动化场景进行了特殊优化。

### 4.1 HTTP/HTTPS 代理

HTTP 代理通过标准的 Playwright 代理字典传递，由 Playwright 负责处理 `Proxy-Authorization` 认证握手，能够很好地适配大多数商业代理服务。

### 4.2 SOCKS5 代理的技术实现

由于 Playwright 原生不支持带凭据的 SOCKS5 代理字典，CloakBrowser 采取了**绕过 Playwright 直接操作启动参数**的方案。它通过 `--proxy-server` 参数直接向 Chrome 内核传递认证信息。代码在 `browser.py:1063` 的 `_resolve_proxy_config` 函数中处理。针对凭据中可能包含的特殊字符（如 `=`），系统会自动进行 URL 编码处理（issue #157 修复），确保了复杂密码环境下的稳定性 [1]。

## 5. 性能验证与已知限制

### 5.1 检测通过情况 (2026年4月验证)

CloakBrowser 官方声称其在多项机器人检测测试中表现优异，以下是基于 Chromium 146 的测试结果 [1] [2]：

| 检测服务 | Stock Playwright | CloakBrowser | 备注 |
| :--------------------------- | :--------------- | :----------- | :------------------- |
| reCAPTCHA v3 | 0.1 (机器人) | **0.9 (人类级)** | 服务器端验证 |
| Cloudflare Turnstile (非交互式) | 失败 | **PASS** | 自动解决 |
| Cloudflare Turnstile (管理式) | 失败 | **PASS** | 单击解决 |
| ShieldSquare | 阻止 | **PASS** | 生产站点 |
| FingerprintJS 机器人检测 | 检测到 | **PASS** | demo.fingerprint.com |
| BrowserScan 机器人检测 | 检测到 | **NORMAL (4/4)** | browserscan.net |
| bot.incolumitas.com | 13 失败 | **仅 1 项失败** | 仅 WEBDRIVER 规范未过 |

### 5.2 已知限制与技术权衡

在实际部署中，用户需要注意以下技术权衡 [1] [4]：
*   **二进制闭源**: 虽然封装层遵循 MIT 开源协议，但核心的 C++ 补丁部分以预编译二进制形式发布（受 `BINARY-LICENSE.md` 约束），这要求用户对开发者保持一定的信任。
*   **后端兼容性**: 使用 `backend="patchright"` 虽然能显著提升 reCAPTCHA Enterprise 的通过率，但目前已知该模式会破坏代理认证功能。
*   **存储配额权衡**: `launch_persistent_context` 默认的存储配额设置能通过 FingerprintJS 检测，但在 BrowserScan 中可能被识别为隐私模式（导致评分下降 10 分）。用户可通过 `--fingerprint-storage-quota=5000` 进行手动干预。

## 6. Docker 部署方案

CloakBrowser 提供了灵活的 Docker 部署选项，以适应不同的使用场景，从快速测试到生产环境的浏览器配置文件管理 [1] [5]。

### 6.1 官方镜像快速部署

对于快速验证或运行简单的自动化任务，可以直接使用 CloakHQ 提供的官方 Docker 镜像 `cloakhq/cloakbrowser`。该镜像预装了 CloakBrowser 及其所有依赖，并提供了 `cloaktest` 命令用于快速检查隐身能力。例如，运行以下命令可以启动一个临时容器并执行测试：

```bash
docker run --rm cloakhq/cloakbrowser cloaktest
```

### 6.2 CloakBrowser Manager 部署

CloakBrowser Manager 是一个基于 Web 的浏览器配置文件管理工具，它允许用户通过图形界面创建、管理和启动具有独特指纹、代理和持久会话的浏览器配置文件。这对于需要管理大量独立浏览器环境的场景（如多账号操作）非常有用。部署 CloakBrowser Manager 的命令如下：

```bash
docker run -d -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager
```

部署后，可以通过访问 `http://localhost:8080` 来使用其 Web 界面。`-v cloakprofiles:/data` 参数用于将配置文件数据持久化到宿主机的 `cloakprofiles` 卷中，确保数据在容器重启后不会丢失。

### 6.3 自定义 Dockerfile 构建

对于需要更精细控制或集成到现有 CI/CD 流程的用户，可以基于 CloakBrowser 提供的 `Dockerfile` 进行自定义构建。官方 `Dockerfile` 基于 `python:3.12-slim` 镜像，并安装了 Chromium 运行所需的系统依赖、Node.js 以及各种字体包（如 `fonts-noto-color-emoji`、`fonts-wqy-zenhei` 等）。这些字体对于规避基于 Canvas 指纹的检测至关重要。此外，`Dockerfile` 中还包含了在构建阶段预下载 CloakBrowser 二进制文件的步骤，以优化运行时性能 [5]。

自定义构建时，应确保包含所有必要的系统依赖和字体，并考虑在构建过程中运行 `python -c "from cloakbrowser import ensure_binary; ensure_binary()"` 来预下载 CloakBrowser 二进制文件，从而避免在容器启动时才进行下载，减少首次运行的延迟。

## 7. 测试与验证方案

为了全面评估 CloakBrowser 的隐身能力和功能完整性，可以设计以下测试方案：

### 7.1 基础功能测试

*   **环境搭建验证**: 编写一个简单的 Python 或 JavaScript 脚本，使用 CloakBrowser 启动一个浏览器实例，访问一个公共网站（如 `https://example.com`），并获取页面标题。这可以验证 CloakBrowser 是否正确安装、二进制文件是否可用以及基本功能是否正常。
*   **API 兼容性测试**: 确保现有的 Playwright 或 Puppeteer 脚本在切换到 CloakBrowser 后能够正常运行，验证其 API 兼容性。

### 7.2 隐身能力测试

隐身能力是 CloakBrowser 的核心价值，应针对主流的机器人检测服务进行测试：

*   **reCAPTCHA v3 分数检测**: 访问 `https://antcpt.com/score_detector/` 或其他 reCAPTCHA v3 测试站点，检查 CloakBrowser 获得的 reCAPTCHA 分数。理想情况下，分数应接近 0.9，表明其被识别为人类用户 [1]。
*   **Cloudflare Turnstile 绕过**: 访问包含 Cloudflare Turnstile 保护的网站（例如 Cloudflare 官方 Demo 页面或一些受保护的网站），验证 CloakBrowser 是否能自动绕过非交互式和管理式挑战 [1]。
*   **指纹检测服务**: 使用专业的指纹检测网站，如 `https://www.browserscan.net/` 和 `https://fingerprint.com/products/bot-detection/`，检查 CloakBrowser 是否被识别为自动化工具或具有独特的机器人指纹。同时，可以利用 `https://abrahamjuliot.github.io/creepjs/` 进行更深层次的指纹分析，评估其对 Canvas、WebGL、AudioContext 等高级指纹的伪装效果。
*   **WebDriver 检测**: 验证 `navigator.webdriver` 属性是否为 `false`，以及其他 WebDriver 相关的自动化标志是否被成功移除 [1]。
*   **TLS 指纹匹配**: 检查 TLS 指纹（如 JA3/JA4）是否与真实 Chrome 浏览器一致，以避免在网络层被识别 [1]。

### 7.3 行为模拟测试 (Humanize)

对于启用了 `humanize=True` 功能的场景，需要进行行为模拟的验证：

*   **视觉观察**: 在 `headless=False` 模式下运行自动化脚本，并录制视频或进行屏幕截图，肉眼观察鼠标移动、键盘输入和页面滚动是否自然，是否存在明显的机器人行为特征（如直线移动、瞬间跳转）。
*   **日志分析**: 如果可能，分析目标网站的服务器日志或行为分析工具的报告，查看用户行为模式是否与真实用户相似，例如请求间隔、交互速度等。

### 7.4 环境一致性测试

为了确保 CloakBrowser 在不同部署环境中的表现一致，可以进行以下测试：

*   **多环境对比**: 在本地开发环境、Docker 容器以及云服务器（VPS）等不同环境中，使用相同的 CloakBrowser 配置和脚本，对同一目标网站进行隐身能力测试。比较各环境下的测试结果，确保一致性。
*   **固定指纹验证**: 使用 `--fingerprint=seed` 参数指定一个固定的指纹种子，在不同环境中启动 CloakBrowser，并检查其生成的指纹是否完全一致，以验证指纹持久性功能。

## 8. 结论

CloakBrowser 通过在 Chromium 源码层面的深度干预，为浏览器自动化提供了一套近乎完美的隐身方案。尽管闭源二进制文件带来了一定的透明度挑战，但其在反风控领域的卓越表现、免费自托管的特性、灵活的 Docker 部署方案以及对主流框架的无缝支持，使其成为当前复杂反爬环境下的首选技术方案。

## 参考文献

[1] CloakHQ. (2026). *CloakHQ/CloakBrowser: Stealth Chromium that passes every bot detection test.* GitHub. [https://github.com/CloakHQ/CloakBrowser](https://github.com/CloakHQ/CloakBrowser)
[2] CloakBrowser. (n.d.). *CloakBrowser — Stealth Chromium for Browser Automation*. [https://cloakbrowser.dev/](https://cloakbrowser.dev/)
[3] CloakHQ. (2026). *CloakBrowser Binary License v1.0*. [https://github.com/CloakHQ/CloakBrowser/blob/main/BINARY-LICENSE.md](https://github.com/CloakHQ/CloakBrowser/blob/main/BINARY-LICENSE.md)
[4] Reddit Community. (2026). *Discussion on CloakBrowser Stealth Capabilities*. Reddit r/webscraping. [https://www.reddit.com/r/webscraping/comments/1t9g0kr/is_cloak_browser_good/](https://www.reddit.com/r/webscraping/comments/1t9g0kr/is_cloak_browser_good/)
[5] CloakHQ. (2026). *CloakBrowser Dockerfile Configuration*. GitHub. [https://github.com/CloakHQ/CloakBrowser/blob/main/Dockerfile](https://github.com/CloakHQ/CloakBrowser/blob/main/Dockerfile)


搜索结果: 浏览器指纹