## 1. 项目概述

`invisible_playwright` 是一个旨在绕过机器人检测的隐形 Firefox 浏览器，它通过在 C++ 级别而非 JavaScript 层面修补浏览器指纹，以实现高度的隐蔽性。该项目作为 Playwright 的直接替代品，提供了 100% 的 API 兼容性，使得现有 Playwright 用户可以轻松切换。其核心优势在于能够通过所有机器人检测测试，包括 reCAPTCHA v3 和 CreepJS 的“谎言检测器”。

## 2. 核心功能与技术原理

### 2.1 C++ 级别修补

与大多数在 JavaScript 层面修补 `navigator`、`WebGLRenderingContext.getParameter`、Canvas API 等的防检测浏览器不同，`invisible_playwright` 在 C++ 级别对 Firefox 进行了修补。这意味着伪造的值通过正常的 Gecko 路径返回，没有 JavaScript shim、没有覆盖、也没有 `Object.defineProperty`。从页面的角度来看，浏览器只是在“说真话”，这使得反机器人谎言检测器无法捕捉到任何异常。

### 2.2 指纹伪装

`invisible_playwright` 能够全面伪装所有关键层面的指纹信息，包括：

*   **Navigator**: 浏览器用户代理等信息。
*   **屏幕 (Screen)**: 屏幕分辨率、可用区域等。
*   **GPU/WebGL**: 图形处理器信息和 WebGL 参数。
*   **Canvas**: Canvas 渲染指纹。
*   **字体 (Fonts)**: 系统安装字体列表。
*   **音频 (Audio)**: 音频上下文参数。
*   **WebRTC**: 避免 IP 地址泄露。
*   **时区 (Timezone)**: 浏览器时区设置。
*   **DevTools 检测**: 绕过开发者工具的检测。
*   **SOCKS5 认证**: 支持代理认证。

所有这些伪装值都由偏好设置驱动，而非硬编码，用户可以通过修改偏好设置来改变伪装值。

### 2.3 Playwright 兼容性

`invisible_playwright` 与 Playwright 100% 兼容，支持同步和异步模式，所有方法均可直接使用，无需更改 API。这意味着现有的 Playwright 脚本只需少量修改即可使用 `invisible_playwright`，例如：

```python
- from playwright.sync_api import sync_playwright
- with sync_playwright() as p:
-     browser = p.firefox.launch()
+ from invisible_playwright import InvisiblePlaywright
+ with InvisiblePlaywright() as browser:
```

### 2.4 指纹生成与定制

每个会话都会从真实的 Firefox 遥测数据（包括 GPU、音频、字体等约 400 个字段）中生成一个独特且一致的指纹，并内置贝塞尔曲线鼠标移动轨迹。用户可以通过 `seed` 参数复现特定指纹，也可以通过 `pin` 参数强制指定某些字段的值，同时让其他字段保持通过贝叶斯采样器生成，以实现高度定制化。

## 3. 竞品分析

`invisible_playwright` 的 README 文档中详细对比了其与现有反检测浏览器和 Firefox 强化项目的异同。以下是主要对比点：

### 3.1 与基于 Chromium 的方案对比

大多数其他反检测浏览器（如 CloakBrowser）主要修补 Chromium。然而，`invisible_playwright` 指出基于 Chromium 的方案存在两个致命问题 [1]：

1.  **JS 补丁可检测性**: JavaScript 补丁容易被检测到。反机器人系统可以通过检查原生函数的 `toString()`、描述符可配置性、属性枚举顺序和原型变异来发现这些补丁。CreepJS 等工具内置了大量的“谎言检测器”来识别这些指纹。
2.  **Chromium 本身的可疑性**: 住宅代理机器人流量绝大多数基于 Chromium，因此检测器默认将任何 Chromium 形状的浏览器视为高风险。尽管基于 Chromium 的分支继承了 Chrome 的开源层，但它们无法完全匹配 Chrome 的实际表现，因为 Chrome 包含闭源组件（如 Widevine、专有编解码器、Google Update / Safe Browsing 端点），这些组件会触发可检测的 JS 功能标志和网络信号。此外，分支版本通常滞后于 Chrome 的发布节奏，留下可供检测器识别的版本特定行为。

### 3.2 与现有 Firefox 强化项目对比

