systemctl est l'outil de systemd pour piloter les services Linux, et en SSH il fonctionne exactement comme sur une console locale. systemctl status affiche l'état et les journaux récents, et restart arrête puis démarre un service. enable --now le démarre et l'active au démarrage, daemon-reload recharge les fichiers d'unité modifiés, et is-active renvoie un état exploitable dans un script.

Commandes systemctl essentielles pour gérer un service en SSH

sudo systemctl start nginx démarre le service et sudo systemctl stop nginx l'arrête. Les requêtes comme status, is-active et is-enabled s'exécutent sans sudo, même si un utilisateur non privilégié peut ne pas voir les lignes de journal. Ces commandes couvrent presque tout le travail quotidien sur une unité :

systemctl status nginx
sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx
sudo systemctl reload nginx
sudo systemctl enable --now nginx
sudo systemctl disable --now nginx
sudo systemctl daemon-reload
systemctl is-active nginx
systemctl is-enabled nginx
systemctl list-units --type=service --state=failed

Vous pouvez omettre le suffixe .service du nom de l'unité. Vérifiez toutefois le nom du serveur SSH lui-même : sur Debian et Ubuntu, l'unité s'appelle généralement ssh, tandis que les autres distributions utilisent sshd. Chaque sous-commande et option est documentée dans la page de manuel de systemctl.

systemctl status : lire l'état d'un service distant

systemctl status nginx condense en quelques lignes ce qu'il faut pour un diagnostic :

  • Loaded : le chemin du fichier d'unité et s'il est enabled ou disabled au démarrage.
  • Active : active (running), inactive (dead) ou failed, ainsi que le moment du dernier changement.
  • Main PID et l'arborescence des processus : les processus qui appartiennent au service.
  • Lignes récentes du journal : quand un service ne démarre pas, l'erreur se trouve généralement ici.

Lorsque la sortie dépasse la taille de l'écran, status ouvre un pager que l'on quitte avec q. L'option --no-pager évite le pager et -l (ou --full) empêche la troncature des lignes. Si ces lignes ne suffisent pas, journalctl -u nginx -n 50 --no-pager donne plus de contexte. journalctl -u nginx -f suit le journal en direct jusqu'à ce que vous appuyiez sur Ctrl+C. Les filtres par date et par priorité figurent dans la page de manuel de journalctl.

systemctl restart, reload et enable --now : quand utiliser chacun

  1. restart arrête le service puis le redémarre, en coupant toutes les connexions gérées par le processus.
  2. reload demande au service de relire sa configuration sans s'arrêter. Cela ne fonctionne que si l'unité définit comment le faire ; sinon, la commande renvoie une erreur.
  3. reload-or-restart recharge lorsque l'unité le permet et redémarre dans le cas contraire.
  4. enable --now active le service au démarrage et le lance immédiatement. Un simple enable ne lance rien avant le prochain démarrage.
  5. disable --now fait l'inverse : il retire le service du démarrage et l'arrête.

Avant de redémarrer le serveur SSH par lequel vous êtes connecté, validez sa configuration avec sudo sshd -t. La commande affiche toute erreur de syntaxe et se termine avec un code non nul. Gardez une seconde session ouverte jusqu'à avoir confirmé que vous pouvez vous reconnecter sur le port TCP 22 ou celui que vous utilisez.

systemctl daemon-reload après modification d'un fichier .service

sudo systemctl daemon-reload force systemd à relire ses fichiers d'unité. Sans cette commande, les modifications d'un fichier .service ne sont pas appliquées, et status avertit que l'unité a changé sur le disque. La séquence habituelle ressemble à ceci :

sudo nano /etc/systemd/system/myapp.service
sudo systemctl daemon-reload
sudo systemctl restart myapp
systemctl status myapp --no-pager -l

daemon-reload ne redémarre aucun service ; il recharge seulement la configuration du gestionnaire. C'est le restart qui suit qui fait tourner le processus avec la nouvelle définition.

