1. Forum
    1. Rated threads
    2. Latest Posts
    3. Unresolved Threads
  2. Members
    1. Users Online
    2. Recent Activities
    3. Search Members
    4. Staff
  3. Tools
    1. Tutorials
    2. Community Benefits
    3. Docker Run > Compose
    4. compatibility list
    5. Marketplace
    6. RAID-Rebuilt Calculator
    7. RAID-Calculator
    8. Retro Ping-Pong
    9. Signature Generator
    10. S.M.A.R.T Analyser
    11. Electricity cost calculator
    12. UPS-Calculator
    13. Improve UGOS Pro
  4. Filebase
  5. Articles
  6. Blog
    1. Articles
  • Login
  • Register
  • Search
Skripte & Automatisierung
  • Everywhere
  • Skripte & Automatisierung
  • Articles
  • Pages
  • Forum
  • Files
  • Blog Articles
  • More Options
  1. UGREEN.FORUM - DACH Community
  2. Filebase
  3. Skripte & Automatisierung

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

  • RomanG
  • December 4, 2025 at 8:40 PM
  • 59 Downloads
  • 8 Comments
  • Download
  • Overview
  • Versions 4
  • Comments 8

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. :)

  • Virtuelle Maschine
  • VM
  • Backup
  • Sicherung
  • Skript
  • Version 4.0

    • RomanG
    • April 15, 2026 at 3:33 PM
    • 838.52 kB
    • 3 Downloads

    Neuerungen in v4

    • Disaster Recovery (DR) stark erweitert
    • Wiederherstellung gelöschter/verlorener VMs direkt aus Backup-XML + qcow2
    • Neu-Registrierung der VM in der UGREEN-Datenbank
    • Reparatur von VNC-/Freigabelink und Konsole
    • Neuer VNC-Guard zur Unterstützung der letzten UI-Schritte in UGOS
    • Dokumentation für den kompletten DR-Ablauf deutlich erweitert
  • Version 3

    • RomanG
    • December 11, 2025 at 10:16 PM
    • 298.53 kB
    • 39 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
msa
April 15, 2026 at 6:31 PM
  • Report Content

Hallo Roman!

vielen, vielen Dank für Deine Arbeit!!

Es funktioniert perfekt, ohne Probleme.

Jetzt kann ich wieder etwas ruhiger Schlafen!

Also, herzlichen Dank nochmal und bis die Tage!

Grüße

RomanG
April 15, 2026 at 8:13 PM
Author
  • Report Content

Klasse, dann haben sich ja die grauen Haare gelohnt. Ich habe das Disaster Recovery bestimmt auch über 20-mal getestet auf verschiedenen Geräten, sollte es dennoch irgendwo klemmen einfach schreiben :)

msa
March 6, 2026 at 7:16 PM
  • Report Content

Hört sich gut an, freue mich schon drauf!

msa
March 5, 2026 at 7:57 PM
  • Report Content

Hallo Roman, danke für die schnelle Rückmeldung 😀

Nutze die Version v3

Ich habe meinen (dummen) Fehler wahrscheinlich gefunden. Die VM muss wohl noch vorhanden sein. Ich habe sie nach dem Backup immer komplett gelöscht.

Dann ist es doch eher ein Snapshot der gesichert wird?

Für ein komplettes Backup und Wiederherstellung, muss die VM ja eigentlich nicht mehr vorhanden sein.

Grüße

RomanG
March 6, 2026 at 6:54 PM
Author
  • Report Content

In der V4 wird alles automatisch angelegt, nach meiner Kur mache ich mich drann und veröffentliche das. Also rechne so in 5 Wochen damit :)

msa
March 4, 2026 at 9:00 PM
  • Report Content

Hallo RomanG,

erstmal vielen Dank für die Arbeit!

Das Backup funktioniert tadellos.

Bei dem Restore hab ich allerdings Probleme.

maryjan@ugreen-nas:/volume1/vm-backup$ sudo ./vm_restore.sh 04_03_2026_20-14-50 test
04.03.2026 20:47:12 - === VM-Rücksicherung gestartet ===
04.03.2026 20:47:12 - Backup-Verzeichnis: 04_03_2026_20-14-50
04.03.2026 20:47:12 - Ziel-VM-Spezifikation: Nginx-Ubuntu24-192-168-0-25
04.03.2026 20:47:12 - FEHLER: Es wurde keine VM gefunden, die zu 'test' passt

Ich finde den Fehler einfach nicht. Hast Du evtl. Ideen woran es liegen könnte?

Grüße

RomanG
March 4, 2026 at 10:22 PM
Author
  • Report Content

H, vielen Dank für das Lob.
Welche Version des Scripts nutzt du genau?
Bitte einmal die UUID nutzen statt des Namens. Ich bin gerade in der Überarbeitung des Scripts, das wird allerdings noch dauern.
Bei mir klappt alles mit der UUID. Diese findest du in der Sicherung.

