Backup-System
Backup-System
Drei Backup-Typen, Wiederherstellung mit intelligentem Diff-Verfahren und Backup-Verwaltung.
Backup-Typen
| Typ |
Was enthalten ist |
Methode |
API |
| Welt |
Nur Weltdaten |
Native Java-Mod-API |
POST /backups |
| Mods |
Alle Mods im mods/-Verzeichnis |
Daemon-ZIP-Kompression |
DaemonFileRepository |
| Voll |
Gesamtes Server-Verzeichnis |
Daemon-ZIP-Kompression |
DaemonFileRepository |
Berechtigungen
| Aktion |
Berechtigung |
| Backups anzeigen |
hytale-admin.backups-read |
| Backups erstellen/wiederherstellen/löschen |
hytale-admin.backups-manage |
Backup erstellen
| Detail |
Wert |
| Erfolg |
„Backup erstellt" |
| Fehler |
„Backup-Erstellung fehlgeschlagen" + optionaler Fehler aus $result['error'] |
Ablauf
- Backup-Typ wählen (Welt, Mods oder Voll)
- Backup erstellen klicken
- Bei Welt-Backups: API handhabt das Backup serverseitig
- Bei Mods/Voll-Backups: Daemon komprimiert das Zielverzeichnis als ZIP
- Backup wird im konfigurierten
backupDir-Verzeichnis gespeichert
Backup wiederherstellen
Intelligenter Diff-Wiederherstellungsprozess
- Temporäres Verzeichnis für Extraktion erstellen
- Entpacken des Backup-Archivs ins temporäre Verzeichnis
- Dateien vergleichen — Backup-Dateien mit aktuellen Dateien abgleichen
- Nur geänderte Dateien ersetzen — nur tatsächlich unterschiedliche Dateien werden überschrieben
- Aufräumen des temporären Verzeichnisses
Wichtig: Server vor der Wiederherstellung stoppen, um Dateikonflikte zu vermeiden.
Backup löschen
| Detail |
Wert |
| Erfolg |
„Backup gelöscht" |
| Fehler |
„Backup-Löschung fehlgeschlagen" |
Die Backup-Tabelle aktualisiert sich alle 60 Sekunden.
Fehlerbehebung
„Backup-Erstellung fehlgeschlagen"
- Festplatte voll: Verfügbaren Speicherplatz prüfen
- Berechtigung: Backup-Verzeichnis muss beschreibbar sein
- Der API-Fehler in
$result['error'] nennt den genauen Grund
„Backup-Wiederherstellung fehlgeschlagen"
- Backup-Datei möglicherweise beschädigt
- Server zuerst stoppen — Dateien könnten gesperrt sein
- Ungenügend Speicherplatz für temporäre Extraktion
Wann welchen Backup-Typ verwenden
| Szenario |
Empfohlener Typ |
| Schnelle Sicherung vor Experimenten |
Welt |
| Vor Mod-Updates |
Mods |
| Vor größeren Änderungen |
Voll |
| Regelmäßige planmäßige Backups |
Welt (klein, schnell) |
| Vor Server-Migration |
Voll |