PKR-Lab

c0000 - DNS-Architektur & Ausfallsicherheit

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/c-netzwerk-dns/c0000-dns-architecture.md

DNS-Architektur & Ausfallsicherheit

Dieses Dokument beantwortet eine sehr berechtigte Frage:

"Wenn ich den Home-Server als zentralen DNS-Server für mein LAN
eintrage und der mal ausfällt, geht zu Hause das ganze Internet weg.
Wie verhindere ich das?"

Kurzfassung: Mach den Home-Server NIEMALS zum einzigen DHCP-DNS-Server
in der Fritz!Box.
Die Fritz!Box kann per DHCP nur eine lokale
DNS-IP verteilen — es gibt also keinen automatischen Fallback. Stattdessen
behandelst du *.homeserver als opt-in-Komfort pro Gerät.


Warum die naheliegende Lösung schlecht ist

            ┌───────────────────────────────────────┐
            │  Fritz!Box (DHCP)                     │
            │  → "Dein DNS-Server ist 192.168...1". │
            └───────────────────────────────────────┘
                            │
                            ▼
            ┌──────────────────────────────────────┐
            │  Jedes LAN-Gerät: Smart-TV,          │
            │  IoT-Steckdose, Drucker, Telefon...  │
            │  Alle fragen NUR 192.168.178.94      │
            └──────────────────────────────────────┘
                            │
                Home-Server crashed
                            │
                            ▼
            ┌──────────────────────────────────────┐
            │  Komplett-Ausfall:                   │
            │  - Kein YouTube auf dem TV           │
            │  - Heizungssteuerung tot             │
            │  - Familie ist sauer                 │
            └──────────────────────────────────────┘

→ Wer den Home-Server zum einzigen DNS für alles macht, hängt sein
gesamtes Heimnetz an dessen Uptime.


Die richtige Architektur

┌───────────────────────────────────────────────────────────────────┐
│  Fritz!Box bleibt unverändert der DHCP-DNS für alle LAN-Geräte    │
└───────────────────────────────────────────────────────────────────┘
                            │
              ┌─────────────┴─────────────┐
              ▼                           ▼
   ┌──────────────────────┐    ┌──────────────────────────┐
   │  Geräte OHNE Bedarf  │    │  Geräte MIT Bedarf an    │
   │  für *.homeserver    │    │  *.homeserver-Hostnames  │
   │  (TV, IoT, Drucker)  │    │  (dein Laptop, Handy)    │
   └──────────────────────┘    └──────────────────────────┘
              │                           │
              ▼                           ▼
       Fritz!Box-DNS               (siehe drei Wege unten)
              │                           │
              ▼                           ▼
            Internet                  *.homeserver
                                      + Internet

Wenn der Home-Server ausfällt:


Die drei Wege für deine Power-User-Geräte

Weg 1: Tailscale Split DNS (empfohlen)

Dein Laptop und dein Handy haben sowieso schon Tailscale, weil du
remote auf den Server willst. Tailscale Split DNS löst beide
Probleme gleichzeitig:

Setup: einmaliger Admin-Console-Schritt, beschrieben in
capulus-ansible/b-kubernetes-gitops/b0030-semaphore.md → Zugriff über Tailscale.

Verfügbarkeit: macOS, Windows, Linux, iOS, Android — überall wo
Tailscale läuft, was praktisch jedes moderne Gerät ist.

Weg 2: Pro Gerät manuell zweiten DNS-Server eintragen

Wenn ein bestimmtes Gerät kein Tailscale haben soll (z.B. ein
Familien-Tablet), trägst du dort manuell zwei DNS-Server in den
WLAN-Einstellungen ein:

Verhalten:

Wo eingetragen?

Weg 3: /etc/hosts-Einträge (Linux/macOS) bzw. hosts-Datei (Windows)

Für einzelne, langlebige Hostnamen — wenn du es ganz statisch willst:

192.168.178.94  semaphore.tech.homeserver argocd.tech.homeserver headlamp.tech.homeserver

Vorteil: funktioniert auch wenn der dnsmasq down ist (das ist halt
eine lokale Datei, kein Netzwerk-Lookup).
Nachteil: musst du auf jedem Gerät pflegen und bei jedem neuen
Service ergänzen.


Was passiert eigentlich am Home-Server selbst?

Der Home-Server hat zwei DNS-Einträge in seiner /etc/resolv.conf:

nameserver 192.168.178.94   # dnsmasq (sich selbst)
nameserver 192.168.178.1     # Fritz!Box (Fallback)

→ Eigene Auflösung läuft schnell über das lokale dnsmasq. Falls dnsmasq
crasht, fällt der Server selbst nach ~5 s auf die Fritz!Box zurück und
bleibt funktional.


Pi-hole: Werbeblocking im DNS-Forward

Seit argocd/apps/tech/pihole/ existiert, leitet dnsmasq alle nicht-*.homeserver-
Anfragen nicht mehr direkt an die Fritz!Box weiter, sondern zuerst an Pi-hole
(k3s-NodePort auf 192.168.178.94:30053, siehe pihole_dns_nodeport in
capulus-ansible/group_vars/all.yml). Pi-hole filtert Werbe-/Tracking-Domains heraus
und reicht den Rest an die Fritz!Box weiter.

Client → dnsmasq (192.168.178.94:53)
           ├── *.homeserver           → statische IPs (wie gehabt)
           └── alles andere           → Pi-hole (NodePort :30053)
                                            → Fritz!Box (192.168.178.1)
                                            → Internet

Das betrifft nur Geräte, die dnsmasq bereits als DNS nutzen (siehe die
drei Wege oben) — ohne Router-Änderung. Fällt Pi-hole aus, liefert dnsmasq
schlicht keine Antwort für nicht-*.homeserver-Namen mehr (kein Fallback auf
die Fritz!Box), bis der Pod wieder läuft; *.homeserver bleibt unberührt.

Das gilt auch für den homeserver selbst und für die PROD-VM: Beide fragen
dnsmasq, CoreDNS beider Cluster damit indirekt ebenfalls Pi-hole. Ein
Pi-hole-Ausfall verhindert deshalb auch Image-Pulls und bringt beide
Cloudflare-Tunnel zum Absturz. Updates laufen darum als RollingUpdate
ohne Unterbrechung, siehe
50020-pihole-update-dns-deadlock.md.


Was ist mit der "Local DNS server"-Option in der Fritz!Box?

Fritz!Box → Heimnetz → Netzwerk → Netzwerkeinstellungen →
"Lokaler DNS-Server"

Lass das Feld leer. Wenn du dort 192.168.178.94 einträgst,
verteilt die Fritz!Box den Home-Server als einzigen DNS-Server an alle
LAN-Geräte per DHCP — genau das Single-Point-of-Failure-Szenario, das
wir vermeiden wollen.


TL;DR Entscheidungsbaum

Brauche ich *.homeserver auf diesem Gerät?
 │
 ├── Nein → nichts tun. Fritz!Box-DNS reicht.
 │
 └── Ja → Hat das Gerät Tailscale?
      │
      ├── Ja → Tailscale Split DNS aktivieren (1× im Tailscale-Admin)
      │
      └── Nein → DNS-Server am Gerät manuell auf
                 192.168.178.94 + 192.168.178.1 setzen

Nachtrag 2026-09-06: UFW blockierte Loopback-DNS

