Camofox-Browser

Camofox-Browser 是一款专为 AI Agent（AI智能体） 设计的隐身无头浏览器服务器，由 jo-inc 团队开发并开源。它基于 Camoufox——一个在 C++ 引擎层面进行指纹伪装的 Firefox 分支——构建而成。

简单来说，当你的 AI 智能体需要访问网页时，传统的 Puppeteer、Playwright 或 Headless Chrome 很容易被 Cloudflare、Google 等反机器人系统检测并拦截。Camofox-Browser 通过 C++ 级别的指纹伪造，在 JavaScript 执行之前就完成了对 navigator.hardwareConcurrency、WebGL 渲染器、AudioContext、屏幕几何尺寸、WebRTC 等浏览器指纹的伪装。网站看到的不是一个“机器人”，而是一个“真实的浏览器”。

该项目由 jo 个人 AI 助手背后的团队打造——jo 是一款半运行在 Mac、半运行在专属云端机器上的个人 AI，无需任何维护。

为什么 AI Agent 需要 Camofox-Browser？

核心功能亮点

🛡️ C++ 级反检测

绕过 Google、Cloudflare 及绝大多数机器人检测系统。指纹伪造发生在浏览器引擎层，而非 JavaScript 注入层，因此更难被检测。

🎯 稳定元素引用（Element Refs）

页面元素被标记为 e1、e2、e3 等稳定标识符，即使 DOM 结构发生变化，也能可靠地进行点击、输入等交互操作。

💰 Token 高效

使用可访问性快照（Accessibility Snapshot） 代替完整 HTML，Token 消耗减少约 90%，大幅降低 AI 模型的调用成本。

🔍 14 个内置搜索宏

内置 @google_search、@youtube_search、@amazon_search、@reddit_subreddit 等 14 个常用网站的搜索宏，AI 可直接调用。

👤 会话隔离与持久化

每个用户拥有独立的浏览器上下文，Cookie、localStorage 完全隔离。登录一次，重启后自动恢复登录态。

🌐 代理与 GeoIP 支持

支持通过住宅代理路由流量，并自动适配地区/时区设置。

🖥️ VNC 交互式登录

通过 noVNC 在浏览器中远程可视化操作网站，特别适合需要扫码登录的场景（如小红书、Boss直聘等）。

📦 多部署方式

支持 Docker、Fly.io、Railway 等多种部署方式，甚至可以在 Raspberry Pi 或 $5 VPS 上运行。

快速安装与使用教程

前置要求

• Node.js 环境
• 约 300MB 磁盘空间（用于首次下载 Camoufox 浏览器）

方式一：源码安装（推荐入门）

# 克隆项目
git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser

# 安装依赖
npm install

# 启动服务（首次运行会自动下载 Camoufox 浏览器，约 300MB）
npm start

# 服务默认运行在 http://localhost:9377

方式二：Docker 部署（推荐生产环境）

# 使用 Makefile（推荐，自动下载依赖）
make up

# 或使用 CI Dockerfile
docker build -f Dockerfile.ci -t camofox-browser .
docker run -d -p 9377:9377 camofox-browser

⚠️ 注意：不要直接运行默认的 docker build，默认 Dockerfile 需要预下载的 dist/ 目录。

与 AI Agent 集成（MCP 协议配置）

Camofox-Browser 通过 MCP（Model Context Protocol） 协议与各类 AI 智能体（如 OpenClaw、Hermes、Trae、Codex、Workbuddy 等）对接。

Trae 配置示例：

打开 Trae 设置 → MCP 配置，添加以下 JSON：

{
  "mcpServers": {
    "camofox-browser": {
      "command": "npx",
      "args": ["-y", "camofox-browser-mcp@latest"],
      "env": {
        "CAMOFOX_BASE_URL": "http://127.0.0.1:9377",
        "CAMOFOX_DEFAULT_USER_ID": "trae-agent"
      }
    }
  }
}

Workbuddy 配置：
侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」，填入相同的 JSON 配置。

配置成功后，AI 智能体可获得 42 个浏览器自动化工具，涵盖导航、交互、搜索、提取、下载等全流程操作。

CLI 命令行使用

Camofox-Browser 也提供了命令行工具，方便终端操作：

# 打开网页
camofox open https://example.com

# 获取页面快照
camofox snapshot

实战建议

1. 首次使用推荐 VNC 登录

对于 Boss直聘、小红书等需要登录的网站，建议首次使用 VNC 远程桌面 方式登录。通过浏览器远程可视化操作完成扫码或账号密码登录后，导出存储状态供后续 AI 复用。

2. 善用 Cookie 导入

如果已有 Netscape 格式的 Cookie 文件，可直接导入会话，避免重复登录。

3. 注意首次下载体积

首次启动会下载 Camoufox 浏览器（约 300MB），请确保网络通畅。

4. 生产环境启用结构化日志

Camofox-Browser 支持 JSON 格式的结构化日志，带有请求 ID，便于生产环境的问题追踪和可观测性。

5. 按需启用会话追踪

可选的每会话 Playwright 追踪功能（含截图、DOM 快照、网络请求），便于调试复杂交互场景。

6. 资源占用优化

Camofox-Browser 采用懒加载浏览器启动 + 空闲自动关闭机制，空闲时内存占用仅约 40MB，非常适合与其它服务共享服务器资源。

总结

Camofox-Browser 是目前 AI Agent 领域最具竞争力的反检测浏览器解决方案之一。它通过在 C++ 引擎层进行指纹伪装，从根本上解决了传统浏览器自动化工具容易被检测的痛点。配合 MCP 协议的标准化集成方式，可以无缝接入各类 AI 智能体工作流。

无论你是正在构建 AI 助手、数据采集系统，还是需要让 AI 自动化操作各类 Web 应用，Camofox-Browser 都值得纳入你的技术栈。