重启 & 运维

本页说明 Docker Compose 生产部署后的常用运维动作，包括状态检查、日志查看、服务重启、停止启动和定制内容变更。

1. 查看当前状态

docker compose ps
./scripts/doctor.sh

doctor.sh 会先等待全部官方常驻服务进入 running/healthy 状态，再检查 PostgreSQL、Redis、Django、定制定义和 RustFS/S3 bucket。生产环境中，升级、重启或修改定制内容后建议执行一次。

2. 查看日志

查看容器标准输出和标准错误：

docker compose logs -f asp-frontend
docker compose logs -f asp-web
docker compose logs -f asp-worker-elk-action
docker compose logs -f asp-worker-dashboard-cache

查看部署目录下的挂载日志：

tail -f logs/django.log
tail -f logs/asgi.log
tail -f logs/agentic-module-worker.log
tail -f logs/agentic-case-analysis-worker.log
tail -f logs/agentic-playbook-worker.log
tail -f logs/elk-action-worker.log
tail -f logs/dashboard-cache-worker.log

3. 重启服务

重启所有 Compose 服务：

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.yaml 或端口映射后，使用 docker compose up -d 重新应用编排；只替换证书或需要进程重新读取配置时，使用 docker compose restart <service>。

4. 停止和启动

停止容器但保留数据卷：

docker compose stop

重新启动：

docker compose up -d

不要在生产环境执行 docker compose down -v，除非明确要删除 PostgreSQL、Redis 和 RustFS 的 Docker 数据卷。

5. Dashboard 缓存排障

Dashboard 显示缓存正在准备、持续返回 503 或提示数据陈旧时，先检查缓存 Worker：

docker compose ps asp-worker-dashboard-cache
docker compose logs --tail=100 asp-worker-dashboard-cache

如果服务已经存在但未正常刷新，可以重启：

docker compose restart asp-worker-dashboard-cache

Worker 会依次生成 24h、7d 和 30d 数据。首次启动或大数据量环境可能需要等待首轮刷新完成，Dashboard 才会显示数据。

6. 定制内容变更

• 只修改 Module、Playbook 或 SIEM YAML：在 Custom Console 执行 Refresh / Validate。
• 修改 custom/requirements.txt 或公共 helper module：重新安装依赖并重启相关后端服务。

docker compose run --rm asp-custom-deps --index-url https://pypi.org/simple
docker compose restart asp-web asp-worker-module asp-worker-playbook

下一步

• 备份 & 恢复 — 了解 PostgreSQL、Redis、RustFS 和定制目录的备份范围。
• 升级 — 查看发布包升级流程。
• Custom Console — 刷新并校验自定义 Module、Playbook 和 SIEM YAML。