Zum Hauptinhalt springen

VM-Einrichtung

Das Einrichten einer VM auf Unraid ist eine flexible Möglichkeit, vollständige Betriebssysteme - wie Windows, Linux oder andere Plattformen - parallel zu Ihren Containern und nativen Anwendungen zu betreiben. Egal, ob Sie neue Software testen, Legacy-Anwendungen ausführen, eine Desktop-Umgebung hosten oder Hardware-Passthrough für Gaming oder kreative Arbeit nutzen möchten, Unraids VM Manager macht den Prozess für alle Erfahrungsstufen zugänglich.

New in Unraid 7.0

Unraid 7.x bringt bedeutende Verbesserungen für VMs, einschließlich:

  • VM-Klone und -Snapshots
  • Benutzerdefinierte VM-Vorlagen
  • Inline-XML-Bearbeitung/Ansicht
  • Erweiterte Funktionen für GPU-Sharing und -Passthrough

Schauen Sie sich den Abschnitt VM-Manager-Funktionen für weitere Details an.

Mit vorbereitetem System und festgelegten Präferenzen können Sie mithilfe des WebGUI eine neue virtuelle Maschine (VM) erstellen.

Erstellen Ihrer eigenen virtuellen Maschinen​

Nachdem Ihr System vorbereitet und die Einstellungen vorgenommen sind, können Sie über das WebGUI eine neue VM erstellen.

Before Sie beginnen
  • Klicken Sie auf VM hinzufügen auf der Seite Virtuelle Maschinen.
  • Laden Sie Ihr Betriebssystem-Installations-ISO und für Windows VMs die neuesten VirtIO-Treiber-ISOs in den isos Share hoch.
  • Entscheiden Sie, ob Sie GPU-Passthrough oder VNC für die Grafik verwenden möchten.

Zum Erstellen einer grundlegenden VM:

  1. Klicken Sie auf VM hinzufügen auf der Seite Virtuelle Maschinen.
  2. Setzen Sie die Vorlage auf Benutzerdefiniert oder wählen Sie eine vordefinierte OS-Vorlage für gängige Distributionen.
  3. Geben Sie einen Namen und optional eine Beschreibung für Ihre VM ein.
  4. Aktivieren Sie Autostart, wenn Sie möchten, dass die VM automatisch mit dem array gestartet wird.
  5. Wählen Sie den Typ des Betriebssystems aus. Dadurch wird auch das VM-Symbol angepasst.
  6. Weisen Sie der VM CPU-Kerne zu. Sie können bis zu der Anzahl der auf Ihrem Host verfügbaren physischen Kerne zuweisen.
  7. Legen Sie den Initialspeicher (RAM) für die VM fest. Konsultieren Sie die Dokumentation Ihres Gastbetriebssystems für empfohlene Werte.
  8. Wählen Sie das OS-Installations-ISO aus Ihrer isos Freigabe.
  9. Konfigurieren Sie den primären vDisk (Ort, Größe und Typ).
    • Die primäre vDisk speichert das Betriebssystem der VM.
    • Fügen Sie bei Bedarf zusätzliche vDisks mithilfe des Pluszeichens hinzu.
  10. Wählen Sie eine Grafikkarte:
    • Wählen Sie VNC für den Fernzugriff oder eine physische GPU für Passthrough.
    • Weisen Sie eine USB-Tastatur/Maus zu, wenn eine physische GPU verwendet wird.
    • Legen Sie ein VNC-Passwort fest, falls gewünscht.
  11. Weisen Sie eine Soundkarte zu (optional, aber erforderlich für HDMI-Audio über GPU).
  12. Weisen Sie bei Bedarf USB-Geräte zu.
    • Geräte müssen vor dem Start der VM angeschlossen werden (USB-Hotplug wird nicht unterstützt).
    • Das Unraid-USB-Flash-Gerät steht nicht zur Zuweisung zur Verfügung.
  13. Klicken Sie auf VM erstellen. Die VM startet automatisch, es sei denn, Sie deaktivieren VM nach Erstellung starten.

Benutzerdefinierte VM-Vorlagen​

Unraid 7.1+ führt Benutzer-VM-Vorlagen ein, die das Speichern und Wiederverwenden Ihrer benutzerdefinierten VM-Konfigurationen erleichtern. Benutzer-Vorlagen vereinfachen die VM-Bereitstellung und sorgen für Konsistenz in den Setups.

