🌐 Réseaux

networking-tcp-ip-troubleshooter

Diagnostic et résolution de problèmes réseau TCP/IP incluant latence, perte de paquets, DNS et routing.

⚡ Installation & lancement en 1 commande

Copiez-collez dans votre terminal : le skill s'installe dans ~/.claude/skills et Claude Code se lance directement dessus.

macOS / Linux
curl -fsSL https://raw.githubusercontent.com/khalilbenaz/claude-skills-collection/main/install.sh | sh -s -- networking-tcp-ip-troubleshooter --launch
Windows (PowerShell)
iex "& { $(iwr -useb https://raw.githubusercontent.com/khalilbenaz/claude-skills-collection/main/install.ps1) } networking-tcp-ip-troubleshooter -Launch"

🚀 Déjà installé ?

claude "/networking-tcp-ip-troubleshooter"

Ou tapez /networking-tcp-ip-troubleshooter dans une session Claude Code, ou décrivez simplement votre besoin — le skill se déclenche automatiquement via le skill-router.

🔑 Déclencheurs automatiques

Le skill s'active automatiquement quand votre demande contient :

TCP/IPproblème réseaulatence réseaupingtracerouteDNS

📦 Installation manuelle

git clone https://github.com/khalilbenaz/claude-skills-collection.git cp -r claude-skills-collection/skills/networking-tcp-ip-troubleshooter ~/.claude/skills/

Payload du plugin : skills/networking-tcp-ip-troubleshooter · source éditable : networking-skills/tcp-ip-troubleshooter

📖 Manuel

TCP/IP Troubleshooter

Workflow de diagnostic en 8 étapes

1. Qualifier le symptôme

Avant toute commande, déterminer :

Exemple d'arbre décisionnel rapide :

Ping gateway KO  → couche 1-3 (câble, IP, route)
Ping gateway OK, ping DNS KO → routing ou firewall
DNS OK, port cible KO → couche 4 (port bloqué, service down)
Port OK, appli KO → couche 7 (TLS, auth, timeout app)

2. Connectivité de base (couche 3)

# Linux/Mac — tester loopback, gateway, DNS, cible
ping -c 4 127.0.0.1
ping -c 4 192.168.1.1          # gateway locale
ping -c 4 8.8.8.8              # DNS public (bypass résolution)
ping -c 4 example.com          # résolution + connectivité

# Windows
ping -n 4 8.8.8.8
Test-NetConnection 8.8.8.8 -Port 443   # PowerShell — teste port aussi

Critère de décision :


3. Analyse du chemin réseau

# Linux
traceroute -n 8.8.8.8          # -n évite la résolution inverse (plus rapide)
mtr --report --report-cycles 20 8.8.8.8   # outil préféré : stats par saut

# Windows
tracert -d 8.8.8.8
Test-NetConnection -TraceRoute 8.8.8.8

Interpréter mtr :


4. Diagnostic DNS

# Résolution standard
nslookup example.com
dig example.com A              # plus détaillé, voir AUTHORITY/ANSWER section

# Tester un serveur spécifique
dig @1.1.1.1 example.com A
nslookup example.com 8.8.8.8

# Résolution inverse
dig -x 93.184.216.34
nslookup 93.184.216.34

# Vider le cache DNS
sudo systemd-resolve --flush-caches    # Linux systemd
ipconfig /flushdns                     # Windows

Pièges DNS courants :


5. Interfaces et table de routage

# Linux
ip addr show                   # IPs, masques, état UP/DOWN
ip route show                  # table de routage
ip neigh show                  # cache ARP
ss -tuln                       # ports en écoute (remplace netstat)

# Windows
ipconfig /all
route print
arp -a
netstat -ano | findstr LISTEN

Vérifier :


6. Analyse de paquets (couche 2-4)

# Capturer le trafic vers une IP/port cible
sudo tcpdump -i eth0 -nn host 93.184.216.34 and port 443 -w /tmp/cap.pcap

# Afficher en direct les retransmissions TCP
sudo tcpdump -i eth0 'tcp[tcpflags] & (tcp-rst|tcp-syn) != 0' -nn

# Statistiques de retransmission sans capture complète
ss -ti dst 93.184.216.34       # retrans, rtt, cwnd

Indicateurs critiques dans Wireshark/tcpdump :


7. Vérification des services et ports

# Tester un port TCP depuis le client
nc -zv 192.168.1.10 443        # Linux (netcat)
telnet 192.168.1.10 443        # cross-platform basique
Test-NetConnection 192.168.1.10 -Port 443   # Windows PowerShell

# Voir ce qui écoute côté serveur
ss -tlnp | grep :443           # Linux
netstat -ano | findstr :443    # Windows

# Tracer une connexion applicative avec strace (Linux)
strace -e trace=network -p <pid>

Critère : si nc KO depuis client mais ss montre le port ouvert → firewall intermédiaire ou binding incorrect (écoute sur 127.0.0.1 au lieu de 0.0.0.0).


8. Remédiation et validation

  1. Documenter l'état avant modification (snapshots ip route, iptables -L, etc.)
  2. Appliquer un seul changement à la fois et tester immédiatement
  3. Valider end-to-end avec le même chemin que l'utilisateur final
  4. Pour un rollback réseau Linux : ip route replace / ip addr replace ou redémarrage interface ip link set eth0 down && ip link set eth0 up

Garde-fous et anti-patterns

Anti-patternRisqueAlternative
Modifier plusieurs paramètres en même tempsImpossible d'isoler la causeUn changement, un test
Se fier uniquement au ping ICMPBloqué par firewalls, pas représentatif TCPCompléter avec nc/Test-NetConnection
Ignorer Loss% intermédiaire sans vérifier les sauts suivantsFaux positif mtrComparer avec le saut N+1
Vider le cache ARP en prod sans coordinationMicro-coupure sur tous les flux actifsAttendre expiration naturelle ou fenêtre de maintenance
Capturer sans filtre sur un lien haut débitSaturation disque en secondesToujours filtrer : host X and port Y
Changer le DNS resolver en prod sans test préalableRupture des résolutions internesTester d'abord depuis une VM isolée

Bonnes pratiques 2026