Vider le cache DNS sur macOS Tahoe

Sur macOS Tahoe 26, la commande pour vider le cache DNS est :

sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder

Utilisez-la après une modification du fichier /etc/hosts, un changement de serveur DNS, une migration de site ou un domaine local qui continue à pointer vers l'ancienne adresse IP.

Réponse rapide

Ouvrez le Terminal, lancez la commande, puis saisissez votre mot de passe administrateur. Le Terminal n'affiche pas les caractères du mot de passe. Si aucune erreur n'apparaît, le cache système a été rafraîchi.

Pour les autres versions de macOS, consultez le guide complet flush DNS Mac par version.

Quand vider le DNS sur Tahoe

Videz le cache DNS quand :

• Une modification de /etc/hosts ne prend pas effet.
• Un domaine .test ouvre encore l'ancien projet.
• Un site de staging pointe vers l'ancien serveur.
• Vous changez de DNS public, de VPN ou de proxy.
• Chrome affiche encore une erreur DNS après correction.

Vérifier l'adresse résolue

Après le flush, vérifiez la résolution :

dscacheutil -q host -a name monprojet.test
ping monprojet.test
dig monprojet.test

dscacheutil montre ce que macOS résout, ping donne une vérification rapide, et dig aide à comparer avec les serveurs DNS.

Vérifier le fichier hosts

Un flush DNS ne corrige pas une ligne hosts invalide. Vérifiez :

• Le fichier est bien /etc/hosts.
• Chaque ligne active commence par une IP.
• Le domaine ne contient ni https://, ni port, ni chemin.
• Les domaines locaux utilisent plutôt .test.
• .local peut entrer en conflit avec Bonjour.

Exemple :

127.0.0.1 monprojet.test
127.0.0.1 api.monprojet.test
::1       monprojet.test

Pour la syntaxe complète, lisez le guide du format /etc/hosts.

Notes spécifiques aux développeurs

Sur macOS Tahoe, la commande de flush reste simple, mais les problèmes viennent souvent de plusieurs couches de cache.

Cache DNS système

C'est la couche gérée par dscacheutil et mDNSResponder. Videz-la après une modification hosts, un changement DNS ou un test de migration.

Cache DNS navigateur

Chrome et Firefox peuvent conserver leur propre cache. Si le Terminal résout la bonne IP mais pas Chrome, nettoyez Chrome.

Cache applicatif

Certaines apps gardent des connexions ouvertes. Redémarrez les clients API, apps Electron, navigateurs ou serveurs dev si l'ancien domaine reste utilisé.

VPN et DNS d'entreprise

Un VPN peut imposer ses propres DNS. Si le domaine fonctionne hors VPN mais pas avec le VPN, vérifiez le split DNS, le proxy et les règles réseau.

Matrice de test

Pour isoler le problème :

• dscacheutil -q host -a name monprojet.test : résolution macOS.
• ping monprojet.test : vérification IP rapide.
• curl -I http://monprojet.test : couche HTTP.
• Fenêtre privée Chrome : cache navigateur.
• Autre navigateur : problème propre à Chrome.
• Partage de connexion mobile : problème réseau.

Si les tests Terminal passent mais pas Chrome, Chrome est probablement bloqué sur un ancien cache. Si les tests Terminal échouent, corrigez d'abord hosts ou DNS.

Automatiser les vérifications

Ajoutez des alias dans ~/.zshrc :

alias flushdns="sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder && echo 'Cache DNS vidé'"
alias checkhost="dscacheutil -q host -a name"

Puis :

flushdns
checkhost monprojet.test

Pour les équipes, documentez dans chaque projet :

• Domaines locaux requis.
• Ports utilisés.
• Commande mkcert.
• Besoin de HTTPS ou non.
• Étapes de reset DNS.
• Contraintes VPN ou proxy.

Exemple :

App locale : https://app.monprojet.test
API locale : https://api.monprojet.test
Hosts : 127.0.0.1 app.monprojet.test api.monprojet.test
Certificat : mkcert app.monprojet.test api.monprojet.test
Après changement hosts : flushdns

Locahl permet de séparer les mappings permanents, les migrations temporaires et les profils clients, ce qui évite de modifier un gros fichier hosts à la main.

Vider le cache navigateur

Chrome garde son propre cache DNS :

• Ouvrez chrome://net-internals/#dns.
• Cliquez sur "Clear host cache".
• Ouvrez chrome://net-internals/#sockets.
• Fermez les sockets inactifs et videz les pools.

Firefox :

• Ouvrez about:networking#dns.
• Cliquez sur "Clear DNS Cache".

Safari :

• Menu Développement > Vider les caches.
• Quittez et relancez Safari si nécessaire.

Automatiser avec un alias

Ajoutez dans ~/.zshrc :

alias flushdns="sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder && echo 'Cache DNS vidé'"

Rechargez :

source ~/.zshrc

Vous pouvez ensuite taper flushdns.

Locahl automatise ce geste après une modification hosts : vous éditez visuellement vos domaines locaux, vous sauvegardez, et le flush DNS est intégré au flux.

Scénarios courants sur Tahoe

Après modification de /etc/hosts

Si vous ajoutez une ligne hosts pour un projet local, faites trois tests :

dscacheutil -q host -a name app.monprojet.test
curl -I http://app.monprojet.test
curl -I http://127.0.0.1

Si l'IP directe répond mais pas le domaine, le problème est côté résolution. Si les deux échouent, le serveur local n'est probablement pas démarré.

Après migration de site

Pendant une migration, évitez de vous fier uniquement au navigateur. Testez le nom de domaine avec curl, vérifiez l'en-tête server, puis confirmez que le contenu chargé vient bien du nouveau serveur. Chrome peut garder une connexion ouverte vers l'ancien hébergement tant que les sockets ne sont pas vidés.

Avec un VPN d'entreprise

Certains VPN remplacent les DNS système, ajoutent du split DNS ou forcent un proxy. Si un domaine fonctionne hors VPN mais échoue avec le VPN, comparez :

scutil --dns
dscacheutil -q host -a name domaine.test

Dans ce cas, vider le cache DNS aide parfois, mais la vraie correction peut être une règle VPN ou un domaine local différent.

Erreurs à éviter

• Ajouter https:// dans le fichier hosts.
• Mettre un port dans /etc/hosts.
• Utiliser .local pour un projet web local.
• Confondre cache DNS et cache HTTP.
• Oublier de redémarrer le navigateur après un changement de certificat.

Le fichier hosts mappe seulement un nom vers une IP. Les ports, protocoles, certificats, cookies et règles CORS se diagnostiquent séparément.

Conclusion

Sur macOS Tahoe, un problème DNS après modification hosts vient souvent de trois couches : cache système, cache navigateur ou syntaxe hosts. Commencez par la commande système, vérifiez avec dscacheutil, puis nettoyez Chrome ou Firefox si le navigateur reste bloqué.