CloakHQ/CloakBrowser

CloakBrowser – 用于自动化的隐身 Chromium

简介 – CloakBrowser 是一个自定义构建的 Chromium 二进制文件，其源代码经过补丁（约 87 处 C++ 修改）以隐藏反机器人服务所寻找的常见“自动化”指纹。该项目提供轻量的 Python、JavaScript/Node 和 .NET 包装器，暴露与 Playwright（以及 Puppeteer）相同的 API，因此只需更改导入即可将其放入现有的抓取或测试脚本中。

核心能力

• 源码级隐身 – 指纹（canvas、WebGL、GPU、屏幕尺寸、WebRTC、时序、navigator.webdriver 等）在编译时被修改，而不是通过注入 JavaScript 或设置标志。这使得浏览器在检测服务看来像普通的 Chrome 安装。
• Playwright/Puppeteer 即插即用 – from cloakbrowser import launch（Python）或 import {launch} from 'cloakbrowser'（JS）与标准 Playwright 启动调用完全一样。除了导入之外无需更改代码。
• 类人交互 – 单个 humanize=True 标志使鼠标移动、打字和滚动遵循真实的贝塞尔曲线和时序模式，有助于通过行为检查。
• 代理与地理 IP 支持 – 您可以提供 HTTP 或 SOCKS5 代理，并且使用 geoip=True 时，浏览器会自动将时区/区域设置与代理的出口 IP 匹配，并欺骗 WebRTC ICE 候选。
• 跨平台二进制文件 – 适用于 Linux（x64/ARM64）、Windows 和 macOS（Intel 和 Apple Silicon）的预编译隐身 Chromium。二进制文件在首次运行时自动下载（约 200 MiB），并使用 Ed25519 签名进行验证。
• Pro 版本 – 免费层提供最新构建的一个并发会话；付费计划解锁多个同时会话、优先更新和支持。
• CloakBrowser Manager – 一个可选的开源 GUI（单独仓库），允许您创建无限隔离配置文件，每个配置文件都有自己的指纹、代理和持久状态，类似于商业反检测浏览器。

典型用法

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 中通过 import {launch} from 'cloakbrowser' 工作。

为什么对 AI/自动化很重要

• 许多 LLM 驱动的代理（例如 LangChain、Crawl4AI、自主网络代理）需要一个不会被 Cloudflare Turnstile、reCAPTCHA v3、FingerprintJS 等阻止的浏览器。CloakBrowser 提供了一个通过那些检查的“真实”Chrome，让代理可靠地检索内容。
• 因为它使用原生 Playwright API，它可以无缝集成到现有的 Python/JS 自动化管道中，而不会像仅 JS 的隐身插件那样在每次 Chrome 更新时出现维护问题。

限制

• CloakBrowser 不解决实际出现的 CAPTCHA；它只减少它们出现的可能性。如果挑战通过，您仍然需要单独的解算服务或手动处理。
• 免费层限制为一个并发会话；大规模抓取需要 Pro 许可证。

总结 – CloakBrowser 是一个真正的、积极维护的工具，为 Playwright/Puppeteer 自动化提供隐身 Chromium 二进制文件，目标受众与反检测浏览器相同，但具有开源包装器和对源码级指纹移除的明确关注。