camofox-browser

环境要求

• Docker（用于运行 camofox-browser 容器镜像）
• 一个自行生成的 CAMOFOX_API_KEY 密钥用于接口鉴权
• 可选：Railway CLI（部署到 Railway）
• 可选：Fly.io CLI（部署到 Fly.io）

安装与启动步骤

1. 1准备服务密钥

   按 README 的 Setup 章节先生成一个密钥，用于后续所有接口的 Bearer 鉴权；节选中该命令未完整给出，请以仓库文档为准。

2. 2启动 Docker 容器

   映射 9377 端口，通过环境变量注入密钥，并把本机 cookies 目录只读挂载进容器以复用登录态。

   docker run -p 9377:9377 -e CAMOFOX_API_KEY="your-generated-key" -v ~/.camofox/cookies:/home/node/.camofox/cookies:ro camofox-browser

   复制

3. 3调用接口验证

   用 curl 向会话的 cookies 接口发一次请求，验证服务已起来且密钥生效；被拒绝说明密钥不匹配。

   curl -X POST http://localhost:9377/sessions/agent1/cookies -H 'Content-Type: application/json' -H 'Authorization: Bearer YOUR_CAMOFOX_API_KEY' -d '{"cookies":[{"name":"foo","value":"bar","domain":"example.com","path":"/","expires":-1,"httpOnly":false,"secure":false}]}'

   复制

4. 4调整浏览器配置

   在 camofox.config.json 中设置 newPageTimeoutMs，控制新建标签页等待 Firefox 的超时时间，默认 10 秒。

5. 5部署到 Railway

   用 Railway CLI 关联并上传项目，再通过变量命令设置 API 密钥；密钥也可在 Railway 面板中设置。

   railway link
   railway up
   railway variables set CAMOFOX_API_KEY="your-generated-key"

   复制

6. 6部署到 Fly.io

   在 Fly.io 上以密钥形式写入 CAMOFOX_API_KEY，避免明文出现在配置文件中。

   fly secrets set CAMOFOX_API_KEY="your-generated-key"

   复制

7. 7关闭遥测上报

   不需要崩溃上报时，把 CAMOFOX_CRASH_REPORT_ENABLED 设为 false；也可用 CAMOFOX_CRASH_REPORT_URL 指向自建端点。

   CAMOFOX_CRASH_REPORT_ENABLED=false

   复制

关键配置

如何确认成功

curl 带 Authorization: Bearer 密钥请求 http://localhost:9377/sessions/agent1/cookies，能正常返回即启动成功。

常见问题

注意事项

• README 节选中密钥生成命令被截断，未给出可复制命令，请以仓库 Setup 章节为准。
• CAMOFOX_API_KEY 属敏感信息，建议用平台 secret 或环境变量注入，不要提交到代码仓库。
• 服务会拉起 Camoufox 浏览器引擎子进程，YouTube 字幕提取时还会拉起 yt-dlp，属正常行为。
• 官方遥测端点可自行校验部署代码哈希，与仓库不一致说明运行的不是当前代码。