CLI pour les nuls

Un serveur n'a pas de bureau, pas d'icônes et pas de souris. Tout se passe dans un terminal, et cette fenêtre noire avec un curseur clignotant est principalement ce qui décourage les gens de se lancer de le self-hosting. À tort : le terminal n'est qu'un chat. Vous posez une question ou écrivez un ordre, la machine répond. Rien de plus complexe qu'une barre de recherche, sauf qu'il en fait bien plus et ne cache jamais une option derrière trois menus.

La bonne nouvelle, c'est que vous n'avez pas besoin de connaître des centaines de commandes. Une dizaine d'entre elles couvrent presque tout vos besoins sur un serveur maison, et elles suivent toutes le même schéma. Apprenez à lire ce schéma et chaque commande que vous croiserez par la suite deviendra lisible, même celles que vous n'avez jamais vues.

Comment une commande est construite

Chaque ligne de commande, sans exception, est rédigée de la même manière : quoi lancer, comment le lancer, sur quoi le lancer.

sudo apt install -y nano
│    │   │       │  └─ argument : ce sur quoi la commande travaille
│    │   │       └──── option : change son comportement
│    │   └──────────── sous-commande : ce que le programme doit faire
│    └──────────────── le programme que vous lancez
└───────────────────── le lancer avec les droits administrateur

Lue à voix haute, cette ligne dit « en tant qu'administrateur, demande au gestionnaire de paquets d'installer le paquet nano, et ne me demande pas de confirmer ». Ce sont les espaces qui séparent les parties, et c'est notamment pour ça qu'un dossier nommé Mes Sauvegardes doit être mis entre guillemets (cd "Mes Sauvegardes"), sinon le shell (le système utilisé par le terminal) y lit deux choses différentes.

Les options, courtes et longues

Les options changent le comportement d'une commande. Elles existent en deux versions, et la plupart des commandes acceptent les deux :

• Courtes, un tiret et une seule lettre : ls -a. Elles peuvent s'empiler, donc ls -l -a -h s'écrit généralement ls -lah.
• Longues, deux tirets et un mot entier : ls --all. Plus longues à taper, mais vous saurez encore ce qu'elles font six mois plus tard, ce qui en fait le meilleur choix dans un script.

Certaines options attendent une valeur juste après elles : ssh-keygen -t ed25519 (-t pour type), rsync --exclude @eaDir. Et la casse compte, toujours. Dans ls, -r inverse l'ordre de tri alors que -R descend dans les sous-dossiers. Deux choses différentes, pour une même lettre.

Les arguments et les chemins

L'argument est la cible : un fichier, un dossier, un nom de paquet, une adresse. Beaucoup de commandes en acceptent plusieurs à la fois, séparés par des espaces, et c'est ce qui rend le terminal rapide : rm fichier1.txt fichier2.txt fichier3.txt supprime trois fichiers d'un coup.

Quand la cible est un endroit sur le disque, vous l'écrivez sous forme de chemin, et quelques raccourcis valent la peine d'être connus :

L'invite de commande indique elle-même où vous êtes : dans utilisateur@serveex:~/docker$, vous êtes connecté en tant qu'utilisateur sur la machine nommée serveex, dans le dossier docker de votre home. Ce $ final signifie que vous êtes loggé avec un utilisateur normal. Si vous voyez # à la place, c'est que vous êtes connecté avec l'utilisateur root et chaque faute de frappe compte double.

Trouver de l'aide

Deux astuces vous rendront indépendant des tutoriels. commande --help affiche un résumé rapide de chaque option, et man commande ouvre le manuel complet (man pour manual), que vous quittez en appuyant sur Q.

Enchaîner les commandes

Une fois le schéma compris, les commandes peuvent se combiner les unes aux autres :

• && lance la suivante seulement si la précédente a réussi : sudo apt update && sudo apt full-upgrade
• |, le pipe, envoie la sortie d'une commande dans une autre : ls -l | grep sauvegarde liste le dossier, puis ne garde que les lignes contenant « sauvegarde »
• > écrit la sortie dans un fichier au lieu de l'écran, et >> l'ajoute à la fin de ce fichier : df -h > rapport-disques.txt

Les commandes que vous utiliserez vraiment

La plupart des noms de commandes sont des abréviations. Une fois que vous savez ce qu'elles signifient, elles cessent de ressembler à des incantations obscures.

pwd, print working directory

Vous dit où vous êtes. Elle ne change rien, elle répond juste à la question.

pwd

/home/utilisateur/docker

ls, list

Liste ce qu'il y a dans le dossier courant. Seule, elle n'affiche que les noms, elle est donc presque toujours utilisée avec des options : -l pour le format long avec tailles, dates et permissions, -a pour afficher aussi les fichiers cachés (ceux qui commencent par un point), -h pour des tailles en K/M/G plutôt qu'en octets bruts.

