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 du eigene Updater, Router-Integrationen oder kleine Homeserver-Skripte ohne direkten DNS-API-Zugriff verwenden kannst.

Der Kern des Ablaufs ist immer gleich: Du aktivierst DynDNS für eine Domain im Regfish Domain-Management, erhältst ein persönliches Token und sendest anschließend Updates per GET oder POST an https://dyndns.regfish.de.

Voraussetzungen

eine Domain bei Regfish
Zugriff auf das Regfish Domain-Management
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 du IPv4, IPv6 oder beide Adressfamilien aktualisieren willst

Schritt 1: DynDNS für die Domain aktivieren

Melde dich im Domain-Management von Regfish an, öffne die gewünschte Domain und aktiviere unter den Nameserver-Einstellungen Dynamisches DNS. Danach erhältst du dein persönliches DynDNS-Token.

Optional kannst du zusätzlich E-Mail-Benachrichtigungen für spätere DynDNS-Updates einschalten.

Wenn du einen eigenen Updater oder ein kleines Script baust, 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. Dein Updater kann daraus später die passenden DynDNS-Parameter für den eigentlichen URL-Aufruf zusammensetzen.

Schritt 2: Update-Parameter festlegen

Der Legacy-Dienst kennt ein festes Parameterset. Wichtig sind vor allem:

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

Wenn du aus einem generischen DynDNS-Client oder einem Script arbeitest, wird das Token typischerweise wie ein Benutzername verwendet. Ein separates Kennwort brauchst du 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 kannst du dieselbe Anfrage auch per POST absenden, wenn dein Client das bevorzugt.

Schritt 4: Explizite IPv4 oder IPv6 setzen

Wenn dein Updater die Zieladresse selbst kennt, kannst du 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, verwendest du 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, kannst du 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'

Verwende forcehost=1 bewusst nur dort, wo dein 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

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

Ergebnis

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