ASPbackup

插件

· 作者 LIAO_S_Z

ASPbackup 是一款面向 Spigot/Paper Minecraft 服务器(1.20.6+)的全面备份插件,支持分布式多节点传输、检查点/断点续传、完整性校验以及灵活的调度计划。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0-SNAPSHOT · 26.2 · Bukkit / Folia

一键开服(送7天)

ASPbackup

Advanced Backup System for Minecraft Spigot Servers

ASPbackup is a comprehensive backup plugin for Spigot/Paper Minecraft servers (1.20.6+) featuring distributed multi-node transfer, checkpoint/resume, integrity verification, and flexible scheduling.

特性

? 备份管理

  • 自动备份:在服务器启动和关闭时进行(可配置)
  • 手动备份:通过游戏内命令或控制台执行
  • 完整与增量:支持两种备份模式
  • 自定义源路径:支持针对每个数据源的包含/排除过滤
  • 多种目标类型:本地、NAS 和远程(分布式)

⚡ 高级功能

  • 中断与恢复:安全地中途停止备份,并从检查点恢复
  • 完整性验证:使用 SHA-256 校验和并生成清单
  • 保留期管理:自动清理旧备份
  • 磁盘空间监控:备份前检查空间并发出警告

? 分布式传输

  • 多节点:并行传输以加快备份速度
  • 负载均衡:支持轮询和最少负载策略
  • 分块传输:将大文件拆分为可配置大小的块
  • 连接池:复用 TCP 连接以减少开销
  • 自定义二进制协议:使用魔术字节 + CRC32 帧结构确保可靠性

? 管理

  • 9 个子命令:start、stop、status、resume、list、nodes、verify、reload、help
  • 命令补全:所有命令均支持 Tab 键补全
  • 基于权限的访问控制
  • Bukkit 事件:用于插件互操作性

?️ 可靠性

  • 每日日志文件:支持可配置的保留期
  • 错误隔离:备份失败不会导致服务器崩溃
  • 网络重试:自动重试失败的块传输
  • 优雅关闭:在插件禁用时保存检查点

要求

  • Java 21 或更高版本
  • Spigot/Paper 1.20.6+(API 版本 1.20)
  • Maven 3.8+(用于从源码构建)

快速开始

插件安装

  1. 从 Releases 下载 ASPbackup-1.0.0-SNAPSHOT.jar
  2. 将其放入服务器的 plugins/ 文件夹中
  3. 启动(或重启)你的服务器
  4. 编辑 plugins/ASPbackup/config.yml 以配置备份源和目标
  5. 运行 /aspbackup reload 应用配置更改

基本用法

# 启动手动备份
/aspbackup start --target local

# 查看备份状态
/aspbackup status

# 查看备份历史
/aspbackup list --all

# 重新加载配置
/aspbackup reload

# 显示所有命令
/aspbackup help

接收端设置(分布式传输)

  1. 下载 ASPbackup-receiver-1.0.0-SNAPSHOT.jar
  2. 在每个节点上运行:
    java -jar ASPbackup-receiver-1.0.0-SNAPSHOT.jar --port 9876 --dir /backups --token your-secure-token
    
  3. 在 plugins/ASPbackup/config.yml 中配置节点:
    transfer:
      nodes:
        - id: "node-1"
          host: "192.168.1.101"
          port: 9876
          auth-token: "your-secure-token"
          enabled: true
          weight: 1
    

配置

主配置文件为 plugins/ASPbackup/config.yml。主要部分如下:

部分 用途
backup 自动备份设置、压缩、源、目标、文件过滤器
schedule 定期备份调度及静默时段
transfer 块大小、线程数、超时、重试、负载均衡、节点列表
checkpoint 恢复支持与检查点清理
logging 日志级别、目录、保留期、控制台输出
disk-space 可用空间监控阈值

命令参考

命令 权限 描述
/aspbackup start [--full|--incremental] [--target <id>] aspbackup.start 启动手动备份
/aspbackup stop <task-id> aspbackup.stop 停止正在进行的备份
/aspbackup status [task-id] aspbackup.status 查看备份状态
/aspbackup resume <task-id> aspbackup.resume 恢复暂停的备份
/aspbackup list [--active|--completed|--failed] aspbackup.list 列出备份历史
/aspbackup nodes <list|status> aspbackup.nodes 管理传输节点
/aspbackup verify <task-id> aspbackup.verify 验证备份完整性
/aspbackup reload aspbackup.reload 重新加载配置
/aspbackup help [command] aspbackup.command 显示帮助信息

从源码构建

# 克隆仓库
git clone https://github.com/HDB-Studio/ASPbackup.git
cd ASPbackup

# 构建插件
mvn clean package

# 构建接收端
cd receiver
mvn clean package

输出文件:

  • target/ASPbackup-1.0.0-SNAPSHOT.jar — Spigot 插件
  • receiver/target/ASPbackup-receiver-1.0.0-SNAPSHOT.jar — 独立接收端

架构

ASPbackup/
├── src/main/java/com/aspbackup/     # Spigot Plugin
│   ├── ASPBackup.java               # 插件主类
│   ├── core/
│   │   ├── backup/                  # 备份引擎(源、目标、压缩)
│   │   ├── transfer/                # 分布式传输(协议、块、负载均衡)
│   │   ├── config/                  # 配置管理
│   │   ├── schedule/                # 自动备份调度
│   │   └── resume/                  # 检查点 & 恢复
│   ├── command/                     # 命令系统(9 个子命令)
│   ├── event/                       # Bukkit 自定义事件
│   ├── logging/                     # 备份日志系统
│   ├── model/                       # 数据模型
│   └── util/                        # 工具类
└── receiver/                        # 独立接收端应用程序
    └── src/main/java/com/aspbackup/receiver/
        ├── BackupReceiver.java      # 主入口点
        ├── server/                  # Netty TCP 服务器
        ├── assembly/                # 块组装
        └── verification/            # 完整性检查

网络协议

分布式传输使用自定义二进制协议:

┌──────────┬──────────┬──────────┬──────────┬──────────┐
│ Magic(2B)│Type(1B)  │Length(4B)│Payload(NB)│CRC32(4B) │
└──────────┴──────────┴──────────┴──────────┴──────────┘

数据包类型:握手 (0x01)、区块数据 (0x03)、确认 (0x04)、恢复请求 (0x07)、状态 (0x09)

许可证

本项目采用 Apache License 2.0 许可协议 —— 详情请参阅 LICENSE 文件。

贡献

欢迎贡献!请随时在 GitHub 仓库 提交拉取请求(Pull Request)或创建 Issue。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源