日常维护

以下服务名对应当前 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/ 的数据库和设置。同一完整包的数据维护见备份与恢复。

更新与故障

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

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