内容
<div align="center">
# 🐱 阿笨猫指纹浏览器
**开源反检测指纹浏览器** — 多配置文件隔离，内置自动化HTTP API + MCP服务器，Windows / Linux，带头和无头。永久免费。
🌐 [browser.abencat.com](https://browser.abencat.com) ·
**语言：** 简体中文 · 日本語 · 한국어 · Русский · Español ·
Français · Deutsch
[](LICENSE)
[](https://github.com/abencat/abencat-browser/releases)
[](https://github.com/abencat/abencat-browser/stargazers)
[](https://browser.abencat.com)
[](https://browser.abencat.com)
</div>
---
> **指纹内核致谢：** 指纹隔离由 **[CloakBrowser](https://github.com/CloakHQ/CloakBrowser) © CloakHQ** 提供 — 一个具有源级指纹补丁的隐身Chromium内核。阿笨猫浏览器是一个围绕该内核的开源**控制器/启动器**。内核**不**在此仓库中重新分发；请使用下面的脚本下载。浏览器引擎的所有功劳归于CloakHQ。参见 [NOTICE](NOTICE)。
## ✨ 功能
- **指纹隔离** — Canvas / WebGL / Audio / Fonts / WebRTC，每个配置文件种子；通过CloakBrowser内核进行机器人检测。
- **自动化API** — 每次启动自动分配调试端口并返回CDP WebSocket；立即连接Puppeteer / Playwright / Selenium。
- **MCP服务器** — AI代理（Claude, Cursor, …）直接创建/启动/控制环境。参见 [AGENT_AUTOMATION.md](AGENT_AUTOMATION.md)。
- **代理池 + GeoIP** — 批量导入，健康检查，自动同步语言/时区/出口IP。
- **本地加密** — 代理密码和cookie静止加密（AES-256-GCM），可选Argon2id主密码。
- **跨平台和无头** — Windows桌面 + Linux服务器；按启动切换 headed/headless。
- **国际化** — 8种语言的UI（zh/en全 + ja/ko/ru/es/fr/de）。
## 📦 下载
所有下载文件都托管在 **[browser.abencat.com](https://browser.abencat.com)** 上（GitHub Release仅包含源代码存档）。
**完整包 — 包括浏览器内核，准备好运行（无需额外下载）：**
| 平台 | 下载 |
|---|---|
| 🪟 Windows x64 | [abencat-windows-x64-full.zip](https://browser.abencat.com/downloads/abencat-windows-x64-full.zip) (225 MB) — 解压并运行 `Abencat Browser.exe` |
| 🐧 Linux x86_64 | [abencat-linux-x64-full.tar.gz](https://browser.abencat.com/downloads/abencat-linux-x64-full.tar.gz) (210 MB) — 提取并运行 `./cloak-headless` |
**仅控制器 — 极小，首次运行时自动下载内核：**
| 平台 | 带头（GUI） | 无头（服务器） |
|---|---|---|
| Windows | [安装程序](https://browser.abencat.com/downloads/AbencatBrowser-0.1.0-x64-setup.exe) (5 MB) | [cloak-headless.exe](https://browser.abencat.com/downloads/abencat-headless-windows-x64.exe) |
| Linux x86_64 | 桌面构建（需要webkit2gtk）/ `xvfb-run` | [cloak-headless](https://browser.abencat.com/downloads/abencat-headless-linux-x64) |
> 指纹内核（独立）： [Windows zip](https://browser.abencat.com/downloads/cloakbrowser-windows-x64.zip) · [Linux tar.gz](https://browser.abencat.com/downloads/cloakbrowser-linux-x64.tar.gz)
## 🚀 快速开始
```bash
# 1) 获取CloakBrowser指纹内核（此仓库中不提供）
./scripts/download-browser.sh # Linux/macOS
# scripts\download-browser.ps1 # Windows (PowerShell)
# 2a) 桌面应用程序 — 只需运行安装程序/可执行文件。
# 2b) 无头服务器（Windows/Linux）
export CLOAKBROWSER_BINARY_PATH=/opt/cloakbrowser/chrome # 或使用脚本的输出
./cloak-headless
# → http://127.0.0.1:50327 + 一个令牌（打印一次）
```
📖 **逐步教程：** [让AI驱动反检测浏览器（MCP）](docs/tutorial-ai-automation.md) · [中文教程](docs/tutorial-ai-automation.zh-CN.md)
通过HTTP或MCP驱动它 — 完整指南见 **[AGENT_AUTOMATION.md](AGENT_AUTOMATION.md)**:
```bash
GET /api/v1/browser/start?id=<id>&headless=1&token=<token>
# → { "ws": "ws://127.0.0.1:42555/devtools/browser/...", "debuggerAddress": "127.0.0.1:42555" }
```
## 🛠 从源代码构建
```bash
# 前端 + 桌面应用程序（Windows/macOS/Linux桌面）
npm install
npm run tauri:build # → 安装程序在src-tauri/target/release/bundle下
# 无头服务器二进制文件（无Tauri/webkit，适用于Ubuntu服务器）
cd src-tauri
cargo build --release --bin cloak-headless --no-default-features
```
工具链：Rust（稳定版），Node ≥18。Linux桌面构建需要`libwebkit2gtk-4.1-dev`等 — 参见 [LINUX_HEADLESS.md](LINUX_HEADLESS.md)。
## 📂 布局
```
src-tauri/src/ Rust后端（模型，存储，加密，代理，启动，API，命令，…）
src/ React/TS前端（App.tsx，i18n.ts，组件/）
mcp/ MCP服务器（cloak-mcp.mjs）
website/ landing page（browser.abencat.com，8种语言）
docs/ 多语言README + 指南
scripts/ download-browser.{sh,ps1}
```
## 📜 许可证
[MIT](LICENSE) © 阿笨猫浏览器。 指纹内核 © CloakHQ ([CloakBrowser](https://github.com/CloakHQ/CloakBrowser))。
