X Backup

X Backup

简体中文 | English

适用于 Fabric 的先进备份模组。

优势

• ⚡️极速体验：采用多线程技术实现快速备份，大幅缩短完成时间，速度提升高达 50 倍。[^1]
• 💾空间高效：实现增量备份并自动压缩大型文件，最大限度减少存储占用。
• 🔄无缝还原：还原后自动重启服务器，带来无缝体验。
• ✨局部还原：仅还原指定范围内的区块，范围外的玩家将不受影响。
• 🛡️灵活支持：设计用于同时支持服务器端和客户端，为所有备份需求提供多功能解决方案。
• ☁️自动云备份：轻松将数据备份至云端，支持微软 OneDrive，确保信息随时安全可及。

使用方法

创建备份

您可以使用 /xb create 命令创建新备份。此命令保存游戏当前状态，以便日后还原。若想为备份添加备注，可在命令后附加内容，例如：

/xb create 这是我的第一次备份

这样，您就创建了一个带备注的备份。

查看已创建的备份

想知道已经创建了哪些备份，可以使用 /xb list 命令。此命令列出所有备份，并显示每个备份的编号、创建时间和备注。例如：

/xb list

此命令显示最近 6 个备份。如果备份较多，可以点击灰色字体按钮查看更多备份。

还原备份

若需还原到特定备份，可以使用 /xb restore <id> 命令，其中 <id> 是备份的编号。例如：

/xb restore 1

此命令将游戏还原到编号为 1 的备份状态。若只想还原特定范围，可使用 --chunk 参数指定从哪个坐标到哪个坐标，例如：

/xb restore 1 --chunk 0 0 10 10

[!TIP] 这些是方块的 x/z 坐标，请勿与区块坐标混淆。

这将把游戏还原到备份 1 的状态，但仅还原方块坐标 (0, 0) 到 (10, 10) 的区域。

定时备份配置

可以使用 /xb backup-interval <秒数> 命令设定自动备份间隔。例如，若想每 3 小时自动备份一次，可以这样设置：

/xb backup-interval 10800

此命令将自动备份间隔设置为 10800 秒（即 3 小时）。

镜像服务器配置

如果使用镜像服务器，可以通过 /mirror 命令从主服务器同步最新备份。例如：

首先，需要在主服务器上创建备份：

/xb create

然后，在镜像服务器配置中，设置主服务器的文件路径（包含 server.properties 的路径）和 blob_path，并启用镜像模式：

{
  "mirror_mode": true,   
  "mirror_from": "C:\\MinecraftServer\\My-Server",
  "blob_path": "C:\\MinecraftServer\\My-Server\\blob"
}

之后，执行 /mirror 命令。此命令会将主服务器的最新备份状态同步到镜像服务器。您还可以添加 id 参数指定要同步的备份编号：

/mirror 1

如果希望在备份同步前停止服务器并还原备份，可以使用 --stop 参数：

/mirror --stop

清理不必要的备份

该模组还提供旧备份的自动清理功能。您可以在配置文件中设置 keep_policy，例如：

{
  "prune": {
    "enabled": false,
    "keep_policy": {
      "1d": "30m",
      "1w": "6h",
      "1M": "1d",
      "1y": "1w",
      "2y": "1M"
    }
  }
}

该配置表示：

• 最近 1 天内每 30 分钟保留一份备份
• 最近 1 周内每 6 小时保留一份备份
• 最近 1 个月内每天保留一份备份
• 最近 1 年内每周保留一份备份
• 最近 2 年内每月保留一份备份

您可以根据需要调整这些设置。

当 enabled 为 true 时，模组会自动清理不符合保留策略的备份。或者，您也可以使用 /xb prune 命令手动清理不必要的备份。

查看备份信息

若想查看特定备份的详细信息，可以使用 /xb info <id> 命令，例如：

/xb info 1

此命令将显示 1 号备份的详细信息，包括备份时间、备注、大小等。

致谢

本模组的部分（GUI）基于 CreeperHost LTD 开发的 BackupManager。