Anime-Sanctuary

Quand ça casse : la checklist

Serveur en panne : que vérifier, et dans quel ordre ? Voici la checklist de dépannage à suivre quand « ça ne marche plus », du plus large au plus précis, sans rien casser de plus.

Parcours
Tutoriel 35 sur 35
Durée
25 min de lecture
Vérifié avec
Commandes : essais sous Debian 13.7 (systemd 257.13, Apache 2.4.69, restic 0.18.0)
Ce que vous saurez faire
  • Suivre dix vérifications dans l'ordre, de « la machine répond-elle ? » à « que s'est-il passé ? ».
  • Lire les vraies sorties d'erreur d'un disque plein et d'un service tombé.
  • Choisir la première commande selon le symptôme.
  • Revenir en arrière sans aggraver la panne.

Avant de commencer : Lire les journaux, Pare-feu avec ufw, Premier site avec Apache.

Sommaire
  1. Un entonnoir plutôt qu'un labyrinthe
  2. Respirer et ne rien casser de plus
  3. Le serveur est-il joignable ?
  4. Reste-t-il de la place et de la mémoire ?
  5. Quels services sont tombés ?
  6. Que disent les journaux ?
  7. Le réseau et le pare-feu laissent-ils passer ?
  8. Le site web répond-il ?
  9. Disque ou mémoire saturés
  10. Revenir en arrière
  11. Écrire ce qui s'est passé
  12. Le tableau : symptôme, première commande
  13. Si ça échoue
  14. Pour finir
  15. Sources

Serveur en panne : que faire en premier ? Suivre une checklist de dépannage, c'est-à-dire une liste de vérifications dans un ordre fixe, du plus large au plus précis. Dix étapes suffisent. Chacune écarte une famille de pannes, et la première qui répond « non » vous dit où creuser. Une panne n'est pas un échec : c'est le serveur qui vous demande de l'attention.

Un entonnoir plutôt qu'un labyrinthe

On commence par les questions les plus larges, parce qu'elles ne coûtent presque rien et éliminent beaucoup : la machine est-elle seulement allumée ? Il serait dommage de fouiller un journal d'Apache si le câble réseau est débranché. À chaque étape, la question se resserre, jusqu'à une seule commande qui désigne la cause.

L'entonnoir de diagnostic Sept barres de plus en plus étroites, de haut en bas : respirer, joignable, ressources, services, journaux, réseau, web. 1 Respirer, noter 2 Joignable ? 3 Ressources 4 Services 5 Journaux 6 Réseau 7 Web du plus large au plus précis
Texte équivalent : les étapes 1 à 7 forment un entonnoir. On part de la plus large, « respirer et noter », et on resserre jusqu'au site web. Les étapes 8 à 10 (saturation, retour en arrière, compte rendu) viennent ensuite.

Pour que ce soit concret, suivons une panne simulée. Sur mon-serveur, le site exemple.fr est servi par Apache, comme dans Premier site avec Apache. Vous avez modifié un réglage, relancé Apache, et il répond par une erreur :

Sur le serveur
sudo systemctl restart apache2
Résultat attendu
Job for apache2.service failed because the control process exited with error code.
See "systemctl status apache2.service" and "journalctl -xeu apache2.service" for details.

Le site est tombé. Avant d'enchaîner les commandes, la première étape n'en demande aucune.

1Respirer et ne rien casser de plus

Avant toute commande, notez l'heure et ce qui a changé récemment, et ne redémarrez rien au hasard. Un redémarrage efface la mémoire de la machine, donc une partie des indices. Il peut aussi transformer une petite panne en grosse. Trois notes suffisent :

  • L'heure du début de la panne, ou de votre première alerte.
  • Ce qui a changé juste avant : une mise à jour, un réglage modifié, un nouvel utilisateur.
  • Qui est touché : vous seul, ou tous les visiteurs.

Deux commandes retrouvent ce qui a changé. La première lit le registre des installations de paquets, /var/log/dpkg.log, et garde les trois dernières lignes. La seconde trie les réglages de /etc du plus récent au plus ancien. Entre les deux, le trait vertical | est un tube : il passe ce que la commande de gauche affiche à celle de droite, ici tail -n 3 ou head -n 5, qui n'en gardent que les dernières ou les premières lignes.