ls -lah

total 20K
drwxr-xr-x  4 utilisateur utilisateur 4.0K Sep  5 10:12 .
drwxr-xr-x 18 utilisateur utilisateur 4.0K Sep  4 21:03 ..
-rw-r--r--  1 utilisateur utilisateur  512 Sep  5 10:12 .env
-rw-r--r--  1 utilisateur utilisateur 1.2K Sep  5 09:58 compose.yaml
drwxr-xr-x  3 utilisateur utilisateur 4.0K Sep  2 18:44 immich

La première colonne, ce sont les permissions, le d tout au début signifiant qu'il s'agit d'un dossier. Puis le propriétaire, la taille, la date de dernière modification, et le nom.

cd, change directory

Permet de changer de repertoire. Lorsque vous indiquez un chemin, elle vous y rend. Avec .. elle remonte d'un niveau, et sans rien du tout elle vous ramène dans votre dossier utilisateur.

utilisateur@serveex:~/docker$ cd /var/log
utilisateur@serveex:/var/log$ cd ..
utilisateur@serveex:/$ cd
utilisateur@serveex:~$

Notez l'invite de commande : elle montre toujours où vous vous trouvez, si bien qu'en pratique vous avez rarement besoin de pwd.

mkdir, make directory

Crée un dossier. Plusieurs à la fois si vous les listez, et -p crée toute la chaîne de parents d'un coup, c'est la version que vous utiliserez vraiment.

mkdir sauvegardes
mkdir -p docker/immich/config

La sortie n'affiche rien. Ce n'est pas un bug, c'est la règle : la plupart des commandes ne disent rien quand elles réussissent et ne se manifestent que si quelque chose se passe mal. Le silence est une bonne nouvelle, et ls confirme que le dossier est bien là.

cp et mv, copy et move

cp copie, mv déplace. Même syntaxe dans les deux cas : d'abord la source, puis la destination. Copier un dossier demande -r, pour recursive, puisqu'un dossier veut dire tout ce qu'il contient aussi. mv sert également de commande pour renommer, parce que renommer un fichier revient simplement à le déplacer vers un nouveau nom.

cp compose.yaml compose.yaml.bak
cp -r config/ config-backup/
mv ancien-nom.txt nouveau-nom.txt
ls

compose.yaml  compose.yaml.bak  config  config-backup  nouveau-nom.txt

Trois commandes silencieuses, et ls qui montre le résultat : la copie est à côté de l'original, le dossier a été dupliqué, et ancien-nom.txt a disparu parce que le déplacer vers un autre nom équivaut à le renommer/

rm, remove

Supprime. Il n'y a pas de corbeille, pas d'annulation, pas de fenêtre de confirmation. -r supprime un dossier et son contenu, -f force sans demander.

cat et nano, lire et modifier

cat (abréviation de concatenate) déverse un fichier entier à l'écran, parfait pour une config courte. Pour tout ce qui est plus long, less le fait défiler. Pour quitter, tapez simplement Q.

Pour éditer un fichier, nano ouvre un éditeur simple : les flèches pour se déplacer, Ctrl + O pour enregistrer, Ctrl + X pour quitter.

cat .env

PUID=1000
PGID=1000
TZ=Europe/Paris

grep, chercher dans les fichiers

grep veut dire global regular expression print, une façon compliquée de dire « trouve-moi ce texte ». Vous lui donnez quoi chercher et où, et il affiche chaque ligne correspondante. -r cherche dans tout un dossier, -i ignore les majuscules et minuscules, -n affiche les numéros de ligne.

grep -rin "password" /home/utilisateur/docker

/home/utilisateur/docker/immich/.env:6:DB_PASSWORD=changeme
/home/utilisateur/docker/vaultwarden/compose.yaml:14:  ADMIN_PASSWORD=hunter2

Chaque ligne indique le fichier, puis le numéro de ligne à l'intérieur, puis la ligne correspondante elle-même. Très pratique le jour où vous ne vous souvenez plus dans quelle stack se trouve un réglage.

sudo, lancer en privilèges administrateur

Substitute user do. Afin d'éviter de casser votre serveur par accident, un utilisateur normal ne peut pas toucher aux fichiers du système. Préfixer une commande par sudo lance cette seule commande avec les droits administrateur. Cette commande vous demandera votre mot de passe au moins une fois par session, et parfois plusieurs fois selon le temps qui se sera écoulé depuis sa dernière utilisation.

nano /etc/ssh/sshd_config

Error writing /etc/ssh/sshd_config: Permission denied

sudo nano /etc/ssh/sshd_config

[sudo] password for utilisateur:

Aide-mémoire

Les commandes qui valent la peine d'être gardées sous la main, et d'où viennent leurs noms.