
如何用 npx 一键启动 camofox-browser最快上手指南【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browsercamofox-browser 是一款面向 AI 智能体的隐身无头浏览器服务器Stealth headless browser能绕过 Cloudflare、机器人检测与反爬机制是 Puppeteer/Playwright 的即插即用替代品。本指南教你用npx 一条命令完成启动从环境准备到服务验证几分钟内跑通。camofox-browser 是什么给 AI 智能体配的隐身浏览器普通无头浏览器Headless Chrome / Playwright很容易被网站指纹识别成机器人而 camofox-browser 基于Camoufox一个在 C 层面做了指纹伪装的 Firefox 分支在 JavaScript 执行前就替换了硬件参数、WebGL 渲染器、屏幕几何等信息因此能稳定绕过 Google、Cloudflare 等主流检测。它把这套引擎封装成了REST API 服务器核心亮点包括特性说明️ C 级反检测指纹在浏览器内核层伪造无 JS 注入痕迹 元素引用稳定e1、e2标识符点击/输入更可靠 省内存空闲时内存约 40MB树莓派、$5 VPS 都能跑 Token 高效可访问性快照比原始 HTML 小约 90% 搜索宏google_search、youtube_search等 14 个开箱即用启动前准备确认已安装 Node.js 22camofox-browser 要求Node.js 22见 package.json 的engines字段。运行以下命令检查版本node -v版本满足 22直接进入下一步版本过低先升级 Node.js 再继续本文不再赘述升级方法npx 一键启动 camofox-browser核心步骤只需在终端执行一条命令npx 会自动拉取 npm 包 npx askjo/camofox-browser 并启动服务器npx askjo/camofox-browser首次启动时请注意两点自动下载浏览器内核安装阶段会自动下载约300MB的 Camoufox 二进制文件由 scripts/postinstall.js 触发请耐心等待之后即为缓存默认端口 9377服务启动后监听http://localhost:9377。启动后验证三步确认服务已就绪第 1 步健康检查curl http://localhost:9377/health返回正常状态即表示服务器已运行。第 2 步打开交互式 API 文档在浏览器访问http://localhost:9377/docs可在线浏览所有接口规范文件见仓库根目录的 openapi.json也可查看静态文档 docs/api.html。第 3 步发起一次真实浏览# 创建标签页并打开页面 curl -X POST http://localhost:9377/tabs \ -H Content-Type: application/json \ -d {userId: agent1, sessionKey: task1, url: https://example.com} # 获取带元素引用的可访问性快照 curl http://localhost:9377/tabs/TAB_ID/snapshot?userIdagent1 # - { snapshot: [button e1] Submit [link e2] Learn more, ... }看到快照内容说明 camofox-browser 已完全跑通 ✅常用配置启动时环境变量速查表所有环境变量统一收敛在 lib/config.js 中读取最常用的几项如下变量作用默认值CAMOFOX_PORT修改服务端口9377CAMOFOX_ACCESS_KEY全局 Bearer 鉴钥部署到非本机必设-CAMOFOX_API_KEY启用 Cookie 导入接口不设置则 403-BROWSER_IDLE_TIMEOUT_MS浏览器空闲自动关闭省内存3000005 分钟MAX_SESSIONS最大并发会话数50示例换个端口并开启鉴权启动CAMOFOX_PORT8080 CAMOFOX_ACCESS_KEYmy-secret npx askjo/camofox-browser 除环境变量外还可以编辑 camofox.config.json 调整浏览器行为如newPageTimeoutMs。替代方式从源码启动git clone需要看源码或参与开发时可克隆仓库后本地运行git clone https://gitcode.com/GitHub_Trending/ca/camofox-browser cd camofox-browser npm install # 首次运行会自动下载 Camoufox 内核 npm start # 等价于 node server.js服务器主入口为 server.js完整的 API 列表与部署方式Docker、Fly.io、Railway详见 README.md容器化部署可参考 Dockerfile 和 Makefile。常见问题排查启动失败先看这里❓ 端口 9377 被占用用CAMOFOX_PORT8080换端口即可。❓ 启动即崩溃提示浏览器不存在常见于环境里导出了PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD1导致内核下载被静默跳过。安装脚本会针对自身清除该变量见 scripts/postinstall.js若已有自定义 Camoufox 可执行文件可通过CAMOUFOX_EXECUTABLE/path/to/camoufox-bin指定完全跳过下载。❓ 内存不足小 VPS / 树莓派Node 默认 V8 堆上限为 128MBMAX_OLD_SPACE_SIZE一般无需干预空闲 5 分钟后浏览器进程会自动退出释放资源。❓ 如何确认自己装的版本运行npm start -- -v或直接查看 package.json 中的version字段最新版变更历史可参考 changelog/1.4.0.md。总结步骤命令/操作1. 检查环境node -v需 222. 一键启动npx askjo/camofox-browser3. 验证服务curl http://localhost:9377/health4. 开始使用访问http://localhost:9377/docs查看 API至此你的 AI 智能体已经拥有一台能绕过 Cloudflare 的隐身浏览器服务器。下一步建议用搜索宏google_search跑一次真实任务体验 token 友好的快照式页面读取 【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browser创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考