ZELYRA
SOFTWARE-HANDBUCH · NETZWERK-TOOL

DynamicDNS
*.dyn.zelyra.eu

Vollständiges Praxishandbuch für DynamicDNS: Dual-Stack IPv4/IPv6, eigene Domains per CNAME, Fritz!Box-/ddclient-/cURL-Einrichtung, /nic/update-API und optionale HMAC-SHA256-Webhooks.

Software-Handbuch: DynamicDNS (*.dyn.zelyra.eu)

1. Überblick & Architektur

Das DynamicDNS-Modul der Siedelmann Business Suite stellt Ihnen eine eigene, DSGVO-konforme DynamicDNS-Infrastruktur auf Basis eines autoritativen PowerDNS-Servers in Deutschland bereit.

  • Basis-Domain: Alle neuen Hosts werden automatisch unter *.dyn.zelyra.eu angelegt (z. B. office.dyn.zelyra.eu).
  • Dual-Stack: Unterstützt IPv4 (A), IPv6 (AAAA) oder Dual-Stack (IPv4 + IPv6) mit kurzer 60-Sekunden-TTL für schnelle Umschaltungen.
  • Eigene Domain (CNAME): Über einen einzelnen CNAME-Eintrag bei Ihrem Domain-Anbieter können Sie beliebige eigene Subdomains (z. B. vpn.ihrefirma.de) auf Ihre DynDNS-Adresse zeigen lassen.
  • Eigenständig buchbar: DynamicDNS kann komplett unabhängig von anderen Business-Suite-Modulen 14 Tage kostenlos getestet und anschließend monatlich (3,90 € netto/Monat) oder jährlich (29,00 € netto/Jahr) über PayPal gebucht werden.

2. Schnellstart & ersten Host anlegen

  1. Melden Sie sich im Portal an und öffnen Sie in der Seitenleiste DynDNS → + Neuer Host (/app/tools/dyndns/neu).
  2. Vergeben Sie eine Subdomain / Hostname (nur Buchstaben a-z, Ziffern 0-9 und Bindestriche, z. B. buero-nord). Daraus entsteht automatisch buero-nord.dyn.zelyra.eu.
  3. Wählen Sie den DNS-Eintragstyp (Dual-Stack empfohlen, Nur IPv4 oder Nur IPv6).
  4. Optional können Sie direkt eine eigene Domain per CNAME (z. B. vpn.ihrefirma.de), eine Beschreibung oder eine Start-IP angeben.
  5. Nach dem Speichern wird automatisch ein geheimer Update-Token (dyn_...) generiert und die Detailansicht mit fertigen Router-Vorlagen geöffnet.

Kontingent & reservierte Hostnamen

  • Standard-Kontingent: Im bezahlten Tarif sind bis zu 10 DynamicDNS-Hosts enthalten (im 14-tägigen Testkonto bis zu 3 Hosts).
  • Kostenfreie Erweiterung: Benötigen Sie mehr Hosts, klicken Sie direkt auf „Kostenfrei weitere Domains anfragen“ – wir erweitern Ihr Kontingent auf kurze Anfrage kostenlos.
  • Globale Eindeutigkeit: Jeder Hostname unter *.dyn.zelyra.eu ist weltweit eindeutig („Wer zuerst kommt, mahlt zuerst“). Systemseitig reservierte Namen (www, ns, ns1, ns2, mail, admin, api, app, status, zelyra, siedelmann usw.) sind geschützt.

3. Eigene Domain per CNAME verbinden

Sie möchten statt office.dyn.zelyra.eu lieber Ihre eigene Adresse wie vpn.ihrefirma.de verwenden?

  1. Tragen Sie beim Anlegen oder Bearbeiten Ihres Hosts im Feld „Eigene Domain per CNAME (Optional)“ z. B. vpn.ihrefirma.de ein und speichern Sie.
  2. Legen Sie bei Ihrem Domain-Anbieter (Strato, Hostinger, IONOS, Cloudflare, Netcup, ALL-INKL usw.) folgenden DNS-Eintrag an:
Feld Wert
Typ CNAME
Host / Name vpn (ergibt vpn.ihrefirma.de)
Ziel / Value office.dyn.zelyra.eu
  1. Öffnen Sie im Portal die Detailseite Ihres Hosts und klicken Sie auf „DNS-Eintrag jetzt prüfen“.
  2. Sobald der CNAME propagiert ist, erscheint das grüne Badge ✓ DNS verifiziert. Jedes IP-Update Ihres Routers gilt damit automatisch auch für vpn.ihrefirma.de.

Hinweis: Ein CNAME-Eintrag ist gemäß DNS-Standard (RFC 1034) für Subdomains (vpn.ihrefirma.de, nas.ihrefirma.de) vorgesehen, nicht für die nackte Hauptdomain (ihrefirma.de).


4. Business-Firewalls, Router & Clients (Konfiguration)

Unser Update-Endpunkt ist vollständig kompatibel zum DynDNS2-Standard (/nic/update, HTTP Basic Auth oder Query-Token):

  • Update-URL: https://siedelmann.com/nic/update (alternativ /dyndns/update oder JSON-API /api/v1/dyndns/update)
  • Eigene IP ermitteln: https://siedelmann.com/nic/checkip
  • Server-Host (für DynDNS2-Clients): siedelmann.com

4.1 AVM Fritz!Box

Pfad: Internet → Freigaben → DynDNS → Benutzerdefiniert

  • Update-URL: https://siedelmann.com/nic/update?hostname=<domain>&myip=<ipaddr>&myipv6=<ip6addr>
  • Domainname: office.dyn.zelyra.eu (oder Ihre eigene CNAME-Domain)
  • Benutzername: office.dyn.zelyra.eu (oder Ihr individueller Benutzername)
  • Kennwort: Ihr geheimer Update-Token (dyn_...)

4.2 OPNsense (os-ddclient)

