Camoufox:Firefox C++ 伪装开源反检测浏览器
在构建现代自动化测试、数据采集或 AI Browser Agent 时,传统基于 JavaScript 注入改写属性、或通过 Chromium CDP 协议驱动的无头浏览器,往往会在几毫秒内被现代反机器人系统识别——无论是 toString() 原型链异常、Worker / iframe 指纹不一致,还是 CDP 绑定残留与异常的 Canvas 噪点,都可能暴露自动化身份。
在 GitHub 上斩获 13,400+ Star、采用 MPL-2.0 协议开源的 daijro/camoufox,选择了一条更彻底的技术路线:直接对 Firefox 源码进行 C++ 层级补丁编译,结合隔离世界的 Juggler 协议与真实设备分布指纹生成器,让目标网页看到的始终是原生、一致且无自动化痕迹的浏览器行为。
🌟 核心架构与亮点:从底层抹除自动化特征
┌────────────────────────────────────────────────────────────────────────┐
│ Camoufox 核心工作链路 │
├──────────────────┬──────────────────┬──────────────────┬───────────────┤
│ Python / TS 启动器│ 真实指纹与一致性 │ Patched Firefox │ 隔离自动化层 │
│ • fpgen 设备抽取 │ • coherence 校验 │ • C++ MaskConfig │ • Juggler 隔离│
│ • GeoIP 出口对齐 │ • 字体/GPU/音频 │ • 原生 API 响应 │ • 页面不可见 │
│ • NewContext隔离 │ • 拒绝矛盾组合 │ • 无 JS 劫持痕迹 │ • myuri 拟人 │
└──────────────────┴──────────────────┴──────────────────┴───────────────┘
1. C++ 底层原生伪装,告别 JS 注入“露馅”
与常见插件或脚本在页面世界中覆盖 Object.defineProperty 不同,Camoufox 通过 CAMOU_CONFIG 环境变量将身份配置注入浏览器内核,由 C++ 补丁(MaskConfig) 直接应答 Web API:
- 全链路一致覆盖:涵盖 Navigator(UA、平台、CPU 核心数、语言)、HTTP 请求头、屏幕/窗口尺寸与 CSS 媒体查询、WebGL / WebGL2 / WebGPU、CPU 算术微架构差异(Intel / AMD / ARM64)、音频硬件参数、内置真实字体集、语音合成列表与媒体设备;
- 主线程与 Worker 一致:无论主文档、iframe 还是 Web Worker,获取到的属性完全一致且原型链原生;
- 克制的“零噪点”哲学:对 Canvas 像素、字体宽度与音频渲染遵循原生 Firefox 逻辑(宿主机同系统 + GPU 渲染下不随意注入易被识别为反指纹插件的异常噪点),避免“过度伪装反成指纹”。
2. fpgen 真实设备分布 + 一致性校验 + 单浏览器多身份
- 拒绝拼凑假指纹:启动器(Python 与 TypeScript 双端共享同一套定义)基于
fpgen/fpgen-js从真实互联网流量分布抽取设备画像,并经过coherence.py严格筛查,剔除现实中不存在的硬件与系统矛盾组合; - 代理与 GeoIP 一键对齐:传入
proxy并开启geoip=True(内置 GeoIP All-in-One),自动根据代理出口 IP 匹配时区、语言区域、经纬度以及 WebRTC IP(支持 SOCKS5 代理下的 WebRTC UDP 中继防泄漏); - 单进程多上下文隔离:通过
NewContext()可在同一个浏览器实例中为不同任务分配完全独立的操作系统身份、指纹与代理配置。
3. 对网页不可见的 Playwright 驱动与拟人交互
- Juggler 隔离世界:Playwright 通过 Firefox 独立的 Juggler 协议驱动,脚本求值、选择器与初始化脚本均在隔离世界运行,页面端看不到自动化绑定或调用栈泄露,
navigator.webdriver为false; - 原生事件与拟人输入:浏览器内保持原生可信事件派发(粘贴、滚轮刻度、拖拽、快捷键),并可在驱动层按需开启
humanize=True(集成myuri拟人轨迹与键入模型); - 轻量去臃肿与隐私增强:编译期剥离 Mozilla 遥测与后台上报,默认捆绑开箱即用的 uBlock Origin(如
v159.0-beta.42集成 uBO 1.75.4),同时支持 Linux 下的headless="virtual"(Xvfb)与headless="virtual-gpu"模式。
🛠️ 快速上手(Python & TypeScript)
Camoufox 返回的是标准 Playwright Browser / BrowserContext 对象,现有 Playwright 脚本几乎只需替换启动入口即可无缝迁移。
Python 安装与示例
pip install -U "camoufox[geoip]"
camoufox fetch
from camoufox.sync_api import Camoufox, NewContext
# 基础用法:自动生成一致的设备指纹
with Camoufox(headless=True) as browser:
page = browser.new_page()
page.goto("https://example.com")
# 进阶用法:搭配代理自动对齐 GeoIP,并在单浏览器内隔离多套身份
with Camoufox(headless=True, geoip=True, humanize=True) as browser:
ctx = NewContext(
browser,
os="windows",
proxy={"server": "http://proxy.example.com:8080", "username": "user", "password": "pass"},
)
page = ctx.new_page()
page.goto("https://example.com")
TypeScript / Node.js 安装与示例(需 Node.js ≥ 22.15)
npm install camoufox playwright-core
npx camoufox fetch
import { Camoufox } from "camoufox";
const browser = await Camoufox({
headless: true,
proxy: { server: "http://proxy.example.com:8080", username: "user", password: "pass" },
geoip: true,
});
const page = await browser.newPage();
await page.goto("https://example.com");
await browser.close();
⚡ 为什么需要 GH-Proxy?1.25 GB 内核包高速加速下载
由于 Camoufox 的每个预编译浏览器压缩包都内置了完整的跨平台真实字体库与定制 Firefox 内核,单个 Release 文件体积高达 1.24 GB – 1.27 GB。在网络环境受限时,直接从 GitHub Releases 下载或执行 camoufox fetch 很容易超时断流。
通过下方 GH-Proxy 链接即可高速获取官方构建包与源码:
🚀 强烈推荐:通过 GH-Proxy 主站一键解析所有平台发行包
👉 点击直达 GH-Proxy 智能解析 Camoufox 最新 Release
👉 直达v159.0-beta.42(Firefox 159 最新预览版)解析页
👉 直达v158.0.1-beta.41(最新常规发布版)解析页
📦 v159.0-beta.42(Firefox 159 内核)全平台高速加速直链
- Windows (x86_64,1267.0 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v159.0-beta.42/camoufox-159.0-beta.42-win.x86_64.zip - macOS Apple Silicon (arm64,1243.7 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v159.0-beta.42/camoufox-159.0-beta.42-mac.arm64.zip - macOS Intel (x86_64,1251.3 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v159.0-beta.42/camoufox-159.0-beta.42-mac.x86_64.zip - Linux (x86_64,1252.8 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v159.0-beta.42/camoufox-159.0-beta.42-lin.x86_64.zip - Linux (arm64,1245.6 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v159.0-beta.42/camoufox-159.0-beta.42-lin.arm64.zip
📦 v158.0.1-beta.41(最新常规发布版)常用平台直链
- Linux (x86_64,1243.2 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v158.0.1-beta.41/camoufox-158.0.1-beta.41-lin.x86_64.zip - Windows (x86_64,1258.9 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v158.0.1-beta.41/camoufox-158.0.1-beta.41-win.x86_64.zip - macOS Apple Silicon (arm64,1237.6 MB):
https://gh-proxy.org/https://github.com/daijro/camoufox/releases/download/v158.0.1-beta.41/camoufox-158.0.1-beta.41-mac.arm64.zip
💻 极速克隆源码仓库
git clone https://gh-proxy.org/https://github.com/daijro/camoufox.git
💡 使用与部署建议
- 项目迭代活跃度提示:官方 README 明确提示项目仍在快速演进中(版本号紧跟 Firefox 迭代,如
v158/v159),生产环境建议通过camoufox list/camoufox set锁定经过验证的内核版本。 - 注意内核引擎边界:Camoufox 仅模拟真实 Firefox 身份(SpiderMonkey 引擎),无法也不会伪装成 Chromium;请结合实际目标站点特性合理选型。
- 配合高质量代理与合规使用:浏览器指纹只是反检测的一环,出口 IP 质量同样关键;请务必遵守目标网站的
robots.txt与相关法律法规,仅用于授权测试、学术研究与合规自动化场景。
- GitHub 官方仓库:https://github.com/daijro/camoufox
- 官方文档站点:https://camoufox.com
- 🚀 GH-Proxy 最新版智能解析下载:https://gh-proxy.com/#https://github.com/daijro/camoufox
- GH-Proxy 镜像加速主站:https://gh-proxy.com