Avant tout : regarder avant de deviner
Une panne ressemble toujours à autre chose. « Le site est mort » peut être le DNS, nginx, le service, ou ton navigateur qui garde une vieille page. La seule méthode qui marche : une commande qui montre l'état réel, avant toute hypothèse.
Le symptôme La commande qui montre La cause, vue La réparation Jamais de la case 1 à la case 4 directement. C'est là que les heures se perdent. L'endroit À quoi ça ressemble La commande 1. Le terminal « commande introuvable » ls ~/.local/bin sur Mac, dir $HOME\.local\bin sur Windows (sur ta machine)2. Le DNS le site « n'existe pas » nslookup ton-domaine 1.1.1.1 (sur ta machine)3. Le service une page « 502 Bad Gateway » systemctl status build-web (sur le serveur)4. Les droits le service démarre puis meurt ls -l /home/build/app (sur le serveur)5. Les secrets connexion impossible, ou 503 ls -l serveur/.env (sur le serveur)6. nginx tous les sites tombent d'un coup nginx -t (sur le serveur)
Où taper ces commandes
Les commandes 1 et 2 se tapent dans le terminal de ta machine. Les quatre autres se tapent sur le serveur : connecte-toi d'abord avec ssh root@ton-adresse-ip, comme à la leçon La mise en ligne . Elles sont écrites pour Build : remplace build-web par le nom de ton service et /home/build/app par le dossier de ton application. Si tu ne les connais plus, demande-les à Claude, ou demande-lui de lancer la commande pour toi.
Ne réinstalle pas : presque aucune de ces six pannes ne se règle en réinstallant et réinstaller efface les indices.
01
Le terminal et le DNS : ce qui n'est pas là où on croit
1. « commande introuvable » après une installation. Le programme est là, la fenêtre ne le sait pas encore. Ferme le terminal, rouvre. Si ça persiste, regarde dans le dossier où il s'est installé : ls ~/.local/bin sur Mac, le dossier .local\bin de ton dossier personnel sur Windows. S'il y est, lance-le par son chemin complet, il ne manque que la liste des chemins. La leçon Claude Code s'installe en une ligne explique pourquoi.
2. Le DNS. Le site répond par son adresse IP mais pas par son nom, ou le nom mène à une page de parking. nslookup ton-domaine 1.1.1.1 dit ce que le monde voit. Si l'adresse est mauvaise, c'est chez le vendeur du domaine que ça se corrige. Si c'est la bonne, ton navigateur a gardé l'ancienne : attends, ou teste depuis ton téléphone en 4G (pas sur ton wifi). Ne modifie pas nginx parce que « le site ne répond pas » alors que le problème est le DNS : la commande de vérification de la mise en ligne, avec l'en-tête Host, sépare les deux en une seconde.
Premium
La suite est dans la formation.
Tu viens de lire la première partie. Il en reste 3, avec les commandes exactes et les pièges à chaque étape :
Le service et les droits : ce qui tourne, ou pas Les secrets et nginx : ce qui manque et ce qui casse tout Ce qui n'est dans aucune des six cases 29 € une seule fois, accès à vie. 29 € pour les 50 premiers membres, il en reste 35. Ensuite 49 €.
Prendre l'accès à vie