`invisible_playwright` 也借鉴并超越了现有的 Firefox 强化项目 [1]：

*   **arkenfox/user.js**: 这是一个通过偏好设置强化 Firefox 隐私/安全配置的权威项目。`invisible_playwright` 在此基础上，通过修补 C++ 源代码解决了仅凭偏好设置无法解决的问题，例如 Canvas 噪声、WebGL 参数覆盖、字体白名单、WebRTC IP 交换和 DevTools 检测绕过。
*   **LibreWolf**: 这是一个捆绑了合理隐私默认设置的 Firefox 分支。`invisible_playwright` 与其受众相同，但分发模型不同：LibreWolf 发布配置好的 Firefox 二进制文件，而 `invisible_playwright` 发布源代码补丁和一个用于自动化的包装器。
*   **Camoufox**: 最知名的开源反检测 Firefox 项目。`invisible_playwright` 与其在指纹伪装方面有相似的设计目标，但实现方法不同。Camoufox 修补了更广泛的表面并拥有自己的指纹数据库，而 `invisible_playwright` 更接近原版 Firefox，并通过贝叶斯采样器驱动指纹伪装。

### 3.3 与商业反检测浏览器对比

商业反检测浏览器（如 Multilogin、GoLogin、AdsPower、Dolphin、Kameleo）通常是付费 SaaS 服务，它们在修补过的 Chromium 上叠加 JavaScript 层的伪装。`invisible_playwright` 强调其在 C++ 级别的修补深度和开源性质是其优势 [1]。

以下表格总结了 `invisible_playwright` 与主要竞品的对比：

| 特性             | invisible_playwright | Camoufox             | CloakBrowser         | Multilogin Engine    |
| :--------------- | :------------------- | :------------------- | :------------------- | :------------------- |
| **浏览器**       | Firefox 150          | Firefox (~1 年旧版本) | Chromium             | Chromium fork        |
| **补丁深度**     | C++ 源代码           | C++ 源代码           | C++ 源代码           | JS 覆盖              |
| **维护状态**     | 活跃                 | 存在差距 (~1 年)     | 活跃                 | 活跃                 |
| **开源**         | ✅ MIT               | ✅ MPL               | ❌ 闭源              | ❌ 闭源              |
| **`.toString()` 清洁** | ✅                   | ✅                   | ✅                   | ❌ 可检测的 shim     |
| **Canvas/WebGL/Audio** | ✅ C++               | ✅ C++               | ✅ C++               | ❌                   |
| **SOCKS5 认证**  | ✅ 已修补            | ❌                   | ❌                   | ✅                   |
| **reCAPTCHA v3 分数** | 0.90                 | ~0.3-0.5             | ~0.3-0.5             | ~0.3-0.6             |
| **FP Pro - 机器人检测** | ✅ 未检测            | ❌ 已检测            | ❌ 已检测            | ❌ 已检测            |
| **CreepJS 谎言** | ✅ 0                 | ❌ 多个              | ✅ 0                 | ❌ 多个              |
| **成本**         | 免费                 | 免费                 | 免费                 | 从 $99/月起          |

## 4. 总结

`invisible_playwright` 通过其独特的 C++ 级别修补方法，为 Playwright 用户提供了一个强大的反检测解决方案。它在指纹伪装的深度和隐蔽性方面表现出色，尤其是在绕过复杂的机器人检测系统方面。与现有竞品相比，`invisible_playwright` 在开源性、补丁深度和检测规避能力上具有显著优势，并且免费提供，使其成为需要进行网络自动化和数据抓取任务的开发者的一个极具吸引力的选择。

## 5. 参考文献

[1] feder-cr/invisible_playwright. *Stealth Firefox that passes every bot detection test. Drop-in Playwright replacement, fingerprint patched at the C++ level, not a JavaScript shim.* [https://github.com/feder-cr/invisible_playwright](https://github.com/feder-cr/invisible_playwright)

[2] feder-cr/invisible_playwright. *pinning.md*. [https://github.com/feder-cr/invisible_playwright/blob/main/docs/pinning.md](https://github.com/feder-cr/invisible_playwright/blob/main/docs/pinning.md)


invisible_playwright 项目调研报告

# 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)


搜索结果: 反检测浏览器