Prime Backup

English | 中文

一个强大的 MCDR 备份插件，一套先进的 Minecraft 世界备份解决方案

中文文档：https://tisunion.github.io/PrimeBackup/zh/

功能特性

• 基于哈希的文件池与压缩去重：仅存储新增或变更的数据，备份数量没有上限
• 可选的 CDC（Content-Defined Chunking，内容定义分块）分块存储：适用于大文件的局部编辑场景，能显著提升跨备份的去重效果
• 安全的回档流程：包含确认与倒计时、回档前自动创建备份、回收站式的回滚机制以及数据完整性校验
• 完善的备份操作，包括备份回档、展示删除、导入导出等
• 流畅的游戏内交互，大部分操作都能点点点
• 丰富的数据库工具，含概览统计、完整性校验、孤儿数据清理、文件删除、哈希/压缩算法迁移等功能
• 高可自定义备份清理策略，是 PBS 所用策略的同款
• 定时任务：支持自动创建备份和自动清理备份，计划方式支持固定间隔和 crontab 表达式
• 支持作为命令行工具使用，无需启动 MCDR 即可管理备份，还可以通过 FUSE 挂载为文件系统进行访问

依赖

MCDReforged 依赖：>=2.12.0

Python 包要求：见 requirements.txt

使用方法

参见文档：https://tisunion.github.io/PrimeBackup/zh/

工作原理

Prime Backup 使用一个自定义的文件池来存储备份数据。池中的每个对象都以其内容的哈希值作为唯一标识。 通过这种方式，Prime Backup 可以对内容完全相同的文件进行去重，并只存储它们的一份副本，从而显著降低磁盘空间占用

此外，Prime Backup 还支持对存储的数据进行压缩，以进一步减少磁盘使用量

对于体积较大且仅被局部修改的文件，Prime Backup 可选择启用 CDC（Content-Defined Chunking，内容定义分块）功能来提升去重效率。 文件会被切分成由内容定义的数据块（chunk），每个数据块都会计算哈希值。只有新的数据块才会被写入存储。如果数据块的内容没有改变，它就可以在不同的备份中被复用

Prime Backup 支持常见的文件类型，包括普通文件、目录和符号链接。对于这三类文件：

• 普通文件：Prime Backup 会先计算其哈希值（及文件大小）。 启用 CDC 时，文件以“chunked blob”形式存储，并引用多个数据块。这些数据块会独立进行去重和压缩； 否则，文件会以“direct blob”形式存储，整个文件作为一个单元进行去重和压缩。 文件的权限（mode）、用户ID（uid）、修改时间（mtime）等元数据会存储在数据库中
• 目录：Prime Backup 将其信息存储在数据库中
• 符号链接：Prime Backup 存储的是符号链接本身，而不是它所指向的目标文件

致谢

基于哈希的文件池思路来自 https://github.com/z0z0r4/better_backup