camofox-browser
SHA-256隐身无头浏览器，为 AI 代理设计。基于 Camoufox，在 C++ 层伪装指纹，轻松绕过 Cloudflare 等反爬检测，内存占用仅 ~40MB。
AI 代理专用隐身浏览器，指纹伪装在底层，绕过反爬基本靠它。
核心功能
- C++ 层指纹伪装：绕过 Google、Cloudflare 等大多数机器人检测
- 节省 Token：可访问性快照比原始 HTML 小约 90%
- 稳定元素引用（e1/e2/e3）：点击、输入更可靠
- 低资源占用：空闲约 40MB，可跑树莓派或 5 美元 VPS
- 会话隔离与 Cookie 导入：免登录浏览 LinkedIn、Amazon 等
避坑指南
- •首次启动需下载约 300MB 的 Camoufox，耗时较久。不要直接 docker build，务必使用 make up 或脚本先下载二进制。若在本地已安装 yt-dlp 可加速 YouTube 字幕提取，无 yt-dlp 时回退到浏览器方法较慢。若出现二进制下载被跳过导致崩溃，请参考 README 中 PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD 变量说明。
适用场景
- AI 代理执行需要登录或易被屏蔽的网站自动化任务
- 开发者构建网页抓取工具，替代易被检测的 Playwright/无头 Chrome
详细介绍
camofox-browser 是为 AI 代理和网页自动化打造的隐身无头浏览器服务。与使用 stealth 插件的 Playwright/Puppeteer 不同——后者容易被指纹识别——Camoufox 在 C++ 层直接修补 Firefox，在 JavaScript 能看到之前就伪装了 navigator.hardwareConcurrency、WebGL 渲染器、AudioContext、屏幕几何和 WebRTC 等指纹信息，能有效绕过 Google、Cloudflare 及大多数机器人检测。项目将该引擎封装为 REST API，专为代理流程优化：可访问性快照比原始 HTML 小约 90%，稳定的元素引用（e1/e2/e3）用于可靠点击和输入，会话隔离、Cookie 导入、代理与 GeoIP 支持、YouTube 字幕提取、常用站点搜索宏等。运行内存仅约 40MB，可跑在树莓派或 5 美元 VPS 上，支持 Docker 部署、VNC 可视化登录、JSON Schema 结构化提取。相比 stealth 插件，它更简单也更安全。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
克隆仓库：git clone https://github.com/jo-inc/camofox-browser
安装依赖并启动：npm install && npm start（首次自动下载 Camoufox 约 300MB）
浏览器访问 http://localhost:9377 使用 API 或查看交互文档
- 克隆仓库：git clone https://github.com/jo-inc/camofox-browser
- 安装依赖并启动：npm install && npm start（首次自动下载 Camoufox 约 300MB）
- 浏览器访问 http://localhost:9377 使用 API 或查看交互文档
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
5720d45b894ce1770543de024c6f10d514b38be560fa2dc3226b3d8586caf672该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除项目目录即可完全移除。若想清理 Camoufox 浏览器缓存和下载的二进制，可手动删除用户目录下的 ~/.cache/camoufox 和 ~/.cache/ms-playwright 相关文件夹。
无额外依赖
下载后即可直接使用，无需安装其他运行环境