mdocker doctor ausführen

Wann immer etwas nicht funktioniert, führe zuerst das aus:

mdocker doctor

doctor ist ein read-only Health-Check deiner gesamten Toolchain und deines MultiDocker-States. Es verändert nichts — es sagt dir nur, was falsch ist, und wo möglich, wie du es behebst.

Was es prüft

scripts/doctor.sh läuft den ganzen Stack durch:

Kategorie	Prüfungen
Container-Runtime	docker und docker compose v2 vorhanden und funktionsfähig
Toolchain	yq (mikefarah v4), jq, mkcert, tmux verfügbar
TLS	das Wildcard-Zertifikat existiert und deckt jede konfigurierte Basis-Domain ab
DNS	die Datei /etc/resolver/<base-domain> existiert und löst tatsächlich auf
Netzwerk	das multi-docker-edge-Docker-Netz existiert
Edge-Stack	die Edge-Container laufen
Ports	80, 443 und 53 sind verfügbar (oder vom Edge-Stack gehalten, nicht von einem fremden Prozess)

DNS wird verifiziert, nicht nur angenommen

Der DNS-Check sucht nicht nur nach der Resolver-Datei — er führt einen echten Lookup gegen einen Probe-Hostnamen aus (dscacheutil -q host -a name <probe>.<base-domain>). Das fängt den häufigen Fall „Resolver-Datei vorhanden, aber nicht aktiv“ ab, bei dem ein frischer Mac die Resolver-Konfiguration noch nicht neu geladen hat. Siehe DNS & TLS.

Die Ausgabe lesen

Jede Prüfung meldet ihren Status und, bei Fehlern, eine kurze Meldung und einen Lösungsvorschlag. Arbeite von oben nach unten — frühere Prüfungen sind grundlegend (ohne Container-Runtime kann nichts anderes bestehen), sodass das Beheben des ersten roten Punkts oft mehrere darunter mitklärt.

Typische Lösungen, die doctor aufzeigt:

• Fehlendes Tool → brew install <tool>.
• Fehlendes Zertifikat → mdocker setup-tls.
• Fehlender/inaktiver Resolver → mdocker setup-dns (oder bash scripts/setup-dns.sh).
• Fehlendes Netzwerk → mdocker setup-network.
• Edge unten → mdocker edge up.
• Port von einem fremden Prozess gehalten → doctor nennt den störenden Prozess, damit du ihn stoppen kannst.

Maschinenlesbare Ausgabe

Fürs Scripting oder die App ergänze --json:

mdocker doctor --json

Jede Zeile trägt ein category, name, status, message und fix. Die macOS-App konsumiert genau das: Die Doctor-Ansicht gruppiert die Prüfungen nach Kategorie und kann für die ihr bekannten Fälle Auto-Fixes versuchen.

In der App

Klicke den Doctor-Button in der Toolbar. Er führt dieselbe Prüfung aus und zeigt die gruppierten Ergebnisse mit Buttons zum Kopieren der Lösung und zum Ausführen des Auto-Fixes. Es ist das grafische Äquivalent des CLI-Befehls — gleiche Daten, gleiche Schlüsse.

Wenn doctor grün ist, es aber trotzdem scheitert

Wenn jede Prüfung besteht und ein bestimmtes Projekt trotzdem nicht lädt, ist das Problem wahrscheinlich auf Projekt-Ebene statt auf Infrastruktur-Ebene. Weiter zu Häufige Probleme und Edge- & Traefik-Logs lesen.