Debian 13 : tutoriel / Diagnostiquer le DNS, les ports en écoute et les erreurs HTTP

Lorsqu'un serveur Debian 13 est injoignable, vérifiez séparément les adresses et les routes, la résolution des noms par le système DNS (Domain Name System), le socket d’écoute et la réponse HTTP (Hypertext Transfer Protocol). Une requête qui fonctionne à l'intérieur de la machine virtuelle ne prouve pas qu'un hôte peut y accéder via la NAT. Un HTTP 404 signifie qu'un serveur HTTP a répondu à la requête, donc examinez le chemin demandé et le serveur répondant au lieu de le considérer comme un simple échec de connexion.

Identifier le chemin de connexion testé

Ce tutoriel utilise une machine virtuelle Debian 13 connectée à VirtualBox NAT (Network Address Translation, traduction d’adresses réseau) et un hôte Windows. L'adresse de l'invité est 10.0.2.15, et la passerelle est 10.0.2.2 dans une configuration à un seul adaptateur NAT. Vérifiez les adresses réelles de l'environnement avec les résultats de requête ci-dessous, et n'appliquez pas les adresses d'exemple à d'autres réseaux.

ip -br address
ip route
ip route get 10.0.2.2
getent ahostsv4 deb.debian.org
sudo ss -lntp

ip route get vérifie la route, l'interface et l'adresse source que le noyau sélectionne lorsqu'il envoie vers la destination spécifiée. Ce n'est pas une commande pour vérifier que le paquet a réellement atteint la destination. getent utilise les paramètres de résolution de noms du système, et l'adresse du réseau de distribution de contenu (CDN) résolue peut varier en fonction du moment. ss -l fait référence à l'écoute, -n à l'adresse et au port numériques, -t au TCP et -p aux informations du processus.

Résultats des tests Cibles à vérifier en premier
Impossible de résoudre le nom en adresse Erreur de saisie du nom, paramètres DNS et de recherche de noms système
Aucune route vers la destination Adresse de l'interface, route de connexion et passerelle par défaut
Seulement réussi à l'intérieur de l'invité Adresse d'écoute, cible de redirection de port, pare-feu
Réponse HTTP 404 Chemin URL, emplacement du fichier, hôte virtuel et routage de l'application
Délai d'attente de la connexion Vérifiez à nouveau la destination, le port, le chemin et le filtrage ; vous ne pouvez pas déterminer une cause uniquement sur la base de ce résultat.

Les adresses 127.0.0.1 de l'hôte et 127.0.0.1 de l'invité sont des adresses de boucle locale de différents ordinateurs. Pour permettre à un invité NAT de recevoir des connexions normales depuis l'hôte, un chemin tel que le transfert de port est nécessaire. Tout en conservant les règles de transfert SSH existantes, nous ajouterons des règles séparées pour la pratique HTTP. Pour identifier les outils responsables, consultez la gestion du réseau et du DNS. Pour modifier les adresses dans l’environnement vérifié, suivez la configuration IPv4 statique et le rétablissement de DHCP.

Préparer des fichiers de test et un serveur uniquement en boucle locale

Préparez deux terminaux Debian et le PowerShell de l'hôte. Le serveur HTTP Python est utilisé uniquement pour la vérification de la connexion et non comme serveur web de production. Si un service existant utilise le port 8080, ne l'arrêtez pas : sélectionnez un port de pratique non utilisé et appliquez-le de manière cohérente dans toutes les commandes et règles de transfert suivantes.

sudo ss -lntp 'sport = :8080'
sudo apt update
sudo apt install --no-install-recommends python3 curl
python3 --version
curl --version

Si ss n'affiche aucune ligne d'écoute au-delà de son en-tête, aucun écouteur TCP n'était répertorié pour ce port à ce moment-là. Passez en revue les dépendances et les changements de paquets avant de confirmer l'installation. La VM invitée du cours d’origine utilisait Python 3.13.5 et curl 8.14.1 ; les mises à jour de sécurité Debian peuvent modifier ces révisions de paquets.

Exécutez ce qui suit sur un terminal utilisateur standard A. mkdir est conçu pour échouer s'il existe un dossier portant le même nom. Ne remplacez pas le dossier existant : vérifiez d'abord son contenu.

mkdir "$HOME/lf-net-demo" &&
printf 'debian-network-lab\n' > "$HOME/lf-net-demo/probe.txt" &&
python3 -m http.server 8080 --bind 127.0.0.1 --directory "$HOME/lf-net-demo"

