camofox-browser健康检查与启停API/health、/start、/stop实战指南【免费下载链接】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 Agent 的隐身无头浏览器基于 Camoufox 引擎内置一套极简的运维接口/health健康检查、/start启动浏览器引擎、/stop停止浏览器引擎。本文带你快速搞懂这三个 REST API 的返回含义、鉴权方式和实战调用技巧几分钟即可把 camofox-browser 接进你的监控系统与自动化流程。 /health 健康检查3 种状态一次看懂/health是 GET 接口无需任何鉴权因此特别适合做 Docker 健康检查或负载均衡探活在 lib/auth.js 的中间件里它是全局CAMOFOX_ACCESS_KEY鉴权的白名单。它并不只是活着/没活着的二元判断而是有精细的状态语义实现见 server.js状态HTTP 状态码含义典型返回✅ 正常200服务可用浏览器运行中或处于计划内停止{ok:true,engine:camoufox,browserRunning:true,...}⚠️ 意外不健康503浏览器意外消失断连、内存压力等已自动触发后台重启{ok:false,browserRunning:false,reason:browser_disconnected} 恢复中503浏览器正在重启恢复过程中{ok:false,engine:camoufox,recovering:true}200 里有个小细节区分主动停与意外死camofox-browser 的浏览器是懒启动 空闲自动关机的5 分钟无会话后浏览器进程自动退出空闲内存仅约 40MB。所以浏览器没在跑不等于服务坏了。主动停止idle_shutdown空闲关机、admin_stop管理员停止→ 返回200服务依然健康意外停止browser_disconnected、memory_pressure、browser_rss_pressure等→ 返回503并附带reason字段同时自动调度后台热重试见 tests/unit/healthSemantics.test.js 中对全部状态语义的覆盖。另外/health请求默认不会写入请求日志避免探活流量刷屏server.js。实战curl 探测 判断退出码curl -s http://localhost:9377/health # 200: {ok:true,engine:camoufox,browserConnected:true,activeTabs:0,activeSessions:0,memory:{rssMb:...}} # 脚本里判断健康与否503 时退出码非 0 curl -sf http://localhost:9377/health /dev/null echo OK || echo DOWN /start 启动引擎幂等、免参数的点火键POST /start的作用只有一件事确保浏览器引擎正在运行server.js。它调用内部的ensureBrowser()server.js这个函数非常聪明浏览器已在跑 → 直接返回幂等随便重复调用不会出错浏览器已死掉断连→ 先清理僵尸会话再重新拉起从未启动 → 发起单飞启动single-flight并发请求不会拉起多个实例启动超过 60 秒超时 → 返回 500。成功返回curl -X POST http://localhost:9377/start # 200: {ok:true,profile:camoufox}适用场景冷启动预热比如部署完成后先热一下引擎避免第一个真实请求等待启动、定时任务唤醒、故障后手动恢复。 其实你甚至可以不手动/start——任何打开 tab 的请求都会自动懒启动浏览器。/start的价值在于给你一个显式的、可脚本化的控制点。 /stop 停止引擎需要管理员密钥的安全闸POST /stop会关闭全部会话 完整终止浏览器进程树清理临时 Firefox profile、强制回收残留进程实现见 server.js。⚠️ 安全要点x-admin-key 鉴权/stop是独立的危险操作面必须在请求头携带x-admin-key且服务器端要通过环境变量CAMOFOX_ADMIN_KEY配置了同一个密钥否则一律返回 403README.md 环境变量表# 先配置密钥再启动服务 export CAMOFOX_ADMIN_KEYyour-secret-key npm start # 调用 /stop curl -X POST http://localhost:9377/stop -H x-admin-key: your-secret-key # 200: {ok:true,stopped:true,profile:camoufox}三个密钥各管一段互不重叠CAMOFOX_ACCESS_KEY管普通路由、CAMOFOX_API_KEY管 Cookie 导入、CAMOFOX_ADMIN_KEY管/stop——这是 camofox-browser 安全模型里每个密钥守一个面的设计见 lib/auth.js。 实战速查表接口方法鉴权典型用途/healthGET无Docker 健康检查、监控探活/startPOST可选CAMOFOX_ACCESS_KEY冷启动预热、脚本化唤醒/stopPOST必须x-admin-key维护窗口、资源回收配套环境变量完整清单见 README.mdCAMOFOX_PORT默认9377—— 三个接口的端口BROWSER_IDLE_TIMEOUT_MS默认 5 分钟—— 空闲多久后自动关机关机后/health依然是 200CAMOFOX_ADMIN_KEY——/stop的管理员密钥。一个典型运维脚本BASEhttp://localhost:9377 # 1. 部署后探活 curl -sf $BASE/health || { echo 服务未就绪; exit 1; } # 2. 预热浏览器 curl -sf -X POST $BASE/start # 3. 维护时优雅关停 curl -sf -X POST $BASE/stop -H x-admin-key: $CAMOFOX_ADMIN_KEY 延伸阅读API 全量定义openapi.json服务运行后也可访问/docs查看交互式文档路由实现server.js鉴权中间件lib/auth.js健康语义测试tests/unit/healthSemantics.test.js配置项参考camofox.config.json掌握这三个接口你就拥有了 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-browser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
