3.7 KiB
可移植虚拟机备份与异机恢复
管理员可在虚拟机管理页为面板创建的云镜像实例生成一个完整系统盘备份,并把该备份直接上传到后台已验证的 S3 兼容对象存储。恢复不会修改或替换源实例,而是在另一台符合条件的宿主机上创建一个独立实例。
虚拟机管理页顶部的“备份库”以备份目录自身为管理边界。即使源实例已按到期规则删除,超级管理员仍可从备份库恢复或删除对象;只读管理员只能查看。目录固定分页,浏览器响应不包含对象键、预签名 URL 或长期凭据。
备份边界
- 当前只支持一个面板托管、可写、无 backing chain 的
vdaqcow2 系统盘;额外数据盘、LUN、外部快照链或正在 pivot/mirror 的磁盘会被拒绝。 - 运行中实例通过 libvirt full push backup 生成完整对象。可用 QEMU Guest Agent 时选择文件系统一致性;否则只能生成崩溃一致性备份。关机实例从稳定的系统卷生成完整副本。
- S3 长期凭据只在 PHP 控制面解密。Agent 只得到单对象、单方法、最长七天有效的预签名传输能力,不接收 Access Key 或 Secret Key。
- 对象内容是原 qcow2 数据。传输强制 HTTPS,但当前版本不额外执行客户端加密;生产 Bucket 应启用服务端加密、版本控制、最小权限和不完整 multipart 生命周期清理。
- 系统盘内容保持不变,因此来宾系统数据、账户、SSH host key 和应用配置也保持不变。它是从备份创建新实例,不是重装一个空白操作系统。
异机恢复
恢复目标必须满足以下条件:
- 与源宿主机不同,已启用且 Agent、存储配置和
bridge:br0网络均就绪; - CPU、内存、磁盘和带宽容量足够,并且目标资源池有一个未分配的公网 IPv4;
- 目标宿主机没有同名实例。
控制面先在同一数据库事务内预留目标容量和新公网 IP,再派发恢复。Agent 校验下载对象的精确字节数和 SHA-256,创建新的 UUID、MAC、seed、NVRAM、网络过滤器和流量状态,并把新公网地址写入使用 br0 的 cloud-init 网络配置。它不会复用源 IP,也不会复制原 Domain XML。
恢复实例保留备份时冻结的 CPU、内存、系统盘、带宽及系统兼容元数据,归属原用户,但不继承订单、账单、套餐、服务期、到期时间或流量周期;后台将其标记为免计费实例,后续商业化前需要另行定义计费迁移策略。
失败与不确定效果
备份和恢复均为异步 HeavyIO 操作,单次宿主机 worker 最长可运行 24 小时。控制面只会派发一次同一 operation ID:超时、断连或回执丢失均视为效果未知,并通过 Agent Journal 查询原操作,不会重新执行备份或创建第二台 VM。
若远端对象已经完整提交并校验,但源宿主机的临时快照清理失败,Agent 会保留对象大小、SHA-256 和一致性结果,把备份标记为可恢复并单独提示本地清理待核对;该提示不会触发重新上传或删除远端对象。
恢复失败时,只有 Agent 明确证明新 Domain、所有 UUID 所属卷、seed、NVRAM、网络过滤器和流量状态均不存在,控制面才能释放容量与公网 IP。只要清理结果不确定,资源保持锁定等待人工核对。
备份对象删除也遵守同一原则:明确删除成功才释放目录额度;DELETE 响应未知时只允许通过 HEAD 核对对象已经不存在,不会自动重放删除。若 Bucket 开启版本控制,S3 删除会隐藏当前对象但可能保留历史版本,生产环境还应配置仅覆盖备份前缀的历史版本过期策略。