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

  1. 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.).
  2. Kea DDNS (/etc/kea/kea-dhcp-ddns.conf): Erhält NameChangeRequests (NCRs) von DHCPv4 und leitet diese an den Technitium DNS weiter.
  3. Kea DHCPv4 (/etc/kea/kea-dhcp4.conf): Vergibt IP-Adressen und schickt bei Lease-Vergabe/-Freigabe ein Update an kea-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:

  1. 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.arpa für das Subnetz 192.168.4.0/24
  2. Sicherstellen, dass Dynamische Updates für die Zone erlaubt sind (z. B. für die IP von Kea-01 zugelassen 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_SUCCEEDED
  • FQDN: [<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