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
- Un entonnoir plutôt qu'un labyrinthe
- Respirer et ne rien casser de plus
- Le serveur est-il joignable ?
- Reste-t-il de la place et de la mémoire ?
- Quels services sont tombés ?
- Que disent les journaux ?
- Le réseau et le pare-feu laissent-ils passer ?
- Le site web répond-il ?
- Disque ou mémoire saturés
- Revenir en arrière
- Écrire ce qui s'est passé
- Le tableau : symptôme, première commande
- Si ça échoue
- Pour finir
- 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.
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 :
sudo systemctl restart apache2Job 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.
date
sudo grep -E ' (install|upgrade) ' /var/log/dpkg.log | tail -n 3
ls -lt /etc | head -n 5Thu 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 hostsChaque 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.
ping -c 3 203.0.113.10PING 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 2049msIci, « 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.
ssh alice@203.0.113.10ssh: connect to host 203.0.113.10 port 22: Connection timed outLe 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 -hliste les disques avec leur remplissage. Cherchez la colonneUse%, et méfiez-vous des valeurs proches de 100 %. - Les fiches :
df -icompte 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 -hmontre la mémoire vive. Lisez la colonneavailable: c'est ce qui reste réellement disponible. - La charge :
uptimeaffiche trois nombres, la charge moyenne sur 1, 5 et 15 minutes. Comparez-les au nombre de cœurs du processeur, donné parnproc. 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 :
df -h /donneesFilesystem Size Used Avail Use% Mounted on
tmpfs 2.0M 2.0M 0 100% /donneesLa 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.
sudo du -ah /donnees | sort -h | tail -n 31.0M /donnees/export.sql
1.0M /donnees/gros.log
2.0M /donneesLes 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.
systemctl --failed --plain --no-legendapache2.service loaded failed failed The Apache HTTP ServerChaque 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.
sudo systemctl status apache2 --no-pager 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.
sudo journalctl -p err -b --no-pagerNov 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.
sudo journalctl -u apache2 --since "10 minutes ago" --no-pager | tail -n 4Nov 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.
sudo ss -tlnpState Recv-Q Send-Q Local Address:Port Peer Address:PortProcessLes 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.
sudo ufw status
dig +short exemple.frLa 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.
curl -sSI http://localhostcurl: (7) Failed to connect to localhost port 80 after 0 ms: Could not connect to serverLe 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.
sudo apachectl configtestAH00526: 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 configurationLe 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.
sudo apachectl configtest
sudo systemctl restart apache2
curl -sSI http://localhost | head -n 1Syntax OK
HTTP/1.1 200 OKLe 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 :
sudo tail -n 20 /var/log/apache2/error.logLes 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.
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.bakpar-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.
sudo restic -r /sauvegardes snapshotsenter 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 snapshotsChaque ligne est un point de retour. Restaurez dans un dossier à côté, jamais par-dessus : vous vérifiez d'abord, vous remplacez ensuite.
sudo restic -r /sauvegardes restore latest --target /tmp/restauration --include /srv/site/index.html
sudo cat /tmp/restauration/srv/site/index.htmlenter 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 configtestavant 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ôme | Première commande | Où chercher ensuite |
|---|---|---|
| Plus rien ne répond (ni ping ni SSH) | la console distante de l'hébergeur | l'état de la machine dans l'espace client ; RAID logiciel et surveillance SMART si le disque est suspect |
SSH : Connection refused | sudo systemctl status ssh via la console | sudo ufw status, puis journalctl -u ssh |
| Le serveur répond mais tout traîne | uptime | free -h, df -h, puis Diagnostiquer un disque saturé |
No space left on device | df -h et df -i | sudo du -ah /donnees | sort -h | tail |
| Un service ne démarre pas | sudo systemctl status nom | sudo journalctl -u nom --since "10 minutes ago" |
| Le site ne s'ouvre pas | curl -sSI http://localhost | sudo apachectl configtest, puis error.log |
| Le nom de domaine ne mène nulle part | dig +short exemple.fr | Nom de domaine et DNS, puis sudo ufw status |
| Un programme a disparu sans bruit | sudo journalctl -k | grep -i "out of memory" | free -h, puis Supervision simple |
| Ça marchait hier, plus aujourd'hui | ls -lt /etc | head -n 5 | le 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 manquesudodevantjournalctl. Relancez la même commande avec lui.systemctl statussans lignes de journal. Même cause : sanssudo, 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.