ZELYRA HANDBUCH

Vollständige Sprachdokumentation & Technische Referenz
Zelyra 1.3.1 (Commit e20d099)
Offizielle Dokumentation · Stefan Siedelmann
https://siedelmann.com · November 2026

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.


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


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):

4.1 AVM Fritz!Box

Pfad: Internet → Freigaben → DynDNS → Benutzerdefiniert

4.2 OPNsense (os-ddclient)

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

4.3 pfSense

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

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

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

4.5 Sophos Firewall (SFOS / XG / XGS)

Pfad: Netzwerk → Dynamisches DNS → Hinzufügen

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)

(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

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.


6. Sicherheit, Protokolle & Datenschutz