Erstellen einer Benutzervorlage:

  1. Bearbeiten Sie die VM, die Sie als Vorlage speichern möchten.
  2. Wählen Sie Vorlage erstellen/ändern und geben Sie einen Namen ein.
  3. Ihre Vorlage ist jetzt im Bereich Benutzervorlagen auf dem VM hinzufügen-Bildschirm verfügbar.

Um eine Benutzervorlage zu verwenden:

  • Auf der VMs-Seite klicken Sie auf VM hinzufügen und wählen Ihre Vorlage im Abschnitt Benutzer-Vorlagen aus.

Import/Export:

  • Bewegen Sie den Mauszeiger über eine Benutzervorlage und klicken Sie auf den Pfeil, um sie auf Ihren Server zu exportieren oder herunterzuladen.
  • Verwenden Sie auf einem anderen Unraid-System Import aus Datei oder Hochladen, um die Vorlage hinzuzufügen.

Neu in Unraid 7.x: VM-Manager​

Unraid 7.x führt eine Reihe leistungsstarker Verbesserungen für den VM Manager ein, die den Prozess des Betriebs und Managements von VMs vereinfachen. Diese Funktionen richten sich sowohl an Anfänger als auch an fortgeschrittene Benutzer und erleichtern das Einrichten, Anpassen und Optimieren Ihrer VMs.

:::tip[Highlights]

  • Sparen Sie Zeit mit VM-Klone, Snapshots und wiederverwendbaren Vorlagen
  • Optimieren Sie Leistung und Kompatibilität mit erweiterten Passthrough- und Speicheroptionen
  • Genießen Sie verbesserte Sichtbarkeit und Kontrolle mit Nutzungsstatistiken und Inline-XML-Bearbeitung

:::

Erweiterte Grafik- und GPU-Sharing-Optionen
  • VM-Klonen & Snapshots: Vervielfältigen Sie VMs oder speichern/wiederherstellen Sie ihren Zustand schnell für Tests oder Backups.
  • Benutzer VM Vorlagen: Speichern Sie Ihre benutzerdefinierten VM-Konfigurationen und setzen Sie neue VMs mit nur wenigen Klicks ein.
  • Inline-XML-Ansicht/Bearbeitung: Betrachten oder kopieren Sie das vom WebGUI generierte XML sofort; wechseln Sie in den XML-Modus für erweiterte Bearbeitungen.
  • Autostart deaktivieren: Wählen Sie aus, welche VMs automatisch mit Ihrem array starten.
  • Timer/Offset-Konfigurationsoptionen
Workflow-Verbesserungen
  • PCI-Multifunktion/andere: Weisen Sie komplexe PCI-Geräte oder Gruppen für fortgeschrittene Passthrough-Szenarien zu.
  • QEMU-Befehlszeilen-Passthrough: Fügen Sie benutzerdefinierte QEMU-Argumente für eine Expertenstufe VM-Feinabstimmung hinzu.
  • Speicherüberschreibung: Geben Sie den Speicherort für jeden virtuellen Disk der VM an.
  • SSD-Flag & Unmap: Optimieren Sie die vDisk-Leistung für SSDs und aktivieren Sie Discard/Unmap-Unterstützung.
  • SR-IOV für Intel-iGPU: Teilen Sie integrierte Intel-Grafiken zwischen mehreren VMs.
  • VM-Namen-Validierung für ZFS: Verhindern Sie die Verwendung unzulässiger Zeichen in VM-Namen für ZFS-Pools.
Erweiterte Hardware- und Speicheroptionen
  • VirGL & QXL virtuelle GPUs: Teilen Sie Intel/AMD-GPUs zwischen mehreren Linux-VMs oder nutzen Sie QXL für Multi-Screen/Memory-Optionen.
  • CPU-Pinning optional: Lassen Sie Unraid die CPU-Zuteilung automatisch verwalten oder pinnen Sie Kerne manuell nach Bedarf.
