Snapback

插件

· 作者 moonlord7722

一键自动备份服务器并回滚。在世界加载前恢复,并先创建安全副本。可选的 Discord 通知功能。

0 本站下载 0 关注 更新于 15 小时前

最新 1.2.3 · 26.2 · Folia / Paper

一键开服(送7天)

Snapback

备份是简单的那一半。这个插件负责另一半。

一条命令即可将服务器回滚至任意备份。免费,无依赖,无推销。


为什么需要另一个备份插件

制作存档已经是成熟的技术。有很多插件可以做到这一点,其中不少还是免费的。

问题出在恢复上。世界被破坏,或者插件更新吃掉了玩家数据,现在已是午夜,你不得不停止服务器,寻找正确的 zip 文件,手动解压它,祈祷你把文件夹放回了原来的位置——并且更祈祷你没有漏掉任何一个。

Snapback 帮你完成了这部分工作,并且只在它真正能起作用的那一刻执行。

恢复机制及其设计原因

当服务器运行时,无法恢复世界文件。 服务器会占用这些文件:在 Windows 上根本无法覆盖它们;在 Linux 上,下一次自动保存会将内存中的世界重新写入磁盘,从而擦除你解压的内容。任何试图通过命令解压存档的插件都在与这一机制对抗,并且无声地失败。

因此,决策和工作被分开处理:

  1. /backup restore <file> — 显示将会发生什么:涉及多少文件、哪种模式、你会丢失什么。不更改任何内容。
  2. /backup restore <file> confirm — 将当前状态归档为 before-restore-*.zip,写入标记,然后停止服务器。
  3. 启动服务器。 恢复过程在 onLoad 中运行——这是插件生命周期中发生在世界加载之前的唯一时刻。
  4. /backup restore cancel — 改变主意了?清除标记。

单个世界或单个玩家

当只有一个玩家丢失了物品栏,或者只有一个世界在被破坏而其他玩家仍在其他世界中建造时,完全回滚并不是合适的工具。

  • /backup restore <file> world <name> — 仅恢复该世界。其他世界、插件和设置保持不变。
  • /backup restore <file> player <name> — 仅恢复该玩家的文件:物品栏、位置、进度、统计数据。其他人不会丢失任何东西。可以使用 UUID 代替名称。 世界文件不会被触碰,因此玩家在备份后掉落、放入箱子或送出的物品仍留在原位——并且也会出现在玩家的物品栏中。预览功能会对此发出警告。

相同的预览、相同的安全副本、相同的重启流程——只是影响范围更小。

防止回滚加剧问题的措施

恢复本身具有破坏性。每一项防护措施都是针对特定的错误场景设计的:

  • 首先创建安全副本。 恢复点之后的所有内容即将消失。before-restore-*.zip 捕获当前状态,并从 keep-last 轮换中排除,因此更多的备份不会将其删除。
  • 插件 jar 包不回滚。 将世界回滚一周几乎从不意味着希望将所有插件也降级一周——包括本插件。默认关闭,需通过一项设置启用。
  • 备份文件夹永远不会被触碰。 否则,一次恢复操作可能会删除正在读取的存档。
  • 检查存档条目是否存在路径穿越漏洞。 包含 ../../ 的恶意 zip 文件无法写入你的服务器文件夹之外——在检查存档和解压时都会进行检查。
  • 标记仅在成功时清除。 重复解压同一个存档是无害的;但如果在失败的恢复中遗留了一个未清除的标记,就会导致世界丢失。如果存档不可读,标记会被重命名,服务器会在当前文件上启动。

备份功能

  • Paper、Purpur 和 Folia —— 一个 jar 包,在这三个服务端上行为一致
  • 定时或手动 —— 设置分钟数作为间隔,或设为 0 以仅使用 /backup run
  • 自动发现世界 —— 无需维护与世界名称同步的列表
  • keep-last —— 自动清理旧存档
  • 可用空间检查 —— 如果备份空间不足,会在开始前拒绝,而不是填满磁盘
  • 重新读取服务器仍在写入的文件,而非复制半写文件;如果一个文件持续变化,备份记录会说明情况
  • skip-if-no-activity —— 如果自上次备份以来没有人上线,则跳过定时备份
  • include / exclude —— 自定义包含或排除任何内容。默认情况下已排除 session.lock、日志和缓存
  • 压缩级别 0–9
  • 聊天通知 —— 向持有 snapback.notify 权限的玩家发送通知
  • Discord 通知 —— 当备份完成或失败时,通过 webhook 发布到频道(可选)

