Dépannage réseau Mac : La checklist du développeur

En tant que développeur sur Mac, vous rencontrez régulièrement des problèmes de réseau : domaines qui ne se résolvent pas, connexions lentes, fichiers hosts qui ne fonctionnent pas. Ce guide vous donne une checklist complète pour diagnostiquer et résoudre les problèmes réseau les plus courants sur macOS.

Checklist de dépannage réseau

Étape 1 : Vérifier la connexion de base

Avant de creuser plus profondément, vérifiez les bases.

Vérifier la connexion Internet :

# Ping Google
ping -c 4 8.8.8.8

# Ping un domaine
ping -c 4 google.com

Si le ping vers l'IP fonctionne mais pas vers le domaine : Problème de résolution DNS.

Si aucun ping ne fonctionne : Problème de connexion réseau de base.

Vérifier l'état de la connexion :

• Préférences Système > Réseau
• Vérifiez que vous êtes connecté
• Vérifiez l'adresse IP obtenue

Étape 2 : Vérifier le fichier hosts

Le fichier hosts est souvent la cause de problèmes de résolution.

Vérifier le contenu :

cat /etc/hosts

Vérifier la syntaxe :

• Une tabulation entre l'IP et le domaine (pas d'espaces)
• Pas de lignes vides problématiques
• Pas de caractères spéciaux non échappés

Vérifier les conflits :

• Plusieurs entrées pour le même domaine ?
• Entrées qui pointent vers des IPs incorrectes ?

Avec ToggleHosts :

• ToggleHosts valide automatiquement la syntaxe
• Vous voyez visuellement toutes vos entrées
• Facile de détecter les conflits

Étape 3 : Vider le cache DNS

Le cache DNS peut conserver d'anciennes résolutions.

Vider le cache DNS sur Mac :

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

Avec ToggleHosts :

• ToggleHosts flush automatiquement le cache DNS après chaque modification
• Vous n'avez rien à faire manuellement

Quand vider le cache :

• Après avoir modifié le fichier hosts
• Si un domaine ne se résout pas correctement
• Après un changement de configuration réseau

Étape 4 : Vérifier les serveurs DNS

Des serveurs DNS lents ou non répondants peuvent causer des problèmes.

Voir vos serveurs DNS configurés :

scutil --dns | grep nameserver

Ou via l'interface :

• Préférences Système > Réseau
• Sélectionnez votre connexion
• Cliquez sur "Avancé" > "DNS"

Tester les serveurs DNS :

# Tester avec dig
dig @8.8.8.8 google.com

# Tester avec nslookup
nslookup google.com 8.8.8.8

Changer de serveur DNS :

Serveurs DNS recommandés :

• Google : 8.8.8.8, 8.8.4.4
• Cloudflare : 1.1.1.1, 1.0.0.1
• Quad9 : 9.9.9.9, 149.112.112.112

Étape 5 : Vérifier la résolution DNS

Testez la résolution DNS étape par étape.

Tester la résolution :

# Avec dig
dig google.com

# Avec host
host google.com

# Avec nslookup
nslookup google.com

Vérifier l'ordre de résolution :

1. Cache DNS local
2. Fichier hosts
3. Serveurs DNS

Tester un domaine spécifique :

# Tester votre domaine local
dig app.local
host app.local

Étape 6 : Vérifier les processus réseau

Des processus peuvent bloquer ou interférer avec le réseau.

Voir les processus réseau :

# Processus utilisant le réseau
lsof -i

# Processus spécifiques
lsof -i :80
lsof -i :443

Vérifier les connexions actives :

netstat -an | grep LISTEN

Étape 7 : Redémarrer les services réseau

Parfois, redémarrer les services réseau résout les problèmes.

Redémarrer mDNSResponder :

sudo killall -HUP mDNSResponder

Redémarrer le réseau :

# Désactiver et réactiver la connexion
# Via Préférences Système > Réseau

Redémarrer complètement :

sudo reboot

Problèmes spécifiques et solutions

Problème : Domaine local ne fonctionne pas

Symptômes :

• Vous avez ajouté une entrée dans le fichier hosts
• Le domaine ne se résout pas
• Erreur "Cannot resolve hostname"

Solutions :

1. Vérifier la syntaxe du fichier hosts :

cat /etc/hosts | grep votre-domaine

2. Vérifier qu'il n'y a pas d'erreurs :

