#!/bin/bash
# simple-backup.sh - 简单全量备份脚本

# ============ 配置 ============
SERVER_DIR="/opt/minecraft/paper"
BACKUP_DIR="/opt/minecraft/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_NAME="mc_backup_${TIMESTAMP}"
SCREEN_NAME="minecraft"
KEEP_COUNT=10                        # 保留最近 N 个备份

# ============ 初始化 ============
mkdir -p "$BACKUP_DIR"
echo "[$(date)] === 开始备份 ==="

# ============ 通知服务器 ============
screen -S "$SCREEN_NAME" -p 0 -X eval 'stuff "say §e[备份] 正在创建备份，请稍候...\015"'
screen -S "$SCREEN_NAME" -p 0 -X eval 'stuff "save-off\015"'
screen -S "$SCREEN_NAME" -p 0 -X eval 'stuff "save-all\015"'
sleep 5

# ============ 执行备份 ============
echo "[$(date)] 正在备份世界文件..."
tar -czf "${BACKUP_DIR}/${BACKUP_NAME}.tar.gz" \
  -C "$SERVER_DIR" \
  --exclude='cache' \
  --exclude='libraries' \
  --exclude='logs/latest.log' \
  world world_nether world_the_end \
  plugins config \
  server.properties \
  bukkit.yml spigot.yml \
  banned-players.json banned-ips.json \
  ops.json whitelist.json \
  2>/dev/null

# ============ 恢复自动保存 ============
screen -S "$SCREEN_NAME" -p 0 -X eval 'stuff "save-on\015"'

# ============ 检查备份结果 ============
if [ -f "${BACKUP_DIR}/${BACKUP_NAME}.tar.gz" ]; then
    SIZE=$(du -h "${BACKUP_DIR}/${BACKUP_NAME}.tar.gz" | cut -f1)
    echo "[$(date)] 备份成功: ${BACKUP_NAME}.tar.gz (${SIZE})"
    screen -S "$SCREEN_NAME" -p 0 -X eval 'stuff "say §a[备份] 备份完成！\015"'
else
    echo "[$(date)] 备份失败！"
    screen -S "$SCREEN_NAME" -p 0 -X eval 'stuff "say §c[备份] 备份失败！\015"'
    exit 1
fi

# ============ 清理旧备份 ============
echo "[$(date)] 清理旧备份（保留最近 ${KEEP_COUNT} 个）..."
ls -t ${BACKUP_DIR}/mc_backup_*.tar.gz 2>/dev/null | tail -n +$((KEEP_COUNT + 1)) | while read f; do
    echo "[$(date)] 删除旧备份: $(basename $f)"
    rm -f "$f"
done

echo "[$(date)] === 备份完成 ==="

#!/bin/bash
# full-backup.sh - 完整服务器备份（包含 JAR 和所有配置）

SERVER_DIR="/opt/minecraft/paper"
BACKUP_DIR="/opt/minecraft/backups/full"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

mkdir -p "$BACKUP_DIR"

# 备份整个服务器目录（排除缓存和日志）
tar -czf "${BACKUP_DIR}/full_${TIMESTAMP}.tar.gz" \
  -C "$(dirname $SERVER_DIR)" \
  --exclude='*.cache' \
  --exclude='logs/*.log' \
  --exclude='cache' \
  --exclude='libraries' \
  "$(basename $SERVER_DIR)"

echo "完整备份完成: full_${TIMESTAMP}.tar.gz"
ls -lh "${BACKUP_DIR}/full_${TIMESTAMP}.tar.gz"

#!/bin/bash
# incremental-backup.sh - 使用 rsync 增量备份

SERVER_DIR="/opt/minecraft/paper"
BACKUP_DIR="/opt/minecraft/backups/incremental"
LATEST_LINK="${BACKUP_DIR}/latest"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

mkdir -p "$BACKUP_DIR"

# rsync 增量备份（硬链接未变更文件）
rsync -a --delete \
  --link-dest="$LATEST_LINK" \
  --exclude='cache' \
  --exclude='libraries' \
  --exclude='logs/latest.log' \
  "$SERVER_DIR/" \
  "${BACKUP_DIR}/${TIMESTAMP}/"