Pfad: Dienste → Dynamisches DNS → Einstellungen → + Hinzufügen (Plugin os-ddclient installiert)

  • Aktiviert: Ja
  • Dienst: Benutzerdefiniert (Custom)
  • Protokoll: DynDns2
  • Server: siedelmann.com
  • Benutzername: office.dyn.zelyra.eu
  • Passwort: Ihr geheimer Update-Token (dyn_...)
  • Hostname(n): office.dyn.zelyra.eu
  • Schnittstelle zur Überwachung: WAN
  • IP-Prüfmethode: Interface (oder https://siedelmann.com/nic/checkip bei Doppel-NAT)

4.3 pfSense

Pfad: Services → Dynamic DNS → Dynamic DNS Clients → + Add

  • Service Type: Custom (oder Custom (v6) für IPv6)
  • Interface to monitor: WAN
  • Username: office.dyn.zelyra.eu
  • Password: Ihr geheimer Update-Token (dyn_...)
  • Update URL: https://siedelmann.com/nic/update?hostname=office.dyn.zelyra.eu&myip=%IP%
  • Result Match: good %IP%|nochg %IP%

4.4 Ubiquiti UniFi (UDM / UDM Pro / UCG / UXG)

Pfad: Einstellungen → Internet → [WAN] → Dynamic DNS → Neu erstellen

  • Dienst: custom (Benutzerdefiniert)
  • Hostname: office.dyn.zelyra.eu
  • Benutzername: office.dyn.zelyra.eu
  • Passwort: Ihr geheimer Update-Token (dyn_...)
  • Server: siedelmann.com/nic/update?hostname=%h&myip=%i (ohne https:// vorangestellt – UniFi ergänzt https:// automatisch)

4.5 Sophos Firewall (SFOS / XG / XGS)

Pfad: Netzwerk → Dynamisches DNS → Hinzufügen

  • Schnittstelle: WAN (z. B. Port2)
  • Dienstanbieter: Benutzerdefiniert (oder DynDNS2-kompatibles Profil)
  • Hostname / Domäne: office.dyn.zelyra.eu
  • Benutzername: office.dyn.zelyra.eu
  • Kennwort: Ihr geheimer Update-Token (dyn_...)
  • Update-URL (bei benutzerdefiniertem Profil): https://siedelmann.com/nic/update?hostname=office.dyn.zelyra.eu&myip=<IP>

4.6 Fortinet FortiGate (FortiOS)

Über CLI (oder Web-GUI unter Network → DNS → FortiGuard DDNS / Custom):

config system ddns
    edit 1
        set monitor-interface "wan1"
        set ddns-server genericDDNS
        set ddns-server-addr "siedelmann.com"
        set ddns-domain "office.dyn.zelyra.eu"
        set ddns-username "office.dyn.zelyra.eu"
        set ddns-password "IHR_TOKEN"
        set use-public-ip enable
    next
end

4.7 LANCOM Systems (LCOS / LANconfig)

Pfad in LANconfig: IPv4 → Aktions-Tabelle (bzw. IP-Router → Aktions-Tabelle)

  • Name: DYNDNS_ZELYRA
  • Aktiv: Ja
  • Bedingung: Verbindungsaufbau (WAN-Gegenstelle)
  • Aktion: https://siedelmann.com/nic/update?token=IHR_TOKEN&hostname=office.dyn.zelyra.eu&myip=%a

(Der Platzhalter %a wird von LCOS automatisch durch die aktuelle öffentliche WAN-IPv4 ersetzt.)

4.8 MikroTik RouterOS

Pfad: System → Scripts (und alle 5 Minuten über System → Scheduler aufrufen)

:global ddnsuser "office.dyn.zelyra.eu"
:global ddnspass "IHR_TOKEN"
:global ddnshost "office.dyn.zelyra.eu"
/tool fetch mode=https url=("https://siedelmann.com/nic/update?hostname=" . $ddnshost) user=$ddnsuser password=$ddnspass keep-result=no

4.9 Synology DSM (NAS)

Pfad: Systemsteuerung → Externer Zugriff → DDNS → Anpassen

  • Serviceanbieter: Siedelmann DynDNS
  • Query URL: https://siedelmann.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__&token=__PASSWORD__
  • Anschließend unter DDNS → Hinzufügen den neuen Anbieter wählen, als Hostname office.dyn.zelyra.eu und als Passwort Ihren geheimen Update-Token (dyn_...) eintragen.

4.10 Linux-Server (cURL & ddclient)

# IPv4 automatisch über Client-IP aktualisieren
curl -4 "https://siedelmann.com/nic/update?token=IHR_TOKEN"

# IPv6 automatisch aktualisieren
curl -6 "https://siedelmann.com/nic/update?token=IHR_TOKEN"

/etc/ddclient.conf:

protocol=dyndns2
use=web, web=https://siedelmann.com/nic/checkip
server=siedelmann.com
ssl=yes
login=office.dyn.zelyra.eu
password=IHR_TOKEN
office.dyn.zelyra.eu

Antwortcodes (/nic/update)

Antwort Bedeutung
good <IP> Erfolgreich aktualisiert, PowerDNS wurde synchronisiert.
nochg <IP> IP-Adresse ist unverändert (kein DNS-Write notwendig).
badauth Token oder Benutzername/Passwort ungültig.
nohost Übergebener Hostname passt nicht zum Token.
abuse Domain ist im Portal pausiert/deaktiviert.

5. Webhook & externe Automatisierung (Optional)

Für die normale DynDNS-Nutzung ist der Webhook nicht erforderlich. Wenn Sie jedoch auf IP-Wechsel automatisiert reagieren möchten (z. B. Server-Firewall/Allowlist aktualisieren, Home Assistant, n8n, Slack oder Teams benachrichtigen), können Sie eine Webhook URL (POST) und optional ein Webhook Secret hinterlegen.

  • Bei jeder IP-Änderung sendet der Server ein JSON-Payload per HTTP POST.
  • Ist ein Webhook Secret gesetzt, enthält der Request den Header X-DynDNS-Signature mit der HMAC-SHA256-Signatur des JSON-Bodys zur Echtheitsprüfung.

6. Sicherheit, Protokolle & Datenschutz

  • Token-Rotation: Im Portal lässt sich jederzeit mit einem Klick ein neuer Update-Token generieren – der alte Token wird sofort ungültig.
  • Protokoll-Historie: Alle Update-Versuche (inkl. Status, IPv4/IPv6, User-Agent) sind im Detailprotokoll einsehbar und werden automatisch nach 30 Tagen bereinigt.
  • DSGVO & AVV: Betrieb auf deutschen Servern; der Auftragsverarbeitungsvertrag (Art. 28 DSGVO) steht direkt im Portal als PDF bereit.
PRODUKTÜBERSICHT & PREISEDynamicDNS (ab 29 € netto/Jahr) →