Sur le serveur
date
sudo grep -E ' (install|upgrade) ' /var/log/dpkg.log | tail -n 3
ls -lt /etc | head -n 5
Résultat attendu
Thu Nov  5 08:01:14 UTC 2026
2026-11-05 08:01:09 install libncursesw6:amd64 <none> 6.5+20250216-2
2026-11-05 08:01:10 install nano:amd64 <none> 8.4-1+deb13u1
2026-11-05 08:01:10 install libgpm2:amd64 <none> 1.20.7-11+b2
total 236
drwxr-xr-x 2 root root    4096 Nov  5 08:01 apache2
-rw-r--r-- 1 root root    4399 Nov  5 08:01 ld.so.cache
drwxr-xr-x 1 root root    4096 Nov  5 08:01 alternatives
-rw-r--r-- 1 root root     172 Nov  5 08:01 hosts

Chaque ligne du registre commence par une date et une heure, puis le mot install ou upgrade et le nom du paquet ; dans ls -lt, la date est juste avant le nom. Dans notre essai, ces dates ne désignent rien d'utile : seule compte la méthode. Chez vous, comparez-les à l'heure de la panne : un réglage daté de dix minutes avant, c'est un suspect. Redémarrer au hasard, c'est secouer la télé en espérant qu'elle capte. Reste à savoir si la machine répond encore.

2Le serveur est-il joignable ?

Deux tests disent si la machine répond : ping pour le réseau, puis ssh pour la porte d'entrée. La commande ping envoie de petits messages et attend leur écho, comme un sonar. Lancez-la depuis votre ordinateur, avec -c 3 pour s'arrêter après trois messages.

Sur votre ordinateur
ping -c 3 203.0.113.10
Résultat attendu
PING 203.0.113.10 (203.0.113.10) 56(84) bytes of data.

--- 203.0.113.10 ping statistics ---
3 packets transmitted, 0 received, 100% packet loss, time 2049ms

Ici, « 0 received » veut dire qu'aucun écho n'est revenu. Une machine en bonne santé répond trois fois, avec « 0% packet loss ». Mais certains hébergeurs bloquent le ping : un silence seul ne prouve donc rien. Essayez la connexion elle-même, comme dans Première connexion en SSH.

Sur votre ordinateur
ssh alice@203.0.113.10
Résultat attendu
ssh: connect to host 203.0.113.10 port 22: Connection timed out

Le message vous dit où se situe la panne :

  • Vous êtes connecté : la machine vit, la suite se passe sur elle.
  • Connection timed out : rien n'arrive jusqu'au serveur. Il est éteint, le réseau est coupé, ou un pare-feu avale les messages.
  • Connection refused : la machine répond, mais personne n'écoute sur le port 22. Le service SSH est arrêté.

Dans les deux derniers cas, vous ne pouvez plus entrer par SSH. Utilisez alors la console distante de votre hébergeur : un écran et un clavier virtuels, accessibles depuis le site de l'hébergeur. Elle fonctionne même quand le réseau du serveur est tombé. Si SSH répond, vous êtes dans la machine : regardons ce qu'elle a dans le ventre.

3Reste-t-il de la place et de la mémoire ?

Un disque plein ou une mémoire épuisée suffisent à faire tomber des services qui n'ont rien de cassé. Quatre commandes donnent l'état des lieux en dix secondes :

  • La place : df -h liste les disques avec leur remplissage. Cherchez la colonne Use%, et méfiez-vous des valeurs proches de 100 %.
  • Les fiches : df -i compte les inodes, les fiches qui décrivent chaque fichier. Un disque peut manquer de fiches alors qu'il lui reste de la place, par exemple avec des millions de minuscules fichiers.
  • La mémoire : free -h montre la mémoire vive. Lisez la colonne available : c'est ce qui reste réellement disponible.
  • La charge : uptime affiche trois nombres, la charge moyenne sur 1, 5 et 15 minutes. Comparez-les au nombre de cœurs du processeur, donné par nproc. Bien au-dessus, la machine est surchargée.

Supposons que vos données vivent dans /donnees. Voici un disque plein. Ici, c'est un petit espace de test en mémoire, le vôtre portera un autre nom :

Sur le serveur
df -h /donnees
Résultat attendu
Filesystem      Size  Used Avail Use% Mounted on
tmpfs           2.0M  2.0M     0 100% /donnees

La colonne Avail est à zéro et Use% à 100 % : toute écriture échoue avec le message No space left on device. Pour trouver ce qui occupe la place, du additionne la taille des fichiers, et sort -h les range du plus petit au plus gros.

Sur le serveur
sudo du -ah /donnees | sort -h | tail -n 3
Résultat attendu
1.0M	/donnees/export.sql
1.0M	/donnees/gros.log
2.0M	/donnees

Les coupables sont en bas de liste, ici deux fichiers de 1 Mo. Si df -i annonce 100 % d'IUse%, cherchez plutôt le dossier qui contient des millions de petits fichiers. Place et mémoire sont correctes ? Alors un programme est peut-être simplement arrêté.

