--- title: Technitium DNS (HA-Cluster) category: systems tags: [dns, adblock, ha, keepalived, vrrp, technitium, lxc] created: "2026-11-14" modified: "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):** ```bash pct restore 150 noris_v4:backup/ct/150/ --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`. ## Related - [[reference/ip-map]] · [[concepts/network-architecture]] · [[reference/ports]] - [[systems/monitoring]]