备份管理
管理悦库系统的数据备份，包含查看备份列表、修改备份路径、恢复数据和立即备份。
子命令一览
| 子命令 | 只读 | 说明 |
|---|---|---|
backup info | ✓ | 查看备份路径配置及备份文件列表 |
backup path set | — | 修改系统备份路径 |
backup restore | — | 使用指定备份文件恢复系统数据 |
backup run | — | 立即执行一次系统数据备份 |
所有
backup子命令均需先执行opscli login。
查看备份信息
opscli backup info
opscli backup info --json
查看当前备份路径配置及已有备份文件列表。
修改备份路径
opscli backup path set --path <新路径>
| 参数 | 必填 | 说明 |
|---|---|---|
--path | ✓ | 新备份路径的绝对路径（须已存在且可读写） |
--no-restart | — | 写入配置后跳过重启提示，手动重启后生效 |
直接修改本机 config.json 中的备份路径配置。
注意：修改前服务需已关闭。 若检测到服务正在运行，命令会询问是否自动关闭：
检测到服务正在运行，是否自动关闭服务？输入 "yes" 继续，其他输入退出:
修改成功后，命令会提示是否立即重启服务（指定 --no-restart 可跳过提示）。
示例：
opscli backup path set --path /data/backup-new
立即备份
opscli backup run
立即触发一次系统数据备份。需要服务处于运行状态（通过 API 提交任务）。
备份文件保存到 backup info 中显示的备份路径，文件名格式为 <版本号>-<时间>.zip，例如 7.3.2-20260501-143000.zip。
恢复数据
高危操作：恢复会覆盖当前数据库数据，请确认备份文件完整后再执行。
# 交互选择备份文件
opscli backup restore
# 指定备份文件
opscli backup restore --file /data/backup/7.3.2-20260501-143000.zip
# 脚本使用（跳过确认提示）
opscli backup restore --file /data/backup/7.3.2-20260501-143000.zip --force
| 参数 | 必填 | 说明 |
|---|---|---|
--file | — | 指定备份文件（.zip）的绝对路径；省略时列出已有备份供选择 |
--force | — | 跳过操作确认提示（供脚本使用） |
恢复流程：
- 执行一次快照备份（确保恢复前有可回滚的备份）
- 停止服务
- 解压备份文件覆盖数据路径
- 重启服务并导入数据库
省略 --file 时，命令列出备份目录中的所有备份文件供选择：
序号 文件名 大小 修改时间
1 7.3.2-20260501-143000.zip 120 MB 2026-05-01 14:30:00
2 7.3.1-20260420-090000.zip 98 MB 2026-04-20 09:00:00
请选择要恢复的备份 [1-2]:
常见问题
- 提示"请先执行 opscli login"：先执行
opscli login。 backup path set提示路径不存在：确保目标路径在本机已创建且可读写。backup restore提示"快照备份失败"：确认服务正在运行（执行opscli service status查看），或先手动运行opscli backup run。