# 05 数据备份与恢复 需要成套备份: - `config/deploy.env`。 - `data/state/runtime-secrets.json`。 - `agents-skills/`。 - 外部 MySQL 中的 DeerFlow 数据库。 - Docker 卷 `cmzs-deerflow_deerflow-data`、`cmzs-deerflow_deerflow-browser-context`、`cmzs-deerflow_deerflow-users`。 备份前执行 `sudo ./OFFLINE_INSTALL.sh --stop`,数据库和卷恢复完成后再执行 `--start`。不要重新生成丢失的 JWT 密钥后继续使用旧登录数据。 ## 卷备份示例 先确认实际卷名: ```bash docker volume ls --filter name=cmzs-deerflow ``` 以 `deerflow-data` 为例导出到当前目录: ```bash docker run --rm \ -v cmzs-deerflow_deerflow-data:/source:ro \ -v "$PWD":/backup \ alpine:3.20 sh -c 'cd /source && tar -czf /backup/deerflow-data.tar.gz .' ``` 纯离线目标机不一定有 `alpine:3.20`,该命令仅在镜像已存在时使用;否则使用运维环境已有的备份工具。MySQL 应使用 `mysqldump` 或单位数据库备份平台独立备份。 恢复时必须保证应用已停止,先恢复数据库,再恢复三个卷、`agents-skills/`、`deploy.env` 和 `runtime-secrets.json`,最后执行 `--start`。恢复后检查用户登录、智能体列表、历史会话和文件访问。