Dynamic DNS

Mit Dynamic DNS (kurz DynDNS) zeigt eine Subdomain immer auf die aktuelle IP-Adresse deines Internetanschlusses, auch wenn sich diese regelmäßig ändert. Das ist praktisch, wenn du zu Hause einen Server, ein NAS, eine Kamera oder einen VPN-Zugang betreibst und diesen unter einem festen Namen erreichen möchtest, z.B. home.beispiel.de.

Für Domains, welche unsere Nameserver nutzen, bieten wir den Dynamic-DNS-Service kostenlos an. Er unterstützt IPv4 (A-Eintrag) und IPv6 (AAAA-Eintrag). Beide Adressen werden unabhängig voneinander aktualisiert. Du kannst sie also in einer gemeinsamen oder in zwei getrennten Anfragen übermitteln, z.B. von zwei verschiedenen Geräten.

Voraussetzungen

  • Die Domain nutzt unsere Nameserver (ns1.chaos.domains und ns2.chaos.domains). Bei Domains mit externen Nameservern ist DynDNS nicht verfügbar. Im Domain-Portal wird dort der Hinweis "DynDNS nicht verfügbar bei externen Nameservern" angezeigt. Stelle die Domain in diesem Fall zuerst auf unsere Nameserver um.
  • Du bist Inhaber der Domain, der übergeordnete Reseller des Inhabers oder Administrator.
  • Dein Router (oder ein anderes Gerät in deinem Netzwerk) kann eine URL aufrufen, um die IP-Adresse zu aktualisieren. Das ist bei fast allen gängigen Routern wie z.B. der FRITZ!Box oder OpenWrt möglich.

Aktivierung

  1. Melde dich im Domain-Portal an und öffne die Domain, für die du DynDNS nutzen möchtest.
  2. Im Bereich Services siehst du den aktuellen Status von DynDNS. Klicke dort auf das Zahnrad-Symbol.
  3. Gib unter DynDNS Record hinzufügen den gewünschten Namen der Subdomain ein, z.B. home für home.beispiel.de, und klicke auf Record hinzufügen.
  4. Der Record wird nun im Hintergrund angelegt. Das kann einige Minuten dauern. Öffne die DynDNS-Seite der Domain danach erneut.
  5. Unter Aktive Records findest du jetzt den vollständigen Hostnamen, die aktuell eingetragene IPv4- und IPv6-Adresse und das dazugehörige Token/Passwort. Hostname und Token benötigst du für die Konfiguration deines Routers.

Du kannst beliebig viele Subdomains einrichten, jede Subdomain bekommt ihr eigenes Token.

Regeln für den Namen der Subdomain

  • Erlaubt sind Buchstaben, Ziffern und der Bindestrich (a-z, A-Z, 0-9, -).
  • Es ist immer genau eine Ebene unterhalb deiner Domain möglich (home.beispiel.de, aber nicht nas.home.beispiel.de).
  • Die Domain selbst (beispiel.de) kann nicht per DynDNS aktualisiert werden.

Status in der Domain-Übersicht

Im Bereich Services der Domain zeigt das Feld DynDNS den aktuellen Zustand:

Anzeige Bedeutung
DynDNS nicht aktiv Es ist noch keine Subdomain für DynDNS eingerichtet.
DynDNS aktiv für n Host(s) Es sind n Subdomains für DynDNS eingerichtet.
DynDNS nicht verfügbar bei externen Nameservern Die Domain nutzt nicht unsere Nameserver.

Liegt noch ein unbearbeiteter Auftrag vor (z.B. weil du gerade erst einen Record angelegt hast), erscheint auf der DynDNS-Seite der Hinweis "Für diese Option liegt bereits ein Änderungsauftrag vor!".

Auf der DynDNS-Seite der Domain siehst du bei jedem Record die zuletzt übermittelte IPv4- und IPv6-Adresse. Ein - bedeutet, dass für diese Adressart kein Eintrag existiert. Der Zusatz "(wird eingetragen)" zeigt, dass die Änderung noch verarbeitet wird.

Das Token