04.12.2025 15:38:39 - === VM-Rücksicherung gestartet ===
04.12.2025 15:38:39 - Backup-Verzeichnis: 04_12_2025_15-29-47
04.12.2025 15:38:39 - Ziel-VM-Spezifikation: Win2022
04.12.2025 15:38:40 - Gefundene Ziel-VM: Win2022 (128cea77-77a0-4cb9-b4e0-1434d0feb2a6)
04.12.2025 15:38:40 - Backup-Ordner für VM: 04_12_2025_15-29-47/128cea77-77a0-4cb9-b4e0-1434d0feb2a6
04.12.2025 15:38:40 - Im Backup gefundene Datenträger:
04.12.2025 15:38:40 - 128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2
04.12.2025 15:38:40 - Aktuelle Datenträger der VM:
04.12.2025 15:38:40 - /volume2/@kvm/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2
04.12.2025 15:38:40 - Zu verwendende Zuordnung (Ziel <- Backup):
04.12.2025 15:38:40 - /volume2/@kvm/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2 <- 04_12_2025_15-29-47/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2
04.12.2025 15:38:40 - VM Win2022 (128cea77-77a0-4cb9-b4e0-1434d0feb2a6) ist aktiv – fahre sie für die Rücksicherung herunter.
04.12.2025 15:38:46 - VM Win2022 (128cea77-77a0-4cb9-b4e0-1434d0feb2a6) ist nun aus (Status: shut off).
04.12.2025 15:38:46 - Stelle Datenträger wieder her:
04.12.2025 15:38:46 - Quelle: 04_12_2025_15-29-47/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2
04.12.2025 15:38:46 - Ziel: /volume2/@kvm/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2
04.12.2025 15:38:46 - Temp: /volume2/@kvm/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2.restore_tmp_1764859126
04.12.2025 15:43:37 - Rücksicherung für /volume2/@kvm/128cea77-77a0-4cb9-b4e0-1434d0feb2a6/128cea77-77a0-4cb9-b4e0-1434d0feb2a6_fa9a2ae8-c300-4077-b768-1cf512f7e933.qcow2 erfolgreich.
04.12.2025 15:43:38 - Starte VM Win2022 (128cea77-77a0-4cb9-b4e0-1434d0feb2a6) nach der Rücksicherung wieder.
04.12.2025 15:43:40 - VM-Rücksicherung für Win2022 (128cea77-77a0-4cb9-b4e0-1434d0feb2a6) abgeschlossen. Status: Erfolgreich
04.12.2025 15:43:40 - === VM-Rücksicherung beendet ===

In nächster Zeit wird es eine V4 geben mit einer automatischen Rücksicherungsoption inkl. Einbindung in die VM App von UGreen.

Ansonsten benötige ich bitte genauere Infos. Ist die VM vorhanden?

Versuche mal bitte Folgendes:
virsh list --all --name

Danach als Beispiel hier bitte deine Daten nutzen der VM:
sudo ./vm_restore.sh 04_03_2026_20-14-50 128cea77-77a0-4cb9-b4e0-1434d0feb2a6
virsh dumpxml 128cea77-77a0-4cb9-b4e0-1434d0feb2a6 | grep -i "<title>"

Bitte falls es nicht klappt diese Infos posten mit deinen Daten der VM

RomanG
April 15, 2026 at 6:10 PM
Author
  • Report Content

msa ist dann online. Viel Spaß beim Testen. Es hat mich viele Nerven gekostet und wieder ein paar Graue Haare mehr, aber es klappt. Bitte unbedingt das Handbuch lesen.

File Details

License Agreement
Freie Verwendung

More Files by RomanG

  • USVWatch - USV-Status Benachrichtigung per E-Mail

    RomanG
    February 10, 2026 at 11:43 PM
  • UGREEN Minecraft Docker Pack

    RomanG
    April 5, 2026 at 6:16 PM
  • UGREEN SecurityWatch

    RomanG
    April 4, 2026 at 5:20 PM
  • Syncthing Reporter für UGREEN NAS (UGOS)

    RomanG
    October 27, 2025 at 4:08 PM
  • Schulmanager Homework Watcher

    RomanG
    March 4, 2026 at 9:01 PM
All Files
  1. COMMUNITY
    1. Tutorials
    2. Benefits
    3. Compatibility list
    4. Marketplace
    5. Milestones
    6. Retro Ping-Pong
    7. Signature Generator
    8. Improve UGOS Pro
  2. TOOLS
    1. Docker Run > Compose
    2. RAID-Rebuild Calculator
    3. RAID-Calculator
    4. S.M.A.R.T Analyser
    5. Electricity cost calculator
    6. UPS-Calculator
  3. SUPPORT & PARTICIPATION
    1. Questions & Answers
    2. Contact
    3. Support
  4. RULES & LEGAL MATTERS
    1. Privacy Policy
    2. Legal Notice
    3. Terms of Use
    4. Community rules
ugreen-forum.de ist eine unabhängige Community und steht in keinerlei Verbindung zur UGREEN Group Limited. Alle Marken sind Eigentum der jeweiligen Inhaber.
Powered by WoltLab Suite™
EVENT