# 更新 latest 链接
rm -f "$LATEST_LINK"
ln -s "${BACKUP_DIR}/${TIMESTAMP}" "$LATEST_LINK"

echo "增量备份完成: ${TIMESTAMP}"
echo "备份大小: $(du -sh ${BACKUP_DIR}/${TIMESTAMP} | cut -f1)"

# 安装 restic
sudo apt install restic    # Debian/Ubuntu
sudo dnf install restic    # Fedora

# 初始化备份仓库
restic init --repo /opt/minecraft/backups/restic

# 执行增量备份
restic backup /opt/minecraft/paper \
  --repo /opt/minecraft/backups/restic \
  --exclude cache \
  --exclude libraries \
  --tag minecraft

# 查看备份列表
restic snapshots --repo /opt/minecraft/backups/restic

# 恢复到指定时间点
restic restore latest \
  --repo /opt/minecraft/backups/restic \
  --target /opt/minecraft/paper-restored

# 设置保留策略
restic forget \
  --repo /opt/minecraft/backups/restic \
  --keep-daily 7 \
  --keep-weekly 4 \
  --keep-monthly 6 \
  --prune

# 安装 rclone
curl https://rclone.org/install.sh | sudo bash

# 配置云存储（以 Google Drive 为例）
rclone config
# 按提示选择 Google Drive 并完成授权

# 上传备份
rclone copy /opt/minecraft/backups/mc_backup_latest.tar.gz \
  remote:minecraft-backups/ \
  --progress

# 自动同步
rclone sync /opt/minecraft/backups/ \
  remote:minecraft-backups/ \
  --include "*.tar.gz" \
  --progress

# 安装
sudo apt install duplicity

# 加密备份到云存储
duplicity /opt/minecraft/paper/world \
  s3://s3.amazonaws.com/my-bucket/minecraft-backup \
  --encrypt-key YOUR_GPG_KEY \
  --full-if-older-than 7D

# 恢复
duplicity restore \
  s3://s3.amazonaws.com/my-bucket/minecraft-backup \
  /opt/minecraft/paper/world-restored

# 编辑 crontab
crontab -e

# 每 6 小时全量备份
0 */6 * * * /opt/minecraft/scripts/backup.sh >> /var/log/mc-backup.log 2>&1

# 每天凌晨 2 点做完整备份
0 2 * * * /opt/minecraft/scripts/full-backup.sh >> /var/log/mc-backup.log 2>&1

# 每周日凌晨 3 点上传到云存储
0 3 * * 0 /opt/minecraft/scripts/cloud-upload.sh >> /var/log/mc-backup.log 2>&1

# 每月 1 日清理旧云备份
0 4 1 * * rclone delete remote:minecraft-backups/ --min-age 90d

# /etc/systemd/system/mc-backup.timer

[Unit]
Description=Minecraft Backup Timer

[Timer]
OnCalendar=*-*-* */6:00:00
Persistent=true

[Install]
WantedBy=timers.target

# /etc/systemd/system/mc-backup.service

[Unit]
Description=Minecraft Backup Service

[Service]
Type=oneshot
ExecStart=/opt/minecraft/scripts/backup.sh
User=minecraft

sudo systemctl daemon-reload
sudo systemctl enable mc-backup.timer
sudo systemctl start mc-backup.timer

# 查看定时器状态
sudo systemctl list-timers mc-backup.timer

#!/bin/bash
# verify-backup.sh - 验证备份完整性

BACKUP_FILE="$1"
VERIFY_DIR="/tmp/mc-backup-verify"

if [ -z "$BACKUP_FILE" ]; then
    echo "用法: $0 <备份文件路径>"
    exit 1
fi

echo "=== 备份验证 ==="
echo "文件: $BACKUP_FILE"

# 1. 检查文件是否存在
if [ ! -f "$BACKUP_FILE" ]; then
    echo "错误: 备份文件不存在"
    exit 1
fi

