Auto-sync: 2026-11-14
This commit is contained in:
@@ -0,0 +1,120 @@
|
||||
---
|
||||
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/<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`.
|
||||
|
||||
## Related
|
||||
- [[reference/ip-map]] · [[concepts/network-architecture]] · [[reference/ports]]
|
||||
- [[systems/monitoring]]
|
||||
Reference in New Issue
Block a user