Betrieb

Wiederherstellung

Wiederherstellen eines vollständigen Backups in einen Bind-Mount oder ein benanntes Volume.

Die Wiederherstellung ersetzt aktive Daten. Stoppen Sie NasDash, sichern Sie den aktuellen Zustand geprüft, bestimmen Sie das Archivformat und verwenden Sie zunächst dieselbe Anwendungsversion. Behalten Sie Geheimniskonfiguration und Laufzeit-UID:GID bei. Die Oberfläche stellt keine Sicherungen wieder her.

NasDash-Sicherung oder Oberflächenarchiv

Ein .tar.gz-Archiv der Oberfläche enthält nasdash-backup.json und data/. Entpacken Sie es zunächst in einen neuen privaten Ordner; eine CLI-Sicherung besitzt bereits dieses Format. Stellen Sie aus einem Produkt-Checkout mit Node.js 22 in das tatsächlich eingebundene Hostverzeichnis wieder her. --force erlaubt den Ersatz; das bestehende Ziel wird für die Rettung in ein benachbartes .pre-restore-*-Verzeichnis umbenannt. Behalten Sie es bis zur erfolgreichen Prüfung. --target ist nötig, wenn die aktiven Daten vom Checkout-Standard abweichen.

# Interface archive only: extract into a NEW directory
umask 077
mkdir ./backups/nasdash-snapshot
tar -xzf ./backups/nasdash-interface-backup.tar.gz -C ./backups/nasdash-snapshot
docker compose stop nasdash
npm run data:restore -- --from ./backups/nasdash-snapshot --target ./data --force
# Grant the actual runtime UID:GID access to restored files before starting
docker compose start nasdash

Direktes Bind-Mount-Archiv

Ein direktes Archiv mit tar -C data . enthält unmittelbar die Dateien. Das Sicherungswerkzeug akzeptiert es nicht. Stoppen Sie NasDash, benennen Sie den aktuellen Datenordner um, erstellen Sie ein neues Ziel und entpacken Sie dort. Überlagern Sie kein bestehendes Verzeichnis: Alte Dateien oder Schlüssel könnten bleiben. Stellen Sie Besitzer-/ACL-Zugriff für die tatsächliche Laufzeitidentität her und starten Sie NasDash.

Benanntes Volume

Nutzen Sie vorzugsweise ein neues leeres Volume und behalten Sie das alte zum Zurückrollen. Das Beispiel setzt ein neues leeres nasdash-data-restore und ein geprüftes direktes Archiv voraus. Kopieren Sie bei einem Oberflächenarchiv nur den entpackten Inhalt von data/. Ändern Sie den Compose-Mount erst nach Vorbereitung der Zugriffsrechte. Löschen Sie das Original-Volume niemals vor der Prüfung.

docker compose -f docker-compose.named-volume.yml stop nasdash
docker run --rm \
  --volume nasdash-data-restore:/target \
  --volume "$PWD/backups:/backup:ro" \
  alpine sh -c 'tar -xzf /backup/nasdash-data-backup.tar.gz -C /target'

Prüfen Sie /api/health, die Anmeldung des Administrators und vorhandener Leserkonten, Seiten, Dienste, Topologie, Logos und jede Integration. Prüfen Sie im öffentlichen Modus den anonymen Zugriff anhand der gespeicherten Leserberechtigungen. Bewahren Sie den bisherigen Datenbestand und die Sicherung auf, bis die wiederhergestellte Instanz funktioniert. Wiederhergestellte Einstellungen können geplante Sicherungen erneut aktivieren; prüfen Sie diese ebenfalls.