CloakBrowser

一键替换 Playwright，轻松通过所有机器人检测，让自动化如真人操作。

CloakBrowser 是一个基于 Chromium 的隐身浏览器，专为绕过各类机器人检测而设计。它通过源码级别的指纹修补，使自动化浏览器在网站眼中与真实用户无异，在 30 项主流 bot 检测测试中全部通过。项目定位为 Playwright 的直接替代品，开发者无需大幅改动现有代码即可无缝切换，从而降低被 Cloudflare 等反爬机制拦截的风险。其核心能力包括深度伪造浏览器指纹、模拟真实用户行为模式，以及兼容现有自动化框架的 API。对于需要大规模数据采集、账号自动化管理或测试反爬系统的团队，CloakBrowser 提供了一个高隐蔽性的解决方案，但需注意其使用可能涉及网站服务条款的合规风险。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 31629

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队CloakHQ

所属国家

官网地址https://cloakbrowser.dev

GitHubhttps://github.com/CloakHQ/CloakBrowser

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai-agents,anti-detect,antidetect-browser,bot-detection,browser-automation,captcha-bypass,chromium,cloudflare,cloudflare-bypass,fingerprint,headless-browser,playwright,puppeteer,python,recaptcha,selenium,stealth-browser,undetected,web-scraping,webscraping

GitHub 星标★ 31629

30天Star增速

HF 下载量

上线时间2026-02-22 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 15 分钟部署方式：库/依赖 7 步

环境要求

Python 环境，可用 pip 安装 PyPI 包
Node.js 环境（使用 JavaScript/Node.js 版本时需要）
Linux 服务器或容器需额外安装 emoji/CJK 字体包
使用官方镜像时需要 Docker 与 Docker Compose
需要 Playwright 系统依赖（不要装 Playwright 自带 chromium）

安装与启动步骤

1安装 Python 包

通过 PyPI 安装 cloakbrowser，安装后即可用其 API 启动隐身 Chromium。
```
pip install cloakbrowser
```
2安装 Node.js 包

如果项目是 JavaScript/Node.js 技术栈，改用 npm 安装同名包。
```
npm install cloakbrowser
```
3装 Playwright 系统依赖

不要执行 playwright install chromium，CloakBrowser 自带浏览器二进制，只需系统依赖。
```
playwright install-deps chromium
```

4Linux 装基础字体

Docker、云主机等精简 Linux 缺少 emoji/CJK 字体，会导致 canvas 指纹哈希异常。

sudo apt install -y fonts-noto-color-emoji fonts-freefont-ttf fonts-unifont fonts-ipafont-gothic fonts-wqy-zenhei fonts-tlwg-loma-otf

5装 Windows 字体

Linux 默认伪装 Windows，需从真实 Windows 机器复制字体，否则字体指纹会暴露。
```
mkdir -p ~/.local/share/fonts/windows
cp -r /path/to/windows/Fonts/. ~/.local/share/fonts/windows/
fc-cache -f
```
6预下载浏览器二进制

提前下载可避免首次运行时等待，也适合在 Docker 构建阶段执行。
```
ensure_binary()
```

7Docker Compose 启动

官方镜像已含免费二进制，写入 compose 文件后启动服务，默认监听 9222 端口。

services:
  cloakbrowser:
    image: cloakhq/cloakbrowser
    command: cloakserve
    restart: unless-stopped
    ports:
      - "127.0.0.1:9222:9222"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9222/json/version"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 10s

关键配置

配置项	必填	说明	示例
`CLOAKBROWSER_BINARY_PATH`	否	跳过下载，直接使用本地 Chromium 二进制	`/opt/chromium/chrome`
`CLOAKBROWSER_CACHE_DIR`	否	浏览器二进制的缓存目录	`~/.cloakbrowser`
`CLOAKBROWSER_AUTO_UPDATE`	否	设为 false 可关闭后台更新检查	`false`
`CLOAKBROWSER_VERSION`	否	锁定到指定 Chromium 版本以便回滚	`148.0.7778.215.2`
`CLOAKBROWSER_RELEASE_CHANNEL`	否	设为 preview 可切换到预览通道二进制	`preview`
`CLOAKBROWSER_LICENSE_KEY`	否	Pro 版授权码，Docker 运行时自动下载最新二进制	`cb_xxxxxxxx`

如何确认成功

执行 curl -f http://localhost:9222/json/version 返回版本信息；或调用 binary_info() 看到 installed 为 True。

常见问题

Q：还需要执行 playwright install chromium 吗？

A：不需要。CloakBrowser 会下载自己的浏览器二进制，只安装 Playwright 的系统依赖即可，即 playwright install-deps chromium。

Q：怎么确认浏览器二进制装好了？

A：调用 binary_info() 查看返回字典，包含 version、platform 和 installed 字段，installed 为 True 表示可用。

Q：Linux 上一直提示字体警告怎么办？

A：需补齐 Segoe UI、Calibri、Consolas 等 Windows 专有字体（apt 源里没有），全部找到后警告自动消失；也可用 CLOAKBROWSER_SUPPRESS_FONT_WARNING=1 关闭。

Q：Docker 里能用 Widevine / DRM 吗？

A：可以。仅 Linux x86-64 支持，设置 CLOAKBROWSER_FETCH_WIDEVINE=1，容器启动时会自动拉取 Widevine CDM。

Q：怎么验证 Docker 镜像来源？

A：用 Cosign 校验签名，指定证书身份 regexp 为 GitHub 仓库地址、OIDC issuer 为 GitHub Actions 令牌地址。

注意事项

官方 Docker 镜像 cloakhq/cloakbrowser 已预装基础 emoji/CJK 字体，但仍需自行提供 Windows 字体。
官方下载路径的签名校验是强制的，只有自定义 CLOAKBROWSER_DOWNLOAD_URL 时才可通过 CLOAKBROWSER_SKIP_CHECKSUM 跳过校验。
--disable-http2 只对确实需要的站点使用，优先考虑 SOCKS5 代理；多数站点 HTTP/2 可正常工作。
该工具可能违反目标网站服务条款，请自行评估合规与法律风险。

核心亮点

30/30 通过主流 bot 检测测试，反检测能力经过实证验证
源码级指纹修补，比传统 UA 伪装更深入，难以被识别
作为 Playwright 直接替代品，迁移成本低，兼容现有测试脚本

不足之处

项目可能处于早期阶段，文档和社区支持有待完善
高级隐身功能可能被滥用，存在法律和道德风险

适用场景

大规模网络数据采集，规避反爬虫封锁
自动化测试需要模拟真实用户环境，避免被误判
多账号管理或社交媒体自动化操作，降低封号风险

替代项目

undetected-chromedriver、puppeteer-extra-plugin-stealth、Camoufox

项目介绍

CloakBrowser 是自动化工作流领域的开源项目，由 CloakHQ 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（31,629）位列前 2%，在自动化工作流分类的 503 个项目里位列前 4%。

近 44 天，它的 GitHub 星标从 29,790 增加到 31,629，净增 1,839。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：大规模网络数据采集，规避反爬虫封锁。同类可对比的替代方案包括 undetected-chromedriver、puppeteer-extra-plugin-stealth、Camoufox。

上一篇：banco

下一篇：socialclaw