6.6 KiB
title, category, tags, created, modified
| title | category | tags | created | modified | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Technitium DNS (HA-Cluster) | systems |
|
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. Nuronboot=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.cfgleer) 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/promotehochziehen. - VIP bleibt dank
nopreemptbeim Überlebenden (kein Flapping); bei Kaltstart beider gewinnt dns-01. - Hostnamen-Auflösung der Nodes läuft über
/etc/hostsin 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=Noneist 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) undblackbox_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.shsourctmisc/build.func, das Framework liegt jetzt incommunity-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-Unittechnitium.service. - Cluster-Join verlangt FQDN:
primaryNodeUrlmit IP wird abgelehnt („must use the domain name of the Primary node"). - Erst-Login ist
admin/admin— sofortpasswortvia/api/user/changePasswordändern (1P-Item „Technitium DNS Admin"). prometheus-rules.yamlim Repo ist eine ConfigMap und wird von Prometheus NICHT geladen — eigene Regeln brauchen einePrometheusRulemit Labelrelease: monitoring.