DynDNS Control Center

❓ FAQ – DynDNS auf eigenen Geräten einrichten

Jedes Gerät, das eine eigene Update-URL aufrufen kann, kann diesen Dienst nutzen. Lege zuerst links einen Host an („Neuen Host anlegen"). Du erhältst ein Präfix (= Benutzername) und ein Passwort. Dein Hostname lautet dann PRÄFIX.dyn.itmedia.nrw.

Update-URL (für alle Geräte gleich) https://dyn.itmedia.nrw/?action=update&user=PRÄFIX&pass=PASSWORT&ip=IPV4-ADRESSE

Antworten des Servers

good – IP wurde aktualisiert
nochg – IP war bereits aktuell, nichts zu tun
badauth – Präfix oder Passwort falsch
badparam – Parameter fehlt (user, pass oder ip leer)
dnserr – DNS-Eintrag konnte nicht gesetzt werden

🛠️ FRITZ!Box

Heimnetz-Oberfläche öffnen, Ansicht auf Erweitert stellen.
Internet → Freigaben → Dynamic DNS öffnen und „Dynamic DNS benutzen" aktivieren.
Anbieter: Benutzerdefiniert.
Update-URL: https://dyn.itmedia.nrw/?action=update&user=<username>&pass=<pass>&ip=<ipaddr> (die Platzhalter in spitzen Klammern genau so lassen, die Box ersetzt sie).
Domainname: PRÄFIX.dyn.itmedia.nrw
Benutzername: PRÄFIX, Kennwort: das generierte Passwort.
Mit Übernehmen speichern. Der Status „Dynamic DNS erfolgreich aktualisiert" erscheint nach kurzer Zeit.

Hinweis: Dieser Dienst aktualisiert nur die IPv4-Adresse (<ipaddr>). Bei DS-Lite-Anschlüssen (kein eigenes IPv4) funktioniert das nicht.

💾 Synology DiskStation (DSM)

Systemsteuerung → Externer Zugriff → DDNS → Hinzufügen.
Beim Dienstanbieter Anpassen wählen, einen Namen vergeben (z. B. „ITMedia") und als Abfrage-URL eintragen:
https://dyn.itmedia.nrw/?action=update&user=__USERNAME__&pass=__PASSWORD__&ip=__MYIP__
Zurück im Dialog: Hostname PRÄFIX.dyn.itmedia.nrw, Benutzername PRÄFIX, Passwort = generiertes Passwort. Mit „Test-Verbindung" prüfen.

🔥 pfSense

Services → Dynamic DNS → Add.
Service Type: Custom, Interface to monitor: das WAN-Interface.
Update URL: https://dyn.itmedia.nrw/?action=update&user=PRÄFIX&pass=PASSWORT&ip=%IP%
Result Match: good|nochg. Speichern.

📡 OpenWrt (ddns-scripts)

Pakete ddns-scripts, ddns-scripts-services und luci-app-ddns installieren.
Services → Dynamic DNS: neuen Eintrag anlegen, DDNS-Dienstanbieter: -- custom --.
Eigene Update-URL: https://dyn.itmedia.nrw/?action=update&user=[USERNAME]&pass=[PASSWORD]&ip=[IP]
Domain PRÄFIX.dyn.itmedia.nrw, Benutzername PRÄFIX, Passwort eintragen, Netzwerk/Quelle für die IP wählen (meist WAN) und aktivieren.

📶 MikroTik (RouterOS)

Script anlegen (System → Scripts) und per Scheduler alle 5 Minuten starten. „ether1" durch das WAN-Interface ersetzen:

:local a [/ip address get [find interface="ether1"] address]
:local ip [:pick $a 0 [:find $a "/"]]
/tool fetch keep-result=no url=("https://dyn.itmedia.nrw/?action=update&user=PRÄFIX&pass=PASSWORT&ip=" . $ip)

🐧 Linux / Raspberry Pi / Server (curl + Cron)

Funktioniert überall, wo ein Gerät Befehle ausführen kann (z. B. QNAP, Raspberry Pi, VM). Crontab-Eintrag (crontab -e), alle 5 Minuten:

*/5 * * * * curl -fsS "https://dyn.itmedia.nrw/?action=update&user=PRÄFIX&pass=PASSWORT&ip=$(curl -fsS4 https://api.ipify.org)" >/dev/null

🪟 Windows (PowerShell + Aufgabenplanung)

Script dyndns.ps1 anlegen und in der Aufgabenplanung alle 5 Minuten ausführen:

$ip = (Invoke-RestMethod https://api.ipify.org)
Invoke-RestMethod "https://dyn.itmedia.nrw/?action=update&user=PRÄFIX&pass=PASSWORT&ip=$ip"

🏠 Home Assistant

In der configuration.yaml einen REST-Befehl anlegen und per Automatisierung (Zeitintervall) mit der externen IP aufrufen:

rest_command:
  dyndns_update:
    url: "https://dyn.itmedia.nrw/?action=update&user=PRÄFIX&pass=PASSWORT&ip={{ ip }}"

❔ Mein Gerät kann keine eigene Update-URL

Manche Router (z. B. Speedport, viele Provider-Geräte) bieten nur feste DynDNS-Anbieter an. Dann bleibt der Umweg über ein Gerät im Netz, das die URL aufruft: Raspberry Pi, NAS oder PC mit dem curl-/PowerShell-Beispiel oben (alle 5 Minuten).

🛡️ ITM Gateway (VPN + DynDNS + WebUI) einrichten – per Skript, per Image, mit Einrichtungscode

Das ITM Gateway richtet auf einem Debian-/Ubuntu-System (oder einem Raspberry Pi) einen WireGuard-VPN-Zugang, den DynDNS-Client für diesen Dienst und eine WebUI (HTTPS, Port 8443) mit Logbuch ein. In der WebUI legst du VPN-Clients an (QR-Code fürs Handy, Konfigurationsdatei für den PC).

1 · Einrichtungscode erzeugen (für beide Wege)

Links einen Host anlegen („Neuen Host anlegen“).
Solange für den Host noch keine IP gemeldet wurde, erscheint in der Zeile der Button 🔑 Einrichtungscode. Er zeigt einen Code aus 4 × 4 Zeichen (z. B. ABCD-EFGH-JKLM-NPQR).
Der Code ist 24 Stunden gültig und nur einmal verwendbar. Er enthält keine Zugangsdaten, sondern holt sie beim Einrichten vom Server. Ist er abgelaufen oder verbraucht, einfach einen neuen erzeugen.
Im Popup erscheinen zwei QR-Codes für das Pi-Image: ① verbindet das Handy mit dem Setup-WLAN des Pi, ② öffnet die Einrichtungsseite mit schon eingetragenem Code (dann nur noch das Heim-WLAN wählen). Das Handy muss dafür zuerst mit ① im Setup-WLAN sein.
Das Passwort der WebUI (Benutzer admin) ist bei der Einrichtung per Code das Passwort des Hosts (unter „Zugangsdaten“). Es lässt sich in der WebUI unter Konto ändern.

2 · Weg A: Installation per Skript (Debian 12/13, Ubuntu, Raspberry Pi OS)

Auf dem Gerät als Benutzer mit sudo anmelden und ausführen: curl -fsSLO https://dyn.itmedia.nrw/download/itm-gateway-install.sh && sudo bash itm-gateway-install.sh
Auf die Frage nach der Einrichtungsart „Einrichtungscode“ wählen und den Code eintragen. („Manuell“ fragt stattdessen nach Host, Passwort und Namen.)
Die Frage nach dem Relay (Verbindung über den ITM-Hub) mit Ja beantworten, wenn der Anschluss kein eigenes öffentliches IPv4 hat (DS-Lite, CGNAT, z. B. Deutsche Glasfaser). Dann ist keine Portweiterleitung im Router nötig.
Danach ist die WebUI erreichbar unter https://<IP des Geräts>:8443. Die Zertifikatswarnung ist normal (selbstsigniertes Zertifikat).

Ohne Rückfragen (z. B. für Skripte): sudo ITMGW_MODE=code ITMGW_CODE=ABCD-EFGH-JKLM-NPQR bash itm-gateway-install.sh. Entfernen: sudo bash itm-gateway-install.sh --uninstall.

Ohne Relay: Im Router den UDP-Port des VPN (Standard 51820) auf das Gerät weiterleiten.

3 · Weg B: fertiges Image für den Raspberry Pi (Zero 2 W, Pi 2/3/4)

Im Raspberry Pi Imager in den Einstellungen den Dialog Image Repository öffnen, „Eigene URL verwenden“ wählen und eintragen (danach „Anwenden & neu starten“): https://dyn.itmedia.nrw/download/repo.json
Als Betriebssystem „ITM Gateway“ und die SD-Karte wählen, schreiben (keine Anpassungen im Imager nötig).
Pi mit der Karte starten. Der erste Start dauert 2–3 Minuten (zwei Neustarts sind normal). Auf einem angeschlossenen Monitor zeigt die Konsole den Status.
Mit WLAN (Zero 2 W, Pi 3/4): Der Pi öffnet das WLAN ITM-Gateway-Setup (ohne Passwort, nur während der Einrichtung offen). Mit dem Handy verbinden, die Einrichtungsseite öffnet sich selbst (sonst http://10.42.0.1/). Dort das Heim-WLAN auswählen, dessen Passwort und den Einrichtungscode eintragen.
Ohne WLAN (Pi 2) oder per LAN-Kabel: Kabel einstecken und im selben Netz http://itm-gateway.local/ öffnen (oder die IP des Pi aus dem Router). Dort nur den Einrichtungscode eintragen.
Die Installation läuft danach selbständig (je nach Modell 5–30 Minuten, ein Pi 2 ist am langsamsten). Das Gerät meldet sich anschließend bei diesem Dienst und im Hub. Fehler zeigt das Setup-WLAN bzw. die Einrichtungsseite wieder an.
Danach WebUI: https://itm-gateway.local:8443 oder https://<IP>:8443 (Benutzer admin). Per SSH: Benutzer itm, Passwort gateway – bitte nach dem ersten Login mit passwd ändern.

4 · Nach der Einrichtung

In der WebUI VPN-Clients anlegen (Name eingeben, QR-Code in der WireGuard-App scannen oder .conf laden). Der VPN-Zugang erreicht auf Wunsch auch das Heimnetz hinter dem Gateway.
Updates: WebUI → Konto → „Version & Update“. Updates sind signiert; auf Wunsch lassen sie sich automatisch installieren. Sicherheitsupdates des Betriebssystems spielt das Gateway selbst ein.
Menü nach dem Login: Per SSH oder Konsole (Benutzer itm) erscheint ein Menü mit Statusanzeige: neuer Einrichtungscode, Selbsttest, Sicherung/Wiederherstellung, SD-schonender Modus, Updates, erweiterte Shell. Sicherung und Selbsttest gibt es auch in der WebUI unter Konfiguration.
Typische Fehler: „Code ungültig/verbraucht“ → neuen Code erzeugen. Nichts erreichbar → Installation läuft noch (Pi 2 braucht länger) oder Gerät hat keine Internetverbindung. Adressen wie 100.64.x.x (CGNAT) oder private IPs lehnt dieser Dienst als „öffentliche IP“ bewusst ab; dafür das Relay verwenden.

Tipps

Sonderzeichen im Passwort in der URL kodieren (z. B. & → %26, # → %23).
Zum Testen die URL im Browser aufrufen: bei good oder nochg ist alles in Ordnung.
Passwörter erscheinen in der URL: den Dienst nur über HTTPS nutzen (ist hier der Fall) und Geräte-Logs nicht öffentlich teilen.

❓ FAQ – DynDNS auf eigenen Geräten einrichten

Zugangsdaten

2FA Aktivierung

🔑 Einrichtungscode

📋 System-Logbuch (dyndns.log)