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=failedVous 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
enabledoudisabledau démarrage. - Active :
active (running),inactive (dead)oufailed, 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
- restart arrête le service puis le redémarre, en coupant toutes les connexions gérées par le processus.
- 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.
- reload-or-restart recharge lorsque l'unité le permet et redémarre dans le cas contraire.
- enable --now active le service au démarrage et le lance immédiatement. Un simple
enablene lance rien avant le prochain démarrage. - 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 -ldaemon-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-pageris-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 systemctl | Téléphone (iOS/Android) | Ordinateur |
|---|---|---|
Quitter le pager ou journalctl -f | Nécessite Ctrl et Échap, que le clavier système masque | Ctrl et Échap toujours présents sur le clavier physique |
| Faire défiler de longs journaux | PgUp/PgDn seulement si le client les propose | Touches physiques PgUp/PgDn |
| Connexion pendant un long redémarrage | Passer du wifi aux données mobiles coupe SSH ; Mosh conserve la session | Ré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.