• Tabulation entre IP et domaine (pas d'espaces)
• Pas de caractères spéciaux
• Format correct

3. Flush le cache DNS :

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

4. Tester la résolution :

ping votre-domaine.local
dig votre-domaine.local

5. Vérifier que le serveur écoute :

• Votre application/serveur web est-il démarré ?
• Écoute-t-il sur le bon port ?

Avec ToggleHosts :

• ToggleHosts valide la syntaxe automatiquement
• Flush le DNS automatiquement
• Vous montre visuellement si tout est correct

Problème : Connexion Internet lente

Symptômes :

• Pages qui chargent lentement
• Timeouts fréquents
• Latence élevée

Solutions :

1. Tester la vitesse de connexion :

• Utilisez speedtest.net ou fast.com
• Comparez avec votre débit théorique

2. Vérifier les serveurs DNS :

• Changez pour des serveurs DNS rapides (8.8.8.8, 1.1.1.1)
• Testez la vitesse de résolution

3. Vérifier le cache DNS :

• Un cache DNS bien configuré accélère les résolutions
• Ne le désactivez pas sauf si nécessaire

4. Vérifier les processus réseau :

• Des processus peuvent consommer la bande passante
• Utilisez Activity Monitor pour identifier

5. Vérifier le routeur :

• Redémarrez votre routeur
• Vérifiez les paramètres QoS

Problème : Conflits de domaines

Symptômes :

• Un domaine pointe vers la mauvaise IP
• Plusieurs projets utilisent le même domaine
• Comportement inattendu

Solutions :

1. Vérifier le fichier hosts :

cat /etc/hosts | grep domaine-conflictuel

2. Identifier les entrées en conflit :

• Plusieurs entrées pour le même domaine ?
• La première entrée gagne

3. Réorganiser avec ToggleHosts :

• Créez des environnements séparés
• Un environnement par projet
• Activez seulement celui dont vous avez besoin

4. Utiliser des noms différents :

• projet1-app.local
• projet2-app.local

Problème : Serveur web ne répond pas

Symptômes :

• Le domaine se résout correctement
• Mais le serveur ne répond pas
• Erreur "Connection refused"

Solutions :

1. Vérifier que le serveur est démarré :

# Laravel
php artisan serve

# Node.js
npm start

# Apache
sudo apachectl start

2. Vérifier le port :

lsof -i :8000
netstat -an | grep 8000

3. Vérifier les logs :

• Consultez les logs de votre serveur
• Recherchez les erreurs

4. Tester la connexion :

curl http://app.local:8000
telnet app.local 8000

5. Vérifier les pare-feu :

• Préférences Système > Sécurité > Pare-feu
• Vérifiez que votre application est autorisée

Problème : Cache DNS obsolète

Symptômes :

• Anciennes résolutions toujours actives
• Modifications du fichier hosts ignorées
• Domaine pointe vers une ancienne IP

Solutions :

1. Flush le cache DNS :

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

2. Vider le cache du navigateur :

• Chrome : Cmd+Shift+Delete
• Safari : Cmd+Option+E
• Firefox : Cmd+Shift+Delete

3. Utiliser la navigation privée :

• Pour tester sans cache du navigateur

4. Avec ToggleHosts :

• ToggleHosts flush automatiquement le cache DNS
• Vous n'avez pas à vous en soucier

Outils de diagnostic

Commandes essentielles

ping : Tester la connectivité

ping -c 4 google.com

dig : Interroger les serveurs DNS

dig google.com
dig @8.8.8.8 google.com

nslookup : Résoudre un domaine

nslookup google.com

host : Résolution DNS simple

host google.com

traceroute : Tracer le chemin réseau

traceroute google.com

netstat : Voir les connexions réseau

netstat -an | grep LISTEN

lsof : Voir les processus utilisant le réseau

lsof -i
lsof -i :80

Outils graphiques

Network Utility (inclus dans macOS) :

• Préférences Système > Réseau > Avancé
• Outils de diagnostic intégrés

Wireshark (avancé) :

• Analyse de paquets réseau
• Pour les problèmes complexes

Activity Monitor :

• Voir l'utilisation réseau
• Identifier les processus consommateurs

Checklist rapide

Quand un domaine ne fonctionne pas

• [ ] Vérifier la connexion Internet de base
• [ ] Vérifier la syntaxe du fichier hosts
• [ ] Flush le cache DNS
• [ ] Vérifier que le serveur est démarré
• [ ] Tester la résolution DNS
• [ ] Vérifier les ports et pare-feu
• [ ] Vider le cache du navigateur

Quand la connexion est lente

• [ ] Tester la vitesse de connexion
• [ ] Vérifier les serveurs DNS
• [ ] Vérifier les processus réseau
• [ ] Redémarrer le routeur
• [ ] Vérifier le cache DNS

Quand le fichier hosts ne fonctionne pas

• [ ] Vérifier la syntaxe (tabulation, pas d'espaces)
• [ ] Vérifier qu'il n'y a pas de conflits
• [ ] Flush le cache DNS
• [ ] Vérifier l'ordre des entrées
• [ ] Utiliser ToggleHosts pour validation automatique

Bonnes pratiques

Maintenance préventive

Organisez votre fichier hosts :

• Utilisez ToggleHosts pour gérer vos configurations
• Créez des environnements séparés
• Documentez vos entrées

Surveillez votre réseau :

• Vérifiez régulièrement vos serveurs DNS
• Testez la vitesse de connexion
• Gardez vos configurations à jour

Faites des sauvegardes :

• Avec ToggleHosts, c'est automatique
• Sinon, sauvegardez régulièrement votre fichier hosts

Documentation

Documentez vos configurations :

• Ajoutez des commentaires dans le fichier hosts
• Ou utilisez ToggleHosts pour organiser visuellement

Gardez une trace :

• Notez les changements de configuration
• Documentez les problèmes résolus

Guides complémentaires

Si le diagnostic pointe vers le DNS, commencez par le guide de résolution DNS puis appliquez les commandes de flush DNS sur Mac. Si le problème concerne un domaine local ou staging, vérifiez aussi le guide fichier hosts ne fonctionne pas.

Conclusion

Le dépannage réseau sur Mac peut être frustrant, mais avec une approche méthodique et les bons outils, la plupart des problèmes peuvent être résolus rapidement.

Checklist essentielle :

1. Vérifier la connexion de base
2. Vérifier le fichier hosts
3. Flush le cache DNS
4. Vérifier les serveurs DNS
5. Tester la résolution
6. Vérifier les processus et ports

Outils recommandés :

• ToggleHosts : Pour gérer le fichier hosts facilement
• Commandes terminal : Pour le diagnostic avancé
• Network Utility : Pour les outils graphiques

ToggleHosts à 4,99 € simplifie énormément le dépannage réseau en validant automatiquement votre fichier hosts et en flushant le cache DNS. Essayez-le dès aujourd'hui et découvrez comment le dépannage réseau peut être plus simple et efficace.

Sources et ressources externes

• Comment fonctionne le DNS (Cloudflare Learning)
• Guide d’utilisation du Terminal (Assistance Apple)
• Le fichier hosts expliqué (Wikipédia)