Files
memory/systems/technitium-dns.md
2026-11-14 22:00:21 +00:00

6.6 KiB
Raw Permalink Blame History

title, category, tags, created, modified
title category tags created modified
Technitium DNS (HA-Cluster) systems
dns
adblock
ha
keepalived
vrrp
technitium
lxc
2026-11-14 2026-11-14

Technitium DNS — HA-Cluster (LAN-Resolver + Adblock)

Zwei unprivileged LXC auf getrennten PVE-Nodes, betrieben als Technitium-Cluster (1 Primary + 1 Secondary, Config-Sync) mit keepalived-VIP davor.

Topologie

dns-01 dns-02
CT 150 153
PVE-Node proxmox6 (10.0.20.60) ms-a2-2 (10.0.20.93)
IP 10.0.30.150/24, gw 10.0.30.1, tag=30 10.0.30.153/24
Spez 1 vCPU / 1 GB / 4 GB local-lvm (node-lokal, Ceph-unabhängig), unprivileged, onboot dito
Rolle Cluster-Primary, VIP-Träger (VRRP-Prio 150) Cluster-Secondary (Prio 100)
Web-UI http://10.0.30.150:5380 · TLS :53443 http://10.0.30.153:5380

VIP 10.0.30.149 — keepalived, VRID 51, unicast (kein Multicast), nopreempt, Health-Check = TCP :53 und Web-API :5380. Failover gemessen: ~4 s.

Clients / DHCP

Omada-Gateway (10.0.30.1) macht weiterhin DHCP. Es gibt nur zwei DNS-Felder:

DNS 1: 10.0.30.149   (VIP)
DNS 2: 1.1.1.1       (Cloudflare-Fallback)

IPv6-Felder (falls vorhanden): 2606:4700:4700::1111, 2606:4700:4700::1001.

Grund für die VIP: mit nur zwei Feldern wäre sonst entweder der zweite Knoten oder der Public-Fallback verloren gegangen.

Konfiguration (Cluster-Parameter, syncen auf beide Nodes)

  • Cluster-Domain: dns.internal.schoen.codes (Zonen: dns.internal.schoen.codes, cluster-catalog...)
  • Forwarder: 1.1.1.1, 1.0.0.1, 2606:4700:4700::1111, 2606:4700:4700::1001 (UDP)
  • recursion = UseSpecifiedNetworkACL → 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8, ::1, fd00::/8, fe80::/10 (kein offener Resolver)
  • DNSSEC-Validierung an, logQueries=false (Datei-Log aus, Query-Log läuft über die MySQL-App)
  • Blockliste: HaGeZi Multi Pro → https://raw.githubusercontent.com/hagezi/dns-blocklists/main/wildcard/pro.txt (227.848 Domains)

Resilienz-Entscheidung (2026-11-14)

Rootfs auf local-lvm, NICHT auf Ceph. Grund: ceph health = HEALTH_WARN mit „8 OSDs experiencing slow operations"; ein Ceph-Stall hätte beide DNS-Knoten gleichzeitig blockiert (gleicher Cluster → kein Failover-Effekt) und bei Neustart wäre kein Boot möglich.

Konsequenzen, bewusst akzeptiert:

  • Kein HA-Manager für ct:150/153 (state: disabled → entfernt). PVE-HA kann node-lokale Disks nicht relocaten; ein Versuch hat am 2026-11-14 beide CTs auf proxmox4/proxmox5 „verschoben" (Config ja, Disk nein) → ~2–3 Min DNS-Ausfall. Nur onboot=1.
  • Node-Ausfall = Handarbeit: Rebuild per PBS-Restore (siehe unten), Config kommt vom Peer.
  • PVE-native Redundanz für lokale Disks existiert nicht: entweder Shared Storage (Ceph/iSCSI/NFS, automatisch) oder ZFS-Replikation (pvesr, braucht lokales ZFS — proxmox6/ms-a2-2 haben nur LVM-thin, replication.cfg leer) und selbst dann kein Auto-Promote.

Wiederaufbau (nativ, ~1–2 Min):

pct restore 150 noris_v4:backup/ct/150/<snapshot> --storage local-lvm --hostname technitium-dns-01
# danach: Cluster-Join gegen den überlebenden Node, Zonen/Blocklists syncen automatisch

