Zum Hauptinhalt springen

VM-Einrichtung

Das Einrichten einer virtuellen Maschine (VM) auf Unraid ist eine flexible Möglichkeit, vollständige Betriebssysteme – wie Windows, Linux oder andere Plattformen – neben Ihren Containern und nativen Apps auszuführen. Egal, ob Sie neue Software testen, Legacy-Anwendungen ausführen, eine Desktop-Umgebung hosten oder Hardware-Passthrough für Spiele oder kreative Arbeiten nutzen möchten, der VM-Manager von Unraid macht den Prozess für alle Kenntnisstufen zugänglich.

New in Unraid 7.0

Unraid 7.x bietet bedeutende Verbesserungen für virtuelle Maschinen (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.

Falls noch nicht geschehen, lesen Sie bitte die Anweisung Übersicht & Systemvorbereitung, um sicherzustellen, dass Ihre Hardware und Freigaben für die Virtualisierung bereit sind.

Erstellen Ihrer eigenen virtuellen Maschinen​

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

Before Sie beginnen
  • Bestätigen Sie, dass Ihre isos- und domains-Freigaben konfiguriert und zugänglich sind. Erfahren Sie hier mehr über Share-Management.
  • 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:

  • Klicken Sie auf der VM-Seite auf VM hinzufügen und wählen Sie Ihre Vorlage aus dem Abschnitt Benutzervorlagen 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 Erweiterungen für den VM-Manager ein, die den Prozess des Ausführens und Verwalten von virtuellen Maschinen vereinfachen. Diese Funktionen richten sich sowohl an Anfänger als auch an fortgeschrittene Benutzer und vereinfachen die Bereitstellung, Anpassung und Optimierung Ihrer VMs.

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
Workflow-Verbesserungen
  • VM-Klone & Snapshots: Duplizieren Sie VMs oder speichern/stellen Sie ihren Zustand schnell wieder her, um Tests oder Backups zu erstellen.
  • Benutzerdefinierte VM-Vorlagen: Speichern und verwenden Sie Ihre benutzerdefinierten VM-Konfigurationen mit nur wenigen Klicks.
  • 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.
  • VM-Nutzungsstatistiken: Verfolgen Sie die Ressourcennutzung pro VM direkt vom Dashboard aus.
Erweiterte Hardware- & Speicheroptionen
  • 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.
Verbesserte Grafik- und GPU-Freigabe
  • 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.
Weitere erweiterte Funktionen
  • 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

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​

Diesen Abschnitt erweitern, um Anleitungen zu den 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 festgelegt 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 anderes PCI-Gerät einer virtuellen Maschine zuweisen können, ist es wichtig, das Gerät an den vfio-pci Treiber zu "binden". Dieser Prozess 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

Wenn Sie Hardwareänderungen vornehmen (z. B. Hinzufügen oder Entfernen von PCI-Geräten), gehen Sie zu Systemgeräte, um sicherzustellen, dass die richtigen Geräte noch gebunden sind. Wenn Geräte ungebunden oder falsch verbunden sind, erscheinen sie möglicherweise nicht für das Passthrough.

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 virtuellen Maschine (VM) zuzuweisen, wodurch nahezu native Leistung für Gaming, kreative Arbeit oder maschinelles Lernen bereitgestellt wird.

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 Mehrzweck-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.

Software:

  • 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.

Manuelle ROM-Injektion​

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'/> <!-- Pfad aktualisieren -->
        <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​

In diesem Abschnitt werden fortgeschrittene Themen und Lösungen für häufige Probleme beim Verwalten von virtuellen Maschinen (VMs) auf Unraid behandelt. Erweitern Sie die folgenden Abschnitte für Schritt-für-Schritt-Anleitungen und Problemlösungstipps.

Einen vDisk erweitern​

Klicken Sie zum Erweitern/Einklappen

Sollte Ihre VM wenig Speicherplatz haben, können Sie die Größe der %%virtuellen Festplatte (vDisk)|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 eine vDisk nicht über das Unraid GUI verkleinern; es wird nur eine Erweiterung unterstützt.

Die Partition in Ihrem Gast-Betriebssystem erweitern

Nachdem Sie die Größe der vDisk geändert haben, starten Sie Ihre VM. Sie müssen die Partition im Gastbetriebssystem 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 immer Ihre VM, bevor Sie Änderungen an der Festplatte vornehmen.

Steckenbleiben in der UEFI-Shell​

Klicken Sie zum Erweitern/Einklappen

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 auftritt, überprüfen Sie die Boot-Reihenfolge Ihrer VM und stellen Sie sicher, dass die richtige vDisk oder ISO als primäres Boot-Gerät in den VM-Einstellungen festgelegt ist.

Schwarzer Bildschirm nach VM-Start​

Klicken Sie zum Erweitern/Einklappen

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 Sie zum Erweitern/Einklappen

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 ausführliche Erklärungen zu IOMMU-Gruppen empfehlen wir, Alex Williamsons Blog zu konsultieren.