5.5 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、内存、系统盘、带宽及系统兼容元数据,归属原用户,但不继承订单、账单、套餐、服务期、到期时间或流量周期;后台将其标记为免计费实例,后续商业化前需要另行定义计费迁移策略。
维护迁移
维护迁移是独立恢复之外的管理员流程,只允许选择同一资源池内的其他宿主机。控制面先锁定目标容量和新公网 IP,再正常关闭源实例并关闭其 autostart,从稳定系统盘生成备份;目标宿主机恢复并验证新 UUID、新公网 IP、系统盘摘要和资源预留后,才切换原 cloud_instances 记录。迁移不会创建第二份账单实例,也不会改动原订单、套餐、服务期、到期时间、续费参数或当前流量周期。
目标使用统一的 bridge:br0 网络和新公网 IPv4。原累计流量作为新 Agent 计数器世代的基数继续单调累计,不能因宿主机和 UUID 改变而清零或重复计费。若实例启用了用户防火墙,目标必须重新应用并确认同一策略后,流程才允许进入源副本清理。
管理员可在开始时选择两种源副本策略:
- “目标验证后自动清理”会在目标恢复及防火墙收敛后删除源 Domain 和面板托管磁盘,只有 Agent 同时确认 Domain 与全部托管产物均不存在时,才释放原公网 IP 和源容量。
- “保留源副本”会保持源 Domain 关机且禁用 autostart,并继续锁定原公网 IP 和源容量;管理员稍后可从同一页面显式发起清理。
- 在源副本清理或异常核对完成前,面板会阻止普通实例变更和套餐升级;到期策略仍可断网,但不会只删除目标实例而遗留源副本。
任何删除响应超时、断连或回执丢失都进入待核对状态,系统不会重放源删除,也不会提前释放源资源。迁移备份与普通备份共用对象存储目录,但迁移目标恢复属于隐藏的编排步骤,不会生成一个免计费的独立业务实例。
失败与不确定效果
备份和恢复均为异步 HeavyIO 操作,单次宿主机 worker 最长可运行 24 小时。控制面只会派发一次同一 operation ID:超时、断连或回执丢失均视为效果未知,并通过 Agent Journal 查询原操作,不会重新执行备份或创建第二台 VM。
若远端对象已经完整提交并校验,但源宿主机的临时快照清理失败,Agent 会保留对象大小、SHA-256 和一致性结果,把备份标记为可恢复并单独提示本地清理待核对;该提示不会触发重新上传或删除远端对象。
恢复失败时,只有 Agent 明确证明新 Domain、所有 UUID 所属卷、seed、NVRAM、网络过滤器和流量状态均不存在,控制面才能释放容量与公网 IP。只要清理结果不确定,资源保持锁定等待人工核对。
备份对象删除也遵守同一原则:明确删除成功才释放目录额度;DELETE 响应未知时只允许通过 HEAD 核对对象已经不存在,不会自动重放删除。若 Bucket 开启版本控制,S3 删除会隐藏当前对象但可能保留历史版本,生产环境还应配置仅覆盖备份前缀的历史版本过期策略。