你有没有遇到过这样的情况：刚在电商网站搜了某样东西，转眼就在社交平台上看到相关广告？或者在同一台电脑上登录两个账号，其中一个立刻被封？这些场景，都和浏览器指纹（Browser Fingerprint）有关——你的浏览器会悄悄地暴露设备型号、操作系统、屏幕分辨率、安装字体等信息，网站用这些特征来”认出”你。

Cloak Browser 是一款基于深度定制 Chromium 的免费反检测浏览器。它在 C++ 源码级别修改了 58 项浏览器指纹特征（包括 Canvas、WebGL、Audio、字体、GPU、屏幕、WebRTC 等），让每一次浏览都像是全新的设备。其核心封装代码（Python/JS 封装层）采用 MIT 开源许可证，浏览器二进制文件可免费使用（详见 BINARY-LICENSE.md）。

📊 Cloak Browser 核心数据一览

过去，想要达到这样的隐私保护水平，要么付费使用 Multilogin（每月 29 美元起）、GoLogin、AdsPower 等商业工具，要么自己动手搭建一套技术方案。Cloak Browser 改变了游戏规则——它完全免费（无订阅、无使用限制），核心代码开源，且可以部署在你自己的机器上。

本教程将一步步带你完成 Cloak Browser 的安装与使用。不论你是普通用户还是开发者，都能找到适合自己的方案。

前提条件

在开始之前，请确保你的环境已经就绪：

• 一台电脑：Windows / macOS / Linux 均可，建议至少 8 GB 内存
• 网络连接：首次启动需要下载约 200 MB 的定制浏览器核心（下载时会自动校验 SHA-256 哈希值）
• 基本的终端操作能力：知道怎么打开命令行就行
• 可选：Docker 环境——如果选择”普通用户”方案会用到

💡 别担心——我也会手把手教你安装 Docker，不要被”命令行”三个字吓退。

概览：你应该选择哪条路？

Cloak Browser 提供两种主要的使用方式，快速对比一下：

🎯 普通用户 → 直接看方案一；开发者 → 看方案二。

方案一：Docker + CloakBrowser Manager（推荐普通用户）

这个方案的精妙之处在于——你完全不用碰代码。打开一个网页，就能创建和管理多个”隐形”浏览器环境。每个环境都有自己独立的指纹、代理、Cookie 和会话数据。

Manager 也是一个开源项目（MIT 协议）——源码在 CloakBrowser-Manager。

第一步：安装 Docker

你可以把 Docker 理解成一个”软件集装箱”，它能让 Cloak Browser 在任何电脑上稳定运行。

Windows 用户：

1. 访问 Docker Desktop 官网 下载安装包
2. 双击安装，一路点”Next”
3. 安装完成后重启电脑，打开 Docker Desktop，看到鲸鱼图标就说明准备好了

macOS 用户：

1. 从官网下载 Docker Desktop for Mac（Intel 芯片选 x86_64 版，Apple Silicon 选 ARM64 版）
2. 将安装包拖入”应用程序”文件夹
3. 打开 Docker，等待菜单栏出现鲸鱼图标

Linux 用户（以 Ubuntu 为例）：

1
2
3
4
5
6

sudo apt update
sudo apt install docker.io docker-compose-v2
sudo systemctl enable --now docker
# 将当前用户加入 docker 组，避免每次输 sudo
sudo usermod -aG docker $USER
# 退出并重新登录，使权限生效

⚠️ 卡住了？ 安装完成后在终端输入 docker --version，如果能显示版本号，说明一切正常。

第二步：启动 CloakBrowser Manager

打开终端（Windows 用户可以用 PowerShell 或 CMD），运行：

1

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

请保持这个终端窗口打开——服务需要它来持续运行。这条命令的含义是：

• -p 8080:8080 —— 将你电脑的 8080 端口映射到容器内，方便通过浏览器访问
• -v cloakprofiles:/data —— 将浏览器配置文件存储到名为 cloakprofiles 的 Docker 卷中，即使删除容器数据也不会丢失
• cloakhq/cloakbrowser-manager —— 要运行的镜像名称

当你看到类似下面的输出，就说明启动成功了：

1

CloakBrowser Manager is running on http://0.0.0.0:8080

第三步：在网页界面中创建第一个浏览器配置

1. 打开 Chrome 或其他浏览器，访问 http://localhost:8080
2. 你会看到一个简洁的管理界面。点击 “Create Profile”（创建配置）
3. 给你的配置起个名字，比如”工作账号 1”或”小号购物”
4. 配置一些参数（之后都可以修改）：
   • Proxy（代理）：有代理就填上，没有则留空
   • Timezone/Language（时区/语言）：选择”自动检测”或手动指定