Erweiterte Grafik- und GPU-Sharing-Optionen
  • View all graphics cards and VM-assigned IP addresses in the VM tab
  • Unterstützung für QEMU PPC64-Ziel und qemu:override
  • Hypervclock-Unterstützung für Windows-VMs
  • „Wanderbar“ an/aus für die emulierte CPU
  • Timer/Offset-Konfigurationsoptionen
  • Keine Keymap/nogpu-Optionen für spezifische Anwendungsfälle verfügbar
  • Verbesserte Auswahl und Bearbeitung von VM-Icons
  • Warnungen bei der Zuweisung der primären GPU als Passthrough (kann vBIOS erfordern)
  • Starten Sie Unraid-VMs im GUI-Modus mit dem QXL-Videotreiber
  • Verschiedene Lösungen für Pfad- und Icon-Probleme in XML-Ansicht

VM-Snapshots​

VM-Snapshots ermöglichen es Ihnen, den aktuellen Zustand Ihrer VM zu einem bestimmten Zeitpunkt zu speichern. Sie können zu diesem Zustand zurückkehren, falls etwas schiefgeht, oder Snapshots nutzen, um Änderungen sicher zu testen. Dies ist besonders nützlich, bevor Sie neue Software installieren, Konfigurationsänderungen vornehmen oder Systemupdates durchführen.

How VM snapshots work

Wenn Sie einen Snapshot erstellen, generiert Unraid eine "Overlay-Datei", die alle nach diesem Zeitpunkt vorgenommenen Änderungen an Ihrer VM erfasst. Sie können es sich so vorstellen:

  • Original-VM-Disk: Dies stellt den aktuellen Zustand Ihrer VM dar (ähnlich einem Foto).
  • Snapshot-Overlay: Dies ist eine separate Datei, die alle nach dem Snapshot vorgenommenen Änderungen aufzeichnet (wie eine Liste von Bearbeitungen).
  • VM läuft weiter: Ihre VM nutzt sowohl die Originaldisk als auch die Overlay-Datei zusammen.

Diese Einrichtung ermöglicht es Ihnen, mehrere Snapshots zu erstellen, wobei jeder eine eigene Overlay-Datei erzeugt. So können Sie problemlos zu einem beliebigen vorherigen Zustand zurückkehren.

Beispielszenario:

  1. Sie erstellen einen Snapshot namens "Saubere Windows-Installation".
  2. Sie installieren einige Software und nehmen Änderungen vor.
  3. Sie erstellen einen weiteren Snapshot namens "Nach der Software-Installation".
  4. Sie können nun entweder zur sauberen Installation oder zum Zustand nach der Softwareinstallation zurückkehren.
  5. Sie können auch Block Commit oder Block Pull verwenden, um Änderungen dauerhaft zu machen.

Um eine Snapshot Ihrer VM zu erstellen:

  1. Gehen Sie zur VMs-Seite im WebGUI.
  2. Klicken Sie auf den VM-Namen, um Details zu erweitern.
  3. Suchen Sie nach dem Abschnitt Snapshots und klicken Sie auf Snapshot erstellen.
  4. Geben Sie einen beschreibenden Namen für Ihren Snapshot ein (zum Beispiel "Vor dem Windows-Update" oder "Zustand der sauberen Installation").
  5. Speicherabbild-Option: In den aktuellen Unraid-Versionen ist das Kontrollkästchen "Speicherabbild" standardmäßig nicht ausgewählt. Wenn Sie es auswählen, wird der RAM der VM für ein vollständiges speicherunterstütztes Snapshot eingeschlossen (erfasst den laufenden Zustand, ist jedoch größer und langsamer zu erstellen/wiederherstellen). Wenn es unausgewählt bleibt, wird ein reines Festplattensnapshot erstellt (kleiner und schneller, aber alle nicht gespeicherten In-Memory-Daten gehen verloren). Entscheiden Sie basierend darauf, ob Sie vollständige Live-Zustandserhaltung oder nur Datenträgerwiederherstellung benötigen.
  6. Klicken Sie auf Erstellen, um den Snapshot zu speichern.
Beste Praktiken
  • Erstellen Sie Snapshots, bevor Sie wesentliche Änderungen an Ihrer VM vornehmen.
  • Verwenden Sie beschreibende Namen, die Ihnen helfen, sich zu erinnern, was der Snapshot enthält.
  • Wählen Sie Speicherabbild basierend auf Ihren Bedürfnissen: aktivieren Sie es für vollständige Live-Zustandserhaltung oder deaktivieren Sie es für schnellere Festplattennrecovery.
  • Bewahren Sie Schnappschüsse für wichtige Meilensteine auf, aber löschen Sie alte, um Speicherplatz zu sparen.

Snapshot-Speicherung​

