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

:::

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

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.

Comprendre la sortie

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
astuce

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.

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.

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.