deploy.stack/camofox

Camofox 部署

反检测浏览器服务，Hermes browser 工具后端（Camoufox 引擎，C++ 层指纹伪装）。 镜像 redf0x1/camofox-browser（2.4.7）预装引擎与版本元数据，零下载直跑。

快速开始

cp env.cfg.example env.cfg          # 按需配置（默认 disabled 认证即可用）
docker compose -p camofox --env-file ./env.cfg -f ./stack.yml up -d
docker compose -p camofox --env-file ./env.cfg -f ./stack.yml ps             # 期望 healthy
curl -s http://localhost:9377/health
# {"ok":true,"running":true,"engine":"camoufox","version":"2.4.7",...}

从 docker run 容器迁移（本次部署场景）

之前直接 docker run 跑过同名容器，切换到 compose：

docker rm -f camofox                 # 删掉旧容器（卷 camofox-data 保留复用）
docker compose -p camofox --env-file ./env.cfg -f ./stack.yml up -d

Hermes 接入（已配置，无需改动）

~/.hermes/.env 已有 CAMOFOX_URL=http://localhost:9377，browser 工具自动走 camofox。 验证：Hermes 中调用 browser 工具 → camofox 容器日志出现 /tabs 请求、health 中 browserConnected 变 true。

代理（可选，治境外站加载挂死 / 提升反检测）

编辑 env.cfg 取消注释并填值：

PROXY_HOST=<代理IP或域名>
PROXY_PORT=<端口>
PROXY_USERNAME=<可选>
PROXY_PASSWORD=<可选>
CAMOFOX_ALLOW_PRIVATE_NETWORK=true   # 必须 true，否则服务拒绝启动

然后重建容器：

docker compose -p camofox --env-file ./env.cfg -f ./stack.yml up -d

代理是引擎级（Camoufox context proxy），页面所有流量走代理；支持 http 与 socks5 格式。 住宅/家宽 IP 代理能显著提高 Cloudflare 等验证码通过率（数据中心 IP 天然低信任）。

常见问题

现象	处理
启动即退	容器内 CAMOFOX_HOST 必须 0.0.0.0（默认 127.0.0.1 映射不通）；AUTH disabled 时不能设 CAMOFOX_API_KEY
启用代理后拒启	需 CAMOFOX_ALLOW_PRIVATE_NETWORK=true
重型境外页 30s 超时	直连资源慢/挂；配代理；或换轻量目标
端口被占用	修改 stack.yml 端口映射 + env.cfg 中 CAMOFOX_PORT 同步对齐

目录

camofox/
├── stack.yml              # Docker Compose 编排
├── env.cfg.example        # 变量模板 → 复制为 env.cfg
├── readme.md
└── env.cfg                # 真实变量（gitignore，部署时手工创建）

数据持久化：docker managed named volume camofox-data 挂载到 /home/node/.camofox （profiles、引擎缓存、cookie）。复用旧 docker run 创建的同名卷；全新部署可改为 bind mount 到 ${Volumes_Path}。