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

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.

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.

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.

    astuce

    Envisagez d'utiliser htop pour une interface plus conviviale avec des commandes améliorées.

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" basse n'indique pas nécessairement un problème—Linux met en cache de manière agressive les données pour améliorer les performances.

Utilitaires de stockage​

Ces commandes aident à vérifier l'utilisation des disques, les informations des partitions et à identifier les périphériques de stockage.

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 à diagnostiquer les tailles de disque incompatibles, notamment 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.

Diagnostics réseau​

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

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.

tail​

Surveiller les fichiers journaux en temps réel.

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.

Maintenance du système​

Commandes pour l'arrêt du système, la surveillance des journaux et la gestion des services.

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.

Opérations de transfert de fichiers​

Ces méthodes vous aident à transférer des fichiers depuis des partages réseaux externes (partages Windows ou Linux SMB/CIFS) vers votre serveur Unraid en utilisant des outils de ligne de commande et des utilitaires intégrés.

Utilisation de Midnight Commander (intégré)​

Unraid inclut Midnight Commander (mc), un gestionnaire de fichiers à double volet basé sur du texte accessible via le terminal Web.

  1. Open the web terminal. You can find this option in the top-right menu of the Unraid WebGUI.

  2. Lancez Midnight Commander :

    mc

    Cette interface propose une navigation par glisser-déposer entre les partages locaux et les chemins réseau montés.

  3. Montez un partage réseau (s'il n'est pas déjà monté) :

    # Create a temporary mount point
    mkdir /work
    # 1) Interactive prompt (recommended for one-off mounts)
    mount -t cifs //workstation/share /work -o username=youruser,iocharset=utf8
    # You will be prompted for the password interactively.
    # 2) Use a credentials file (recommended for scripts/automation)
    # Create /root/.cifscredentials with the following content:
    #   username=youruser
    #   password=yourpassword
    # Then protect the file and mount using:
    chmod 600 /root/.cifscredentials
    mount -t cifs //workstation/share /work -o credentials=/root/.cifscredentials,iocharset=utf8
    • Remplacez workstation, share et youruser par les valeurs appropriées.
    • L'option iocharset=utf8 aide à maintenir les noms de fichiers internationaux.

    Note de sécurité : Ne passez pas les mots de passe en ligne de commande (par exemple motdepasse=...). Les arguments de commande peuvent être enregistrés dans l'historique du shell et sont visibles par d'autres utilisateurs locaux via les listes de processus ; préférez les invites interactives ou un fichier de crédentiels protégé avec chmod 600.

  4. Utilisez les volets MC pour transférer les fichiers entre /work (le partage réseau) et n'importe quel partage /mnt/user/ ou /mnt/diskX.

  5. Nettoyez ensuite :

    umount /work
    rmdir /work

Midnight Commander fonctionne entièrement dans le système intégré, nécessitant aucune installation supplémentaire. Il convient à la plupart des besoins de transfert, y compris ceux impliquant des noms de fichiers Unicode, et il préserve les attributs de fichier lorsque la source et la destination les prennent en charge.

Utilisation de Krusader​

Si vous préférez une interface utilisateur graphique, vous pouvez utiliser des conteneurs Docker tels que Krusader comme solution tierce.

  1. Installez Krusader :
    • Naviguez jusqu'à l'onglet Apps (Applications Communautaires).
    • Recherchez et installez le conteneur Docker Krusader.
  2. Démarrez le conteneur et accédez à son interface WebUI depuis l'onglet Docker.
  3. Connectez-vous aux partages distants dans Krusader, et utilisez le glisser-déposer ou le copier-coller pour transférer les fichiers entre le partage réseau et votre array Unraid.
info

D'autres conteneurs de gestion de fichiers populaires incluent Double Commander et CloudCommander, tous deux disponibles via les Applications Communautaires.

Méthodes en ligne de commande​

Pour les utilisateurs avancés ou ceux utilisant l'automatisation, vous pouvez également utiliser des méthodes de transfert en ligne de commande.

Voir les instructions de transfert en ligne de commande - Cliquez pour développer/réduire

  1. Ouvrez le terminal (Terminal Web ou SSH en tant que root).

  2. Créez et montez un partage réseau :

mkdir /work
# 1) Interactive prompt (recommended for one-off mounts)
mount -t cifs //workstation/share /work -o username=youruser,iocharset=utf8
# You will be prompted for the password interactively.
# 2) Use a credentials file (recommended for scripts/automation)
# Create /root/.cifscredentials with the following content:
#   username=youruser
#   password=yourpassword
# Then protect the file and mount using:
chmod 600 /root/.cifscredentials
mount -t cifs //workstation/share /work -o credentials=/root/.cifscredentials,iocharset=utf8

Note de sécurité : Ne pas passer de mots de passe en ligne de commande. Utilisez plutôt une invite interactive ou un fichier de crédentials avec des permissions strictes.

  1. Copier les fichiers :

    • Vous pouvez utiliser cp :

      cp -r /work/* /mnt/disk1

    • Ou, utilisez rsync pour un suivi détaillé :

      rsync -av --progress /work/ /mnt/disk1/

  2. Démontez et supprimez le répertoire temporaire :

    umount /work
    rmdir /work
précaution

Lors du transfert de fichiers avec des caractères spéciaux ou internationaux, montez toujours le partage avec l'option iocharset=utf8. Ne pas le faire peut entraîner des noms de fichiers incorrects ou des fichiers illisibles sur d'autres plateformes.

Also, if you copy files as root via terminal, they may have restrictive permissions. If this occurs, use the New Permissions tool from the Tools menu in the WebGUI or the Docker Safe New Perms if you're dealing with Docker-involved shares to reset permissions, ensuring all users have network access.