在复制开始前,会通过服务器 API 告知服务器将世界刷盘并停止写入(日志中不会出现 save-off 刷屏),并且之后自动保存会恢复到确切的状态——始终如此,即使存档失败也是如此。跳过这一步会导致存档中出现半写的区域文件,直到你需要它的那一天才会发现问题。

打包在主线程之外运行,因此大型世界不会冻结服务器上的所有人。

命令

命令 作用
/backup run 立即备份
/backup list 显示存档大小和年龄
/backup status 距离下次定时备份的时间
/backup restore <file> 预览回滚 —— 不更改任何内容
/backup restore <file> confirm 创建安全副本,然后停止服务器
/backup restore <file> world <name> [confirm] 回滚单个世界
/backup restore <file> player <name> [confirm] 回滚单个玩家
/backup restore cancel 取消预定的回滚
/backup reload 重新读取 config.yml

权限:snapback.use, snapback.notify, snapback.restore, snapback.reload —— 默认均为 op。

配置

restore:

  # 在回滚前将当前状态归档为 before-restore-*.zip。
  # 它会被排除在 keep-last 轮换之外。
  safety-copy: true

  # 是否从存档中覆盖插件 jar 包。
  # 默认关闭:到恢复时,服务器已经打开了这些文件,
  # 并且将世界回滚很少意味着也要将所有插件回滚。
  replace-plugin-jars: false

true - 用存档中的世界文件夹完全替换当前的(即真正的回滚)

false - 将文件覆盖到当前文件上;备份中缺失的区块保持现状,形成两种状态的混合

默认关闭:删除世界文件夹的操作无法撤销。

clean-worlds: false


配置文件中每条消息都有对应的文本。自带俄语翻译文件 `config-ru.yml`,会在首次启动时与你的配置文件放在同一目录下——替换该文件,重启服务器即可。

## Discord 通知

Snapback 可以通过 Webhook 在每次备份成功或失败时向 Discord 频道发送一条消息。无需邀请机器人、无需登录、无需额外的服务器权限——只需一个 URL。

1. 在 Discord 中:打开目标频道,点击齿轮图标(**编辑频道**)→ **集成** → **Webhooks** → **新建 Webhook** → **复制 Webhook URL**。
2. 打开 `plugins/Snapback/config.yml`,找到 `discord` 部分,设置 `enabled: true`,并将 URL 粘贴到 `webhook-url` 中。
3. 重启服务器,或运行 `/reload confirm`。

```yaml
discord:
  enabled: false
  webhook-url: ""
  notify-success: true
  notify-failure: true

你可以通过 notify-success / notify-failure 关闭某一类通知,例如如果你只关心失败情况(或只关心成功情况)。请将 Webhook URL 视为密码对待——任何拥有它的人都能向该频道发送消息。

要求

  • Paper、Purpur 或 Folia,版本 1.21.4 – 1.21.11 和 26.1 – 26.2 —— 单个 JAR 文件兼容所有这些版本
  • Java 21 或更高版本
  • 无依赖项

不包含的功能

  • 不支持云上传。 仅本地副本——不支持 S3、Google Drive 或 FTP。如果磁盘损坏,备份也会随之丢失。这是诚实的局限性,也是同时保留服务器外备份的主要原因。
  • 不支持增量备份——每个存档都是完整副本
  • 不备份外部数据库

为什么免费

因为现有的备份插件已经有不错的免费选项,而付费版必须在发布第一天就明显优于所有其他选项才能成立。这是首个发行版本:我更希望它在真实服务器上运行,并收集哪些功能会出现问题。

欢迎提交 Bug 报告,且会优先处理。提供配置文件和相关日志行的报告修复速度最快。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源