Interface en ligne de commande
Bien que la plupart des tâches dans Unraid puissent être exécutées à travers le WebGUI, certaines opérations - particulièrement celles liées au diagnostic, à la gestion des disques ou au scripting - nécessitent l'utilisation de la console système ou du terminal SSH. Cette page propose des outils de ligne de commande spécifiques à Unraid et des exemples pouvant être utilisés sans nécessiter une connaissance approfondie de Linux.
De nombreuses opérations au niveau des disques Unraid dépendent des noms de périphériques Linux, tels que /dev/sdX
. Vous pouvez trouver l'identifiant de périphérique pour n'importe quel lecteur dans l'onglet Principal du WebGUI. Recherchez le label à trois lettres sdX
ou nvmeX
à côté de chaque disque. Utilisez l'identifiant approprié dans toutes les commandes, en remplaçant sdX
par votre disque spécifique.
Accéder au terminal
Unraid inclut un terminal web intégré auquel vous pouvez accéder directement depuis le WebGUI. Utilisez simplement le menu déroulant en haut à droite et sélectionnez ">_". Cela ouvre une session en ligne de commande en tant qu'utilisateur root, vous donnant un accès administratif complet à votre système.
Vous pouvez également vous connecter à votre serveur Unraid depuis l'extérieur en utilisant SSH (shell sécurisé) avec un client comme PuTTY.
:::tip[When devrais-je utiliser le terminal ?
Si vous utilisez Windows, vous pourriez préférer PuTTY pour l'accès SSH au lieu du terminal intégré. Il est léger, gratuit, et vous permet d'enregistrer des sessions pour un accès facile ultérieur.
- Lancer des diagnostics et des outils en ligne de commande comme
smartctl
,xfs_repair
,tail
outop
- Exécuter des scripts ou des outils de plug-ins qui ne nécessitent pas d'interface utilisateur.
- Résoudre des problèmes liés à la connectivité, aux services système, ou aux user shares
:::
Test et surveillance des disques
Si vous utilisez Windows, vous pourriez préférer PuTTY pour l'accès SSH au lieu du terminal intégré. Il est léger, gratuit, et vous permet d'enregistrer des sessions pour un accès facile ultérieur.
Comment installer et utiliser PuTTY - Cliquer pour développer/réduire
- Téléchargez PuTTY depuis le site officiel.
- Lancer l'application PuTTY.
- Entrez l'adresse IP ou le nom d'hôte de votre serveur Unraid (par exemple,
tower.local
). - Définissez le type de connexion sur
%%SSH|ssh%%
. - (Facultatif) Enregistrez le nom de la session pour une utilisation ultérieure.
- Cliquez sur Ouvrir pour démarrer la session.
- Lorsque vous y êtes invité, connectez-vous en tant que
root
et entrez votre mot de passe.
Une fois connecté, vous êtes dans l'environnement shell d'Unraid. Tapez exit
lorsque vous avez terminé pour fermer la session.
Unraid configure automatiquement le serveur SSH lors du premier démarrage. Assurez-vous que votre réseau fonctionne correctement et que votre mot de passe root est défini avant de tenter une connexion à distance.
Test et surveillance des disques
Ces outils aident à évaluer la performance, vérifier la santé des disques, et diagnostiquer la lenteur de l'array. Toutes les commandes doivent être exécutées depuis le terminal ou via SSH.
diskspeed.sh
Ce script permet des tests de performance de surface complets avec des rapports visuels.
Voir l'utilisation de diskspeed.sh - Cliquer pour développer/réduire
Cela a été un script que vous téléchargiez depuis les forums Unraid. DiskSpeed est maintenant disponible dans un package plus raffiné :
hdparm -tT /dev/sdX
L'option -t
teste les lectures de disque mises en tampon, tandis que -T
teste les lectures du cache. Cela mesure principalement les performances de lecture séquentielle et aide à identifier les disques exceptionnellement lents.
Effectuer plusieurs tests pour plus de précision :
for ((i=0;i<5;i++)); do hdparm -tT /dev/sdX; done
Voir les informations sur le disque :
hdparm -I /dev/sdX
Cela affiche le modèle, le firmware, la taille du cache et les fonctionnalités supportées, ce qui aide à vérifier le type de disque et le comportement du contrôleur.
smartctl
Cette commande exécute des diagnostics SMART et surveille la santé du disque.
Voir les options smartctl - Cliquer pour développer/réduire
Rapport SMART de base :
smartctl -a /dev/sdX
Si cette commande retourne une erreur, essayez de spécifier le type de périphérique : smartctl -a -d ata /dev/sdX
(utilisez -d nvme
pour les disques NVMe).
Commencer les tests autonomes SMART :
Test court (prend quelques minutes)
smartctl -t short /dev/sdX
Test étendu (peut prendre plusieurs heures)
smartctl -t long /dev/sdX
Enregistrer le rapport SMART dans un fichier :
smartctl -a /dev/sdX > /boot/smart_report.txt
Cela enregistre le rapport sur votre clé USB Unraid pour révision ou partage ultérieur sur le forum.
top
Cette commande fournit un moniteur de processus et de ressources en temps réel.
Voir l'utilisation de top - Cliquer pour développer/réduire
Cela a été un script que vous téléchargiez depuis les forums Unraid. DiskSpeed est maintenant disponible dans un package plus raffiné :
Installez DiskSpeed depuis les Applications Communautaires (onglet Apps) en recherchant "DiskSpeed", ou visitez le référentiel GitHub pour des instructions d'installation manuelles.
Surveillance du système
Utilisez ces commandes pour surveiller la mémoire, les processus et les performances du système lorsque le WebGUI n'est pas disponible ou pour des diagnostics plus détaillés.
ps
Utilisez cette commande pour afficher les processus en cours avec des informations détaillées.
Voir les options ps - Cliquer pour développer/réduire
top
- Affiche l'utilisation du CPU et de la mémoire pour chaque processus en temps réel.
- Appuyez sur
q
pour quitter. - Utilisez les flèches pour faire défiler et
k
pour terminer les processus.
Trier par utilisation de la mémoire :
free
Cette commande affiche les statistiques d'utilisation de la mémoire.
Voir l'utilisation de free - Cliquer pour développer/réduire
free -h
Cela affiche l'utilisation de la RAM dans un format lisible par l'homme. L'option -h
signifie que les tailles s'afficheront en Ko, Mo ou Go au lieu de bytes.
Une lecture de mémoire "disponible" faible n'indique pas nécessairement un problème—Linux met en cache les données de manière agressive pour améliorer les performances.
df
Cette commande affiche l'utilisation de l'espace disque des systèmes de fichiers.
Voir utilisation de df - Cliquer pour développer/réduire
Lister tous les processus avec tous les détails :
ps aux
Pensez à utiliser htop
pour une interface plus conviviale avec des commandes améliorées.
ps aux --sort=-%mem | head -20
Trier par utilisation du processeur :
ps aux --sort=-%cpu | head -20
Utilitaires de stockage
Ces commandes aident à vérifier l'utilisation des disques, les informations des partitions et à identifier les périphériques de stockage.
lsblk
Liste tous les périphériques blocs en format arborescent.
Voir l'utilisation de lsblk - Cliquer pour développer/réduire
df -h
Cette commande affiche l'espace utilisé et disponible sur tous les systèmes de fichiers montés. C'est pratique pour vérifier /var/log
(qui utilise la journalisation basée sur la RAM) dans Unraid. Pour plus d'informations sur la journalisation système.
blockdev -getsz
Aide à déterminer si un disque de remplacement a suffisamment d'espace avant la reconstruction.
Voir l'utilisation de blockdev - Cliquer pour développer/réduire
fdisk -l /dev/sdX
Cette commande affiche la disposition des partitions, les tailles et la géométrie du disque. Elle aide à résoudre les problèmes de tailles de disque incompatibles, en particulier lors du remplacement de disques.
blkid
Identifier les labels de systèmes de fichiers.
Voir l'utilisation de blkid - Cliquer pour développer/réduire
lsblk
Cette commande affiche l'espace utilisé et disponible sur tous les systèmes de fichiers montés. C'est pratique pour vérifier /var/log
(qui utilise la journalisation basée sur la RAM) dans Unraid. Pour plus d'informations sur la journalisation système.
blockdev -getsz
Aide à déterminer si un disque de remplacement a suffisamment d'espace avant la reconstruction.
Voir l'utilisation de fdisk - Cliquer pour développer/réduire
Syntaxe :
blockdev --getsz /dev/sdX
Retourne le nombre brut de secteurs de 512 octets sur un périphérique - pratique pour confirmer qu'un disque de remplacement est suffisamment grand avant la reconstruction.
ss
Affiche les statistiques de socket et les connexions réseau. C'est le remplacement moderne de netstat
.
Voir les options ss - Cliquer pour développer/réduire
Syntaxe :
blkid /dev/sdX1
Affiche le type et l'étiquette du système de fichiers. Utilisez cela à la place de la commande vol_id
obsolète lors de la vérification que la clé USB Unraid est étiquetée UNRAID
.
Diagnostics réseau
Outils pour dépanner la connectivité réseau et la configuration des interfaces.
ping
Tester la connectivité réseau.
Voir l'utilisation de ping - Cliquer pour développer/réduire
Tester la connectivité en envoyant un nombre limité de paquets :
ss -tuln
-t
: Sockets TCP-u
: Sockets UDP-l
: Montrer uniquement les sockets à l'écoute-n
: Afficher les numéros de port plutôt que les noms de service
Afficher les connexions établies :
ss -tup
Cette commande affiche les connexions actives avec les informations de process.
ethtool
Outil pratique pour interroger et ajuster les paramètres des cartes réseau (NIC), tels que la vitesse de lien, les fonctionnalités de déchargement et les statistiques.
Voir l'utilisation d'ethtool - Cliquer pour développer/réduire
Informations basiques sur le pilote et le firmware :
ip addr show
Afficher les interfaces réseau avec couleurs :
ip -c addr show
Pour vérifier la vitesse et les paramètres de lien actuels de votre interface, exécutez :
ip route show
ping
Tester la connectivité réseau.
Voir les options ss - Cliquer pour développer/réduire
Afficher tous les ports à l'écoute :
ping -c 4 google.com
Cette commande envoie quatre paquets à la destination et s'arrête, ce qui la rend adaptée aux tests de connectivité de base sans sortie continue.
ethtool
Outil pratique pour interroger et ajuster les paramètres des cartes réseau (NIC), tels que la vitesse de lien, les fonctionnalités de déchargement et les statistiques.
Voir les options ip - Cliquer pour développer/réduire
Afficher toutes les interfaces réseau :
Utilisez cette commande pour obtenir des informations sur le pilote et le firmware de votre interface réseau :
ethtool -i eth0
Afficher la vitesse de lien actuelle et les paramètres :
Afficher la table de routage :
ethtool eth0
Afficher les statistiques d'interface étendues :
Pour des statistiques étendues relatives à l'interface, utilisez la commande suivante :
ethtool -S eth0
Ces commandes peuvent vous aider à confirmer les vitesses de négociation pour les connexions gigabit, 2.5 GbE, ou 10 GbE, diagnostiquer les problèmes avec les câbles, ou identifier les paquets perdus qui pourraient provenir de déconnexions d'équipements.
tail
Surveiller les fichiers journaux en temps réel.
- Infos CPU
- Infos Mémoire
- Infos de stockage
Résumé de l'architecture CPU :
lscpu
Cette commande affiche des informations sur les cœurs, les threads, le support de la virtualisation, et les détails du cache.
Détection de fonctionnalités :
grep -E 'lm|vmx|svm' /proc/cpuinfo
lm
: Indique le support 64 bitsvmx
: Virtualisation Intel VT-xsvm
: Virtualisation AMD-V
Aperçu de l'utilisation de la mémoire :
free -h
Répartition détaillée de la mémoire :
cat /proc/meminfo | head -20
Liste des disques par série/modèle :
ls -l /dev/disk/by-id/ | grep -v part
Vérifier les étiquettes de systèmes de fichiers :
ls -l /dev/disk/by-label/
Maintenance du système
Commandes pour l'arrêt du système, la surveillance des journaux et la gestion des services.
tail
Surveiller les fichiers journaux en temps réel.
Voir l'utilisation de tail - Cliquez pour développer/réduire
tail -f /var/log/syslog
Cette commande montre des mises à jour en direct du journal système. Pour quitter, utilisez Ctrl+C
.
Afficher un nombre spécifique de lignes :
tail -n 50 /var/log/syslog
powerdown
Arrêter le système en toute sécurité.
Voir l'utilisation de powerdown - Cliquez pour développer/réduire
powerdown
Cette commande utilise le processus d'arrêt intégré d'Unraid pour arrêter le array et éteindre le système en toute sécurité. C'est préférable aux méthodes d'arrêt manuelles.