Si la création du dossier échoue, n'exécutez pas la commande du serveur. Si elle démarre normalement, le terminal A reste dans l'état d'exécution du serveur. Comme la racine du document est limitée à un dossier dédié, l'ensemble du répertoire personnel n'est pas fourni. Le port 8080 est un port que l'utilisateur standard peut lier, donc sudo n'est pas nécessaire pour exécuter le serveur.

Exécutez ce qui suit sur le terminal invité B. Faites des requêtes après que le serveur affiche le message de démarrage.

sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8081/probe.txt

La première requête renvoie debian-network-lab. L'adresse locale de ss est 127.0.0.1:8080. S'il n'y a aucun autre service sur le port 8081, la deuxième requête échouera à se connecter. Le test du cours d’origine a produit le code de sortie curl 7. Cette comparaison montre l'importance du port du service en cours d'exécution, et il peut y avoir des services sur des ports que vous vous attendez à voir échouer, donc priorisez vos propres résultats de requête.

--noproxy '*' permet à cette requête de contourner les variables d'environnement du proxy. --connect-timeout est une limitation au niveau de l'étape de connexion, et --max-time est une limitation sur le temps total d'opération. Ce contournement ne concerne que la requête : ne supprimez pas les paramètres globaux de proxy nécessaires à votre organisation.

Comparer l'accès hôte en ne changeant que l'adresse de liaison

Dans VirtualBox, ouvrez les Paramètres de la VM cible → Réseau → Adaptateur NAT → Avancé → Redirection de port . L'emplacement de l'interface peut varier selon la version. Ajoutez uniquement la nouvelle règle ci-dessous et laissez la règle SSH existante telle quelle. Si le port hôte 18080 est utilisé, sélectionnez un port libre.

Élément Paramètres
Nom / Protocole lf-debian13-http15 / TCP
IP / Port de l'hôte 127.0.0.1 / 18080
IP / Port de l'invité Si vous utilisez l'adresse par défaut d'un invité NAT unique, laissez l'IP vide / 8080

Si vous spécifiez une adresse d'invité, elle doit correspondre à l'adresse actuelle de l'invité. Cet exercice utilise l'adresse NAT par défaut 10.0.2.15, et les machines virtuelles dont les adresses ont été modifiées doivent voir leurs cibles de redirection vérifiées à nouveau. Restreindre l'adresse IP de l'hôte à la boucle locale empêche les autres ordinateurs du LAN d'accéder au serveur de pratique. Pour des instructions détaillées, consultez la documentation VirtualBox NAT et redirection de ports.

Exécutez ceci dans PowerShell de l'hôte. curl.exe est spécifié pour le distinguer des alias de Windows PowerShell.

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:18080/probe.txt
$LASTEXITCODE

La requête dans la VM invitée a réussi, mais celle de l’hôte a échoué : le serveur n’écoutait que sur la boucle locale de la VM, pas sur l’adresse de sa carte réseau (NIC) recevant le trafic redirigé par NAT. Le test d’origine a produit une réinitialisation de la connexion et un statut de sortie curl 56. D'autres versions de virtualisation ou états de connexion peuvent produire différentes erreurs ou délais d'attente ; correspondre exactement à 56 n'est pas une exigence.

Dans le terminal A de la VM invitée, arrêtez le serveur avec Ctrl+C . Gardez le même fichier, port et règle de redirection, et changez uniquement l'adresse de liaison.

python3 -m http.server 8080 --bind 0.0.0.0 --directory "$HOME/lf-net-demo"

Après avoir confirmé le message de démarrage du serveur, vérifiez la requête du terminal B de la VM et l’adresse d’écoute indiquée par ss.

sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://10.0.2.15:8080/probe.txt

0.0.0.0:8080 signifie écouter sur toutes les adresses IPv4 locales ; cela ne fournit pas automatiquement l'écoute IPv6. Après que la requête vers l'adresse NIC de l'invité réussit, répétez la même commande curl.exe sur l'hôte pour vérifier le contenu du fichier et le statut de sortie 0. Si une requête échoue immédiatement après le démarrage, confirmez d'abord que le processus est toujours en cours d'exécution et que le socket d'écoute existe.

Cette comparaison isole l'effet de l'adresse d'écoute. Si votre requête échoue toujours, examinez le transfert, l'adresse de l'invité, le socket d'écoute et les règles de filtrage plutôt que de simplement désactiver le pare-feu. L'échec de ping seul peut refléter la politique du protocole ICMP (Internet Control Message Protocol) ; cela ne prouve pas que tous les services TCP (Transmission Control Protocol) sont indisponibles.

