星标数：32878★ Fork数：2728 《CloakBrowser：源码级反检测 Chromium，可直接替换 Playwright》
CloakBrowser 是一个基于 Chromium 打造的隐身浏览器，通过了各类机器人检测测试。它并非修改配置，也不是注入 JavaScript，而是一个在 C++ 源码层面修改了指纹信息的真实 Chromium 二进制文件——反自动化系统将其判定为普通浏览器，因为它本身就是普通浏览器。
它为 Python 和 JavaScript 提供了可直接替换的 Playwright/Puppeteer 方案：API 相同、代码相同，只需更换 import，三行代码、30 秒即可解除封锁。
针对带有反机器人保护的网站，配合住宅代理与相关启动参数即可使用；项目还支持 Docker 一行命令免安装试用。
主要特点
- 87 个源码级 C++ 补丁，覆盖 canvas、WebGL、音频、字体、GPU、屏幕、WebRTC、网络时序、自动化信号与 CDP 输入行为
humanize=True一个开关即可实现类人的鼠标曲线、键盘时序与滚动模式，通过行为检测- 通过 Cloudflare Turnstile、FingerprintJS、BrowserScan 等检测，已在 50 多个检测站点上测试
- 自动下载对应平台的最新二进制文件，
pip install cloakbrowser或npm install cloakbrowser即可使用，零配置 - 支持
geoip=True根据代理 IP 自动匹配时区与语言环境，支持原生 SOCKS5 代理与持久化配置文件 - 在本地、Docker 与 VPS 上表现一致，无需针对环境单独打补丁
安装
# Python
pip install cloakbrowser
# JavaScript / Node.js（Playwright）
npm install cloakbrowser playwright-core
# JavaScript / Node.js（Puppeteer）
npm install cloakbrowser puppeteer-core
# .NET / C#
dotnet add package CloakBrowser
快速开始
# 无需安装即可试用，首次运行会请求密钥
docker run --rm -it cloakhq/cloakbrowser cloaktest
# Python
from cloakbrowser import launch
browser = launch()
page = browser.new_page()
page.goto("https://example.com")
browser.close()
// JavaScript (Playwright)
import { launch } from 'cloakbrowser';
const browser = await launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
应对反机器人保护的启动参数
# Python
browser = launch(
proxy="http://user:pass@residential-proxy:port", # 住宅 IP，非机房 IP
geoip=True, # 时区 + 语言环境匹配代理 IP
headless=False, # 部分站点即使有 C++ 补丁也会检测 headless
humanize=True, # 类人的鼠标、键盘、滚动行为
)
从 Playwright 迁移
# Python，仅需一行改动
- from playwright.sync_api import sync_api
+ from cloakbrowser import launch
+ browser = launch()
page = browser.new_page()
page.goto("https://example.com")
# 其余代码无需修改
许可证密钥
# 无终端环境（CI、Docker 等）通过环境变量设置密钥
CLOAKBROWSER_LICENSE_KEY=
# 通过命令获取
cloakbrowser login
📊 本项目 GitHub 星标数：32878。最后更新：2026-11-12，发布：2026-11-10。项目地址：https://github.com/CloakHQ/CloakBrowser
