UGREEN NAS – VM Backup & Restore Scriptpaket (Community-Lösung)

Kleines Community-Skriptpaket für automatische VM-Backups auf dem UGREEN NAS. Sichert XML + qcow2, kann VMs vorher stoppen und danach wieder starten, legt Zeitstempel-Ordner an, verschickt optional Mail-Benachrichtigungen und räumt alte Backups auf. Restore-Skript für die einfache Rücksicherung ist dabei.

In den letzten Wochen kam immer wieder die Frage auf: „Wie sichere ich meine VMs auf dem UGREEN NAS sinnvoll – und wie spiele ich sie im Notfall wieder zurück?“

Dafür habe ich ein kleines Scriptpaket gebaut, das genau das übernimmt:

  • Automatisches VM-Backup für die offizielle „Virtuelle Maschine“-App
  • Sicherung der XML-Konfiguration und qcow2-Datenträger
  • Optionales Herunterfahren laufender VMs vor dem Backup und automatischer Neustart
  • Speicherung der Backups auf einem anderen Volume (z. B. /volume3)
  • Zeitstempel-Ordner im Format TT_MM_JJJJ_HH-MM-SS
  • E-Mail-Benachrichtigung bei „Erfolgreich“ oder „Fehlgeschlagen“
  • Einfache Logrotation und Aufbewahrung der letzten X Backupläufe
  • Separates Restore-Script zur Rücksicherung einer einzelnen VM aus einem gewählten Backup

Das Paket besteht aus:

  • vm_backup.sh – Backup-Script
  • vm_restore.sh – Restore-Script
  • vm_backup.conf – zentrale Konfigurationsdatei
  • einer ausführlichen deutschen Anleitung im PDF-Format

Was ihr anpassen müsst:

  • Pfade (falls ihr nicht /volume3/dockersich/VMBackup verwendet)
  • SMTP-Daten in der vm_backup.conf (Mailserver, Benutzer, Passwort, Absender/Empfänger)
  • VM-Namen in VM_NAMES (z. B. Win2022, Windows11)

Wichtiger Hinweis:

Das Ganze ist eine Community-Lösung, kein offizielles UGREEN-Feature.

Download:
Das komplette Paket inkl. Anleitung findet ihr im Anhang.

Feedback, Verbesserungsvorschläge und Tests auf anderen DXP-Modellen sind ausdrücklich willkommen. :)

  • Version 3

    • RomanG
    • December 11, 2025 at 10:16 PM
    • 298.53 kB
    • 20 Downloads

    Neuerungen in v3

    • Überarbeitetes Restore-Script:
      Eigentümer & Rechte der qcow2-Dateien werden nach der Rücksicherung wiederhergestellt, um „Permission denied“-Probleme beim Start der VM zu vermeiden.
    • Erweiterte Dokumentation:
      Neues Kapitel „Desaster-Recovery nur mit der UGREEN-Oberfläche (ohne Scriptpaket)” erklärt Schritt für Schritt, wie ihr eine VM auch nur mit der UGREEN-GUI über „Virtuelle Maschine → Importieren“ aus einem qcow2-Backup wiederherstellen könnt.

  • Version 2

    • RomanG
    • December 9, 2025 at 4:58 PM
    • 262.26 kB
    • 1 Download

    Neuerungen in v2

    Auf Basis von User-Feedback wurde das Verhalten beim Stoppen der VMs verbessert:

    • Neue Option in der Konfiguration:
      STOP_ONLY_BACKUP_VMS="yes"
    • Bei yes werden nur die VMs gestoppt (und später wieder gestartet), die tatsächlich gesichert werden (laut VM_NAMES / VM_DOMAINS).
    • Andere laufende VMs, die nicht Teil des Backups sind, bleiben unangetastet.
    • Bei no (oder wenn die Option nicht gesetzt ist) bleibt das Verhalten wie in der ersten Version: alle laufenden VMs werden für das Backup gestoppt.

  • Version 1.0.0

    • RomanG
    • December 4, 2025 at 8:40 PM
    • 261.52 kB
    • 12 Downloads