4Quels services sont tombés ?

La commande systemctl --failed liste les services que systemd a essayé de lancer sans y arriver. Un service est un programme qui tourne en permanence, comme Apache. Les options --plain et --no-legend retirent la ligne de titre des colonnes et le petit rond qui marque chaque service (la « pastille »), pour ne garder que les lignes utiles.

Sur le serveur
systemctl --failed --plain --no-legend
Résultat attendu
apache2.service loaded failed failed The Apache HTTP Server

Chaque ligne est un service tombé. Quand tout va bien, la commande ne répond rien du tout : le silence est la bonne nouvelle. Interrogeons maintenant le coupable, avec sudo pour voir aussi ses dernières lignes de journal.

Sur le serveur
sudo systemctl status apache2 --no-pager
Résultat attendu
     Loaded: loaded (/usr/lib/systemd/system/apache2.service; enabled; preset: enabled)
     Active: failed (Result: exit-code) since Thu 2026-11-05 07:48:59 UTC; 20ms ago
   Duration: 17.284s
 Invocation: 27ea0799a7d349bc8266e4b4f5d80903
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 153 ExecStart=/usr/sbin/apachectl start (code=exited, status=1/FAILURE)
   Mem peak: 1.5M
        CPU: 15ms

Nov 05 07:48:59 mon-serveur systemd[1]: Starting apache2.service - The Apache HTTP Server...
Nov 05 07:48:59 mon-serveur apachectl[155]: AH00526: Syntax error on line 226 of /etc/apache2/apache2.conf:
Nov 05 07:48:59 mon-serveur apachectl[155]: Invalid command 'ServerNaem', perhaps misspelled or defined by a module not included in the server configuration
Nov 05 07:48:59 mon-serveur systemd[1]: apache2.service: Control process exited, code=exited, status=1/FAILURE
Nov 05 07:48:59 mon-serveur systemd[1]: apache2.service: Failed with result 'exit-code'.
Nov 05 07:48:59 mon-serveur systemd[1]: Failed to start apache2.service - The Apache HTTP Server.

La ligne Active: failed confirme la panne, et les lignes datées du bas en donnent déjà la cause : Invalid command 'ServerNaem', une faute de frappe pour ServerName. Vos dates et vos numéros seront autres. Ici l'extrait suffit, mais ce n'est pas toujours le cas : il faut alors lire le journal en entier.

5Que disent les journaux ?

Pour lire les journaux d'une panne, journalctl donne trois angles, détaillés dans Lire les journaux. Le premier garde les erreurs depuis le dernier démarrage de la machine (-p err -b) : il dit quoi.

Sur le serveur
sudo journalctl -p err -b --no-pager
Résultat attendu
Nov 05 07:48:59 mon-serveur systemd[1]: Failed to start apache2.service - The Apache HTTP Server.

La ligne annonce l'échec, sans la raison. Le deuxième angle lit un seul service sur une période courte (-u et --since) : il dit pourquoi. Voici les quatre dernières lignes d'Apache.

Sur le serveur
sudo journalctl -u apache2 --since "10 minutes ago" --no-pager | tail -n 4
Résultat attendu
Nov 05 07:51:04 mon-serveur apachectl[600]: Invalid command 'ServerNaem', perhaps misspelled or defined by a module not included in the server configuration
Nov 05 07:51:04 mon-serveur systemd[1]: apache2.service: Control process exited, code=exited, status=1/FAILURE
Nov 05 07:51:04 mon-serveur systemd[1]: apache2.service: Failed with result 'exit-code'.
Nov 05 07:51:04 mon-serveur systemd[1]: Failed to start apache2.service - The Apache HTTP Server.

Le journal confirme la faute de frappe. Le troisième angle, -b -1, lit le démarrage précédent : utile quand la machine a planté puis redémarré toute seule. Ces trois commandes pointent le service. Reste à vérifier que le réseau le laisse atteindre.

6Le réseau et le pare-feu laissent-ils passer ?

Trois commandes répondent : ss montre ce qui écoute, ufw ce que le pare-feu autorise, dig ce que répond le nom de domaine. Rappel de Le vocabulaire : IP, DNS, domaine, port, pare-feu : un port est une porte numérotée de la machine, et un programme y écoute en attendant les visiteurs. Voyons d'abord qui écoute.

Sur le serveur
sudo ss -tlnp
Résultat attendu
State Recv-Q Send-Q Local Address:Port Peer Address:PortProcess