systemctl is-active dans les scripts et les vérifications rapides

systemctl is-active affiche l'état de l'unité (active, inactive, failed…) et se termine avec le code 0 uniquement lorsque l'unité est active. On peut donc l'utiliser directement dans des conditions. Avec --quiet, la commande n'affiche rien et seul le code de sortie compte :

systemctl is-active --quiet nginx && echo 'nginx OK' || sudo systemctl restart nginx
systemctl is-failed --quiet myapp && journalctl -u myapp -n 20 --no-pager

is-enabled suit la même logique pour l'état au démarrage. is-failed repère les unités qui ont planté, lesquelles apparaissent aussi dans systemctl list-units --type=service --state=failed.

systemctl sur un téléphone ou sur un ordinateur : ce qui change

systemctl se comporte de la même façon dans n'importe quel client SSH. Sur un téléphone, les différences tiennent à l'accès aux touches et à la stabilité de la connexion :

Tâche systemctlTéléphone (iOS/Android)Ordinateur
Quitter le pager ou journalctl -fNécessite Ctrl et Échap, que le clavier système masqueCtrl et Échap toujours présents sur le clavier physique
Faire défiler de longs journauxPgUp/PgDn seulement si le client les proposeTouches physiques PgUp/PgDn
Connexion pendant un long redémarragePasser du wifi aux données mobiles coupe SSH ; Mosh conserve la sessionRéseau généralement stable
Modifier un fichier .serviceÉditeur dans le terminal, ou SFTP pour télécharger et renvoyer le fichierÉditeur local ou distant

termi1, un terminal mobile SSH et Mosh, ajoute son propre clavier avec Échap, Ctrl, Tab, les flèches et une couche fn avec PgUp/PgDn, Début et Fin. Mosh maintient la session lorsque vous passez du wifi aux données mobiles, et tmux conserve ce que vous avez laissé en cours d'exécution. Le SFTP intégré permet de vérifier un fichier .service sans quitter la session. L'IA saisit la commande à l'invite sans appuyer sur Entrée, et le mode « Review » ne l'exécute jamais. Sur les connexions marquées comme production, Production Guard garantit que rien ne reçoit Entrée automatiquement. Il bloque aussi tout ce qui arrête ou modifie quelque chose, comme systemctl stop, avant que cela n'atteigne l'invite. Vous pouvez obtenir termi1 sur l'App Store ou sur Google Play.

Questions fréquentes

Quelle est la différence entre systemctl restart et systemctl reload ?

systemctl restart arrête le service puis le redémarre, en coupant les connexions gérées par son processus. systemctl reload demande seulement au service de relire sa configuration sans s'arrêter. Cela ne fonctionne que si l'unité définit une action de rechargement ; reload-or-restart choisit automatiquement la bonne option.

Quand dois-je exécuter systemctl daemon-reload ?

Il faut exécuter systemctl daemon-reload après avoir créé, modifié ou supprimé un fichier d'unité, par exemple sous /etc/systemd/system. La commande recharge la configuration de systemd sans redémarrer aucun service : un restart reste donc nécessaire pour que le processus prenne en compte les modifications.

Redémarrer le service ssh avec systemctl coupe-t-il ma session SSH ?

Redémarrer le service ssh avec systemctl laisse normalement les sessions ouvertes actives, car chaque connexion possède son propre processus. Le risque concerne les nouvelles connexions : si la configuration contient des erreurs, le service ne redémarrera pas. Validez-la d'abord avec sudo sshd -t et gardez une seconde session ouverte.

Comment vérifier dans un script qu'un service systemd est actif ?

Un script vérifie qu'un service systemd est actif avec systemctl is-active --quiet name. La commande se termine avec le code 0 lorsque l'unité est active et avec un autre code sinon, sans rien afficher. Vous pouvez l'enchaîner avec && ou || ou l'utiliser dans un if.