camofox-browser

Camofox Browser - 反检测浏览器自动化

通过 Camoufox（Firefox 分支）实现隐蔽的浏览器自动化。C++ 层级的指纹伪装，可绕过基于 JavaScript 的机器人检测。使用 curl 封装的 REST API。

安装

首次使用时会自动下载并安装 Camoufox 浏览器（约 300MB，仅需一次）。无需手动设置，只需运行任意 camofox 命令。

快速开始

camofox open https://example.com          # Open URL (auto-starts server)
camofox snapshot                          # Get page elements with @refs
camofox click @e1                         # Click element
camofox type @e2 "hello"                  # Type text
camofox screenshot                        # Take screenshot
camofox close                             # Close tab

核心工作流

1. 导航：camofox open <url> — 打开标签页并导航
2. 快照：camofox snapshot — 返回包含 @e1、@e2 引用的无障碍树
3. 交互：使用引用进行点击、输入和选择
4. 重新获取快照：导航或 DOM 发生变化后，获取新的引用
5. 重复操作：服务会在各命令之间持续运行

camofox open https://example.com/login
camofox snapshot
# @e1 [input] Email  @e2 [input] Password  @e3 [button] Sign In

camofox type @e1 "[email protected]"
camofox type @e2 "password123"
camofox click @e3
camofox snapshot  # Re-snapshot after navigation

命令

导航

camofox open <url>                   # Create tab + navigate (aliases: goto)
camofox navigate <url>               # Navigate current tab
camofox back                         # Go back
camofox forward                      # Go forward
camofox refresh                      # Reload page
camofox scroll down                  # Scroll down (also: up, left, right)

页面状态

camofox snapshot                     # Accessibility snapshot with @refs
camofox screenshot                   # Screenshot to /tmp/camofox-screenshots/
camofox screenshot output.png        # Screenshot to specific path
camofox tabs                         # List all open tabs

交互（使用快照中的 @ 引用）

camofox click @e1                    # Click element
camofox type @e1 "text"              # Type into element

搜索宏

camofox search google "query"        # Google search
camofox search youtube "query"       # YouTube search
camofox search amazon "query"        # Amazon search
camofox search reddit "query"        # Reddit search

提供 13 个宏，详见 references/macros-and-search.md。

会话管理

camofox --session work open <url>    # Isolated session
camofox --session work snapshot      # Use specific session
camofox close                        # Close current tab
camofox close-all                    # Close all tabs in session

服务控制

camofox start                        # Start server (usually auto)
camofox stop                         # Stop server
camofox health                       # Health check

引用生命周期（重要）

页面发生变化时，引用（@e1、@e2）会失效。以下操作后务必重新获取快照：

• 点击会触发导航的链接或按钮
• 提交表单
• 动态内容加载

camofox click @e3                    # Navigates to new page
camofox snapshot                     # MUST re-snapshot
camofox click @e1                    # Use new refs

何时使用 camofox-browser，而非 agent-browser

场景	工具
普通网站，无机器人检测	agent-browser（速度更快）
受 Cloudflare / Akamai 保护	camofox-browser
会拦截 Chromium 自动化的网站	camofox-browser
需要反指纹检测	camofox-browser
需要模拟 iOS / 移动设备	agent-browser
需要录制视频	agent-browser

反检测能力

• C++ 层级的指纹伪装（canvas、WebGL、AudioContext、字体）
• 基于 Firefox（而非 Chromium，检测面不同）
• 类似人类的交互时序（humanize 参数）
• 防止 WebRTC 泄漏
• 不带 navigator.webdriver 标记

详情请参阅 references/anti-detection.md。

环境变量

变量	默认值	说明
CAMOFOX_PORT	9377	服务端口
CAMOFOX_SESSION	default	默认会话名称
CAMOFOX_HEADLESS	true	无头模式
HTTPS_PROXY	—	代理服务

深入文档

参考文档	使用场景
references/api-reference.md	完整的 REST API 端点文档
references/anti-detection.md	指纹伪装详情
references/macros-and-search.md	13 个搜索宏

开箱即用的模板

模板	说明
templates/stealth-scrape.sh	反检测抓取工作流
templates/multi-session.sh	多会话隔离

故障排除

服务无法启动？

camofox health                        # Check if running
camofox stop && camofox start         # Restart

仍然被拦截？

# Enable proxy
HTTPS_PROXY=socks5://127.0.0.1:1080 camofox open <url>

机器人检测测试：

camofox open https://bot.sannysoft.com/
camofox screenshot bot-test.png

清理

完成后务必关闭：

camofox close-all
camofox stop