跳到主要内容

安装与运行前准备

这页的目标不是只把程序打开，而是让第一次备份在正确的路径、工具和权限下完成。先完成普通备份—还原闭环，再启用热备份、云归档或自动化。

选择你的安装方式​

A. Desktop GUI​

桌面用户从 MineBackup Releases 下载对应平台的 GUI 资产，然后按本页的压缩工具、配置档和首次运行检查操作。

B. Headless CLI / Server​

服务器、VPS、NAS 或无 DISPLAY/Wayland 环境请选择 CLI 资产：

MineBackup-CLI-<version>-windows-x64.zip
MineBackup-CLI-<version>-linux-x64.tar.gz
minebackup-cli_<version>_amd64.deb

这些只是资产命名格式，不是固定版本 URL。统一从 MineBackup Releases 进入；生产站公开声称 1.16.2 CLI 可下载前，必须先确认 v1.16.2 Release 已经真正发布。

CLI 不需要启动 GUI。安装后从CLI 与服务器模式概览开始，并按5 分钟快速开始完成一次验证闭环。

GUI 下载与运行​

MineBackup 1.16.2 的 GUI 提供 Windows x64、Linux x86_64 和 macOS arm64 分发形式。请从 MineBackup Releases 下载与平台匹配的资产，并优先核对发布页提供的 SHA-256 校验值。

平台版本和桌面能力见平台支持与安装边界。macOS DMG 未进行 Apple 公证，第一次启动可能需要在“隐私与安全性”中选择“仍要打开”。

压缩工具​

MineBackup 把 7-Zip 作为备份引擎使用。当前版本通常会按以下优先级解析：

  1. 程序资源中的内置 7za.exe 或平台对应资源。
  2. 设置中已经保存的用户指定路径。
  3. 系统中可探测到的 7-Zip 安装。

如果设置页显示的路径不可用，请重新选择压缩程序并保存。不要只根据“设置可以打开”判断备份一定能成功；至少应执行一次测试备份。

云归档还需要单独配置 rclone。rclone 不随 MineBackup 分发，可在用户确认后由程序下载、校验并安装受管理版本，详见云归档。

首次启动会做什么​

首次启动和后续启动会先确定配置档，再加载配置与历史：

  • --data-dir <absolute path> 可以显式指定完整配置档根目录。
  • Windows 或 AppImage 旁边存在 portable.flag 时，会使用相邻的 MineBackupData。
  • 没有显式选项时，程序使用系统默认的配置、数据、状态、缓存、运行时、工具和日志目录。
  • 如果发现旧版位置或 1.15 数据，程序会先让用户确认，再执行迁移；源文件不会被静默删除。

这些位置不是 EXE 同级的固定数据文件。完整目录规则见配置档、便携模式与 1.15 迁移。

安装前的目录规划​

至少准备两个可写位置：

  • 存档根目录：只放要管理的世界或目标文件夹的父目录。
  • 备份根目录：用于保存归档和 MineBackup 元数据，最好与源目录分盘。

热备份可以额外指定 snapshotPath 作为快照临时目录。它需要有足够空间和稳定的写权限；不要把它放在会被自动清理的短生命周期目录中，除非你确认每次任务都能在同一会话内完成。

首次运行检查清单​

在创建配置前确认：

  1. 当前用户可以读取存档根目录。
  2. 备份根目录和快照目录（如果使用）可写。
  3. 目标磁盘有足够空间。
  4. 安全软件不会拦截 MineBackup 或 7-Zip 子进程。
  5. 若使用 Minecraft 热流程，已准备兼容的联动模组和 KnotLinkService。
  6. 若使用 macOS/Linux，已经确认当前桌面会话允许需要的通知、托盘或快捷键能力。

安装后最小自检​

  1. 打开设置并确认当前配置档模式。
  2. 创建一套只包含一个世界的普通配置。
  3. 确认压缩工具探测成功。
  4. 使用 Full 模式完成一次手动备份。
  5. 在测试目录或测试世界中执行一次还原。

Windows Service Mode 不属于安装步骤：1.16 不能安装或启动它，只能检查和清理由旧版本遗留且通过安全验证的服务。