Les options -t, -l, -n et -p demandent les ports où un programme écoute (en TCP, le protocole du web), avec leur numéro plutôt que leur nom, et le programme concerné. Seul l'en-tête s'affiche : personne n'écoute sur le port 80, donc Apache n'est pas là. Quand tout va bien, une ligne apparaît sous l'en-tête pour chaque programme à l'écoute.

Si un programme écoute mais que les visiteurs n'arrivent pas, regardez le pare-feu. Le ufw de Pare-feu avec ufw doit autoriser les ports 80 et 443 pour un site web. Enfin, dig demande son adresse au nom de domaine.

Sur le serveur
sudo ufw status
dig +short exemple.fr

La première commande liste les règles : sans règle pour 80 et 443, les visiteurs voient un délai d'attente. La seconde doit afficher 203.0.113.10, l'adresse de votre serveur. Une autre adresse, ou rien, renvoie au chapitre sur Nom de domaine et DNS. Ici, tout est en ordre, sauf Apache : voyons le site lui-même.

7Le site web répond-il ?

La commande curl -I demande à votre site son en-tête de réponse, la première ligne qu'il renvoie, qui porte un code. Le code 200 veut dire « tout va bien ». Testez depuis le serveur lui-même, avec -sS pour masquer la barre de progression tout en gardant les erreurs.

Sur le serveur
curl -sSI http://localhost
Résultat attendu
curl: (7) Failed to connect to localhost port 80 after 0 ms: Could not connect to server

Le code d'erreur (7) veut dire que personne ne répond : cohérent avec le ss vide. Avant de relancer Apache, une habitude évite bien des soucis : vérifier la syntaxe de ses fichiers de réglages avec apachectl configtest.

Sur le serveur
sudo apachectl configtest
Résultat attendu
AH00526: Syntax error on line 226 of /etc/apache2/apache2.conf:
Invalid command 'ServerNaem', perhaps misspelled or defined by a module not included in the server configuration

Le test donne le fichier, la ligne et la faute. Corrigez ServerNaem en ServerName avec sudo nano /etc/apache2/apache2.conf. nano est un éditeur de texte dans le terminal : déplacez-vous avec les flèches, corrigez le mot, puis Ctrl + O et Entrée pour enregistrer, Ctrl + X pour quitter (détails dans Le terminal pour débutants). Testez ensuite à nouveau.

Sur le serveur
sudo apachectl configtest
sudo systemctl restart apache2
curl -sSI http://localhost | head -n 1
Résultat attendu
Syntax OK
HTTP/1.1 200 OK

Le site répond, et sudo ss -tlnp montre à nouveau la ligne d'Apache sur le port 80. Si le code n'est pas 200, lisez la fin du journal d'erreurs du site, qui n'est pas celui de systemd :

Sur le serveur
sudo tail -n 20 /var/log/apache2/error.log

Les codes qui commencent par 5 signalent une erreur côté serveur, et ceux qui commencent par 4 une demande refusée ou une page absente. Mais la cause n'est pas toujours un réglage : le disque ou la mémoire peuvent être saturés.

8Disque ou mémoire saturés

Quand df, free ou uptime ont tiré la sonnette à l'étape 3, la panne vient d'une ressource épuisée, pas d'un réglage. Trois situations se distinguent :

  • Un disque lent ou saturé de lectures : tout traîne sans qu'aucun service ne tombe. Diagnostiquer un disque saturé apprend à voir qui l'occupe.
  • Un disque qui lâche : des erreurs de lecture, des fichiers illisibles. RAID logiciel et surveillance SMART montre comment surveiller sa santé.
  • Une mémoire pleine : le noyau, le cœur du système, tue alors un programme pour sauver la machine. Il en reste une trace dans son journal.
Sur le serveur
sudo journalctl -k | grep -i "out of memory"

La commande cherche cette trace dans les messages du noyau (-k). Si elle n'affiche rien, la mémoire n'est pas en cause. Sinon, elle affiche une ligne « Out of memory: Killed process » suivie du numéro et du nom du programme tué. Pour être prévenu avant la panne plutôt qu'après, Supervision simple met en place une alerte. Si la cause reste introuvable ou si le temps presse, il y a un dernier recours.

9Revenir en arrière

Quand la cause se cache ou que le temps presse, remettez la dernière version qui marchait. Il y a deux cas, selon ce que vous avez perdu :

  • Un fichier que vous avez modifié : gardez une copie avant chaque modification, avec sudo cp /etc/apache2/apache2.conf /etc/apache2/apache2.conf.bak. Pour revenir, copiez la .bak par-dessus.
  • Des données perdues ou abîmées : récupérez-les dans une sauvegarde, comme celles de Sauvegardes chiffrées avec restic.

