Passer au contenu principal

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.

Device chemins

De nombreuses opérations à l'échelle du disque dans Unraid dépendent des noms de périphériques Linux, tels que /dev/sdX. Vous pouvez trouver l'identifiant du périphérique pour n'importe quel lecteur dans l'onglet Principal du WebGUI. Recherchez le label de 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é que vous pouvez accéder directement depuis le WebGUI. Il suffit d'utiliser le menu déroulant en haut à droite et de sélectionner ">_". 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.

When devrais-je utiliser le terminal ?

L'accès au terminal est utile pour :

  • Lancer des diagnostics et des outils en ligne de commande comme smartctl, xfs_repair, tail ou top
  • 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

Utilisation de PuTTY (Windows uniquement)​

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 - Cliquez pour développer/réduire
  1. Téléchargez PuTTY depuis le site officiel.
  2. Lancer l'application PuTTY.
  3. Entrez l'adresse IP ou le nom d'hôte de votre serveur Unraid (par exemple, tower.local).
  4. Définissez le type de connexion sur %%SSH|ssh%%.
  5. (Facultatif) Enregistrez le nom de la session pour une utilisation ultérieure.
  6. Cliquez sur Ouvrir pour démarrer la session.
  7. 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 quand vous avez terminé pour fermer la session.

note

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.

hdparm​

Utilisez cette commande pour tester la vitesse de lecture et afficher les caractéristiques du disque.

Afficher les options de hdparm - Cliquez pour développer/réduire

Tester la vitesse de lecture du disque :

hdparm -tT /dev/sdX

L'option -t teste les lectures de disque en mémoire 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 l'exactitude :

for ((i=0;i<5;i++)); do hdparm -tT /dev/sdX; done

Afficher les informations du 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.

Afficher les options de smartctl - Cliquez 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).

Démarrer les auto-tests 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.

diskspeed.sh​

Ce script permet des tests de performance de surface complets avec des rapports visuels.

Afficher l'utilisation de diskspeed.sh - Cliquez pour développer/réduire

Cela était auparavant un script que vous téléchargiez des forums Unraid. DiskSpeed est désormais 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.

top​

Cette commande fournit un moniteur de processus et de ressources en temps réel.

Afficher l'utilisation de top - Cliquez 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.

    astuce

    Considérez l'utilisation de htop pour une interface plus conviviale avec des contrôles améliorés.

free​

Cette commande affiche les statistiques d'utilisation de la mémoire.

Afficher l'utilisation de free - Cliquez pour développer/réduire
free -h

Cela affiche l'utilisation de la RAM dans un format lisible par l'utilisateur. L'option -h signifie que les tailles seront indiquées en Ko, Mo ou Go au lieu de bytes.

Comprendre la sortie

Une lecture faible de "mémoire disponible" n'indique pas nécessairement un problème — Linux met en cache les données de manière intensive pour améliorer les performances.

ps​

Utilisez cette commande pour afficher les processus en cours avec des informations détaillées.

Afficher les options de ps - Cliquez pour développer/réduire

Lister tous les processus avec des détails complets :

ps aux

Trier par utilisation de la mémoire :

ps aux --sort=-%mem | head -20

Trier par utilisation du CPU :

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.

df​

Cette commande affiche l'utilisation de l'espace disque des systèmes de fichiers.

Afficher l'utilisation de df - Cliquez 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 le journal système.

fdisk​

Voir les tables de partition de disque et la géométrie.

Afficher l'utilisation de fdisk - Cliquez 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 à diagnostiquer des tailles de disque non assorties, particulièrement lors du remplacement de disques.

lsblk​

Liste tous les périphériques blocs en format arborescent.

Afficher l'utilisation de lsblk - Cliquez pour développer/réduire
lsblk

Cette commande affiche tous les appareils de stockage, ainsi que leurs points de montage, dans une structure arborescente simple. Elle est idéale pour obtenir une vue d'ensemble de la configuration de stockage.

blockdev -getsz​

Aide à déterminer si un disque de remplacement a suffisamment d'espace avant la reconstruction.

Afficher l'utilisation de blockdev - Cliquez 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.

blkid​

Identifier les labels de systèmes de fichiers.

Afficher l'utilisation de blkid - Cliquez pour développer/réduire

Syntaxe :

blkid /dev/sdX1

Affiche le type et le label du système de fichiers. Utilisez cela à la place de la commande vol_id dépréciée lorsque vous vérifiez que le flash d'Unraid est étiqueté UNRAID.

Diagnostics réseau​

Outils pour dépanner la connectivité réseau et la configuration des interfaces.

ss​

Affiche les statistiques de socket et les connexions réseau. C'est le remplacement moderne de netstat.

Afficher les options de ss - Cliquez pour développer/réduire

Afficher tous les ports à l'écoute :

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.

ip​

Configurer et afficher les informations sur l'interface réseau. C'est le remplacement moderne de ifconfig.

Afficher les options de ip - Cliquez pour développer/réduire

Afficher toutes les interfaces réseau :

ip addr show

Afficher les interfaces réseau avec des couleurs :

ip -c addr show

Afficher la table de routage :

ip route show

ping​

Tester la connectivité réseau.

Afficher l'utilisation de ping - Cliquez pour développer/réduire

Tester la connectivité en envoyant un nombre limité de paquets :

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.

Afficher l'utilisation de ethtool - Cliquez pour développer/réduire

Informations de base sur le pilote et le firmware :

Utilisez cette commande pour obtenir des informations sur le pilote et le firmware de votre interface réseau :

ethtool -i eth0

Afficher la vitesse et les paramètres actuels du lien :

Pour vérifier la vitesse et les réglages actuels du lien de votre interface, exécutez :

ethtool eth0

Afficher les statistiques étendues de l'interface :

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.

Informations système​

Obtenez des informations détaillées sur le matériel, le noyau, et la configuration globale du système.

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 bits
  • vmx: Virtualisation Intel VT-x
  • svm: Virtualisation AMD-V

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.

Afficher l'utilisation de tail - Cliquez pour développer/réduire
tail -f /var/log/syslog

Cette commande affiche 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é.

Afficher 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 l'array et éteindre le système en toute sécurité. C'est préférable aux méthodes d'arrêt manuelles.