Snapshots verwenden Speicherplatz auf Ihrem System. Jeder Snapshot speichert nur die Unterschiede zwischen dem aktuellen Zustand und dem Snapshot-Zustand; diese Unterschiede können jedoch im Laufe der Zeit zunehmen.

Hier sind einige Punkte zu beachten:

  • QCOW2-Festplatten unterstützen Snapshots und funktionieren gut mit dieser Funktion.
  • Storage location: Snapshots are stored with your VM files, so make sure you have enough space on your cache pools or array.

Speicherort der Snapshot-Speicherung:

  • Snapshot-Metadaten werden in /etc/libvirt/qemu/snapshotdb/VM_name/ gespeichert.
  • Actual snapshot data is stored alongside your VM files on cache pools or array.
Advanced snapshot concepts

Für detailliertere technische Informationen darüber, wie VM-Snapshots funktionieren, einschließlich Blockdiagrammen und fortgeschrittenen Szenarien mit mehreren Snapshots, sehen Sie sich die QEMU-Snapshots Dokumentation an.

Common use cases
  • Vor Systemupdates: Erstellen Sie einen Snapshot, bevor Sie Windows-Updates oder Linux-Paketaktualisierungen installieren. Sollte etwas schiefgehen, können Sie schnell zu einer früheren Version zurückkehren.
  • Software-Testen: Installieren Sie neue Anwendungen oder nehmen Sie Konfigurationsänderungen vor. Wenn Sie mit den Ergebnissen nicht zufrieden sind, kehren Sie zu Ihren sauberen VM-Snapshots von vor den Änderungen zurück.
  • Entwicklungsarbeit: Erstellen Sie Snapshots in verschiedenen Phasen Ihres Projekts. Dies ermöglicht Ihnen, frei zu experimentieren und zu bekannten guten Zuständen zurückzukehren.
  • Backup-Strategie: Während es kein Ersatz für richtige Backups ist, bieten Snapshots eine schnelle Wiederherstellung für jüngste Änderungen.

Verwendung von virtuellen GPUs und GPU-Sharing​

Unraid unterstützt jetzt fortgeschrittenes GPU-Sharing über VirGL und QXL für Linux-VMs (und einige Nvidia-GPUs mit dem Nouveau-Treiber).

  • Um VirGL zu verwenden: Stellen Sie Grafikkarte auf Virtuell und VM-Konsolen-Video-Treiber auf VirtIO(3D) ein.
  • Um QXL zu verwenden: Stellen Sie Grafikkarte auf Virtuell und VM-Konsolen-Video-Treiber auf QXL (beste).
  • VirGL gibt kein Bild an einen physischen Monitor aus und ist nicht kompatibel mit Windows-VMs oder Standard-Nvidia-Plugins.
  • QXL unterstützt mehrere Bildschirme und konfigurierbaren Videospeicher.

Erweiterte Optionen​

Erweitern Sie diesen Abschnitt, um Anleitungen zu erweiterten Optionen anzuzeigen

Wechseln Sie auf der Seite VM hinzufügen zur Erweiterten Ansicht, um auf zusätzliche Einstellungen zuzugreifen.

Hier sind die wichtigsten erweiterten Optionen, in fokussierte Abschnitte unterteilt:

CPU-Modus:

  • Host-Passthrough: Stellt alle Host-CPU-Funktionen der VM zur Verfügung, um maximale Leistung zu erzielen.
  • Emuliert: Verwendet ein generisches CPU-Modell, reduziert Kompatibilitätsprobleme, begrenzt jedoch die Leistung.

Memory-Ballooning:

  • Legen Sie einen Maximalspeicher-Wert fest, um dynamische Speicherzuordnung (memory ballooning) zu ermöglichen.
  • Nicht verfügbar für VMs mit zugewiesenen PCI-Geräten (z.B., GPU-Passthrough).

Maschinentyp:

  • i440fx: Standard für Windows-VMs. Ändern Sie dies nur, wenn Sie Probleme mit GPU-Passthrough haben.
  • Q35: Standard für Linux-VMs und empfohlen für die meisten modernen Betriebssysteme, insbesondere mit GPU-Passthrough.

BIOS-Typ:

  • SeaBIOS: Traditionelles BIOS für ältere Betriebssysteme.
  • OVMF: UEFI BIOS erforderlich für Windows 8+, die meisten modernen Linux-Distros und GPU-Passthrough.
notiz

