regfish DynDNS per Update-URL verwenden

Dieses Rezept bezieht sich auf das bestehende Produkt regfish DynDNS und nicht auf die regfish DNS API. Der Dienst aktualisiert Hostnamen über die DynDNS-Endpunkte von regfish, sodass Sie eigene Updater, Router-Integrationen oder kleine Homeserver-Skripte ohne direkten DNS-API-Zugriff verwenden können.

Der Kern des Ablaufs ist immer gleich: Sie aktivieren DynDNS für eine Domain im regfish dash, erhalten ein persönliches Token und senden anschließend Updates per GET oder POST an https://dyndns.regfish.de.

Voraussetzungen

eine Domain bei regfish
Zugriff auf das regfish dash
ein Hostname, der per DynDNS gepflegt werden soll, zum Beispiel home.example.com
ein Updater, Script oder Gerät, das die DynDNS-URL aufrufen kann
eine klare Entscheidung, ob Sie IPv4, IPv6 oder beide Adressfamilien aktualisieren wollen

Schritt 1: DynDNS für die Domain aktivieren

Melden Sie sich im Domain-Management von regfish an, öffnen Sie die gewünschte Domain und aktivieren Sie unter den Nameserver-Einstellungen Dynamisches DNS. Danach erhalten Sie Ihr persönliches DynDNS-Token.

Optional können Sie zusätzlich E-Mail-Benachrichtigungen für spätere DynDNS-Updates einschalten.

Wenn Sie einen eigenen Updater oder ein kleines Script bauen, kann eine minimale lokale Konfiguration zum Beispiel so aussehen:

{
  "token": "YOUR_DYNDNS_TOKEN",
  "fqdn": "home.example.com",
  "ttl": 300
}

Das ist kein API-Request an regfish, sondern nur ein mögliches lokales Konfigurationsobjekt. Ihr Updater kann daraus später die passenden DynDNS-Parameter für den eigentlichen URL-Aufruf zusammensetzen.

Schritt 2: Update-Parameter festlegen

Die Schnittstelle kennt ein festes Parameterset. Wichtig sind vor allem:

token: Ihr DynDNS-Token, erforderlich
fqdn: der vollständige Hostname, erforderlich
thisipv4=1: übernimmt die IPv4 des anfragenden Systems
thisipv6=1: übernimmt die IPv6 des anfragenden Systems
ipv4: setzt explizit eine IPv4-Adresse
ipv6: setzt explizit eine IPv6-Adresse
forcehost=1: erlaubt das Anlegen eines neuen Host-Eintrags
ttl: TTL in Sekunden, Standard 300

Wenn Sie aus einem generischen DynDNS-Client oder einem Script arbeiten, wird das Token typischerweise wie ein Benutzername verwendet. Ein separates Kennwort brauchen Sie für den URL-Aufruf selbst nicht.

Schritt 3: Erstes Update mit der aktuellen IPv4 senden

Für viele einfache Setups genügt ein Request gegen dyndns.regfish.de, bei dem die aktuelle IPv4 des aufrufenden Systems verwendet wird:

curl 'https://dyndns.regfish.de/?fqdn=home.example.com&token=YOUR_DYNDNS_TOKEN'

Alternativ können Sie dieselbe Anfrage auch per POST absenden, wenn Ihr Client das bevorzugt.

Schritt 4: Explizite IPv4 oder IPv6 setzen

Wenn Ihr Updater die Zieladresse selbst kennt, können Sie sie explizit mitsenden. Das ist zum Beispiel für eigene Script-Logik oder spezielle Netz-Setups sinnvoll.

{
  "ipv4": "203.0.113.42",
  "ipv6": "2001:db8::42"
}

curl 'https://dyndns.regfish.de/?fqdn=home.example.com&ipv4=203.0.113.42&token=YOUR_DYNDNS_TOKEN'

Für IPv6 ist der Ablauf analog. Wenn der Request selbst sicher über IPv6 laufen soll, verwenden Sie den Host https://dyndns6.regfish.de.

curl 'https://dyndns6.regfish.de/?fqdn=home.example.com&thisipv6=1&token=YOUR_DYNDNS_TOKEN'

Schritt 5: Fehlenden Host bei Bedarf automatisch anlegen

Wenn der Hostname noch nicht existiert, können Sie die Anlage über forcehost=1 erlauben:

curl 'https://dyndns.regfish.de/?fqdn=home.example.com&ipv4=203.0.113.42&forcehost=1&token=YOUR_DYNDNS_TOKEN'

Verwenden Sie forcehost=1 bewusst nur dort, wo Ihr Updater den Hostnamen wirklich verwalten soll.

Schritt 6: Rückgabecodes auswerten

Der Dienst arbeitet mit einfachen Statuscodes. Für die Betriebslogik sind besonders relevant:

100: Aktualisierung erfolgreich
101: keine Aktualisierung notwendig
401 oder 402: Authentifizierung fehlgeschlagen
408 oder 409: ungültige IP-Adresse
412: ungültiges FQDN-Format
414: unbekannter Fehler

Ein robuster DynDNS-Job behandelt 100 und 101 als erfolgreiche Zustände und alarmiert erst bei echten Fehlercodes.

Praxishinweise für produktive DynDNS-Jobs

behandeln Sie dieses Rezept als Workflow für das Produkt regfish DynDNS, nicht für die DNS API
verwenden Sie für IPv6 direkte Aufrufe über dyndns6.regfish.de, wenn Ihr Client sicher aus einem IPv6-Kontext kommt
halten Sie den Hostnamen pro DynDNS-Job stabil und wechseln Sie nicht ständig zwischen mehreren FQDNs
nutzen Sie forcehost=1 vor allem für den ersten Bootstrap und nicht blind in jedem Aufruf
wenn Ihr DynDNS-Client Benutzername und Kennwort erwartet, verwenden Sie das Token als Benutzername; das Kennwort ist clientabhängig und wird für den reinen URL-Aufruf nicht benötigt

Ergebnis

Mit diesem Ablauf nutzen Sie das bestehende Produkt regfish DynDNS so, wie es für gängige DynDNS-Clients, Script-Updater und einfache Geräteintegration gedacht ist: Hostname, Token und Ziel-IP werden direkt über die DynDNS-Endpunkte von regfish aktualisiert.