Das Token ist eine zufällig erzeugte, 64 Zeichen lange Zeichenkette aus Buchstaben und Ziffern. Es dient als Passwort für die Aktualisierung genau dieser einen Subdomain.

  • Behandle das Token wie ein Passwort und gib es nicht weiter. Wer das Token kennt, kann die IP-Adressen deiner Subdomain ändern.
  • Jede Subdomain hat ein eigenes Token. Das Token gibt keinen Zugriff auf dein Kundenkonto oder auf andere DNS-Einträge.
  • Du kannst ein neues Token erzeugen, indem du für dieselbe Subdomain erneut Record hinzufügen wählst. Das alte Token wird dabei sofort ungültig, denke also daran, es auch im Router auszutauschen.

Die Update-URL

Zur Aktualisierung ruft dein Router oder ein Skript die folgende URL auf:

https://chaos.domains/dyndns?hostname=<hostname>&ip4=<ipv4>&ip6=<ipv6>&token=<token>
Parameter Beschreibung
hostname Der vollständige Hostname, wie er unter "Aktive Records" angezeigt wird, z.B. home.beispiel.de. Groß- und Kleinschreibung sind egal.
ip4 Die neue IPv4-Adresse, z.B. 203.0.113.25. Optional.
ip6 Die neue IPv6-Adresse, z.B. 2001:db8::25. Optional. Es werden nur einzelne Adressen akzeptiert, keine Präfixe wie 2001:db8::/64.
token Das Token des Records. Alternativ kann der Parameter auch password heißen, oder du übergibst das Token als Passwort einer HTTP-Basic-Authentifizierung (siehe unten).

IPv4 und IPv6 unabhängig aktualisieren

  • Es muss mindestens eine Adresse übergeben werden, ip4 oder ip6 (oder beide).
  • Eine nicht übergebene oder leere Adresse bleibt unverändert. Eine Anfrage mit nur ip4 ändert ausschließlich den A-Eintrag und lässt den AAAA-Eintrag in Ruhe, und umgekehrt. Deshalb funktioniert es auch, wenn IPv4 und IPv6 in getrennten Anfragen oder von getrennten Geräten übermittelt werden.
  • Möchtest du den Eintrag einer Adressart bewusst löschen, übergib clear, z.B. ip6=clear. Der AAAA-Eintrag der Subdomain wird dann entfernt. Das ist z.B. sinnvoll, wenn du IPv6 nicht mehr nutzt.
  • Die Platzhalteradressen 0.0.0.0 und :: werden wie "keine Adresse" behandelt und ignoriert, einige Geräte senden sie, wenn die Adressart gerade nicht verfügbar ist.
  • Nicht zulässig sind Adressen, die im Internet nie erreichbar wären: Loopback (127.0.0.1, ::1), Multicast, reservierte Bereiche und IPv6-Link-Local-Adressen (fe80::/10). Private Adressen wie 192.168.1.10 werden akzeptiert, z.B. für die Namensauflösung im eigenen Netz.
  • Übermittelst du dieselbe Adresse noch einmal, erkennen wir das und ändern nichts, solange der Eintrag in den letzten 12 Stunden abgeglichen wurde. Danach prüfen wir ihn bei der nächsten Übermittlung erneut und stellen ihn bei Bedarf wieder her (siehe Hinweise).

Weitere Schreibweisen

Damit sich möglichst viele Router und Clients ohne Umbau nutzen lassen, akzeptieren wir zusätzlich:

Schreibweise Beispiel
Alternative Namen für IPv4 ipv4, myipv4, myip4
Alternative Namen für IPv6 ipv6, myipv6, myip6
Ein gemeinsamer Parameter myip oder ip. Ob IPv4 oder IPv6 gemeint ist, erkennen wir an der Adresse selbst. myip=203.0.113.25 oder myip=2001:db8::25
Mehrere Adressen im selben Parameter, durch Komma getrennt myip=203.0.113.25,2001:db8::25
Token als password oder pass statt token password=<token>

clear ist nur bei ip4 und ip6 (und deren Alternativen) erlaubt, nicht bei myip/ip.

