Configuration de VM
La configuration d'une machine virtuelle (VM) sur Unraid est un moyen flexible d'exécuter des systèmes d'exploitation complets - comme Windows, Linux, ou d'autres plateformes - aux côtés de vos conteneurs et applications natives. Que vous souhaitiez tester de nouveaux logiciels, exécuter des applications anciennes, héberger un environnement de bureau, ou utiliser le passage matériel pour le jeu ou le travail créatif, le Gestionnaire de VM d'Unraid rend le processus accessible à tous les niveaux de compétence.
Unraid 7.x apporte des améliorations significatives aux machines virtuelles (VM), notamment :
- Clones et instantanés des VM
- Modèles de VM créés par l'utilisateur
- Edition/visualisation XML en ligne
- Fonctionnalités avancées de partage et de passage GPU
Consultez la section fonctionnalités du gestionnaire de VM pour plus de détails.
Si vous ne l'avez pas déjà fait, veuillez consulter les instructions Aperçu & préparation système pour vous assurer que votre matériel et vos partages sont prêts pour la virtualisation.
Créer vos propres machines virtuelles
Une fois votre système préparé et vos préférences définies, vous pouvez créer une nouvelle machine virtuelle (VM) en utilisant le WebGUI.
- Confirmez que vos partages
isos
etdomains
sont configurés et accessibles. Découvrez-en plus sur la gestion des partages ici. - Téléchargez votre ISO d'installation du système d'exploitation et, pour les VMs Windows, l'ISO des derniers pilotes VirtIO sur le partage
isos
. - Décidez si vous utiliserez le GPU passthrough ou le VNC pour les graphiques.
Pour créer une VM basique :
- Cliquez sur Ajouter une VM dans la page Machines Virtuelles.
- Définissez le Modèle sur Personnalisé, ou sélectionnez un modèle de système d'exploitation prédéfini pour les distributions courantes.
- Entrez un Nom et, si vous le souhaitez, une Description pour votre VM.
- Basculez Démarrage automatique si vous souhaitez que le VM démarre automatiquement avec le array.
- Sélectionnez le type de Système d'Exploitation. Cela ajustera également l'icône VM.
- Affectez des cœurs CPU à la VM. Vous pouvez affecter jusqu'au nombre de cœurs physiques disponibles sur votre hôte.
- Spécifiez la Mémoire Initiale (RAM) pour la VM. Consultez la documentation de votre OS invité pour obtenir les valeurs recommandées.
- Choisissez l'ISO d'installation de l'OS dans votre partage isos.
- Configurez le disque vDisk principal (emplacement, taille, et type).
- Sélectionnez une Carte Graphique :
- Attribuez une Carte Son (optionnel, mais nécessaire pour l'audio HDMI via GPU).
- Assignez des Périphériques USB selon les besoins.
- Les dispositifs doivent être attachés avant de démarrer la VM (le branchement à chaud USB n'est pas supporté).
- Le périphérique USB Unraid n'est pas disponible pour l'affectation.
- Cliquez sur Créer la VM. La VM démarrera automatiquement à moins que vous ne décochiez Démarrer la VM après la création.
Modèles VM utilisateur
Unraid 7.1+ introduit des modèles d'utilisateur VM, simplifiant la sauvegarde et la réutilisation de vos configurations personnalisées VM. Les modèles d'utilisateur rationalisent le déploiement VM et assurent la cohérence des configurations.
Pour créer un modèle utilisateur :
- Modifiez la VM que vous souhaitez modéliser.
- Sélectionnez Créer/Modifier un modèle et entrez un nom.
- Votre modèle sera maintenant disponible dans l'espace des modèles utilisateur sur l'écran Ajouter une VM.
Pour utiliser un modèle utilisateur :
- Sur la page VMs, cliquez sur ajouter une VM et sélectionnez votre modèle dans la section modèles utilisateur.
Importation/exportation :
- Survolez un modèle utilisateur et cliquez sur la flèche pour l'exporter vers votre serveur ou le télécharger.
- Sur un autre système Unraid, utilisez Importer à partir d'un fichier ou Télécharger pour ajouter le modèle.
Nouveautés dans Unraid 7.x : Gestionnaire de VM
Unraid 7.x introduit une gamme d’améliorations puissantes au Gestionnaire de VM, simplifiant le processus d'exécution et de gestion des machines virtuelles. Ces fonctionnalités s'adressent tant aux débutants qu'aux utilisateurs avancés, rendant le déploiement, la personnalisation et l'optimisation de vos VM plus simples.
:::tip[Highlights]
- Gagnez du temps avec des clones de VM, instantanés, et des modèles réutilisables
- Ajustez finement la performance et la compatibilité avec des options avancées de passage et de stockage
- Profitez de la visibilité et du contrôle améliorés avec des statistiques d'utilisation et une édition
XML
en ligne
:::
Améliorations du flux de travail
- Clones & instantanés de VM : Dupliquez des VMs ou sauvegardez/restaurez rapidement leur état pour des tests ou des sauvegardes.
- Modèles de VM utilisateur : Sauvegardez vos configurations VM personnalisées et déployez de nouvelles VMs en quelques clics.
- Edition/visualisation XML en ligne : Visualisez ou copiez instantanément le
XML
généré par le WebGUI ; passez en modeXML
pour des éditions avancées. - Désactivation du démarrage automatique : Choisissez quels VMs démarrent automatiquement avec votre array.
- Statistiques d'utilisation de VM : Suivez l'utilisation des ressources par VM directement depuis le tableau de bord.
Améliorations du flux de travail
- PCI multifonction/autre : Assignez des dispositifs PCI complexes ou des groupes pour des scénarios avancés de passage.
- Passage en ligne de commande QEMU : Ajoutez des arguments QEMU personnalisés pour un réglage expert des VM.
- Remplacement de stockage : Spécifiez l'emplacement de stockage pour chaque disque virtuel de VM.
- Indicateur SSD & deslocage : Optimisez la performance des vDisques pour les SSD et activez le support discard/unmap.
SR-IOV
pour iGPU Intel : Partagez les graphiques intégrés Intel entre plusieurs VMs.- Validation du nom de VM pour ZFS : Empêchez l'utilisation de caractères non pris en charge dans les noms de VM pour les pools ZFS.
Options matérielles et de stockage avancées
Améliorations des graphismes et du partage GPU
- View all graphics cards and VM-assigned IP addresses in the VM tab
- Support pour la cible QEMU ppc64 et
qemu:override
- Support hypervclock pour les VMs Windows
- "Migratable" activé/désactivé pour le CPU émulé
- Options de configuration du Timer/décalage
- Pas d'options de keymap/nogpu disponibles pour des cas d'utilisation spécifiques
- Amélioration de la sélection et de l'édition des icônes de VM
- Avertissements lors de l'affectation du GPU principal comme passage (peut nécessiter
vBIOS
) - Démarrez les VMs Unraid en mode GUI avec le pilote vidéo
QXL
- Divers correctifs pour les problèmes de chemin et d'icône dans la vue
XML
Utilisation des GPUs virtuels et partage GPU
Unraid supporte désormais le partage avancé de GPU via VirGL
et QXL
pour les VMs Linux (et certains GPUs Nvidia avec le driver Nouveau
).
- Pour utiliser
VirGL
: définissez la Carte Graphique sur Virtuel et le pilote vidéo de la console VM sur VirtIO(3D). - Pour utiliser
QXL
: définissez la Carte Graphique sur Virtuel et le pilote vidéo de la console VM surQXL
(meilleur). VirGL
n'output pas vers un moniteur physique et n'est pas compatible avec les VMs Windows ou les plugins Nvidia standard.QXL
supporte le multi-écran et une mémoire vidéo configurable.
Options avancées
Développez cette section pour voir des conseils sur les options plus avancées
Passez à la Vue Avancée sur la page Ajouter une VM pour accéder à des paramètres supplémentaires.
Voici les options avancées les plus importantes, réparties en sections ciblées :
Mode CPU :
- Passage de l'hôte : Expose toutes les caractéristiques du CPU hôte à la VM pour des performances maximales.
- Émulation : Utilise un modèle CPU générique, réduisant les problèmes de compatibilité mais limitant les performances.
Ballonnement de mémoire :
- Définissez une valeur de Mémoire Max pour activer l'allocation dynamique de mémoire (ballonnement de mémoire).
- Non disponible pour les VMs avec des appareils PCI assignés (par exemple, GPU passthrough).
Type de machine :
i440fx
: Défaut pour les VMs Windows. Modifiez uniquement si vous avez des problèmes de GPU passthrough.Q35
: Par défaut pour les VMs Linux et recommandé pour la plupart des systèmes d'exploitation modernes, surtout avec GPU passthrough.
Type de BIOS :
- SeaBIOS : BIOS traditionnel pour les OSes hérités.
- OVMF : BIOS UEFI requis pour Windows 8+, la plupart des distributions Linux modernes, et GPU passthrough.
Le type de BIOS peut uniquement être défini lors de la création d'une nouvelle VM.
Extensions Hyper-V :
- Pour les VMs Windows, activez les extensions Hyper-V pour améliorer la compatibilité et les performances.
ISO des pilotes VirtIO :
- Remplacez l'ISO VirtIO par défaut si nécessaire, surtout pour tester ou utiliser des pilotes plus récents.
Type de vDisk :
RAW
: Meilleures performances, moins flexible pour les instantanés.QCOW2
: Supporte les instantanés mais offre une performance légèrement inférieure.
Mappages VirtFS (VMs Linux) :
- Ajoutez plusieurs partages VirtFS (
9p
) pour l'intégration du système de fichiers entre l'hôte et l'invité. - Voir la documentation QEMU 9p pour plus de détails.
Paramètres réseau :
- Modifiez l'adresse MAC du réseau ou sélectionnez un pont réseau alternatif.
- Cliquez sur le symbole de rafraîchissement pour générer automatiquement une nouvelle adresse MAC.
- Ajoutez des interfaces réseau virtuelles supplémentaires selon besoin.
- Si votre VM ne démarre pas, vérifiez vos chemins ISO et vDisk.
- Pour GPU passthrough, assurez-vous que votre matériel et vos paramètres BIOS prennent en charge IOMMU/VT-d/AMD-Vi.
- Certains périphériques USB peuvent ne pas fonctionner de manière fiable avec le passage - testez et consultez les forums Unraid pour des conseils spécifiques aux périphériques.
Attachement des appareils PCI pour le passage
Avant de pouvoir attribuer un GPU ou n'importe quel dispositif PCI à une machine virtuelle, il est important de "lier" le périphérique au pilote vfio-pci. Ce processus cache le périphérique à Unraid et le consacre uniquement à votre VM.
Pour lier un dispositif PCI (GPU, contrôleur USB, NVMe, etc.) pour le passage :
- Naviguez vers Outils → Périphériques système dans le WebGUI.
- Passez en revue la liste de tous les appareils PCI détectés et leurs groupes IOMMU.
- Cochez la case à côté de chaque appareil que vous souhaitez lier à vfio-pci (pour le masquer d'Unraid).
- Notez que les appareils déjà utilisés par Unraid (tels que les contrôleurs de disque et les cartes réseau) ne peuvent pas être sélectionnés.
- Si vous sélectionnez un GPU, choisissez le périphérique sonore associé.
- Cliquez sur Lier les sélectionnés à VFIO au démarrage pour sauvegarder vos modifications.
- Redémarrez votre serveur pour que le lien prenne effet.
Si vous effectuez des modifications matérielles (comme ajouter ou retirer des dispositifs PCI), retournez dans Périphériques Système pour vous assurer que les dispositifs corrects sont toujours liés. Si les dispositifs ne sont pas liés ou sont mal liés, ils peuvent ne pas apparaître pour le passage.
Après liaison, les appareils liés apparaîtront dans le menu déroulant Autres Périphériques PCI lors de l'édition ou de la création d'une VM.
Chercher des problèmes
- Si vous avez précédemment utilisé le plugin
VFIO-PCI
Config, désinstallez-le - cette fonctionnalité est maintenant intégrée. - Pour réinitialiser toutes les liaisons, supprimez
/boot/config/vfio-pci.cfg
et redémarrez votre système. - Après redémarrage, utilisez le bouton Voir le journal
VFIO-PCI
sur la page des Périphériques système pour un dépannage avancé. - N'oubliez pas que si vous liez votre seul GPU, Unraid pourrait ne pas démarrer en mode GUI. Assurez-vous de prévoir cela.
- Pour plus d'informations, consultez le guide officiel sur les forums Unraid.
Passerelle GPU pour machines virtuelles
Le GPU passthrough vous permet d'assigner une carte graphique physique directement à une machine virtuelle (VM), offrant des performances quasi-native pour les jeux, le travail créatif ou l'apprentissage automatisé.
- Performance : Accès direct au matériel pour des applications exigeantes.
- Compatibilité : Exécutez des charges de travail intensives en graphique nécessitant une carte graphique dédiée.
- Flexibilité : Transformez votre serveur Unraid en une station de travail polyvalente.
Prérequis
Matériel :
- CPU supportant Intel VT-d ou AMD-Vi (IOMMU activé dans le BIOS).
- GPU compatible avec le passage (voir matériel testé par la communauté).
- Une carte mère qui isole correctement les périphériques PCIe.
Logiciel :
- Unraid 6.9+ avec la virtualisation activée.
- Le BIOS OVMF (UEFI) est recommandé pour les VM sur SeaBIOS).
Pour configurer la transmission directe du GPU :
- Assurez-vous que votre matériel prend en charge IOMMU et est activé dans votre BIOS.
- Activez les fonctionnalités de virtualisation dans le BIOS (Intel VT-x/VT-d ou AMD-v/AMD-vi).
- Mettez à jour Unraid à la dernière version stable.
- Attribuez la carte graphique à la VM lors de la création ou de l'édition depuis l'écran sous la section carte graphique.
- Assignez un clavier et une souris USB au VM si vous utilisez le GPU passthrough.
- Utilisez le BIOS OVMF pour le VM pour une meilleure compatibilité avec le GPU passthrough.
- Démarrez la VM et vérifiez que le GPU est bien passé.
Certaines cartes graphiques peuvent nécessiter une configuration supplémentaire ou une injection ROM pour un passage correct.
Injection ROM manuelle
Certaines GPU, en particulier certains modèles NVIDIA, nécessitent qu'un fichier ROM soit manuellement fourni à la VM pour s'initialiser correctement. Cela est souvent nécessaire lorsque le firmware embarqué du GPU n'est pas correctement transmis par défaut, causant des problèmes comme des écrans noirs ou des échecs de démarrage. L'injection manuelle de ROM est un dernier recours après avoir essayé des ajustements de BIOS et de configuration VM.
Pour injecter un ROM :
-
Télécharger le ROM de la carte graphique :
- Visitez la base de données VGA BIOS de TechPowerUp.
- Recherchez le modèle de votre carte graphique et téléchargez le fichier ROM correct.
- Stockez la rom dans votre partage
isos
oudomains
sur Unraid.
-
Éditez le VM XML :
-
Arrêtez la VM et ouvrez sa configuration XML (Éditer l'XML depuis le menu contextuel de la VM).
-
Localisez le bloc
<hostdev>
du GPU et ajoutez le tag<rom>
:
<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>
-
-
Enregistrez et testez : Cliquez sur Mettre à jour et démarrez la VM.
Problèmes courants
Cette section aborde les sujets avancés et les solutions pour les problèmes courants lors de la gestion des machines virtuelles (VMs) sur Unraid. Déroulez les sections ci-dessous pour des instructions étape par étape et des conseils de dépannage.
Agrandir un vDisk
Cliquer pour développer/réduire
Si votre VM manque d'espace disque, vous pouvez augmenter la taille de son %%disque virtuel (vDisk)|vdisk directement depuis le %%WebGUI.
Pour agrandir un vDisk :
- Allez à l'onglet VMs dans le WebGUI.
- Assurez-vous que la VM est arrêtée.
- Cliquez sur le nom de la VM pour développer ses détails.
- Localisez le vDisk que vous souhaitez agrandir. Cliquez sur la valeur dans le champ Capacité pour la rendre modifiable.
- Entrez la nouvelle taille souhaitée (par exemple,
100G
pour 100 gigaoctets) et appuyez sur Entrer. - La nouvelle capacité est maintenant définie.
Vous ne pouvez pas réduire un vDisk depuis l'interface graphique d'Unraid ; seule l'expansion est prise en charge.
Extension de la partition dans votre système d'exploitation invité
Après avoir redimensionné le vDisk, démarrez votre VM. Vous devez étendre la partition dans le système d'exploitation invité pour utiliser le nouvel espace:
-
Windows : Utilisez l'outil intégré de gestion des disques pour étendre votre partition.
-
Linux (LVM) : Utilisez des outils comme
fdisk
,pvresize
,lvextend
, etresize2fs
pour étendre les partitions et volumes logiques.Exemple :
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--lvAjustez les noms de périphériques selon vos besoins.
Toujours sauvegarder votre VM avant de modifier les disques.
Bloqué à l'UEFI shell
Cliquer pour développer/réduire
Si votre VM démarre sur un UEFI shell au lieu de votre système d'exploitation, vous pouvez démarrer le processus de démarrage manuellement :
À l'invite de commande du UEFI shell, entrez :
fs0:
cd efi/boot
bootx64.efi
La VM devrait maintenant continuer à démarrer dans votre système d'exploitation.
Si cela se produit fréquemment, vérifiez l'ordre de démarrage de votre VM et assurez-vous que le bon vDisk ou ISO est défini comme périphérique de démarrage principal dans les paramètres de la VM.
Écran noir après le démarrage de la VM
Cliquer pour développer/réduire
Si votre VM démarre mais que l'écran reste vide :
-
Vérifiez les paramètres BIOS :
- Réglez la carte graphique principale sur le GPU intégré (iGPU), pas sur le GPU de passage.
- Mettez à jour le BIOS de la carte mère et de la carte graphique aux dernières versions.
-
Ajustez les paramètres de la VM :
-
Injection ROM manuelle (dernier recours) : Injectez un ROM GPU manuellement.
Erreur : "Impossible de définir IOMMU pour container : opération non autorisée"
Cliquer pour développer/réduire
Cette erreur indique généralement des conflits de groupe IOMMU ou un manque de remappage d'interruptions :
-
Activer le remplacement PCIe ACS :
- Allez à Paramètres → Gestionnaire de VMs.
- Réglez remplacement PCIe ACS sur Downstream ou Both.
- Redémarrez Unraid.
-
Autoriser les interruptions non sécurisées (avancé) :
-
Éditez
syslinux.cfg
sur votre clé USB Unraid :append vfio_iommu_type1.allow_unsafe_interrupts=1 initrd=/bzroot
-
Utilisez ceci uniquement si vous faites entièrement confiance à vos invités VM.
-
Pour des explications détaillées sur les groupes IOMMU, nous vous recommandons de consulter le blog d'Alex Williamson.