Questions Fréquemment Posées
Si vous avez besoin d'aide avec le système d'exploitation Unraid, vous avez plusieurs options de support :
- Forums Unraid : Support général, Conception compulsive
- Documentation Officielle: Documentation Unraid
- Discord: Communauté Discord Unraid
- Portail de Support: Support Unraid
Construction & Matériel
J'ai besoin d'aide pour une construction ou une configuration système. Où dois-je aller ?
Pour obtenir des conseils sur la construction ou la mise à niveau de votre serveur Unraid, visitez le forum Compulsive Design ou rejoignez le Discord Unraid. La communauté est active et prête à vous aider, quel que soit votre niveau d'expérience.
Quels contrôleurs sont recommandés pour Unraid ?
Unraid fonctionne mieux avec des adaptateurs de bus hôte (HBA) non-RAID. Il est préférable d'éviter les contrôleurs RAID matériels, qui peuvent masquer les informations de santé des disques et compliquer la maintenance.
Vérifiez toujours les mises à jour du firmware et assurez-vous que le contrôleur est réglé en mode HBA/IT, et non en mode RAID. Vous pouvez vous référer au fil de contrôleurs recommandés pour des modèles que la communauté a testés avec succès.
Quelle est la meilleure façon d'ajouter plus de stockage si mon contrôleur intégré est plein ?
Unraid allows for the expansion of storage across multiple controllers. You can add a compatible HBA (as mentioned above). Ensure the controller operates in standard HBA (non-RAID) mode and supports AHCI/SATA. Avoid using RAID-only cards, as Unraid requires direct disk access for parity and monitoring.
Unraid a-t-il une fonction d'allocation qui se souvient des secteurs défectueux sur les disques pour éviter d'écrire dessus ?
Unraid utilise les données SMART de vos disques pour surveiller leur santé et détecter des problèmes tels que les secteurs défectueux. SMART est intégré dans les disques durs et SSD modernes, suivant des attributs tels que les secteurs réalloués et en attente.
Bien que Unraid n'ait pas de fonctionnalité d'allocation spécifique pour éviter les secteurs défectueux, il utilise les données SMART pour vous notifier si un disque montre des signes de défaillance ou un nombre croissant de secteurs défectueux. Ces informations se trouvent dans l'%%WebGUI|interface-web%% sous l'état de santé du disque et les attributs %%SMART|smart%%.
Si un disque montre un nombre élevé de secteurs réattribués ou en attente, envisagez de le remplacer bientôt pour éviter toute perte de données.
Si vous n'êtes pas certain de l'état de santé d'un disque, vous pouvez partager vos données SMART dans le forum de support général pour obtenir de l'aide de la communauté.
OS & Configuration
Puis-je utiliser une clé HASP dans une VM sur Unraid ? Comment cela fonctionne-t-il avec plusieurs VMs ?
Si votre clé HASP est une clé USB, vous pouvez l'assigner à seulement un VM à la fois. Notez que deux VMs ne peuvent pas utiliser la même clé simultanément. Vous pourriez devoir passer par un contrôleur USB entier pour une meilleure compatibilité. Effectuez toujours des tests avec une licence d'essai pour confirmer que votre matériel fonctionne comme prévu.
Ma clé USB a échoué, et je n'ai pas de sauvegarde. Comment restaurer ma configuration ?
Si vous aviez activé Unraid Connect pour les sauvegardes Flash, vous pouvez l'utiliser pour restaurer. Sinon, procurez-vous une nouvelle clé USB de haute qualité, installez Unraid dessus et utilisez la clé d'enregistrement que vous avez reçue par email. Réassignez vos disques comme ils l'étaient. Si vous ne pouvez pas vous souvenir des affectations, postez pour obtenir de l'aide dans le forum de support général.
Que dois-je faire si j'ai oublié mon mot de passe root ?
Référez-vous à Réinitialiser votre mot de passe.
Si vous utilisez des disques chiffrés et oubliez le mot de passe de chiffrement, la récupération de données n'est pas possible - il n'y a pas de porte dérobée.
Comment puis-je redémarrer complètement Unraid OS à partir de zéro ? (Procédure de réinitialisation d'usine)
- Sauvegardez toutes les données que vous souhaitez conserver.
- Stop the array and shut down your server.
- Retirez le périphérique de démarrage.
- Utilisez l'outil Unraid USB Flash Creator pour reformater et réinstaller Unraid sur le lecteur.
- Réinsérez le périphérique de démarrage et démarrez votre serveur.
- Dans le WebGUI, ouvrez un terminal et exécutez
lsblkpour répertorier tous les lecteurs (à l'exception du périphérique de démarrage). - Effacer les systèmes de fichiers existants de chaque disque de données :
:::danger[Critical: Opération destructive
-
Sauvegardez toutes les données que vous souhaitez conserver.
-
Vérifiez deux fois l'identifiant du périphérique dans le WebGUI ou avec
lsblkavant d'exécuter cette commande -
Retirez le périphérique flash USB.
Pour chaque disque de données, exécutez :
wipefs /dev/sdX
Pour chaque disque de données, exécutez :
- Continuez avec la configuration et l'installation normales d'Unraid.
Comment puis-je changer le nom d'hôte de mon serveur ?
Pour changer le nom d'hôte de votre serveur Unraid, accédez au WebGUI dans Paramètres → Paramètres Système → Identification.
Effets du changement de nom d'hôte :
- Le nouveau nom d'hôte sera utilisé pour l'identification réseau (par ex., accès via
http://newname). - Vous devrez peut-être reconnecter tous les lecteurs réseau mappés ou raccourcis en utilisant le nouveau nom d'hôte.
- Certains appareils ou services peuvent mettre en cache l'ancien nom ; un redémarrage complet de l'appareil peut être nécessaire pour reconnaître le nouveau nom.
Mon périphérique de démarrage signale un GUID non valide. Que dois-je faire ?
Unraid requires a boot device with a unique hardware GUID (for USB boot, this is usually a USB flash drive). Some manufacturers may reuse GUIDs or use generic values, and counterfeit drives, especially of well-known brands like SanDisk and Samsung—often lack unique GUIDs. For guidance on choosing a compatible drive (including brand and retailer advice), see Create your bootable media and Selecting a replacement device.
In short: Prefer drives from reputable retailers. Consider second-tier brands (e.g., TeamGroup, Transcend, PNY), which are less often counterfeited. Avoid generic or unbranded drives, SSDs, USB card readers, and SD card adapters; they often lack unique GUIDs and may not be supported for booting Unraid.
Virtualisation & Appareils
Chaque fois que j'arrête ma VM Windows avec un GPU AMD assigné, elle ne parvient pas à redémarrer. Que puis-je faire ?
Il est préférable d'éviter les disques génériques ou sans marque, les SSD, les lecteurs de cartes USB et les adaptateurs de cartes SD, car ils manquent souvent de GUIDs uniques et peuvent ne pas être pris en charge pour démarrer Unraid.
Virtualisation & Appareils
C'est faisable mais nécessite des étapes supplémentaires. Consultez le guide vidéo de SpaceInvaderOne pour des instructions détaillées sur la façon de le faire correctement.
Stockage & RAID
Unraid prend-il en charge divers types de RAID tels que RAID1/5/6/10 ?
C'est faisable mais nécessite des étapes supplémentaires. Consultez le guide vidéo de SpaceInvaderOne pour des instructions détaillées sur la façon de le faire correctement.
| Fonctionnalité / Capacité | Unraid parity array (md) | BTRFS pool (cache) | ZFS pool (7.x+) | RAID 1/RAID 5/RAID 6/RAID 10 |
|---|---|---|---|---|
| Modèle / de redondance parité | Disque(s) parité dédié(s) | Logiciel RAID 1/RAID 10/RAID 5/RAID 6 via BTRFS | RAID 1-Z1/Z2/Z3 ou miroirs | Parité rayée parity (RAID 5/RAID 6) ou miroirs (RAID 10) |
| Division des données | Non | Oui (sauf RAID 1) | Oui | Oui |
| Flexibilité de la taille du disque | Mélange de toutes tailles | Idéal avec des tailles similaires | Idéal avec des tailles similaires par vdev | Requiert des tailles assorties |
| Étendre un disque à la fois | Oui | Oui (ajouter ou remplacer des appareils) | Oui (par vdev*) | Généralement non |
| Système de fichiers par disque | Oui | Non | Non | Non |
| Vitesse de lecture d'un seul disque | Vitesse native du disque | Agrégé (multi-disques) | Agrégé (multi-disques) | Agrégé |
| Dégradation de l'écriture lors de la reconstruction | Minimal (seul le lecteur en panne) | Dépend du niveau | Dépend de l'agencement vdev | Significatif |
| Détection de Bit rot | Optionnel (BTRFS/ZFS checksum) | ✅ Intégré | ✅ End-to-end checksums | ❌ Non inhérent |
| %%Snapshot|Instantané%% / envoi-réception | ❌ | ✅ (BTRFS) | ✅ Native | ❌ |
| Utilisation recommandée en production | Stockage média général | RAID 1/RAID 10 (évitez RAID 5/RAID 6)** | ✅ Tous les niveaux stables | Baies d'entreprise arrays |
* Les vdevs ZFS doivent être étendus en remplaçant tous les disques du vdev ou en ajoutant un nouveau vdev.
* Les BTRFS RAID 5/RAID 6 sont toujours signalés comme "expérimental" en amont; à utiliser avec prudence.
- Unraid %%parity|parité%% %%array|grappe%% est excellent pour une expansion incrémentielle, permettant des tailles de disque disparates avec un stress minimal lors de la reconstruction.
- Les pools ZFS (disponibles en 7.x) offrent une redondance de niveau entreprise, des snapshots, et des checksums, ce qui les rend idéaux pour les VMs et les bases de données.
- Pools BTRFS excellent pour les caches SSD rapides, en mode RAID 1/RAID 10 en miroir, en particulier.
- Les cartes matérielles RAID traditionnelles ne sont pas nécessaires ; vous pouvez utiliser de simples HBA pour permettre à Unraid de gérer directement les disques.
Je dispose actuellement d'un ensemble de périphériques formatés avec une table de partition de style MBR et je souhaite convertir en GPT. Comment faire ?
Pourquoi convertir de MBR à GPT ?
Le partitionnement MBR (Master Boot Record) prend en charge les disques jusqu'à 2 To et ne permet qu'un maximum de quatre partitions principales. D'autre part, GPT (GUID Partition Table) peut gérer des disques beaucoup plus grands et des partitions presque illimitées. La conversion en GPT est conseillée si vous travaillez avec des disques plus grands ou souhaitez une meilleure gestion des partitions.
Avant de commencer le processus de conversion, mettez votre array en Mode Maintenance. Cette étape garantit qu'aucune écriture ne se produit pendant la conversion, protégeant vos données.
Processus de conversion
- Assurez-vous d'avoir une parity valide et une sauvegarde récente de votre périphérique de démarrage.
- Entrez en Mode de Maintenance depuis l'onglet Principal.
- Remplacez et reconstruisez d'abord votre lecteur de %%parity|parité%%.
- Remplacez chaque lecteur de données un à la fois, en reconstruisant le array après chaque remplacement.
- Le nouveau disque sera formaté avec le style de partitionnement approprié selon sa taille :
- 2 To ou moins : Utilise un partitionnement MBR
- Plus grand que 2 To : Utilise un partitionnement GPT
-
- 2 To ou moins : Utilise un partitionnement MBR
- Plus grand que 2 To : Utilise un partitionnement GPT6.
- 2 To ou moins : Utilise un partitionnement MBR
Ce processus garde vos données en sécurité tout en changeant le style de partitionnement.
-
Le partitionnement est automatique : Unraid choisit automatiquement le style de partitionnement basé sur la taille du disque :
- 2 To ou moins : Utilise toujours un partitionnement MBR
- Plus grand que 2 To : Utilise toujours un partitionnement GPT
-
À partir d'Unraid OS 6.9, la partition 1 commence à 32 KiB pour les périphériques rotatifs et à 1 MiB pour les périphériques non rotatifs, quel que soit le style de partition. -- Sauvegardez toujours votre périphérique de démarrage avant de commencer ce processus de conversion.
Réseau
Y a-t-il un moyen de désactiver le pont br0 ?
Oui. Le pont br0 est un pont réseau Linux permettant aux conteneurs Docker et aux VMs de se connecter directement à votre réseau local (LAN) avec leurs adresses IP. Il agit comme un commutateur réseau virtuel connectant votre interface réseau physique aux interfaces virtuelles utilisées par les conteneurs et les VMs.
Désactiver br0 signifie que les VMs et les conteneurs Docker n'auront pas accès direct au LAN et pourraient perdre certaines fonctionnalités réseau avancées.
Je n'arrive pas à me connecter au WebGUI en utilisant http://tower ou http://tower.local. Que dois-je faire ?
Si vous avez du mal à vous connecter à l'%%interface-web|WebGUI%% par nom d'hôte, le problème pourrait venir de votre DNS local qui ne résout pas le nom du serveur. Essayez plutôt de vous connecter directement en utilisant l'adresse IP.
Comment trouver l'adresse IP de votre serveur :
- Vérifiez la liste des clients DHCP de votre routeur ou commutateur pour un appareil répertorié comme "Tower" ou similaire.
- Si vous avez attribué une adresse IP statique lors de la création du support de démarrage avec le USB Flash Creator, utilisez cette adresse.
- Branchez un moniteur et un clavier à votre serveur ; l'adresse IP apparaîtra sur la console locale après le démarrage.
Oui. Le pont br0 est un pont réseau Linux permettant aux conteneurs Docker et aux VMs de se connecter directement à votre réseau local (LAN) avec leurs adresses IP. Il agit comme un commutateur réseau virtuel connectant votre interface réseau physique aux interfaces virtuelles utilisées par les conteneurs et les VMs.
- Votre ordinateur et votre serveur pourraient être sur différents sous-réseaux ou VLANs.
- Votre routeur peut ne pas prendre en charge la résolution locale des noms d'hôtes.
- Le serveur Unraid pourrait ne pas être connecté au réseau ou avoir une configuration réseau incorrecte.
- Les logiciels de sécurité ou pare-feu peuvent bloquer l'accès.
Désactiver br0 signifie que les VMs et les conteneurs Docker n'auront pas accès direct au LAN et pourraient perdre certaines fonctionnalités réseau avancées.
Installation
Je n'arrive pas à faire en sorte que le USB Flash Creator installe Unraid sur mon support de démarrage. Que dois-je faire ?
Si le USB Flash Creator ne fonctionne pas pour votre système ou votre clé USB, vous pouvez utiliser la méthode d'installation manuelle pour préparer votre périphérique de démarrage Unraid. Cette méthode est compatible avec Windows, macOS et Debian/Ubuntu Linux.
J'ai besoin de configurer mon système pour démarrer en utilisant UEFI. Comment faire ?
Si vous ne parvenez pas à vous connecter, essayez de redémarrer votre serveur et les équipements réseau, et assurez-vous que tous les câbles sont correctement connectés.
Installation
Lorsque vous utilisez le USB Flash Creator, sélectionnez l'option permettant d'activer le mode de démarrage UEFI avant d'écrire Unraid sur la clé USB.
Installation
Dans le WebGUI, ouvrez Settings → Boot device (sur Unraid 7.3.0 et versions ultérieures). Sur les versions antérieures, la même page se trouve sous Settings → Flash device.
Activez le mode de démarrage UEFI et redémarrez votre serveur.
Option 3 : Renommer le dossier manuellement
Sur le volume de démarrage (clé USB), renommez le dossier EFI~ en EFI (supprimez le tilde ~).
Vous pouvez configurer le mode de démarrage UEFI de plusieurs façons :
Définissez le périphérique de démarrage Unraid (USB, le cas échéant) comme cible de démarrage principale et activez le mode de démarrage UEFI (veillez à désactiver le mode CSM/Legacy/Compatibility, si disponible).
J'ai des problèmes pour utiliser mon navigateur Web avec le WebGUI. Que puis-je faire ?
Si vous rencontrez des problèmes d'affichage ou de fonctionnalité avec le WebGUI, prenez en compte les éléments suivants :
- Bloqueurs de publicités et de contenu : Ces extensions de navigateur peuvent interférer avec le WebGUI. Essayez d'ajouter votre serveur Unraid à la liste blanche de votre bloqueur de publicités ou désactivez le bloqueur pour l'adresse de votre serveur.
- Extensions de navigateur : Certaines extensions peuvent bloquer des scripts ou altérer le contenu des pages. Désactivez les extensions ou essayez d'utiliser une fenêtre privée/incognito.
- Navigateurs obsolètes : Assurez-vous d'utiliser un navigateur moderne et à jour (comme Chrome, Firefox, ou Edge). Les navigateurs plus anciens peuvent ne pas complètement supporter le WebGUI.
- Problèmes de cache : Effacez votre cache du navigateur ou essayez un rafraîchissement forcé (Ctrl+F5 ou Cmd+Shift+R).
- Problèmes de réseau : Assurez-vous que votre ordinateur et le serveur sont connectés au même réseau et sous-réseau.
Si les problèmes persistent, essayez d'accéder au WebGUI depuis un autre navigateur ou appareil.
Comment puis-je prolonger mon essai d'Unraid ?
Si vous avez besoin de plus de temps avec votre essai gratuit de 30 jours de Unraid, vous pouvez le prolonger. Une fois votre essai initial expiré, arrêtez votre array et allez à la page Enregistrement. Vous devriez voir un bouton vous permettant de demander une extension de 15 jours. Vous pouvez le faire deux fois pour un total de 60 jours avant de devoir acheter une licence.
Vous devez utiliser le même périphérique de démarrage pour poursuivre votre essai. Changer de support de démarrage nécessitera de recommencer un nouvel essai à partir de zéro.