MCDR2Restic

Schedule deduplicated incremental restic backups with multi-channel notifications.

management

Installation command

!!MCDR plugin install mcdr2restic

Author

Synced at

...

Last update

...

Latest version

Total downloads

137

Back to catalogue

MCDR2Restic_v0.12.2.mcdr

Version

0.12.2

Date

November 18, 2026

Size

326.04 KiB

Downloads

9

MD5

4d1cdbe7f61c5f3f20c5c8f9a7c5ffd9

SHA256

2db1177f529edc41451af293f3b08104f7681d28e5161d650a07bbc69a8ae851

MCDR Plugin Dependencies

Plugin IDRequirement
mcdreforged>=2.12.0

Python Package Requirements

Python PackageRequirement
PyYAML>=6.0
websocket-client>=1.8.0

Python Package Installation Command

pip install "PyYAML>=6.0" "websocket-client>=1.8.0"

新增

  • 中转库(staging,beta、默认关闭):备份先写入本地中转库,解冻后再由后台线程复制到远端,把 save-off 冻结窗口从“上传耗时”缩短为“本地写入耗时”。新增 !!m2r staging status / copy / purge 与 staging: 配置段;适合远端上传慢、玩家高峰期长的服务器。beta 功能不建议作为唯一备份手段,启用前请阅读 中转库文档
  • 陈旧备份告警重做:改由独立看门狗按固定节奏检查,不再依赖备份调度周期(每天只跑一次的 cron 也能按时告警)。计时改为“首次被人数门控推迟以来的服务器运行时间”,成功备份立即复位,停用备份时清零;告警后每 24 小时提醒一次,并说明停滞起点、当前人数与阈值
  • 玩家人数门控改进:推迟中的备份可取消,放行后复检;拿到备份槽位后再次复检在线人数,避免等待期间人数超阈值仍进入 save-off;新生成配置默认阈值 5,本地库也预先开启(确认备份很快可显式改为 0 关闭)
  • 维护结果区分成功 / 跳过 / 失败三态,并接入通知与状态页;计划点改为游标重算,调度线程不再被推迟中的备份或维护阻塞

修复

  • 中转库数据安全:新增游标覆盖性不变量,游标与本地快照不一致时不再“假成功”,跳过本地 prune 并全量重放;永久复制失败后仍保留远端落后告警;purge 与 restore 互斥并支持阶段间取消;复制 worker 启停加代际校验,避免重载后出现两个复制循环;初始化 deadline 与取消语义修正
  • 失败分类统一:context deadline exceeded 等超时不再被误判为配额不足;鉴权 / 配额 / 分块错误停止自动重试;中英繁三种语言下归类一致
  • staging status 在远端不可达时不再阻塞约 60 秒并触发 MCDR WatchDog,复用探测结果与共享 deadline
  • 中转库配置校验:与远端仓库路径相同或互相包含、password_file 缺失、backup_command 自带仓库参数时,在备份前直接给出配置错误
  • 自定义 Webhook 的 {message} 保留完整正文,不再被短摘要覆盖;修改 command.root 后 reload 给出重载提示
  • 远端读取失败后 staging status 只探测一次;backlog 未知时写 -1 并标记远端状态不可信;S3 签名错误归类为鉴权失败并停止重试
  • YAML 解析错误提示包含行号、列号与解析器原因;对已初始化仓库重复 init 返回友好提示
  • 快照缓存从未成功刷新时显示“刷新失败”;快照来源改为显示目录名;拒绝 MCDR 折叠后的单反斜杠管理共享路径
  • 日志打印真实执行的 Minecraft 命令(如 save-all flush);取消与门控中断显示真实原因,不再统一写成“收到停止请求”
  • 首次备份等待期间按状态变化节流,不再每 30 秒写状态并刷 info 日志

变更

  • 配置文件版本 10 → 13,升级自动迁移:门控阈值收敛为单开关、新增 staging 段、旧门控注释与旧版陈旧备份通知文案自动更新
  • 文档:新增中转库文档,配置、命令、快速开始与 README_EN 同步更新
  • 发布构建会把内置 restic 信任清单 pin 到当前最新稳定版;已有仓库无需迁移

安装

下载下方 MCDR2Restic_v0.12.2.mcdr 放入 MCDR 的 plugins/ 目录,执行 !!MCDR reload all。 或 在 MCDR 中执行 !!MCDR plugin install mcdr2restic 自动安装。