备份与还原

备份的是实例的数据卷（模板声明的那些卷，例如浏览器的用户配置、桌面的 home 目录）。

数据怎么走

备份由机器上的 agent 执行：读取数据卷，压缩、加密，再上传到你配置的存储。数据不经过 Moorline 的服务器。

存储

「备份」→「存储」→「添加存储」：

• S3 兼容对象存储：填地址、区域、存储桶、可选的路径前缀、访问密钥 ID 和访问密钥。路径式地址（地址/桶/对象），大文件自动分片上传。
• 本机目录：存在机器的 /var/lib/moorline-agent/backups 下。适合做更新前的快速回退，但和数据在同一块盘上，不能防硬盘损坏。

加密口令

每个存储要设一个加密口令（至少 12 位）。备份文件用它加密（AES-256-GCM，密钥由口令经 PBKDF2 派生），存储方看不到内容。

口令丢了，备份就解不开，Moorline 也帮不上忙。 面板不保存口令：它只以「加密给各台机器的 agent」的形式存，并存一个哈希，用来在你重新填写时核对是不是原来那个。

新接入的机器要在存储上点「编辑」重新填一次访问密钥和同一个口令才能备份（列表里显示「待下发」）。

点「测试」会让一台在线机器向存储写入一个小对象、读回、删除，用来验证地址、密钥和口令。

备份计划

「备份」→「计划」，每个实例可设置：存到哪个存储、间隔（每小时、6 / 12 小时、每天、2 天、每周）、保留份数。到点后自动备份，成功后超出保留份数的旧备份会从存储里删掉。也可以点「立即备份」。机器不在线时十分钟后重试。

备份过程：先把实例暂停（冻结，不会杀进程），把数据卷抓成加密的临时文件后立刻放开，再慢慢上传。所以实例被冻结的时间只取决于本机磁盘速度，不是上传速度。抓取时需要本机有大致等于数据量的空闲磁盘。

还原

「备份」→「记录」→ 某条成功的备份 →「还原」：

1. 先把备份下载到本机并完整校验（口令、完整性）；
2. 校验通过才停止实例，把数据解回卷里（覆盖同名文件，不会删除备份之后新增的文件）；
3. 实例恢复成原来的运行状态。

只能还原回原来的实例。

失败了怎么办

失败原因显示在记录里。常见的：

• 「存储凭证解不开」：这台机器还没下发凭证，到存储里重新填写；
• 访问被拒：检查访问密钥和存储桶权限（需要读、写、删除对象）；
• 口令不一致：重新填写时必须是创建时的口令；
• 磁盘空间不足：清理机器磁盘。

备份失败可以接到告警（「备份失败」规则）。