Übergibst du für dieselbe Adressart zwei verschiedene Adressen (z.B. ip4=… und myip=…), wird die Anfrage abgelehnt.

Anmeldung per HTTP-Basic-Authentifizierung

Statt im Parameter token kannst du das Token auch als Passwort einer HTTP-Basic-Authentifizierung übergeben, also z.B. https://dyndns:<token>@chaos.domains/dyndns?hostname=…&ip4=…. Der Benutzername wird nicht ausgewertet, du kannst einen beliebigen Wert verwenden. Das nutzen viele DynDNS-Clients, bei denen man Benutzername und Passwort einträgt.

Ist neben der Basic-Authentifizierung auch der Parameter token (oder password) gesetzt, hat der Parameter Vorrang.

Weitere Hinweise zur Anfrage

  • Die Verbindung muss per HTTPS erfolgen.
  • Die Anfrage kann per GET oder per POST gesendet werden.
  • Ein Benutzername wird nicht benötigt. Falls dein Router zwingend einen verlangt, kannst du einen beliebigen Wert eintragen.
  • Rufe die URL bitte nur auf, wenn sich deine IP-Adresse tatsächlich geändert hat. Router machen das von sich aus richtig.
  • Nicht unterstützt werden Parameter wie <ip6lanprefix> der FRITZ!Box, mit denen ein IPv6-Präfix oder eine Interface-ID übermittelt wird. Sie werden ignoriert.

Antworten des Servers

Die Update-URL /dyndns antwortet bewusst knapp:

HTTP-Status Antwort Bedeutung
200 Okay Die Aktualisierung wurde angenommen (oder es hat sich nichts geändert).
403 Error! Die Anfrage wurde abgelehnt, siehe Fehlersuche.

Ein 200 Okay bedeutet, dass die Aktualisierung entgegengenommen wurde. Sie wird anschließend im Hintergrund verarbeitet und ist nicht sofort im DNS sichtbar (siehe Wann ist die neue IP-Adresse aktiv?).

DynDNS2-kompatible Variante

Für Clients, die das verbreitete "DynDNS2"-Protokoll sprechen (z.B. ddclient, inadyn oder die Standard-Anbieter von Routern), gibt es zusätzlich die URL

https://chaos.domains/nic/update?hostname=<hostname>&myip=<ip>

Sie akzeptiert dieselben Parameter und dieselbe Anmeldung wie /dyndns (insbesondere das Token als Passwort der HTTP-Basic-Authentifizierung mit beliebigem Benutzernamen), antwortet aber mit den DynDNS2-Antwortcodes:

HTTP-Status Antwort Bedeutung
200 good <ip> Die Aktualisierung wurde angenommen.
200 nochg <ip> Die Adresse war bereits eingetragen und in den letzten 12 Stunden abgeglichen, es wurde nichts geändert.
401 badauth Das Token fehlt oder ist ungültig.
404 nohost Der Hostname gehört nicht zu diesem Token.
400 notfqdn Der Hostname ist ungültig.
400 badip Es wurde keine gültige IP-Adresse übergeben.

Hinter good und nochg stehen die übermittelten Adressen, bei zwei Adressen durch Komma getrennt.

Test mit curl

Du kannst die Aktualisierung auch manuell auslösen, z.B. auf einem Linux-Server:

# IPv4 und IPv6 zusammen
curl "https://chaos.domains/dyndns?hostname=home.beispiel.de&ip4=203.0.113.25&ip6=2001:db8::25&token=DEIN_TOKEN"

# nur IPv6 aktualisieren, der A-Eintrag bleibt unverändert
curl "https://chaos.domains/dyndns?hostname=home.beispiel.de&ip6=2001:db8::25&token=DEIN_TOKEN"

# IPv6-Eintrag löschen
curl "https://chaos.domains/dyndns?hostname=home.beispiel.de&ip6=clear&token=DEIN_TOKEN"

Als Antwort erscheint jeweils Okay.

Router-Konfiguration

