Ech0功能指南
数据管理
Ech0 提供多种数据管理方式，保障数据安全与完整性
数据管理
Ech0 提供灵活的数据管理方案，支持备份、导出、迁移与定时自动备份。
Web 在线管理
在 管理面板 → 数据管理 中，您可以：
- 快照导出：一键导出 ZIP 备份包（包含 SQLite 数据库和文件资源）
- 数据迁移：从其他平台导入数据
备份文件名格式：ech0-<timestamp>.zip，存储位置：data/files/backups/。
导出端点：GET /api/backup/export?token=<jwt>，返回 ZIP 文件流。
TUI 数据管理
适用于二进制安装用户（非 Docker 环境）。
ech0 tui在 TUI 菜单中选择"执行备份"即可创建快照。
CLI 命令行备份
ech0 backup生成 ZIP 备份到 data/files/backups/ 目录。适合自动化脚本和 CI/CD 集成。
数据迁移
支持从以下来源导入数据：
| 来源类型 | 标识 | 说明 |
|---|---|---|
| Ech0 v4 | ech0_v4 | 从其他 Ech0 v4 实例迁移 |
| Ech0 v3 | ech0_v3 | 从旧版 Ech0 迁移 |
| Memos | memos | 从 Memos 平台迁移 |
迁移流程：上传 ZIP → 解压 → 数据转换 → 校验 → 写入 → 报告 → 完成
迁移期间启用全局写锁（WriteGuard），防止数据竞争。迁移完成后可选择性应用源实例的设置（系统设置、评论设置、S3 配置、OAuth2 配置）。
不支持从 v3 直接更新到 v4。请先在 v3 面板中导出快照，然后部署 v4 后使用"v3 迁移"导入。
手动恢复
如果在线恢复失败，可手动替换数据文件：
- 停止 Ech0 服务或 Docker 容器
- 找到备份的 ZIP 文件并解压
- 将解压出的数据文件复制到 Ech0 数据目录（默认
/opt/ech0/data） - 替换原有的
ech0.db后重新启动
手动替换前，建议先备份当前的 data 目录，以便出现问题时回退。
定时自动备份
在 系统设置 → 备份计划 中配置：
- 开启自动备份开关
- 填写 Cron 表达式
Cron 表达式说明
支持标准 5 位或 6 位 crontab 格式：
# 5 位格式（分 时 日 月 周）
0 2 * * 0
# 6 位格式（秒 分 时 日 月 周）
0 0 2 * * 0示例
| 表达式 | 说明 |
|---|---|
0 2 * * 0 | 每周日凌晨 2:00 |
30 3 * * * | 每天凌晨 3:30 |
0 */6 * * * | 每 6 小时 |
后台会自动执行备份任务并在日志中记录结果。备份文件以时间戳命名，可通过 Web 面板查看或下载。