Backups: 23:00-Job (all 1, noris_v4, keep-last=3) — Erstaufnahme 2026-11-14 manuell nachgezogen (ct/150 967 MiB, ct/153 890 MiB).

I/O-Entkopplung: Technitium-Datei-Query-Log logQueries=false (kein Disk-Write pro Query). Die MySQL-App protokolliert unabhängig davon weiter (verifiziert: 84 Rows/45 s). keepalived fall 5 (≈10 s Toleranz) statt 3 → kein VIP-Flapping bei kurzen Slow-Ops.

Betrieb

  • Config-Änderungen nur am Primary; Secondary zieht per Cluster-Sync (configRefreshIntervalSeconds=300).
  • Fällt der Primary irreparabel aus: Secondary per POST /api/admin/cluster/primary/promote hochziehen.
  • VIP bleibt dank nopreempt beim Überlebenden (kein Flapping); bei Kaltstart beider gewinnt dns-01.
  • Hostnamen-Auflösung der Nodes läuft über /etc/hosts in beiden CTs (Cluster verlangt FQDN-URLs, nicht IPs).

Query-Logs nach MySQL (Galera)

App „Query Logs (MySQL) v4.2" (isQueryLogger + isQueryLogs), per Cluster-Sync auf beiden Knoten installiert — beide schreiben in dieselbe Tabelle, getrennt über die Spalte server.

Parameter Wert
Datenbank technitium_querylog (utf8mb4) auf Galera, Tabelle dns_logs (App legt sie an)
Endpoint MaxScale-VIP 10.0.30.70:3306 (nicht .71/.72/.73 — die sind vom VLAN 30 aus nicht direkt erreichbar)
User technitium@% (nötig: MaxScale verbindet mit eigener IP, per-Host-Grants scheitern)
Connection String Server=10.0.30.70; Port=3306; Uid=technitium; Pwd=<1P>; SslMode=None; ConnectionTimeout=10; DefaultCommandTimeout=30;
Retention maxLogDays=30, maxLogRecords=10000000, maxQueueSize=1000000
  • SslMode=None ist Pflicht: der MaxScale-Listener hat kein TLS → MySqlConnector bricht sonst mit „SSL is required, but the server does not support it" ab (Passwort läuft damit im Klartext über VLAN 30).
  • Volumen-Messung: ~61 Queries/min ≈ 88 k/Tag → ~2,6 Mio Rows in 30 Tagen (Galera repliziert 3×).
  • Passwort in 1P: „Technitium QueryLogs DB (Galera)".

Monitoring

  • Prometheus (K8s, 10.0.30.202): Jobs blackbox_dns (A-Query gegen .149/.150/.153) und blackbox_http (Web-UI :5380 auf allen drei Adressen).
  • PrometheusRule technitium-dns-rules: TechnitiumDnsProbeFailing, TechnitiumDnsAllNodesDown, TechnitiumDnsVIPMissing, TechnitiumClusterNotSynced.
  • IaC: iac-homelab/clusters/main/monitoring/technitium-dns-rules.yaml + apps/kube-prometheus-stack.yaml.

Bekannte Fallstricke

  • HaGeZi-URL hat sich geändert: hosts/pro.txt → wildcard/pro.txt (404 sonst).
  • community-scripts-One-Liner aktuell kaputt: ct/technitiumdns.sh sourct misc/build.func, das Framework liegt jetzt in community-scripts/core → 404. Installation daher über die Original-Payload (install/technitiumdns-install.sh): MS-Repo → aspnetcore-runtime-10.0, DnsServerPortable.tar.gz → /opt/technitium/dns, systemd-Unit technitium.service.
  • Cluster-Join verlangt FQDN: primaryNodeUrl mit IP wird abgelehnt („must use the domain name of the Primary node").
  • Erst-Login ist admin/admin — sofort passwort via /api/user/changePassword ändern (1P-Item „Technitium DNS Admin").
  • prometheus-rules.yaml im Repo ist eine ConfigMap und wird von Prometheus NICHT geladen — eigene Regeln brauchen eine PrometheusRule mit Label release: monitoring.