# 2. 检查文件大小
SIZE=$(stat -c%s "$BACKUP_FILE")
if [ "$SIZE" -lt 1024 ]; then
    echo "错误: 备份文件过小 (${SIZE} bytes)"
    exit 1
fi
echo "文件大小: $(du -h "$BACKUP_FILE" | cut -f1)"

# 3. 验证压缩完整性
if [[ "$BACKUP_FILE" == *.tar.gz ]]; then
    if gzip -t "$BACKUP_FILE" 2>/dev/null; then
        echo "压缩完整性: 通过"
    else
        echo "错误: 压缩文件损坏"
        exit 1
    fi
fi

# 4. 检查关键文件是否存在
rm -rf "$VERIFY_DIR"
mkdir -p "$VERIFY_DIR"
tar -xzf "$BACKUP_FILE" -C "$VERIFY_DIR" 2>/dev/null

MISSING=0
for f in world/level.dat plugins; do
    if [ ! -e "${VERIFY_DIR}/$f" ]; then
        echo "警告: 缺少 $f"
        MISSING=$((MISSING + 1))
    fi
done

if [ "$MISSING" -eq 0 ]; then
    echo "关键文件: 全部存在"
else
    echo "警告: 缺少 ${MISSING} 个关键文件"
fi

# 5. 清理
rm -rf "$VERIFY_DIR"

echo "=== 验证完成 ==="

## 备份清单

| 备份类型 | 频率 | 保留时间 | 存储位置 | 负责人 |
|----------|------|----------|----------|--------|
| 世界增量 | 每 6h | 7 天 | 本地 | 自动脚本 |
| 全量备份 | 每天 | 30 天 | NAS | 自动脚本 |
| 异地备份 | 每周 | 90 天 | 云存储 | 手动触发 |
| 配置备份 | 每次变更 | 永久 | Git | 开发者 |

## 恢复测试

- [ ] 每月执行一次恢复测试
- [ ] 验证恢复后服务器可正常启动
- [ ] 验证玩家数据完整性

# 1. 停止服务器
sudo systemctl stop minecraft

# 2. 备份当前损坏的数据（以防万一）
mv /opt/minecraft/paper /opt/minecraft/paper_damaged_$(date +%s)

# 3. 从备份恢复
BACKUP_FILE="/opt/minecraft/backups/full/full_20260510.tar.gz"
mkdir -p /opt/minecraft/paper
tar -xzf "$BACKUP_FILE" -C /opt/minecraft/

# 4. 确认权限
chown -R minecraft:minecraft /opt/minecraft/paper

# 5. 启动服务器测试
sudo systemctl start minecraft

# 6. 检查日志
sudo journalctl -u minecraft -f

# 7. 验证服务器状态
# 在游戏内连接并检查世界是否正常

# 1. 停止服务器
sudo systemctl stop minecraft

# 2. 备份当前世界
mv /opt/minecraft/paper/world /opt/minecraft/paper/world_broken

# 3. 从备份中仅提取世界
tar -xzf /opt/minecraft/backups/latest.tar.gz -C /opt/minecraft/paper/ world/

# 4. 启动服务器
sudo systemctl start minecraft

# 使用 nice 降低备份进程优先级
nice -n 19 /opt/minecraft/scripts/backup.sh

# 使用 ionice 降低 IO 优先级
ionice -c 3 /opt/minecraft/scripts/backup.sh

# 使用 pigz 多线程压缩
tar -cf - world | pigz -p 4 > backup.tar.gz

# 使用 zstd 压缩（比 gzip 更快更小）
tar --zstd -cf backup.tar.zst world/

# 修剪世界中未使用的区块（详见第 04 章）
java -jar mcaselector.jar --mode delete --world world --radius 10000 --center 0,0

# 排除不必要的文件
tar -czf backup.tar.gz --exclude='world/region/r.10.*' world/

# 从 CoreProtect 恢复（如果有记录）
/co restore u:<玩家名> t:7d

# 从备份中提取玩家数据
tar -xzf backup.tar.gz world/playerdata/<uuid>.dat

# 从 LuckPerms 恢复权限
/lp user <玩家名> import