Der BIOS-Typ kann nur beim Erstellen einer neuen VM eingestellt werden.

Hyper-V-Erweiterungen:

  • Für Windows-VMs aktivieren Sie die Hyper-V-Erweiterungen zur Verbesserung der Kompatibilität und Leistung.

VirtIO-Treiber-ISO:

  • Überschreiben Sie das Standard-VirtIO-ISO bei Bedarf, insbesondere für Tests oder bei Verwendung neuerer Treiber.

vDisk-Typ:

  • RAW: Beste Leistung, weniger flexibel für Snapshots.
  • QCOW2: Unterstützt Snapshots, bietet aber etwas geringere Leistung.

VirtFS-Zuordnungen (Linux-VMs):

  • Fügen Sie mehrere VirtFS-(9p)-Freigaben für die Dateisystemintegration zwischen Host und Gast hinzu.
  • Siehe die QEMU 9p-Dokumentation für Details.

Netzwerkeinstellungen:

  • Ändern Sie die Netzwerk-MAC-Adresse oder wählen Sie eine alternative Netzwerkbrücke aus.
  • Klicken Sie auf das Aktualisierungssymbol, um automatisch eine neue MAC-Adresse zu generieren.
  • Fügen Sie bei Bedarf zusätzliche virtuelle Netzwerkschnittstellen hinzu.
Troubleshooting tipps
  • Wenn Ihre VM nicht startet, überprüfen Sie Ihre ISO- und vDisk-Pfade.
  • Für GPU-Passthrough, stellen Sie sicher, dass Ihre Hardware und BIOS-Einstellungen IOMMU/VT-d/AMD-Vi unterstützen.
  • Einige USB-Geräte funktionieren möglicherweise nicht zuverlässig mit Passthrough - testen Sie und konsultieren Sie das Unraid-Forum für gerätespezifische Ratschläge.

Binden von PCI-Geräten für Passthrough​

Bevor Sie eine GPU oder ein PCI-Gerät einer VM zuweisen können, ist es wichtig, das Gerät an den vfio-pci-Treiber zu "binden". Dieser Vorgang verbirgt das Gerät vor Unraid und widmet es ausschließlich Ihrer VM.

Um ein PCI-Gerät (GPU, USB-Controller, NVMe usw.) für das Passthrough zu binden:

  1. Navigieren Sie zu Werkzeuge → Systemgeräte im WebGUI.
  2. Durchsuchen Sie die Liste aller erkannten PCI-Geräte und ihrer IOMMU-Gruppen.
  3. Aktivieren Sie das Kästchen neben jedem Gerät, das Sie an vfio-pci binden möchten (um es vor Unraid zu verbergen).
    • Beachten Sie, dass bereits von Unraid verwendete Geräte (wie Festplattencontroller und Netzwerkkarten) nicht ausgewählt werden können.
    • Wenn Sie eine GPU auswählen, wählen Sie das zugehörige Soundgerät aus.
  4. Klicken Sie auf Ausgewählte an VFIO beim Booten binden, um Ihre Änderungen zu speichern.
  5. Starten Sie Ihren Server neu, damit das Binden wirksam wird.
vorsicht

GPU-Passthrough ermöglicht es Ihnen, eine physische Grafikkarte direkt einer virtuellen Maschine (VM) zuzuweisen, wodurch nahezu native Leistung für Gaming, kreative Arbeit oder maschinelles Lernen bereitgestellt wird.

Nach dem Binden werden gebundene Geräte im Dropdown-Menü Andere PCI-Geräte beim Bearbeiten oder Erstellen einer VM angezeigt.

Fehlerbehebung
  • Wenn Sie zuvor das VFIO-PCI-Konfigurations-Plug-in verwendet haben, deinstallieren Sie es - diese Funktionalität ist jetzt integriert.
  • Um alle Bindungen zurückzusetzen, löschen Sie /boot/config/vfio-pci.cfg und starten Sie Ihr System neu.
  • Nach dem Neustart verwenden Sie die Schaltfläche "VFIO-PCI-Protokoll anzeigen" auf der Seite Systemgeräte für erweiterte Fehlerbehebung.
  • Denken Sie daran, dass Unraid möglicherweise nicht ohne GUI startet, wenn Sie Ihre einzige GPU binden. Stellen Sie sicher, dass Sie dafür planen.
  • Für weitere Informationen, konsultieren Sie den offiziellen Leitfaden im Unraid-Forum.

