重启 & 运维

本页命令都在 asp-compose/ 部署目录中执行。启动、重建、重启服务或应用配置变更后，运行一次完整部署诊断：

./scripts/doctor.sh

1. 查看服务状态

查看全部容器：

docker compose ps

STATUS 应为 running；配置了健康检查的服务还应显示 healthy。

doctor.sh 会等待全部官方常驻服务进入 running/healthy 状态，再检查 PostgreSQL、Redis、Django、定制定义和 RustFS/S3 bucket。

Admin 也可以在 System Settings > Workers 查看五类后台 Worker 的心跳、运行状态和最近轮询结果。该页面不能代替容器状态、业务记录和日志排查。

2. 查看日志

先查看可用的服务名：

docker compose config --services

持续查看指定服务日志：

docker compose logs -f <service>

只查看最近 100 行：

docker compose logs --tail=100 <service>

例如：

docker compose logs -f asp-frontend
docker compose logs --tail=100 asp-web

Nginx 和后端进程日志也会写入部署目录的 logs/。

3. 选择正确的操作

场景	操作
仅重新启动现有容器中的进程	docker compose restart
修改 .env 或 compose.override.yaml	docker compose up -d
替换 certs/asp.crt 和 certs/asp.key	docker compose restart asp-frontend
暂停全部服务并保留容器和数据	docker compose stop
启动已停止的服务	docker compose up -d

重启服务

重启所有服务：

docker compose restart

只重启 Web/API 入口：

docker compose restart asp-frontend asp-web asp-asgi

只重启后台 Worker：

docker compose restart asp-worker-module asp-worker-case-analysis asp-worker-playbook asp-worker-elk-action asp-worker-dashboard-cache

应用配置变更

修改 .env 或 compose.override.yaml 后执行：

docker compose up -d

停止和启动

docker compose stop
docker compose up -d

stop 只停止容器。down 会删除容器和 Compose 网络，但默认保留 named volumes。down -v 还会删除 named volumes。

不要删除数据卷

不要在生产环境执行 docker compose down -v，除非明确要删除 PostgreSQL、Redis、RustFS 和定制 Python 依赖等全部持久化数据。

4. 通用故障排查

1. 查看服务状态：

   docker compose ps

2. 找到未处于 running/healthy 状态的服务。

3. 查看该服务最近的日志：

   docker compose logs --tail=100 <service>

4. 修复配置或运行问题后，选择 restart 或 up -d，再执行：

   ./scripts/doctor.sh

下一步

• 环境变量 — 查看 .env 参数及其生效方式。
• 备份 & 恢复 — 创建或恢复停机全量备份。
• 升级 — 下载最新发布包并更新 ASP。
• 定制内容部署 — 安装或更新自定义代码、配置和依赖。
• 服务管理界面 — 登录 Redis Stack UI 和 RustFS Console。