CloakHQ/CloakBrowser-Manager

CloakBrowser 的浏览器配置文件管理器

创建、管理和启动具有唯一指纹的独立浏览器配置文件。
Multilogin、GoLogin 和 AdsPower 的免费、自托管替代方案。

每个配置文件都是一个独立的 CloakBrowser 实例，拥有自己的指纹、代理、cookie 和会话数据。配置文件在重启后依然保留。所有程序都在一个 Docker 容器中运行。 ``` docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager ``` 或从源代码构建： ``` git clone https://github.com/CloakHQ/CloakBrowser-Manager.git cd CloakBrowser-Manager docker compose up --build ``` 在浏览器中打开 [http://localhost:8080](http://localhost:8080)。创建一个配置文件。点击启动。完成。 ## 为什么不直接使用 VPN？ VPN 只能更改您的 IP。隐身模式只能清除 cookie。Chrome 的个人资料在底层仍共享相同的硬件指纹。平台使用 50 多种信号来关联您的账户——包括 canvas、WebGL、audio、GPU、字体、屏幕分辨率和时区。 每个 CloakBrowser 配置文件都会生成一个完全不同的设备身份。对于网站而言，每个配置文件看起来都像是一台不同的电脑。 | 解决方案 | 更改内容 | 账户会关联吗？ | |----------|----------------|-----------------| | VPN | 仅 IP 地址 | 是 — 指纹相同 | | 隐身模式 | 清除 cookie | 是 — 指纹相同 | | Chrome 个人资料 | 独立的书签/cookie | 是 — 硬件指纹相同 | | **CloakBrowser** | **所有内容 — 每个配置文件具有完整的独立设备身份** | **否** | ## 功能 - **配置文件管理** — 创建、编辑、删除具有唯一指纹的浏览器配置文件 - **单配置文件设置** — 指纹种子、代理、时区、语言环境、user agent、屏幕分辨率、平台 - **一键启动/停止** — 每个配置文件作为独立的 CloakBrowser 实例运行 - **会话持久化** — cookie、localStorage 和缓存在浏览器重启后依然保留 - **浏览器内查看** — 通过 noVNC 直接在 Web GUI 中与已启动的浏览器进行交互 - **Playwright/Puppeteer API** — 通过 CDP 以编程方式连接到任何正在运行的配置文件，同时仍可在浏览器中实时观看 - **可选身份验证** — 使用单一 token 保护 Web UI 和 API，或在本地完全开放运行 - **由 CloakBrowser 驱动** — 32 个源代码级别的 C++ 补丁，通过 Cloudflare Turnstile，reCAPTCHA v3 评分达到 0.9 ## 技术栈 - **后端**：FastAPI (Python) - **前端**：React + Tailwind CSS - **浏览器查看器**：noVNC (基于 WebSocket 的 VNC 客户端) - **数据库**：SQLite - **浏览器引擎**：[CloakBrowser](https://github.com/CloakHQ/CloakBrowser) (隐蔽版 Chromium 二进制文件) ## 开发 ### 后端 ``` cd backend python -m venv .venv && source .venv/bin/activate pip install -r requirements.txt uvicorn main:app --reload --port 8080 ``` ### 前端 ``` cd frontend npm install npm run dev ``` ### Docker ``` docker compose up --build ``` ## 系统要求 - Docker (20.10+) - 约 2 GB 磁盘空间（镜像 + 二进制文件） - 每个运行中的配置文件约需 512 MB 内存 ## 更新 拉取最新镜像并重启： ``` docker pull cloakhq/cloakbrowser-manager docker stop docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager ``` 您的配置文件和会话数据存储在 `cloakprofiles` 卷中，并在更新后依然保留。 ## 自动化 API 每个正在运行的配置文件都会暴露一个 CDP (Chrome DevTools Protocol) 端点。连接 Playwright 或 Puppeteer 以在浏览器中实时观看的同时自动化控制该配置文件。 ``` from playwright.async_api import async_playwright async with async_playwright() as pw: browser = await pw.chromium.connect_over_cdp( "http://localhost:8080/api/profiles//cdp" ) page = browser.contexts[0].pages[0] await page.goto("https://example.com") ``` ``` const { chromium } = require("playwright"); const browser = await chromium.connectOverCDP( "http://localhost:8080/api/profiles//cdp" ); const page = browser.contexts()[0].pages()[0]; await page.goto("https://example.com"); ``` 当配置文件运行时，CDP URL 可在工具栏（代码图标）中找到。同一个浏览器会话既可以通过 VNC 进行可视化访问，也可以通过 API 进行编程访问。 ## 远程访问 该容器仅绑定到 localhost。要从远程服务器进行访问： ``` ssh -L 8080:localhost:8080 your-server ``` 然后打开 `http://localhost:8080`。 ## 身份验证 默认情况下，没有身份验证（非常适合本地使用）。要在托管于网络上时保护 Web UI 和 API，请设置 `AUTH_TOKEN` 环境变量： ``` docker run -p 8080:8080 -v cloakprofiles:/data -e AUTH_TOKEN=your-secret-token cloakhq/cloakbrowser-manager ``` 或在 `docker-compose.yml` 中设置： ``` environment: - AUTH_TOKEN=your-secret-token ``` 当设置了 `AUTH_TOKEN` 时： - Web UI 会显示一个登录页面。输入 token 即可解锁。 - API 使用者通过 `Authorization: Bearer ` 请求头传递 token。 - VNC WebSocket 连接通过登录 cookie 进行身份验证。 - `/api/status` 端点保持无需身份验证状态（用于 Docker 健康检查）。 ## 许可证 - **本应用程序**（GUI 源代码）— MIT。参见 [LICENSE](LICENSE)。 - **CloakBrowser 二进制文件**（编译后的 Chromium）— 免费使用，禁止重新分发。参见 [BINARY-LICENSE.md](BINARY-LICENSE.md)。 GUI 应用程序需要 CloakBrowser Chromium 二进制文件才能运行。该二进制文件会在首次启动时自动下载，并受其自身的许可证条款管辖。如果您派生或重新分发本应用程序，您的用户必须遵守 [CloakBrowser 二进制许可证](BINARY-LICENSE.md)。 ## 贡献 欢迎贡献。请先[开启一个 issue](https://github.com/CloakHQ/CloakBrowser-Manager/issues)，讨论您想要更改的内容。 ## 链接 - **CloakBrowser** — [github.com/CloakHQ/CloakBrowser](https://github.com/CloakHQ/CloakBrowser) - **网站** — [cloakbrowser.dev](https://cloakbrowser.dev) - **错误报告** — [GitHub Issues](https://github.com/CloakHQ/CloakBrowser-Manager/issues) - **联系方式** — cloakhq@pm.me

标签：AdsPower替代, Canvas伪装, Cookie隔离, GoLogin替代, IP 地址批量处理, WebGL伪装, 代理IP, 会话管理, 伪装指纹, 反检测浏览器, 多账号管理, 广告验证, 开源Multilogin替代, 指纹浏览器, 流量变现, 浏览器指纹管理, 浏览器隔离, 网络安全, 联盟营销, 自托管, 请求拦截, 跨境电商, 逆向工具, 配置审计, 隐私保护