Diese Anleitung beschreibt Schritt für Schritt, wie ein neues Subnetz inklusive Forward- und Reverse-DNS-Zonen in Kea DHCPv4 und Kea DDNS (kea-dhcp-ddns) für den Technitium DNS-Server (192.168.1.53) konfiguriert wird.
Übersicht der beteiligten Komponenten
- Technitium DNS (
192.168.1.53): Betreibt die Forward- (z. B.holzfeind.lan.,holzfeind.wlan.) und Reverse-Zonen (z. B.2.168.192.in-addr.arpa.,3.168.192.in-addr.arpa.). - Kea DDNS (
/etc/kea/kea-dhcp-ddns.conf): Erhält NameChangeRequests (NCRs) von DHCPv4 und leitet diese an den Technitium DNS weiter. - Kea DHCPv4 (
/etc/kea/kea-dhcp4.conf): Vergibt IP-Adressen und schickt bei Lease-Vergabe/-Freigabe ein Update ankea-dhcp-ddns.
Schritt 1: Backup der Konfigurationen erstellen
Vor allen Änderungen auf Kea-01 immer ein frisches Backup anlegen:
cp /etc/kea/kea-dhcp-ddns.conf /etc/kea/kea-dhcp-ddns.conf.bak.$(date +%F_%H%M%S)
cp /etc/kea/kea-dhcp4.conf /etc/kea/kea-dhcp4.conf.bak.$(date +%F_%H%M%S)
Schritt 2: Technitium DNS vorbereiten
Falls die neue Forward- oder Reverse-Zone im Technitium DNS noch nicht existiert:
- In der Technitium Web UI unter Zones die neue Zone anlegen:
- Forward Zone: z. B.
holzfeind.iot(Type: Primary Zone) - Reverse Zone: z. B.
4.168.192.in-addr.arpafür das Subnetz192.168.4.0/24
- Forward Zone: z. B.
- Sicherstellen, dass Dynamische Updates für die Zone erlaubt sind (z. B. für die IP von
Kea-01zugelassen oder TSIG-Key konfiguriert).
Schritt 3: Kea DDNS Konfiguration anpassen (kea-dhcp-ddns.conf)
Öffne /etc/kea/kea-dhcp-ddns.conf und füge die neuen Zonen unter forward-ddns und reverse-ddns ein.
Wichtige Regel für Kea JSON:
Jede Zone verlangt ein eigenes Objekt { ... } im ddns-domains-Array. Nicht mehrere "name"-Einträge in ein einzelnes Objekt schreiben! Punkt am Ende beachten!
Beispiel-Struktur (/etc/kea/kea-dhcp-ddns.conf):
{
"DhcpDdns": {
"ip-address": "127.0.0.1",
"port": 53001,
"control-socket": {
"socket-type": "unix",
"socket-name": "kea-ddns-ctrl-socket"
},
"tsig-keys": [],
"forward-ddns": {
"ddns-domains": [
{
"name": "holzfeind.lan.",
"dns-servers": [
{ "ip-address": "192.168.1.53", "port": 53 }
]
},
{
"name": "holzfeind.wlan.",
"dns-servers": [
{ "ip-address": "192.168.1.53", "port": 53 }
]
},
{
"name": "holzfeind.iot.",
"dns-servers": [
{ "ip-address": "192.168.1.53", "port": 53 }
]
}
]
},
"reverse-ddns": {
"ddns-domains": [
{
"name": "2.168.192.in-addr.arpa.",
"dns-servers": [
{ "ip-address": "192.168.1.53", "port": 53 }
]
},
{
"name": "3.168.192.in-addr.arpa.",
"dns-servers": [
{ "ip-address": "192.168.1.53", "port": 53 }
]
},
{
"name": "4.168.192.in-addr.arpa.",
"dns-servers": [
{ "ip-address": "192.168.1.53", "port": 53 }
]
}
]
},
"loggers": [
{
"name": "kea-dhcp-ddns",
"output-options": [
{
"output": "stdout",
"pattern": "%-5p %m\n"
}
],
"severity": "INFO",
"debuglevel": 0
}
]
}
}
Schritt 4: Kea DHCPv4 Subnetz anpassen (kea-dhcp4.conf)
In /etc/kea/kea-dhcp4.conf muss das Subnetz definiert und mit den DDNS-Steuerungsparametern versehen werden.
Beispiel für ein neues Subnetz:
{
"id": 3,
"subnet": "192.168.4.0/24",
"pools": [
{ "pool": "192.168.4.100 - 192.1684.200" }
],
"ddns-send-updates": true,
"ddns-qualifying-suffix": ".holzfeind.iot.",
"option-data": [
{
"name": "routers",
"data": "192.168.4.1"
},
{
"name": "domain-name-servers",
"data": "192.168.1.53"
},
{
"name": "domain-name",
"data": "holzfeind.iot"
}
]
}
Schritt 5: Konfigurations-Syntax prüfen
Vor dem Reload der Dienste immer die Syntax aller geänderten Dateien testen:
# 1. DDNS Syntax-Test
kea-dhcp-ddns -t /etc/kea/kea-dhcp-ddns.conf
# 2. DHCPv4 Syntax-Test
kea-dhcp4 -t /etc/kea/kea-dhcp4.conf
Erwartete Ausgabe bei Erfolg:
text=Configuration check successful
Schritt 6: Kea-Dienste neu laden
Wenn beide Syntax-Tests ohne Fehler verlaufen:
systemctl reload isc-kea-dhcp-ddns-server
systemctl reload isc-kea-dhcp4-server
Schritt 7: Funktion verifizieren
1. Dienst-Status prüfen
systemctl is-active isc-kea-dhcp-ddns-server
systemctl is-active isc-kea-dhcp4-server
2. DDNS-Logs im Live-Betrieb beobachten
journalctl -u isc-kea-dhcp-ddns-server -f
Beim Neuverbinden eines Clients im neuen Subnetz muss im Log Folgendes erscheinen:
DHCP_DDNS_ADD_SUCCEEDEDFQDN: [<hostname>.<neue-zone>.]
3. DNS-Einträge auf Technitium prüfen
# Forward-Lookup (A Record)
dig @192.168.1.53 <hostname>.<neue-zone> A +short
# Reverse-Lookup (PTR Record)
dig @192.168.1.53 -x <IP-des-Clients> +short
Troubleshooting & Häufige Fehler
| Symptom | Ursache | Lösung |
|---|---|---|
duplicate name entries in ddns-domains map |
Mehrere "name"-Felder in einem {}-Objekt |
Jede Zone in ein eigenes { "name": "...", ... } trennen |
unexpected }, expecting "," or ] |
Unerwartetes Komma oder fehlende Klammer | Klammerpaare {} und [] sowie Kommas zwischen Objekten prüfen |
NO_FWD_MATCH_ERROR / NO_REV_MATCH_ERROR |
Zone fehlt in kea-dhcp-ddns.conf oder Punkt am Ende fehlt |
Zone in ddns-domains eintragen und Punkte am Ende prüfen (zone.lan.) |
| Update wird im Log gar nicht angezeigt | ddns-send-updates in kea-dhcp4.conf fehlt/deaktiviert |
ddns-send-updates: true und ddns-qualifying-suffix im Subnetz prüfen |