日常维护

以下服务名对应当前 Go API 部署模板；旧版离线包按同包 README 操作，先用 docker compose config --services 核对。

查看与启停

查看服务状态：

docker compose ps -a

查看最近日志：

docker compose logs --tail=100 gateway api web-api

重启服务：

docker compose restart

停止服务并移除容器：

docker compose down

docker compose down 不删除 bind mount 到包内 data/ 的数据库和设置。完整步骤见升级、备份与恢复，并核对所用离线包的 README 和勘误。首次引入 custom 必须采用完整新版配置和工具，不能只替换镜像。

更新与故障

修改 .env 后重新创建对应容器，restart 不重新注入环境变量；已挂载的配置文件按各功能要求重载。完整配置见环境变量参考。需要替换版本时按升级操作。涉及数据替换或大批量自定义修改前按备份与恢复停写备份。不要用删除数据库作为普通故障排查步骤。

需要制作自己的发行包时，按根仓库的镜像构建与交付流程执行，构建流程由根仓库维护。