FRITZ!Box

  1. Öffne die Oberfläche der FRITZ!Box und gehe zu Internet > Freigaben > DynDNS. Je nach FRITZ!OS-Version kann die Menüführung leicht abweichen.
  2. Aktiviere DynDNS benutzen.
  3. Wähle als DynDNS-Anbieter den Eintrag Benutzerdefiniert.
  4. Trage die folgenden Werte ein:

    Feld Wert
    Update-URL https://chaos.domains/dyndns?hostname=<domain>&ip4=<ipaddr>&ip6=<ip6addr>&token=<pass>
    Domainname Dein vollständiger Hostname, z.B. home.beispiel.de
    Benutzername Beliebiger Wert, z.B. dyndns (wird nicht ausgewertet)
    Kennwort Das Token aus dem Domain-Portal
  5. Übernimm die Einstellungen. Die FRITZ!Box ruft die URL ab sofort bei jeder Änderung der IP-Adresse auf und ersetzt die Platzhalter <domain>, <ipaddr>, <ip6addr> und <pass> dabei selbst.

Das Token wird in der Update-URL über den Platzhalter <pass> eingesetzt. Du musst es also nur im Feld Kennwort eintragen und nicht in die URL schreiben.

Wichtig für die Praxis:

  • Nur IPv6, z.B. DS-Lite: Bei einem Anschluss ohne eigene öffentliche IPv4-Adresse (DS-Lite) ist <ipaddr> nur die gemeinsam genutzte Adresse deines Providers und nicht von dir erreichbar. Verwende in diesem Fall eine URL ohne ip4:

    https://chaos.domains/dyndns?hostname=<domain>&ip6=<ip6addr>&token=<pass>

  • Fehlende Adressen: Hat die FRITZ!Box gerade keine IPv4- oder IPv6-Adresse und lässt den Platzhalter leer, bleibt der bisherige Eintrag dieser Adressart unverändert und wird nicht gelöscht.

  • Zwei getrennte URLs: Im Feld Update-URL lassen sich mehrere URLs durch ein Leerzeichen getrennt eintragen. Du kannst IPv4 und IPv6 also auch getrennt übermitteln, z.B. …&ip4=<ipaddr>&token=<pass> …&ip6=<ip6addr>&token=<pass>. Beides funktioniert auch dann, wenn die Anfragen fast gleichzeitig eintreffen.
  • Adresse der FRITZ!Box: <ip6addr> ist die IPv6-Adresse der FRITZ!Box selbst und nicht die eines Geräts in deinem Heimnetz. Möchtest du ein Gerät im Heimnetz (z.B. einen Server oder ein NAS) per IPv6 erreichen, aktualisiere dessen Adresse besser direkt von diesem Gerät aus, z.B. mit curl oder ddclient, und übergib dort die IPv6-Adresse des Geräts.

OpenWrt

OpenWrt aktualisiert IPv4 und IPv6 über getrennte DDNS-Einträge, die zusammen denselben Hostnamen und dasselbe Token verwenden. Dank der unabhängigen Aktualisierung stören sich die beiden Einträge nicht.

Voraussetzung ist das Paket ddns-scripts (in LuCI: luci-app-ddns). Damit HTTPS funktioniert, benötigt OpenWrt außerdem einen HTTPS-fähigen Downloader, z.B. wget-ssl oder curl, und die CA-Zertifikate (ca-certificates).

Lege in LuCI unter Dienste > Dynamic DNS zwei Einträge an, einen für IPv4 und einen für IPv6 (die Bezeichnungen können je nach LuCI-Version und Sprache leicht abweichen):

Einstellung IPv4-Eintrag IPv6-Eintrag
DDNS-Dienstanbieter -- custom -- -- custom --
IP-Adressversion IPv4-Adresse IPv6-Adresse
Benutzerdefinierte Update-URL https://chaos.domains/dyndns?hostname=[DOMAIN]&ip4=[IP]&token=[PASSWORD] https://chaos.domains/dyndns?hostname=[DOMAIN]&ip6=[IP]&token=[PASSWORD]
Domain home.beispiel.de home.beispiel.de
Benutzername beliebig, z.B. dyndns beliebig, z.B. dyndns
Passwort Das Token Das Token
Quelle der IP-Adresse Netzwerk, wan Netzwerk, wan6

