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.euangelegt (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
- Melden Sie sich im Portal an und öffnen Sie in der Seitenleiste DynDNS → + Neuer Host (
/app/tools/dyndns/neu). - Vergeben Sie eine Subdomain / Hostname (nur Buchstaben
a-z, Ziffern0-9und Bindestriche, z. B.buero-nord). Daraus entsteht automatischbuero-nord.dyn.zelyra.eu. - Wählen Sie den DNS-Eintragstyp (Dual-Stack empfohlen, Nur IPv4 oder Nur IPv6).
- Optional können Sie direkt eine eigene Domain per CNAME (z. B.
vpn.ihrefirma.de), eine Beschreibung oder eine Start-IP angeben. - 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.euist weltweit eindeutig („Wer zuerst kommt, mahlt zuerst“). Systemseitig reservierte Namen (www,ns,ns1,ns2,mail,admin,api,app,status,zelyra,siedelmannusw.) 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?
- Tragen Sie beim Anlegen oder Bearbeiten Ihres Hosts im Feld „Eigene Domain per CNAME (Optional)“ z. B.
vpn.ihrefirma.deein und speichern Sie. - 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 |
- Öffnen Sie im Portal die Detailseite Ihres Hosts und klicken Sie auf „DNS-Eintrag jetzt prüfen“.
- 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/updateoder 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(oderhttps://siedelmann.com/nic/checkipbei Doppel-NAT)
4.3 pfSense
Pfad: Services → Dynamic DNS → Dynamic DNS Clients → + Add
- Service Type:
Custom(oderCustom (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(ohnehttps://vorangestellt – UniFi ergänzthttps://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.euund 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-Signaturemit 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.
