Zum Inhalt springen
NetcupWiki

Dynamic DNS

Erfahre, was Dynamic DNS ist und wie du mit der Dynamic-DNS-API DNS-Einträge aktualisierst.

Diese Anleitung ist für unser neues Cloud DNS anwendbar. Clients für Legacy DNS findest du hier: DynDNS-Clients

1. Was ist Dynamic DNS?

2. DynDNS einrichten

3. Häufig gestellte Fragen (FAQ)

1. Was ist Dynamic DNS?

Dynamic DNS (DynDNS, DDNS) ist ein Service, der DNS-Einträge automatisch aktualisieren kann, wenn sich eine IP-Adresse ändert. DynDNS wird zum Beispiel häufig verwendet, wenn ein Server, der bei jemandem zu Hause steht, erreichbar gemacht werden soll, wenn sich die IP-Adresse durch den Provider regelmäßig ändert. Mit der DynDNS-API kannst du automatisiert den A- (IPv4) und/oder AAAA-Record (IPv6) einer Domain oder Subdomain in deinem netcup-Account aktualisieren. Mit DynDNS ruft dein Router oder ein Skript die URL in regelmäßigen Abständen auf und trägt die aktuelle IP-Adresse automatisch in deine CloudDNS-Zone ein.

Voraussetzungen

Um die DynDNS-API nutzen zu können, musst du bestimmte Voraussetzungen erfüllen:

Die Parameter können mit den HTTP-Requests GET(URL) oder POST übergeben werden.

Parameter

Im Folgenden erhältst du eine Übersicht über die verwendeten Parameter:

Parameter

Pflicht

Typ

Beschreibung

Action

Ja

String

Muss den Wert Update haben, andere Werte werden mit dem HTTP-Fehlercode 404 abgewiesen

Token

Ja

String

Authentifizierungs-Token, das den Aufruf dem zugehörigen Kunden-Account zuordnet; ungültige oder unbekannte Token werden mit dem HTTP-Fehlercode 401 abgewiesen

FQDN (Fully Qualified Domain Name)

Ja

String

Vollqualifizierter Domainname des zu aktualisierenden Eintrags, z. B. “example.com” oder “home.example.com”; muss ein gültiger Domainname sein und zu einer Domain gehören, die im Account des Tokens vorhanden ist

ipv4Address

Optional

String

Neue IPv4-Adresse für den A-Eintrag, muss eine gültige IPv4-Adresse sein

ipv6Address

Optional

String

Neue IPv6-Adresse für den AAAA-Eintrag, muss eine gültige IPv6-Adresse sein

Beachte, dass mindestens einer der beiden Parameter ipv4Address oder ipv6Address gesetzt sein muss. Ist dies nicht der Fall, wird der Request mit dem HTTP-Fehlercode 400 abgewiesen.

Details zu einzelnen Parametern

FQDN
  • DynDNS ermittelt automatisch, welcher Teil des FQDN die im Account vorhandene Domain und welcher Teil der Host ist. Dies wird auch bei mehrteiligen Top-Level-Domains (TLDs) ermittelt, wie z. B. “.co.uk”.
    • “home.example.com” → Domain: “example.com”, Host: “home”
    • “example.com” → Domain: “example.com”, Host: ”@” (Root der Zone)
  • Internationalisierte Domainnamen werden intern nach Punycode umgewandelt.
  • Wird keine passende Domain im Account gefunden, wird der Request mit dem HTTP-Fehlercode 404 abgewiesen.
  • Wird die Domain nicht über CloudDNS verwaltet, wird der Request mit dem HTTP-Fehlercode 400 abgewiesen.
ipv4Address / ipv6Address
  • Neue Einträge werden mit dem Standard-time-to-live (TTL) und der Standard-Region angelegt.
  • Es können in einem Aufruf gleichzeitig A- und AAAA-Record aktualisiert werden.

2. DynDNS einrichten

Eine Anleitung für das Einrichten von DynDNS in deiner FRITZ!Box findest du hier:

Trage im Laufe der Einrichtung Folgendes**** in die dafür vorgesehenen Felder ein:

Verhalten der Aktualisierung

Für den ermittelten Host wird der bestehende A- bzw. AAAA-Record geprüft:

  1. Der Eintrag existiert bereits mit exakt dieser IP-Adresse.
    1. Es ist keine Änderung nötig.
  2. Der Eintrag existiert mit abweichender IP-Adresse.
    1. Der Eintrag wird mit der übergebenen IP-Adresse angepasst.
  3. Der Eintrag existiert noch nicht.
    1. Ein neuer Eintrag wird angelegt. Werden dadurch tatsächlich Änderungen vorgenommen, werden diese in der CloudDNS-Zone gespeichert. Sind alle übergebenen Werte bereits gesetzt, erfolgt keine Änderung.

Antwortformat

Die Antwort erfolgt als JSON (Content-Type: text/json; charset=utf-8):

{
    "status": "success",
    "message": "Record(s) have been saved."
}

Feldbeschreibung

Feld

Beschreibung

Status

Success bei Erfolg, ansonsten Error

Message

Menschenlesbare Statusmeldung

Mögliche message-Werte bei Erfolg

  • “Record(s) have been saved.” – Änderungen wurden gespeichert.
  • “No record update needed.” – Alle Werte waren bereits aktuell.

HTTP-Status- und Fehlercodes

HTTP-Code

Message

Status/Fehler

200

“Record(s) have been saved.” / “No record update needed.”

Erfolgreich verarbeitet

400

“At least one of the two fields need to be specified: ipv4Address , ipv6Address.”

Weder IPv4- noch IPv6-Adresse übergeben

400

“At least one of the two fields need to be specified: ipv4Address , ipv6Address.”

Ungültiges Format eines Parameters

400

“This domain is not managed through CloudDNS, for this reason this service will not work.”

Domain wird nicht über CloudDNS verwaltet

401

“Unable to authenticate with provided token.”

Token ungültig oder unbekannt

404

“No matching domain for the given fqdn was found in your account.”

Keine passende Domain im Account

404

“Requested action is not known or not implemented.”

Action fehlt oder ist ungleich Update

500

“An error occurred while trying to … Please reach out to our support.”

Interner Fehler beim Zugriff auf die CloudDNS-Zone/Records

400

”< feld> is a required field.”

Pflichtparameter (token , fqdn) fehlt

3. Häufig gestellte Fragen (FAQ)

Die Verbreitung von aktualisierten DNS-Einträgen ist abhängig von der eingestellten TTL und wie Resolver/DNS-Server die DNS aktualisieren, sie kann bis zu 48 Stunden andauern. In der Regel sind die DNS-Einträge jedoch innerhalb kürzester Zeit bei den wichtigsten Resolver/DNS-Servern verbreitet.

Nein, das ist nicht möglich. Du kannst jedoch gerne unsere DNS-API verwenden, um weitere DNS-Einträge automatisiert zu bearbeiten.

Das könnte dich auch interessieren:

API

CloudDNS

DNS anpassen (CloudDNS)

Eigene Nameserver hinterlegen (CloudDNS)

DNSSEC (CloudDNS)

Zuletzt aktualisiert: 28. August 2026

apiscp