Dashy项目配置备份与恢复指南

配置备份原理

Dashy作为一款开源仪表盘工具，其核心配置存储在YAML格式的文件中。用户可以通过两种主要方式进行配置备份：

1. 手动导出：通过Web界面直接下载配置文件
2. 自动备份：使用内置的云备份功能（需记录备份ID和密码）

手动备份恢复流程

备份阶段

1. 访问Dashy管理界面
2. 进入配置导出功能模块
3. 选择"下载为文件"选项
4. 系统会生成包含当前所有配置的dashy_conf.yml文件

恢复阶段

1. 定位Dashy的数据存储目录（默认为/app/user-data/）
2. 将备份的配置文件覆盖原始conf.yml
3. 重启Dashy服务使配置生效

容器化部署的特殊处理

对于使用Docker部署的环境，需要特别注意：

1. 确保在启动容器时正确挂载了用户数据卷

   -v ~/dashy/:/app/user-data/
   

2. 配置文件实际存储在宿主机的挂载目录中
3. 修改后无需重建容器，只需重启服务

最佳实践建议

1. 定期备份配置文件，建议设置自动化备份流程
2. 重要修改前手动创建备份副本
3. 对于生产环境，考虑将配置纳入版本控制系统
4. 云备份功能更适合需要跨设备同步的场景

故障排查

若恢复后配置未生效，可检查：

1. 文件权限是否正确（应为应用运行用户可读）
2. YAML格式是否有效（可使用在线校验工具检查）
3. 服务日志中是否有相关错误信息

通过掌握这些核心要点，用户可以轻松管理Dashy的配置备份与恢复，确保仪表盘服务的稳定运行。