Avec restic, on liste d'abord les sauvegardes, qu'il appelle des instantanés. Ici, le dépôt est /sauvegardes : remplacez-le par le chemin du vôtre, par exemple /home/alice/depot-restic si vous avez suivi cet article-là. Avant de répondre, restic demande le mot de passe du dépôt, celui choisi à sa création dans Sauvegardes chiffrées avec restic : tapez-le (rien ne s'affiche pendant la saisie) puis Entrée. Comptez sur cette question à chaque commande restic de cette étape.

Sur le serveur
sudo restic -r /sauvegardes snapshots
Résultat attendu
enter password for repository:
repository c1443eb0 opened (version 2, compression level auto)
ID        Time                 Host         Tags        Paths      Size
-----------------------------------------------------------------------
0b782240  2026-11-05 07:51:30  mon-serveur              /srv/site  17 B
-----------------------------------------------------------------------
1 snapshots

Chaque ligne est un point de retour. Restaurez dans un dossier à côté, jamais par-dessus : vous vérifiez d'abord, vous remplacez ensuite.

Sur le serveur
sudo restic -r /sauvegardes restore latest --target /tmp/restauration --include /srv/site/index.html
sudo cat /tmp/restauration/srv/site/index.html
Résultat attendu
enter password for repository:
repository c1443eb0 opened (version 2, compression level auto)
restoring snapshot 0b782240 of [/srv/site] at 2026-11-05 07:51:30.076496234 +0000 UTC by root@mon-serveur to /tmp/restauration
Summary: Restored 3 / 1 files/dirs (17 B / 17 B) in 0:00
<h1>Bonjour</h1>

Les identifiants et les heures seront les vôtres. Le contenu s'affiche : vous pouvez copier le fichier à sa place avec sudo cp. Reste une dernière étape, que tout le monde saute et dont vous serez content plus tard.

10Écrire ce qui s'est passé

Un compte rendu court, écrit tant que vous vous souvenez, évite de retomber dans la même panne. On l'appelle un post-mortem : un bilan écrit après la panne, qui cherche la cause et non un coupable. Cinq lignes suffisent :

  • Début et fin : les heures notées à l'étape 1.
  • Symptôme : ce que voyaient les visiteurs.
  • Cause : ici, une faute de frappe dans apache2.conf.
  • Correction : la ligne corrigée, puis la relance d'Apache.
  • Ce qui change : ici, lancer apachectl configtest avant chaque relance.

La dernière ligne compte le plus : une panne qui n'améliore rien se reproduira. Pour garder tout cela sous la main, voici la liste complète des dix étapes, à imprimer ou à ouvrir à côté de votre terminal.

Le tableau : symptôme, première commande

Quand le symptôme est clair, ce tableau évite de refaire tout l'entonnoir : il donne la première commande, puis où chercher ensuite.

SymptômePremière commandeOù chercher ensuite
Plus rien ne répond (ni ping ni SSH)la console distante de l'hébergeurl'état de la machine dans l'espace client ; RAID logiciel et surveillance SMART si le disque est suspect
SSH : Connection refusedsudo systemctl status ssh via la consolesudo ufw status, puis journalctl -u ssh
Le serveur répond mais tout traîneuptimefree -h, df -h, puis Diagnostiquer un disque saturé
No space left on devicedf -h et df -isudo du -ah /donnees | sort -h | tail
Un service ne démarre passudo systemctl status nomsudo journalctl -u nom --since "10 minutes ago"
Le site ne s'ouvre pascurl -sSI http://localhostsudo apachectl configtest, puis error.log
Le nom de domaine ne mène nulle partdig +short exemple.frNom de domaine et DNS, puis sudo ufw status
Un programme a disparu sans bruitsudo journalctl -k | grep -i "out of memory"free -h, puis Supervision simple
Ça marchait hier, plus aujourd'huils -lt /etc | head -n 5le registre /var/log/dpkg.log, puis la sauvegarde (étape 9)

Si ça échoue

Deux messages reviennent quand on se sert du journal sans les bons droits :

  • Hint: You are currently not seeing messages from other users and the system. Il manque sudo devant journalctl. Relancez la même commande avec lui.
  • systemctl status sans lignes de journal. Même cause : sans sudo, alice ne voit que les informations d'état, pas les lignes datées du bas.

Pour finir

C'est la dernière marche du parcours, et vous voilà avec un serveur qui sait vous dire ce qui lui arrive, et quelqu'un pour l'écouter. Il retombera en panne un jour, comme tous les serveurs du monde, et ce jour-là vous aurez une liste, une tasse de thé et tout votre temps. Bon vent à mon-serveur, et à vous.