In der Konfigurationsdatei /etc/config/ddns sieht das so aus:

config service 'chaos_ipv4'
    option enabled '1'
    option use_ipv6 '0'
    option update_url 'https://chaos.domains/dyndns?hostname=[DOMAIN]&ip4=[IP]&token=[PASSWORD]'
    option domain 'home.beispiel.de'
    option lookup_host 'home.beispiel.de'
    option username 'dyndns'
    option password 'DEIN_TOKEN'
    option ip_source 'network'
    option ip_network 'wan'
    option interface 'wan'
    option use_https '1'

config service 'chaos_ipv6'
    option enabled '1'
    option use_ipv6 '1'
    option update_url 'https://chaos.domains/dyndns?hostname=[DOMAIN]&ip6=[IP]&token=[PASSWORD]'
    option domain 'home.beispiel.de'
    option lookup_host 'home.beispiel.de'
    option username 'dyndns'
    option password 'DEIN_TOKEN'
    option ip_source 'network'
    option ip_network 'wan6'
    option interface 'wan6'
    option use_https '1'

Die Platzhalter [DOMAIN], [IP] und [PASSWORD] ersetzt OpenWrt selbst. Hat dein Anschluss nur IPv4 oder nur IPv6, legst du auch nur den passenden Eintrag an.

Andere Router und Geräte

Die meisten Router und DynDNS-Clients unterstützen einen "benutzerdefinierten" Anbieter, bei dem du eine Update-URL angeben kannst. Verwende dort die URL aus dem Abschnitt Die Update-URL und setze die Platzhalter deines Geräts für Hostname, IPv4-Adresse, IPv6-Adresse und Passwort ein.

Unterstützt dein Gerät nur reines IPv4, lass den Parameter ip6 (inklusive &ip6=) weg. Der IPv6-Eintrag bleibt dann unverändert.

Clients mit DynDNS2-Unterstützung (z.B. ddclient, inadyn) tragen als Server chaos.domains mit dem Pfad /nic/update ein, als Benutzernamen einen beliebigen Wert und als Passwort das Token. Siehe DynDNS2-kompatible Variante.

Kann dein Gerät die URL nicht selbst aufrufen, reicht auch ein kleines Skript, das per Cronjob oder Timer den curl-Befehl von oben ausführt.

Wann ist die neue IP-Adresse aktiv?

Aktualisierungen werden nicht sofort, sondern im Hintergrund verarbeitet. Plane daher folgende Zeiten ein:

  • Neuer Record: Es dauert einige Minuten, bis der Record angelegt und das Token auf der DynDNS-Seite sichtbar ist.
  • IP-Aktualisierung: Nach einem 200 Okay dauert es in der Regel wenige Minuten, bis die Änderung auf unseren Nameservern aktiv ist. Schlägt die Verarbeitung vorübergehend fehl, wird sie automatisch mehrfach wiederholt.
  • Caching: Die TTL (Gültigkeitsdauer im DNS) der Einträge beträgt 3600 Sekunden (1 Stunde). Resolver und Router anderer Anbieter dürfen die alte Adresse so lange zwischenspeichern. Bis die neue Adresse überall ankommt, kann es also bis zu eine Stunde dauern.

Gehen mehrere Aktualisierungen derselben Adressart kurz hintereinander ein, bevor die erste verarbeitet wurde, wird nur die jeweils letzte berücksichtigt. Aktualisierungen für IPv4 und IPv6 gehen dabei nie gegenseitig verloren.

Record löschen

Wenn du einen DynDNS-Record nicht mehr benötigst, klicke auf der DynDNS-Seite der Domain in der Zeile des Records auf Record löschen.

Der Record wird zum Löschen vorgemerkt. Im Hintergrund entfernen wir zuerst die A- und AAAA-Einträge der Subdomain und anschließend den DynDNS-Record samt Token. Auch das kann einige Minuten dauern. Ab dann wird das Token nicht mehr akzeptiert.