GPU-Passthrough für virtuelle Maschinen​

GPU-Passthrough ermöglicht es Ihnen, eine physische Grafikkarte direkt einer VM zuzuweisen und bietet nahezu native Leistung für Spiele, kreative Arbeit oder maschinelles Lernen.

Why GPU-Durchreichung verwenden?
  • Leistung: Direkter Hardwarezugriff für anspruchsvolle Anwendungen.
  • Kompatibilität: Grafisch-intensive Workloads ausführen, die eine dedizierte GPU erfordern.
  • Flexibilität: Verwandeln Sie Ihren Unraid-Server in eine vielseitige Workstation.

Voraussetzungen

Hardware:

  • CPU mit Intel VT-d oder AMD-Vi Unterstützung (IOMMU im BIOS aktiviert).
  • GPU kompatibel mit Passthrough (siehe community-getestete Hardware).
  • Ein Motherboard, das PCIe-Geräte richtig isoliert.

Um ein ROM einzuspeisen:

  • Unraid 6.9+ mit aktivierter Virtualisierung.
  • OVMF (UEFI) BIOS für VMs (empfohlen gegenüber SeaBIOS).

Um GPU-Passthrough einzurichten:

  1. Stellen Sie sicher, dass Ihre Hardware IOMMU unterstützt und im BIOS aktiviert ist.
  2. Aktivieren Sie Virtualisierungsfunktionen im BIOS (Intel VT-x/VT-d oder AMD-v/AMD-vi).
  3. Aktualisieren Sie Unraid auf die neueste stabile Version.
  4. Weisen Sie die GPU der VM im VM-Erstellungs- oder Bearbeitungsbildschirm im Abschnitt Grafikkarte zu.
  5. Weisen Sie eine USB-Tastatur und -Maus der VM zu, wenn Sie GPU-Passthrough verwenden.
  6. Verwenden Sie OVMF BIOS für die VM für bessere Kompatibilität mit GPU-Passthrough.
  7. Starten Sie die VM und überprüfen Sie, ob die GPU korrekt durchgereicht wird.
notiz

Einige GPUs erfordern möglicherweise zusätzliche Konfigurationen oder ROM-Injection für das ordnungsgemäße Passthrough.

Steckenbleiben in der UEFI-Shell​

Einige GPUs, insbesondere bestimmte NVIDIA-Modelle, erfordern, dass eine ROM-Datei der VM manuell bereitgestellt wird, um ordnungsgemäß zu initialisieren. Dies ist häufig erforderlich, wenn die Onboard-Firmware der GPU standardmäßig nicht korrekt durchgereicht wird und Probleme wie schwarze Bildschirme oder der Ausfall beim Booten verursacht. Das manuelle Einfügen von ROM ist ein letzter Ausweg nach dem Versuch von BIOS- und VM-Konfigurationseinstellungen.

Um ein ROM einzuspeisen:

  1. GPU-ROM herunterladen:

    • Besuchen Sie die TechPowerUp VGA BIOS-Datenbank.
    • Suchen Sie Ihr GPU-Modell und laden Sie die korrekte ROM-Datei herunter.
    • Speichern Sie das ROM in Ihrem Unraid-isos oder domains-Freigabe.

  2. Bearbeiten Sie das VM-XML:

    • Stoppen Sie die VM und öffnen Sie deren XML-Konfiguration (XML bearbeiten aus dem VM-Kontextmenü).

    • Lokalisieren Sie den <hostdev>-Block der GPU und fügen Sie das <rom> Tag hinzu:


      <hostdev mode='subsystem' type='pci' managed='yes'>
        <driver name='vfio'/>
        <source>
          <address domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
        </source>
        <rom file='/mnt/user/isos/gpu_roms/your_gpu.rom'/> <!-- Update path -->
        <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
      </hostdev>

  3. Speichern und testen: Klicken Sie auf Aktualisieren und starten Sie die VM.

Häufige Probleme​

Dieser Abschnitt behandelt fortgeschrittene Themen und Lösungen für häufige Probleme bei der Verwaltung von VMs auf Unraid. Erweitern Sie die folgenden Abschnitte für Schritt-für-Schritt-Anleitungen und Tipps zur Fehlerbehebung.

Einen vDisk erweitern​

Klicken zum Erweitern/Reduzieren

