Warum funktioniert die DNS-Auflösung auf dem Host, schlägt aber im Container fehl?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

DNS auf dem Host kann funktionieren, während DNS im Container fehlschlägt, weil der Container einen anderen Resolverpfad, Netzwerk-Namespace, eine andere Firewall-Route oder einen anderen Docker-Weiterleitungsstatus verwendet.

Auf einem Home-Server fragt der Host möglicherweise direkt einen Router, Pi-hole oder VPN-Resolver ab, während ein Container in einem Bridge-Netzwerk seine Anfragen über den integrierten Resolver von Docker oder eine kopierte resolv.conf sendet. Bei der schnellsten Diagnose wird zuerst eine IP-Adresse getestet und anschließend werden die einzelnen Resolver ausdrücklich im fehlerhaften Container abgefragt, damit ein DNS-Ausfall nicht mit einer allgemeinen ausgehenden Verbindungsstörung verwechselt wird.

DNS-Ausfall von einem allgemeinen Netzwerkausfall unterscheiden

Teste im fehlerhaften Container eine bekannte externe IP-Adresse und die IP-Adresse des vorgesehenen DNS-Servers, bevor du einen Hostnamen testest. Notiere Routen, Paketverluste und ob TCP- und UDP-Port 53 erreichbar sind.

Ein Fall mit einem Manjaro-Container zeigt den umgekehrten Fall: Auch direkter IP-Verkehr schlug fehl, was bewies, dass das Problem über DNS hinausging. Dieser Direkt-IP-Verbindungstest verhindert, dass Änderungen am Resolver eine fehlerhafte Bridge-, NAT- oder Firewall-Verbindung verschleiern.

Wenn die IP-Verbindung fehlschlägt, behebe zuerst die Container-Netzwerkverbindung. Wenn die IP-Verbindung funktioniert, aber Namensabfragen fehlschlagen, fahre mit der Resolverkonfiguration und dem Abfragepfad fort.

Resolverkonfiguration im Container überprüfen

Lies /etc/resolv.conf im Container aus und vergleiche die Datei mit der des Hosts. Notiere Nameserver-Adressen, Suchdomänen, Optionen und den Netzwerkmodus sowie, ob sich die Datei nach dem Neuerstellen ändert.

In einem OpenMediaVault-Fall wurde berichtet, dass Container-Abfragen nach einer Laufzeitaktualisierung über Dockers integrierten Resolver 127.0.0.11 fehlschlugen. Dieser Pfad über den integrierten Resolver kann sich anders verhalten als die erfolgreiche Abfrage auf dem Host.

Bearbeite die generierte Datei in einem laufenden Container nicht dauerhaft. Trage beabsichtigte DNS-Server und Suchdomänen in die Compose- oder Plattformkonfiguration ein, damit sie beim Neuerstellen erhalten bleiben.

Docker-DNS und Upstream-Resolver getrennt abfragen

Führe dieselbe Abfrage beim integrierten DNS-Resolver von Docker, beim Router oder lokalen DNS-Server und, sofern die Richtlinien es erlauben, bei einem bekannten externen Resolver aus. Vergleiche Zeitüberschreitung, Ablehnung, NXDOMAIN und die zurückgegebene Adresse.

In einem TrueNAS-Community-Fall ließ sich der ausschließlich in Containern auftretende DNS-Ausfall auf ein Zugriffsprofil des Routers zurückführen, das die Anfragen blockierte, obwohl der übrige Datenverkehr des Hosts funktionierte. Der entscheidende Hinweis war DNS für den Containerpfad blockiert und nicht ein ungültiger Hostname.

Wenn direkte Upstream-Abfragen funktionieren, der integrierte Resolver jedoch nicht, starten Sie den Docker-Resolver und den Netzwerkstatus neu oder setzen Sie sie instand. Wenn bei allen DNS-Servern eine Zeitüberschreitung auftritt, prüfen Sie die Weiterleitung von Port 53, Firewall, VPN und Antwortverkehr.

Single board computer zimaboard2

Auf lokale DNS-Schleifen und falsche interne Antworten prüfen

Ermitteln Sie, ob der Container versucht, einen DNS-Dienst auf demselben Host, einen anderen Container oder einen Hostnamen abzufragen, der über den Reverse-Proxy zurück aufgelöst wird. Zeichnen Sie die Antwort auf, statt davon auszugehen, dass jede erfolgreiche Namensauflösung korrekt ist.

Ein Fall aus der Traefik-Community zeigte, dass ein Container eine benutzerdefinierte Domain zu sich selbst statt zum vorgesehenen Gegenstück auflöste. Diese falsche DNS-Antwort auf der Containerseite bestand einen einfachen Auflösungstest, störte aber weiterhin die API-Verbindung.

Verwenden Sie für den Datenverkehr zwischen Containern im selben Netzwerk Dienstnamen und Split-DNS für öffentliche Hostnamen nur dann, wenn der Rückweg gezielt festgelegt ist. Vermeiden Sie Hairpin-Routen, die einen Container über den öffentlichen Proxy leiten, damit er eine lokale Abhängigkeit erreicht, es sei denn, dieser Pfad wurde ausdrücklich getestet.

UDP-Antworten, NAT und Netzwerkisolierung prüfen

Zeichnen Sie den Datenverkehr auf Port 53 an der Containerschnittstelle und der Host-Bridge auf. Stellen Sie sicher, dass die Anfrage gesendet wird, den Resolver erreicht und die Antwort von der Adresse zurückkommt, die der Client erwartet.

Pi-hole-Nutzer haben dokumentiert, dass Containeranfragen auf demselben Host wegen Zeitüberschreitungen fehlschlagen, weil Antworten von einer unerwartet übersetzten Quelle zurückkamen. Diese unerwartete DNS-Antwortquelle unterscheidet ein Problem mit dem Antwortpfad von einem stillen Resolver.

Wenn Anfrage und Antwort unterschiedliche Docker-Netzwerke durchlaufen, fügen Sie das passende gemeinsame Netzwerk oder eine Route hinzu, statt alle Dienste auf den Host-Netzwerkmodus umzustellen. Prüfen Sie Firewall-Zonen und VPN-Richtlinien, die Bridge-Subnetze anders behandeln als die Host-Adresse.

Netzwerkstatus neu erstellen und Fehlerbehebung nachweisen

Erstellen Sie nach der Korrektur des Resolvers, der Firewall oder der Netzwerkdefinition einen Testcontainer im vorgesehenen Netzwerk neu und wiederholen Sie die Tests für IP-Adresse, direkten Resolver, integrierten Resolver, Dienstnamen und öffentliche Namen.

Der ZimaSpace-Leitfaden zum Trennen von Fehlern bei Adressen und Namen bietet die ergänzende Diagnoseabgrenzung auf Host-Seite.

Das Problem ist erst dann behoben, wenn die DNS-Konfiguration Neuerstellung und Neustart übersteht, interne Dienstnamen und freigegebene öffentliche Namen die vorgesehenen Adressen zurückgeben und der Anwendungsdatenverkehr über denselben Netzwerkpfad funktioniert. Tritt der Fehler erst nach einem Docker-Update wieder auf, halten Sie die Version und die Daemon-Protokolle als Abgrenzung für eine Laufzeitregression fest.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.