Distinguer le statut HTTP du code de sortie de curl

Le serveur fonctionne sur toutes les adresses IPv4 et l'hôte PowerShell demande un fichier inexistant. -w renvoie le code de réponse, et -o NUL ignore le corps sur Windows.

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --fail -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE

Le code HTTP pour la première demande est 404, mais le code de sortie de curl est 0. Par défaut, curl ne considère pas les statuts d'erreur HTTP eux-mêmes comme des échecs de transmission. La deuxième requête reçoit le même HTTP 404 et retourne le code de sortie 22 à cause de --fail. Dans les vérifications automatisées, il faut déterminer selon l'objectif s'il faut uniquement regarder le code de sortie ou aussi juger le statut HTTP. Ne remplacez pas les vérifications opérationnelles nécessitant la confirmation de redirection, d'authentification ou du contenu réel de la réponse par le simple contrôle du 200.

Dans ce test contrôlé, le rapprochement du code 404 et du journal du serveur Python confirme qu’une requête HTTP et sa réponse ont bien été échangées. Vérifiez le chemin URL et la racine du document, et comparez le journal du serveur pour GET /missing.txt et le statut 404. Dans un déploiement réel, confirmez également quel serveur ou proxy a renvoyé la réponse. Le manuel officiel de curl documente la gestion HTTP et les codes de sortie du transfert séparément.

Isoler le DNS en imposant une adresse pour une seule requête

Les règles de nom à usage spécial dans la RFC 6761 réservent .invalid pour les noms qui ne sont pas censés se résoudre avec succès. Gardez le serveur et la règle de transfert inchangés et demandez le nom d'hôte de test ci-dessous depuis l'hôte Windows.

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --resolve "lf-debian13-net15.invalid:18080:127.0.0.1" http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE

Dans le chemin de requête général, la première requête retourne un échec de recherche de nom et un code de sortie 6. La deuxième requête spécifie l'adresse pour ce nom d'hôte et ce port uniquement pour cette exécution de curl, donc elle reçoit le fichier et retourne le code de sortie 0. --resolve ne modifie pas le serveur DNS ni le fichier hosts et conserve le nom d'hôte dans l'URL. En HTTPS, la vérification du certificat pour le nom d'hôte de l'URL est toujours requise, donc ne confondez pas cette option avec l'ignorance de la vérification du certificat.

Si seule la deuxième requête réussit, cela indique que le chemin de transmission vers l'adresse spécifiée fonctionne et donne des raisons d'examiner plus en détail le chemin de recherche de nom original. Spécifier une adresse arbitraire sans vérifier si elle est l'IP correcte dans un service réel pourrait entraîner la vérification d'un autre serveur. Vous ne devriez pas non plus supposer que le proxy, le cache ou la méthode de recherche de nom d'un certain programme est le même que le résultat du système getent.

Nettoyer et enregistrer les résultats du diagnostic

  1. Sur le terminal invité A, arrêtez le serveur HTTP avec Ctrl+C.
  2. Dans le tableau de redirection de ports de VirtualBox, supprimez uniquement la règle lf-debian13-http15 créée cette fois-ci. Conservez la règle SSH.
  3. Dans la VM invitée, vérifiez l'état d'écoute et le fichier ci-dessous, et supprimez uniquement les fichiers et dossiers vides créés cette fois.
sudo ss -lntp 'sport = :8080'
cat "$HOME/lf-net-demo/probe.txt"
rm -- "$HOME/lf-net-demo/probe.txt"
rmdir -- "$HOME/lf-net-demo"

La ligne d'écoute du serveur devrait disparaître, et les requêtes HTTP de test de l'hôte ne devraient plus non plus réussir. Si rmdir échoue, vérifiez s'il y a d'autres fichiers dans le dossier et ne supprimez pas de manière récursive de force. Les outils curl et Python installés peuvent être utilisés pour d'autres tâches de gestion, donc une suppression en masse sans vérifier la nécessité ne doit pas être effectuée.

Lors de l'enregistrement des problèmes, il est utile d'inclure l'emplacement de l'inspection (hôte/invité), l'URL de la requête, l'adresse et le port de destination réels, l'adresse d'écoute, le code de sortie de curl et le code HTTP. La recherche des adresses et des routes peut être vérifiée dans la documentation Debian 13 ip-route, les sockets en écoute dans la documentation ss, et les options du serveur de test dans la documentation Python 3.13 http.server.