AposaBackup

AposaBackup

Мод для Fabric, автоматически создающий резервные копии миров Minecraft с локальным хранилищем и поддержкой облачных бэкапов через S3 API (например, Cloudflare R2). Работает как на выделенных серверах, так и в одиночных мирах.

Возможности

• Автоматические бэкапы по расписанию — настраиваемый интервал (по умолчанию: 60 мин)
• Ручные бэкапы — /backup create с необязательными комментариями
• Бэкап при выключении — автоматический бэкап при остановке сервера
• Локальный бэкап — полные ZIP-архивы с политикой ротации (последние N + ежедневные снимки)
• Облачный бэкап — дифференциальная загрузка в Cloudflare R2 через S3 API с дедупликацией по содержимому
• Восстановление — двухэтапное восстановление с подтверждением, авто-бэкап перед восстановлением
• Скачивание — экспорт облачного бэкапа в локальный ZIP
• Уведомления в игре — сообщения в action bar о статусе бэкапа
• Горячая конфигурация — все настройки меняются через команды, перезапуск не требуется

Установка

1. Скачайте JAR мода из релизов
2. Поместите его в директорию mods/ вашего сервера или клиента
3. Запустите сервер — конфиг по умолчанию будет создан в config/aposabackup.json

Быстрый старт

# Создать ручной бэкап
/backup create

# Создать бэкап с комментарием
/backup create before big build

# Список локальных бэкапов
/backup list

# Проверить статус системы бэкапов
/backup status

Команды

Все команды требуют прав OP уровня 3 (администратор).

Полный справочник команд см. в github/docs/COMMANDS.md.

Конфигурация

Файл конфигурации находится в config/aposabackup.json. Все параметры также можно изменить через /backup config.

{
  "version": 1,
  "local": {
    "enabled": true,
    "backupDir": "./backups",
    "format": "ZIP",
    "compressionLevel": 6,
    "intervalMinutes": 60,
    "recentBackups": 10,
    "dailyKeepDays": 7,
    "shutdownBackup": true,
    "excludePatterns": ["session.lock", "*.tmp"]
  },
  "cloud": {
    "enabled": false,
    "maxBackups": 30,
    "dailyKeepDays": 7,
    "uploadTimeoutSeconds": 300,
    "retryCount": 3,
    "r2": {
      "accountId": "",
      "accessKeyId": "",
      "secretAccessKey": "",
      "bucketName": "mc-server-backups",
      "region": "auto",
      "pathPrefix": "my-server/",
      "customEndpoint": ""
    }
  },
  "notification": {
    "enabled": true,
    "style": "ACTION_BAR"
  }
}

Подробный справочник по конфигурации см. в github/docs/CONFIGURATION.md.

Облачный бэкап (например, Cloudflare R2)

AposaBackup поддерживает дифференциальные облачные бэкапы через S3-совместимый API Cloudflare R2. Как это работает:

1. Загружаются только изменённые региональные файлы .mca (адресация по содержимому SHA-256)
2. Файлы сжимаются gzip и хранятся как чанки с адресацией по содержимому
3. Каждый бэкап создаёт манифест, ссылающийся на чанки
4. Неиспользуемые чанки удаляются сборщиком мусора при удалении старых манифестов Настройка: Пошаговые инструкции см. в github/docs/CLOUD_SETUP.md.

Политика ротации бэкапов

Локальные бэкапы

• Последние бэкапы: хранит последние N бэкапов (по умолчанию: 10)
• Ежедневные снимки: автоматически сохраняет последний бэкап каждого дня в течение N дней (по умолчанию: 7)

Облачные бэкапы

• Хранение манифестов: хранит последние N манифестов (по умолчанию: 30)
• Ежедневные снимки: сохраняет ежедневные манифесты в течение N дней (по умолчанию: 7)
• Сборка мусора: удаляет неиспользуемые чанки после очистки манифестов

Процесс восстановления

/backup restore world_2026-06-22_14-00-00.zip
→ "About to restore backup. Current world will be backed up first."

/backup confirm
→ Creates pre-restore backup → Saves pending restore → Stops server

[Server restarts]
→ Detects pending restore → Decompresses backup → World restored