更新与维护
自部署实例需要定期更新镜像、迁移数据库并备份数据。
更新流程
推荐流程：
- 备份 PostgreSQL 数据。
- 备份对象存储数据。
- 停止当前
web、agent、api应用容器。 - 拉取新镜像。
- 使用
--remove-orphans运行 compose。 - 等待
migrate完成。 - 检查
api、agent、web健康状态。
bash
docker compose -f infrastructure/compose.prod.yml --env-file infrastructure/.env stop web agent api
docker compose -f infrastructure/compose.prod.yml --env-file infrastructure/.env pull
docker compose -f infrastructure/compose.prod.yml --env-file infrastructure/.env up -d --remove-orphans数据库迁移
生产 compose 会通过 migrate 服务执行 Prisma migration。迁移完成后，api 再启动。
不要手动修改已经应用过的 migration 文件。需要变更数据库结构时，应通过新的向前迁移完成。
备份建议
至少备份：
- PostgreSQL volume。
- RustFS 或其他对象存储数据。
- 部署
.env文件。
不要把含密钥的 .env 上传到公开仓库。
日志
生产 compose 使用本地日志驱动，并限制单文件大小和保留数量。排查问题时先看对应服务日志：
bash
docker compose -f infrastructure/compose.prod.yml logs api
docker compose -f infrastructure/compose.prod.yml logs agent
docker compose -f infrastructure/compose.prod.yml logs web密钥轮换
模型服务商 API Key 和对象存储密钥可以按服务商侧规则轮换。APP_SECRET 属于根密钥，不建议在已有实例中随意更换。