🐳 Docker 自部署

• Docker 24.0+ 和 docker compose v2
• amd64 / arm64 任一架构
• 能访问公网（拉镜像 + 连云端 + 摄像头 RTSP）
• 建议 ≥ 2 GB 内存、≥ 5 GB 磁盘（视频本地缓存 + 模型）

先在 NannyCam Cloud 注册账号、创建设备，拿到 DEVICE_TOKEN：

1. 访问 app.forward.hi.cn 注册（需要邀请码）
2. 登录后进入「设备」页面，点「+ 配对新设备」获取一个一次性配对码
3. 在第 4 步运行容器后，agent 会用这个配对码换取持久 DEVICE_TOKEN

镜像在阿里云 ACR 上，公开仓库，无需登录：

复制docker pull crpi-icjev8u6crgnh4f8.cn-shanghai.personal.cr.aliyuncs.com/nannycam/agent:latest

下载 docker-compose 模板和 .env 示例：

复制mkdir nannycam && cd nannycam
curl -O https://app.forward.hi.cn/docker-compose.yml
curl -O https://app.forward.hi.cn/.env.example
mv .env.example .env

用编辑器打开 .env，至少填这几个：

复制# 必填 — 摄像头 RTSP 地址（带 user/pass）
CAMERA_NURSERY_CRIB="rtsp://admin:你的密码@192.168.x.x:554/Streaming/Channels/101"

# 必填 — 配对一次性码（来自第 2 步），首次启动后会被换成 DEVICE_TOKEN
PAIR_CODE="XXXXXX"

# 必填 — 云端地址（默认就这个）
CLOUD_URL="https://app.forward.hi.cn"

# 可选 — 自定义数据目录、端口等
# DATA_DIR=/data/nannycam
# WEB_PORT=8088

复制docker compose up -d
docker compose logs -f agent

看到 Audio pipeline started + Cloud heartbeat OK 就成功了。回到 app.forward.hi.cn 的「设备」页面，会看到这台 agent 状态变绿。

更新到最新镜像：

复制docker compose pull
docker compose up -d

卸载：

复制docker compose down -v   # -v 同时删除挂载卷（数据库 / 录像 / 配置）

镜像 pull 401 / 403？ 检查网络是不是通阿里云 ACR（公网正常都通）。
Agent 起来但页面看不到设备？ docker compose logs agent | grep -i pair 看配对码是否被使用，用过一次就失效，需重新生成新配对码。
视频流不通？ 先在容器内 ffprobe $CAMERA_NURSERY_CRIB 测试 RTSP 直接能否拉到流。
本地仪表盘怎么访问？ http://<服务器 IP>:8088（默认开放 LAN）。