Hinweise

  • Bestehende Einträge: Gibt es in der Zone bereits ein A- oder AAAA-Record mit dem Namen der Subdomain, wird dieser bei der ersten Aktualisierung übernommen und mit der neuen Adresse überschrieben. Er wird ab dann von DynDNS verwaltet und beim Löschen des DynDNS-Records ebenfalls entfernt. Lege deshalb für DynDNS-Subdomains keine eigenen A/AAAA-Einträge im DNS-Portal an und ändere die automatisch verwalteten Einträge dort nicht von Hand.
  • Änderungen von Hand: Hast du einen DynDNS-Eintrag trotzdem im DNS-Portal verändert oder gelöscht, stellen wir ihn spätestens bei der ersten Übermittlung wieder her, die mehr als 12 Stunden nach dem letzten Abgleich eintrifft, oder sobald sich deine IP-Adresse ändert. Innerhalb dieser 12 Stunden wird dieselbe Adresse als "unverändert" erkannt. Möchtest du den Eintrag sofort wiederherstellen, übermittle kurz eine andere Adresse und danach wieder die richtige.
  • Andere Record-Typen: DynDNS verwaltet ausschließlich A- und AAAA-Einträge. Andere Einträge der Subdomain, z.B. MX oder TXT, bleiben unberührt.
  • Erster Aufruf: Direkt nach dem Anlegen eines Records existieren noch keine A/AAAA-Einträge. Sie entstehen mit dem ersten erfolgreichen Aufruf der Update-URL. Dein Router macht das automatisch, sobald du ihn konfiguriert hast. Du kannst es mit dem curl-Befehl auch manuell auslösen.
  • Domain-Umzug: Wechselst du die Nameserver der Domain zu einem externen Anbieter, steht DynDNS nicht mehr zur Verfügung.

Fehlersuche

Die Update-URL /dyndns antwortet bei jedem Problem aus Sicherheitsgründen mit demselben 403 Error! und nennt keine Details. Prüfe bei einem Fehler diese Punkte (bei der DynDNS2-Variante /nic/update zeigt dir der Antwortcode den Grund):

  • Hostname (nohost, notfqdn): Der Parameter hostname muss dem vollständigen Hostnamen des Records entsprechen, z.B. home.beispiel.de und nicht nur home. Groß- und Kleinschreibung spielen keine Rolle, Leerzeichen und andere Sonderzeichen sind nicht erlaubt.
  • Token (badauth): Das Token muss zu genau diesem Hostnamen gehören und vollständig (64 Zeichen) und ohne Leerzeichen übertragen werden. Wurde der Record neu angelegt, gilt nur das neueste Token.
  • IP-Adresse (badip): Es muss mindestens eine gültige Adresse übergeben werden. ip4 muss die Form 203.0.113.25 haben, ip6 darf nur eine einzelne IPv6-Adresse ohne Präfixlänge (/64) sein. Loopback-, Multicast- und Link-Local-Adressen werden abgelehnt. Nur 0.0.0.0 oder :: zählt als "keine Adresse".
  • Widersprüchliche Angaben: Zwei verschiedene Adressen für dieselbe Adressart in einer Anfrage werden abgelehnt.
  • Platzhalter: Prüfe, dass der Router die Platzhalter wirklich ersetzt. Eine URL, in der noch <ipaddr> o.ä. steht, wird abgelehnt.
  • HTTPS: Die URL muss mit https:// beginnen.
  • Record vorhanden: Der Record muss auf der DynDNS-Seite der Domain unter Aktive Records aufgeführt sein.

Bekommst du ein 200 Okay, aber die Adresse ändert sich nicht, warte ein paar Minuten und prüfe dann, ob der Eintrag in der Zone aktualisiert wurde, z.B. mit:

dig +short A home.beispiel.de @ns1.chaos.domains
dig +short AAAA home.beispiel.de @ns1.chaos.domains

Fragst du direkt unseren Nameserver, umgehst du das Caching anderer Resolver. Zeigt unser Nameserver die richtige Adresse, ist die Aktualisierung erfolgreich und du musst nur noch auf den Ablauf der TTL warten.