Wenn Ihre VM wenig Speicherplatz hat, können Sie die Größe ihres vDisk direkt über das WebGUI erhöhen.

Um eine vDisk zu erweitern:

  1. Wechseln Sie zur Registerkarte VMs im WebGUI.
  2. Stellen Sie sicher, dass die VM gestoppt ist.
  3. Klicken Sie auf den Namen der VM, um deren Details zu erweitern.
  4. Suchen Sie die vDisk, die Sie erweitern möchten. Klicken Sie auf den Wert im Feld Kapazität, um ihn bearbeitbar zu machen.
  5. Geben Sie die neue gewünschte Größe ein (z.B. 100G für 100 Gigabyte) und drücken Sie Enter.
  6. Die neue Kapazität ist nun festgelegt.
notiz

Sie können einen vDisk im Unraid GUI nicht verkleinern; nur die Erweiterung wird unterstützt.

Die Partition in Ihrem Gast-Betriebssystem erweitern

Nach dem Anpassen der Größe des vDisk starten Sie Ihre VM. Sie müssen die Partition im Gastsystem erweitern, um den neuen Speicherplatz zu nutzen:

  • Windows: Verwenden Sie das eingebaute Festplattenverwaltungstool, um Ihre Partition zu erweitern.

  • Linux (LVM): Verwenden Sie Werkzeuge wie fdisk, pvresize, lvextend und resize2fs, um Partitionen und logische Volumes zu erweitern.

    Beispiel:

    sudo fdisk /dev/vda
    sudo pvresize /dev/vda3
    sudo lvextend -l +100%FREE /dev/mapper/ubuntu--vg-ubuntu--lv
    sudo resize2fs /dev/mapper/ubuntu--vg-ubuntu--lv

    Passen Sie die Gerätenamen bei Bedarf an Ihre Konfiguration an.

Hinweis

Sichern Sie Ihre VM immer, bevor Sie Festplattenänderungen vornehmen.

Steckenbleiben in der UEFI-Shell​

Klicken zum Erweitern/Reduzieren

Wenn Ihre VM zu einer UEFI-Shell statt zu Ihrem Betriebssystem startet, können Sie den Bootprozess manuell starten:

Geben Sie am UEFI-Shell-Befehlsprompt ein:

fs0:
cd efi/boot
bootx64.efi

Die VM sollte nun in Ihr Betriebssystem booten.

Hinweis

Wenn dies häufig passiert, überprüfen Sie die Startreihenfolge Ihrer VM und stellen Sie sicher, dass der richtige vDisk oder die ISO als primäres Startgerät in den VM-Einstellungen festgelegt ist.

Schwarzer Bildschirm nach VM-Start​

Klicken zum Erweitern/Reduzieren

Wenn Ihre VM startet, aber das Display leer bleibt:

  1. BIOS-Einstellungen überprüfen:

    • Primäre Grafik auf integrierte GPU (iGPU) setzen, nicht auf die Passthrough-GPU.
    • Aktualisieren Sie das Motherboard- und GPU-BIOS auf die neuesten Versionen.

  2. VM-Einstellungen anpassen:

    • Switch from SeaBIOS to OVMF (UEFI) in VM settings.
    • Ändern Sie den Maschinentyp von i440fx auf Q35.

  3. Manuelle ROM-Injektion (letztes Mittel): GPU-ROM manuell injizieren.

Fehler: "IOMMU für Behälter konnte nicht eingestellt werden: Operation nicht erlaubt"​

Klicken zum Erweitern/Reduzieren

Dieser Fehler weist typischerweise auf IOMMU-Gruppenkonflikte oder fehlende Interrupt-Remapping hin:

  1. PCIe ACS-Override aktivieren:

    • Gehen Sie zu Einstellungen → VM-Manager.
    • Setzen Sie PCIe ACS Override auf Downstream oder Beides.
    • Unraid neu starten.

  2. Unsichere Interrupts zulassen (fortgeschritten):

    • Bearbeiten Sie syslinux.cfg auf Ihrem Unraid-Flash-Laufwerk:

      append vfio_iommu_type1.allow_unsafe_interrupts=1 initrd=/bzroot

    • Verwenden Sie dies nur, wenn Sie Ihren VM-Gästen voll vertrauen.

notiz

Für detaillierte Erklärungen zu IOMMU-Gruppen empfehlen wir, Alex Williamsons Blog anzusehen.