forked from DevOps/deploy.stack
cnphpbb
5c5834d576
- 新增 stack.yml 编排、env.cfg.example 模板、readme.md 文档 - 支持认证模式、代理配置、健康检查 - 复用旧 docker run 容器的命名卷 camofox-data
72 lines
2.7 KiB
Markdown
72 lines
2.7 KiB
Markdown
# Camofox 部署
|
||
|
||
反检测浏览器服务，Hermes browser 工具后端（Camoufox 引擎，C++ 层指纹伪装）。
|
||
镜像 `redf0x1/camofox-browser`（`2.4.7`）预装引擎与版本元数据，零下载直跑。
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
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：
|
||
|
||
```bash
|
||
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` 取消注释并填值：
|
||
|
||
```cfg
|
||
PROXY_HOST=<代理IP或域名>
|
||
PROXY_PORT=<端口>
|
||
PROXY_USERNAME=<可选>
|
||
PROXY_PASSWORD=<可选>
|
||
CAMOFOX_ALLOW_PRIVATE_NETWORK=true # 必须 true，否则服务拒绝启动
|
||
```
|
||
|
||
然后重建容器：
|
||
|
||
```bash
|
||
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}`。 |