服务管理

单机安装完成后，Crest 会提供 crestctl 命令用于日常管理。运维人员应优先使用该命令执行启动、停止、重启、状态查看、备份和恢复。

服务管理的目标不是把服务“重启一下”，而是让管理员知道当前服务是否健康、变更后是否恢复、备份能否用于恢复。每次停止、重启、恢复都应记录操作人、时间、原因和验证结果。

常用命令

crestctl status
crestctl start
crestctl stop
crestctl restart
crestctl clear-logs
crestctl backup
crestctl restore crest-backup-YYYYMMDD_HHMMSS.tar.gz
crestctl version

查看服务状态

crestctl status

如果需要查看容器状态：

cd /opt/crest
docker compose ps

查看状态时不能只确认容器存在，还要检查是否持续重启、端口是否映射、启动时间是否异常。容器刚启动成功但应用仍在初始化时，浏览器可能暂时无法访问，需要结合日志判断。

查看日志

cd /opt/crest
docker compose logs -f crest
docker compose logs -f crest-service
docker compose logs -f mysql-crest

v1.5.7 单机部署中，crest 是前端 Nginx 网关，crest-service 是后端 Spring Boot 服务。页面无法访问时优先查看 crest；登录、接口、数据集、导出和权限异常时优先查看 crest-service。启用监控后，Prometheus 和 Grafana 日志分别查看：

docker compose logs -f crest-prometheus
docker compose logs -f crest-grafana

排查启动失败时，优先关注：

日志排查建议按时间点进行。用户反馈“10:30 打不开仪表盘”时，优先查看 10:25 到 10:35 的日志，再结合审计日志和浏览器报错。不建议直接从最新日志向前翻查，容易遗漏关键异常。

重启服务

修改配置后通常需要重启：

crestctl restart

重启后检查：

1. 容器是否运行。
2. 登录页是否可访问。
3. 管理员是否能登录。
4. 工作台和系统设置是否正常打开。

工作台能打开，说明前端资源、后端接口和基础元数据读取基本正常。继续打开数据源、数据集、仪表盘和导出中心，才能确认业务链路恢复。

如果重启后页面能打开但图表空白，继续检查数据源连接、数据库连接池、后端日志和浏览器网络请求。服务重启成功只是第一步，不能证明业务链路已经完整恢复。

备份和恢复

crestctl backup
crestctl restore crest-backup-YYYYMMDD_HHMMSS.tar.gz

备份文件可能包含数据库内容、上传文件、导出文件和业务配置，应按敏感数据管理。

执行恢复前，应先确认恢复目标、备份时间和影响范围。恢复完成后，必须验证登录、权限、数据源、数据集、仪表盘、大屏、分享和导出，而不是只看命令执行成功。

恢复后打开导出中心，确认历史任务状态和新导出任务都正常。导出文件涉及运行目录和文件权限，是恢复检查中容易遗漏的一环。

停机窗口

升级、迁移数据库、恢复备份和调整密钥前，应安排停机窗口。停机窗口内建议禁止用户继续创建资源、导出文件或修改权限，避免状态不一致。