5. 点击保存——你的第一个浏览器配置就创建好了

在 Linux 上运行 Manager？ 请确保安装了字体包，否则反检测系统会发现字体不匹配：

1	sudo apt install -y fonts-noto-color-emoji fonts-freefont-ttf fonts-unifont fonts-ipafont-gothic fonts-noto-cjk

第四步：启动一个浏览器实例

1. 在配置列表中，找到刚才创建的配置，点击 “Launch”（启动）
2. 系统会自动在后台启动一个独立的浏览器窗口（通过 noVNC 显示在你的浏览器页面中）
3. 等待大约十秒钟——你会看到网页里出现一个功能完整的浏览器界面！

🎬 小技巧：你可以同时运行多个配置，每个都有自己的指纹、Cookie 和会话数据。在 Manager 界面切换它们，就像切换电视频道一样简单。

第五步：验证效果——真的”隐身”了吗？

在新启动的浏览器中，访问以下检测网站：

1. BrowserScan —— 检查你的浏览器指纹评分
2. FingerprintJS —— 看看哪些特征被采集了
3. IP 信息查询 —— 确认 IP 地址和时区

如果使用默认设置（不配置代理），你会看到：虽然 IP 地址没变，但 Canvas 指纹、WebGL 渲染器、字体列表等特征已经和你的真实浏览器完全不同了——这就是 Cloak Browser 在引擎层面做的”化妆”。

进阶：为 Manager 设置密码保护（推荐）

如果你想长期运行 Manager 服务，给它加上身份验证是个好主意——否则局域网内任何人都能访问它。

1
2
3
4
5

# 先停止正在运行的容器（按 Ctrl+C）
# 然后加上 AUTH_TOKEN 重新启动
docker run -p 8080:8080 -v cloakprofiles:/data \
  -e AUTH_TOKEN=你的密码 \
  cloakhq/cloakbrowser-manager

再次访问 http://localhost:8080 时，你会看到一个登录页面（输入你设置的密码即可）。API 调用需要在请求头中添加 Authorization: Bearer <token>。

注意：密码通过 HTTP 明文传输。如果你打算将 Manager 暴露到公网，请在前面加一层 HTTPS 反向代理（如 Caddy、Nginx、Traefik）。

方案二：面向开发者的 Python API

如果你会写代码，或者想用脚本实现自动化操作，Python 方案更方便。

第一步：安装 Python 包

1
2
3

pip install cloakbrowser
# 想要自动检测时区和语言？加上 geoip 扩展
pip install cloakbrowser[geoip]

🐍 建议在虚拟环境中安装，避免与系统 Python 包冲突。

首次启动时，约 200 MB 的定制 Chromium 二进制文件会自动下载并缓存到本地（SHA-256 校验）——无需手动配置。

CLI 工具：安装后，你也可以通过命令行管理二进制文件：

1 2 3 4

python -m cloakbrowser install # 下载二进制文件 python -m cloakbrowser info # 查看版本、路径、平台 python -m cloakbrowser update # 检查并更新到最新版 python -m cloakbrowser clear-cache # 清除缓存的二进制文件

第二步：5 行代码启动浏览器

1
2
3
4
5
6
7
8

from cloakbrowser import launch

browser = launch(headless=False, humanize=True)
page = browser.new_page()
page.goto("https://browserscan.net")
# 你会看到一个浏览器窗口自动打开，就像真人在操作一样
input("按回车键退出...")
browser.close()

参数说明：

第三步：持久化上下文的使用

想保存登录状态和 Cookie，下次还能用？用 launch_persistent_context：

1
2
3
4
5
6
7
8
9

from cloakbrowser import launch_persistent_context

# 指定一个文件夹来存放配置信息
ctx = launch_persistent_context("./我的账号配置")
page = ctx.new_page()
page.goto("https://example.com/login")
# ... 执行登录操作 ...
# 关闭后，登录信息保存在 ./我的账号配置 中
ctx.close()

下次使用同一个文件夹启动时，网站会认为你是”老用户”。你也可以加载 Chrome 扩展：

1
2
3
4

ctx = launch_persistent_context(
    "./我的账号配置",
    extension_paths=["./我的扩展"],
)

第四步：Playwright 项目的一行迁移

如果你已经在用 Playwright 写自动化脚本，切换到 Cloak Browser 只需改动一行代码：

1
2
3
4
5
6
7
8
9
10
11
12

