服务器备份

服务器备份

定时自动压缩备份服务器世界,保留备份并在关闭时进行最终备份。/serverbackup now、list、status。

实用

Server Backup

自动将服务器的世界数据打包为压缩备份,并支持保留策略。这是每位服主在开服第一天就会配置的东西。仅服务端。

功能

  • 每 N 分钟(默认 60)将服务器的 universe 文件夹(世界、玩家数据、universe 资源)打包为 backup-YYYYMMDD-HHmmss.zip。
  • 仅保留最新的 keep 个归档(默认 10);每次运行后删除更旧的归档。
  • 从运行中的服务器定位真实的 universe 文件夹,因此自定义的 --universe 路径会被自动识别;sourceDir 可覆盖它。
  • 当无人在线且自上次备份以来没有任何变化时,跳过定时备份,因此空闲服务器不会用相同的归档填满磁盘。
  • 向在线玩家发送“Backup starting...”和“Backup done (12.3 MB, 4.1 s)”;前缀和颜色可配置。
  • 在服务器关闭时运行一次最终备份(会先等待正在运行的备份完成)。
  • 实时安全:在遍历过程中消失或正在被写入的文件会重试一次,然后跳过并计数,绝不会中止归档。归档先写为 .part,完成后重命名。
  • /serverbackup now 启动一次备份,/serverbackup list 显示最新的十个归档及其大小,/serverbackup status 显示上次运行、下次运行和归档数量。别名 /sbackup。仅限管理员。

为什么不用 /backup?Hytale 服务器将这个名称保留给它自己的 --backup 命令行选项。Server Backup 无需任何服务器标志即可工作,并可与其同时运行。

设置

模组数据目录中的 serverbackup.properties(首次启动时创建):

键 默认值 含义
intervalMinutes 60 定时备份之间的分钟数;0 = 仅手动(/serverbackup now 和关闭时备份仍然有效)
keep 10 保留多少个最新归档;每次运行后删除更旧的归档(最少 1)
targetDir backups 归档存放位置;相对路径位于模组数据目录内
sourceDir (空) 要归档的文件夹,相对于服务器工作目录;空 = 运行中服务器的 universe 文件夹
onlyWhenPlayersOnline true 当无人在线且自上次备份以来没有文件变化时跳过定时备份
announce true 向在线玩家广播开始 / 完成 / 失败消息
backupOnShutdown true 服务器关闭时运行一次最终备份
prefix [Backup] 每条公告前的文本;留空则不显示
color #55FF55 公告颜色

服务器日志以 INFO 级别记录每次运行:来源、归档路径、大小、文件数量、耗时以及删除了多少旧归档。

恢复:停止服务器,将归档解压到服务器 jar 旁边(归档中包含 universe/ 文件夹),启动服务器。

安装:将 jar 放入服务器的 mods/ 文件夹并重启。许可证:MIT。

需要定制功能? 我按需构建小型服务器插件,修复 $35 起,新单功能插件 $90 起:https://ko-fi.com/molonlav3/commissions 。如果这个模组为你节省了时间,请我喝杯咖啡有助于持续更新:https://ko-fi.com/molonlav3

要更新 Hytale? 先运行免费的 Update-Ready Check,看看你的哪些模组会失效:https://molonlav3.itch.io/hytale-update-check