Der Home-Server war über HTTPS von außen normal erreichbar, aber
Tailscale zeigte "last seen" mehrere Tage alt, und ein Ansible-Lauf
schlug bei Download Tailscale GPG signing key mit
Temporary failure in name resolution fehl. Root Cause war kein
Netzwerk-/NIC-Problem (siehe
20020-cluster-power-manager.md → Nachtrag 2026-09-02
für den vorherigen, unabhängigen Vorfall), sondern eine UFW-Firewall-
Regression
: die aktive nftables-Regelmenge hatte die Standardregel
-A ufw-before-input -i lo -j ACCEPT verloren (/etc/ufw/before.rules
auf der Platte war unverändert korrekt), obwohl ufw status selbst
unauffällig aussah. /var/log/ufw.log zeigte live geblockte
IN=lo SRC=127.0.0.1 DST=127.0.0.1-Pakete.

Das legt jeglichen Verkehr über Loopback lahm:

Ursache: /etc/ufw/user.rules wurde am 2026-09-05 06:00 neu
geschrieben (vermutlich durch einen automatisierten Ansible-Lauf, der
community.general.ufw-Regeln aus der common- und dnsmasq-Rolle neu
angewendet hat). UFW's nftables-Backend hat dabei offenbar mit den
bereits vorhandenen k3s/kube-router-nftables-Tabellen kollidiert und die
eigene Default-Regel -i lo -j ACCEPT beim Neuaufbau verloren — ein
bekanntes Zusammenspiel-Problem zwischen UFW (nftables-Backend) und
kube-proxy/kube-router auf demselben Host.

Sofortiger Fix: sudo ufw disable && sudo ufw --force enable baut
die nftables-Tabellen komplett neu auf und stellt die Loopback-Regel
wieder her.

Dauerhafte Absicherung: capulus-ansible/site.yml prüft in den
post_tasks (Tag always, läuft also bei jedem Playbook-Aufruf,
unabhängig von --tags) per iptables -C ufw-before-input -i lo -j ACCEPT, ob die Regel aktiv ist, und führt bei Bedarf denselben
disable/enable-Zyklus automatisch aus. Das behebt nicht die
Ursache (ein UFW/nftables-Bug im Zusammenspiel mit k3s), heilt aber
zuverlässig jeden Ansible-Lauf danach selbst.


Fehlersuche

dig +short carplay-api.prod.homeserver @192.168.178.94     # dnsmasq auf dem Homeserver direkt fragen
dig +short carplay-api.prod.homeserver                      # mit dem System-Resolver
tailscale dns status                                         # Split-DNS (Weg 1)
sudo systemctl status dnsmasq                                # auf dem Homeserver
sudo journalctl -u dnsmasq -n 50 --no-pager
Symptom Ursache Lösung
*.homeserver löst nicht auf, Internet geht Gerät nutzt keinen der drei Wege (kein Split-DNS, kein zweiter DNS-Server, kein Hosts-Eintrag) Weg 1 bis 3 oben einrichten
dig … @192.168.178.94 liefert nichts dnsmasq läuft nicht oder address=/homeserver/… fehlt Rolle dnsmasq erneut ausrollen, systemctl status dnsmasq
Auflösung auf dem Homeserver selbst scheitert (Loopback) UFW blockierte Loopback-DNS Abschnitt „Nachtrag 2026-09-06“
Alle Geräte im LAN ohne Internet Homeserver wurde als einziger DHCP-DNS eingetragen Fritz!Box-Einstellung zurücknehmen (Abschnitt „Warum die naheliegende Lösung schlecht ist“)
Tailscale-Gerät löst *.homeserver nicht Split-DNS für die Domain homeserver fehlt im Tailscale-Admin Tailscale, Semaphore: Zugriff über Tailscale
Pods im Cluster lösen *.homeserver nicht auf coredns-custom CoreDNS-Erweiterung
Werbung oder Seiten werden unerwartet geblockt Pi-hole Pi-hole
Neuer Host in PROD wird nicht aufgelöst Eintrag in dnsmasq_prod_vm_hosts fehlt capulus-ansible ergänzen, Rolle dnsmasq ausrollen (Nutzung)

Allgemeine Fehlersuche: zentrale Fehlersuche.