# 之前：使用 Playwright
# from playwright.sync_api import sync_playwright
# pw = sync_playwright().start()
# browser = pw.chromium.launch()

# 之后：使用 Cloak Browser
from cloakbrowser import launch

# 其余代码完全不用动！
browser = launch()
page = browser.new_page()
page.goto("https://example.com")

没错——在你现有的 Playwright 脚本中，只需要改 import 语句和 启动方式 这两处。其他 API（new_page、goto、click、fill 等）完全一样！

进阶：环境变量配置

以下环境变量可以让你自定义运行时行为：

常见问题（FAQ）

❓ Cloak Browser 和普通浏览器的”无痕/隐私模式”有什么区别？

两者完全不同。 普通浏览器的无痕模式只是不在本地保存历史记录，但网站照样采集你的指纹。Cloak Browser 是在 C++ 源码层面修改了浏览器的指纹生成逻辑，让网站以为你在用一台完全不同的设备。

❓ 浏览器会卡吗？

首次启动需要下载约 200 MB 的定制 Chromium 二进制文件。之后启动速度和普通 Chrome 差不多。内存占用比 Chrome 多 100-200 MB（闲置约 190 MB，开 3 个标签页约 280 MB），现代电脑基本感觉不到差异。

❓ Docker 提示端口已被占用怎么办？

说明你电脑上其他程序正在使用 8080 端口。换个端口试试：

1

docker run -p 9090:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager

然后访问 http://localhost:9090 即可。

❓ macOS 提示”开发者无法验证”怎么办？

这是 macOS Gatekeeper 的安全机制在阻拦二进制文件。运行以下命令解除限制：

1

xattr -cr ~/.cloakbrowser/chromium-*/Chromium.app

❓ 某个网站说我在使用自动化工具怎么办？

组合使用以下参数可获得最佳效果：

1
2
3
4
5
6

browser = launch(
    proxy="http://你的代理",   # 使用住宅代理
    geoip=True,                # 自动匹配时区和语言
    headless=False,            # 显示窗口
    humanize=True              # 模拟人类行为
)

大多数被拦截的情况，不是因为指纹检测出了问题，而是缺少住宅代理、时区不匹配（geoip=True 解决）、或使用了无头模式（headless=False 解决）——这三点缺一个都可能被检测到。

❓ 我可以同时在多个网站登录同一个账号吗？

技术上可以，但建议每个网站/账号使用独立的配置，尤其是在管理多个账号时。一个配置 = 一个账号，避免指纹交叉污染导致平台关联。

❓ 这个项目是开源的吗？许可证是什么？

代码许可证：Cloak Browser 的封装层代码（Python/JS 包）采用 MIT 协议——详见 LICENSE。
二进制许可证：编译好的 Chromium 二进制文件可免费用于个人和商业用途，但不可再分发、转售或修改。完整条款见 BINARY-LICENSE.md。
Manager 界面（GUI 源码）同样采用 MIT 协议。

总结

Cloak Browser 的价值可以用一句话概括：免费 + C++ 源码级指纹修改 + 自托管（Self-hosted）。这三个属性加在一起，在今天的反检测浏览器市场中几乎是独一无二的。

普通用户 → 使用 Docker + CloakBrowser Manager，通过网页界面管理多个独立浏览器环境——就像使用任何网页应用一样简单。

开发者 → 使用 Python 或 Node.js API，几行代码就能启动一个”全副武装”的隐形浏览器，现有 Playwright 项目无缝迁移。还可以通过 CLI 工具（python -m cloakbrowser install/info/update）管理二进制文件，通过环境变量（CLOAKBROWSER_BINARY_PATH 等）自定义运行时行为。

快速参考资源：

• 快速 Docker 测试（无需安装）：docker run --rm cloakhq/cloakbrowser cloaktest
• CLI 二进制管理：python -m cloakbrowser install
• 自定义路径环境变量：export CLOAKBROWSER_BINARY_PATH=/path/to/chrome

最后提醒一句：技术是中立工具。用 Cloak Browser 保护个人隐私完全没问题——但不要用它做违法的事情。祝你上网更自由、更安全 🎉

本文基于 Cloak Browser v0.3.30 / Chromium 146 编写。功能可能随版本更新而变化，请查阅 GitHub 仓库 获取最新信息。

📝 引用声明：本文信息于 2026 年 5 月 23 日 核实。所有数据来源于以下官方资料：

• GitHub 主仓库：CloakHQ/CloakBrowser
• Manager 仓库：CloakHQ/CloakBrowser-Manager
• Python 包：cloakbrowser on PyPI
• 官方 Docker 镜像：cloakhq/cloakbrowser-manager