# DynDns

### Übersicht

Mit **DynDNS** (dynamisches DNS) erreichst du dein Heim- oder Firmennetz auch dann unter einem festen Hostnamen (z. B. `home.example.de`), wenn dein Internetanschluss regelmäßig eine **neue IP-Adresse** erhält. Dein Router meldet jede Adressänderung automatisch an unseren Update-Dienst, der den DNS-Eintrag deiner Domain sofort aktualisiert – **IPv4 und IPv6** werden dabei getrennt verarbeitet (A- und AAAA-Record).

Die Verwaltung findest du unter **Domainverwaltung → Dyn-DNS**. Dort legst du Einträge an, siehst den Status und die letzten Updates und findest fertige Konfigurationen für die gängigen Router.

<div id="bkmrk-voraussetzungen%3A-du-" style="background-color: #e3f2fd; border-left: 4px solid #2196f3; padding: 12px 16px; margin: 16px 0;">**Voraussetzungen:** Du benötigst die Berechtigung **Domainverwaltung** sowie mindestens eine Domain in deinem Portfolio, deren DNS über uns verwaltet wird.</div>#### [![dyndns_1.png](https://wiki.fisinger.de/uploads/images/gallery/2026-08/scaled-1680-/TbRQy5bhmN3byt3d-dyndns-1.png)](https://wiki.fisinger.de/uploads/images/gallery/2026-08/TbRQy5bhmN3byt3d-dyndns-1.png)

#### Der Update-Dienst auf einen Blick

<table id="bkmrk-eigenschaft-wert-upd" style="width: 100%; border-collapse: collapse;"><thead><tr style="background-color: #f5f5f5;"><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Eigenschaft</th><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Wert</th></tr></thead><tbody><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Update-URL**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">`https://dyndns.mein-kis.de/nic/update`</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Protokoll**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">dyndns2 (Standard aller gängigen Router)</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Anmeldung**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Benutzername + Passwort (HTTP Basic-Auth)</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**IP-Versionen**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">IPv4 und IPv6, auch beides in einem Update (Dualstack)</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Eigene IP ermitteln**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">`https://dyndns.mein-kis.de/checkip` (ohne Anmeldung)</td></tr></tbody></table>

<div id="bkmrk-bestandsger%C3%A4te%3A-%C3%84lte" style="background-color: #fff8e1; border-left: 4px solid #ffc107; padding: 12px 16px; margin: 16px 0;">**Bestandsgeräte:** Ältere Zugänge, die noch mit einer früheren Update-Adresse (z. B. `dyndns.fisinger.de`) eingerichtet wurden, funktionieren unverändert weiter – eine Umstellung ist nicht erforderlich. Für neue Einrichtungen verwende bitte immer `dyndns.mein-kis.de`.</div>---

### DynDNS-Eintrag anlegen

1. Öffne **Domainverwaltung → Dyn-DNS**.
2. Wähle im Bereich **„Neuen DynDNS-Eintrag anlegen"** eine deiner Domains aus.
3. Trage die gewünschte **Subdomain** ein (z. B. `home` für `home.example.de`) – oder `@`, wenn die Domain selbst dynamisch werden soll.
4. Klicke auf **„Anlegen"**.

Benutzername und Passwort werden automatisch erzeugt und nach der Anlage **einmalig** angezeigt.

[![dyndns_2.png](https://wiki.fisinger.de/uploads/images/gallery/2026-08/scaled-1680-/9wsGQ4k1dxklGiv9-dyndns-2.png)](https://wiki.fisinger.de/uploads/images/gallery/2026-08/9wsGQ4k1dxklGiv9-dyndns-2.png)

<div id="bkmrk-wichtig-%E2%80%93-passwort-s" style="background-color: #ffebee; border-left: 4px solid #f44336; padding: 12px 16px; margin: 16px 0;">**Wichtig – Passwort sofort sichern:** Das Passwort wird aus Sicherheitsgründen **nur dieses eine Mal** angezeigt und danach ausschließlich verschlüsselt gespeichert. Notiere es direkt bzw. trage es sofort in deinen Router ein. Solltest du es verlieren, kannst du auf der Detailseite jederzeit ein **neues Passwort generieren**.</div>---

### Router einrichten

Öffne in der Dyn-DNS-Übersicht die **Detailseite** deines Eintrags (Button „Details"). Im Tab **„Geräte-Konfiguration"** findest du fertige Einstellungen zum Übernehmen – bereits mit deinem Hostnamen und Benutzernamen ausgefüllt.

#### FRITZ!Box

1. Öffne in der FRITZ!Box **Internet → Freigaben → DynDNS**.
2. Wähle als Anbieter **„Benutzerdefiniert"**.
3. Trage die Update-URL exakt so ein (die Platzhalter ersetzt die FRITZ!Box selbst):  
    `https://dyndns.mein-kis.de/nic/update?hostname=<domain>&myip=<ipaddr>&myipv6=<ip6addr>`
4. Domainname = dein DynDNS-Hostname, dazu Benutzername und Kennwort aus dem Portal.

Die FRITZ!Box meldet damit **IPv4 und IPv6 gemeinsam** – beide DNS-Einträge bleiben automatisch aktuell.

#### Telekom Speedport

1. Öffne **Internet → Dynamisches DNS** und wähle als Anbieter **„Anderer Anbieter"**.
2. Update-URL/Server: `https://dyndns.mein-kis.de/nic/update`
3. Domainname/Hostname, Benutzername und Kennwort aus dem Portal eintragen.

#### UniFi (Ubiquiti)

1. Öffne **Settings → Internet → Dynamic DNS**.
2. Service: **custom** (dyndns2)
3. Hostname, Username und Password aus dem Portal eintragen.
4. Server: `dyndns.mein-kis.de/nic/update?hostname=%h&myip=%i`

#### Kommandozeile, Skripte &amp; andere Geräte

Jedes Gerät, das das dyndns2-Protokoll beherrscht, kann den Dienst nutzen. Manuelles Update per `curl`:

`curl -u "BENUTZER:PASSWORT" "https://dyndns.mein-kis.de/nic/update?hostname=home.example.de"`

Ohne IP-Angabe wird automatisch die Absender-IP verwendet; alternativ kannst du die Adressen mit `&myip=…` (IPv4) und `&myipv6=…` (IPv6) explizit übergeben. Auf der Detailseite findest du zusätzlich ein fertiges **Windows-Batch-Beispiel** für die Aufgabenplanung.

<div id="bkmrk-antworten-des-dienst" style="background-color: #e3f2fd; border-left: 4px solid #2196f3; padding: 12px 16px; margin: 16px 0;">**Antworten des Dienstes:** `good <ip>` = Eintrag aktualisiert, `nochg <ip>` = IP unverändert (kein Update nötig). Beide Antworten bedeuten: alles in Ordnung.</div>---

### Detailseite: Status, Logs &amp; Aktionen

[![dyndns_3.png](https://wiki.fisinger.de/uploads/images/gallery/2026-08/scaled-1680-/oQvvobfBW8Sv9IiH-dyndns-3.png)](https://wiki.fisinger.de/uploads/images/gallery/2026-08/oQvvobfBW8Sv9IiH-dyndns-3.png)

Die Detailseite eines Eintrags zeigt rechts die **Zugangsdaten &amp; Status** (Hostname, Benutzername, letzte IPv4/IPv6, letztes Update) und bietet folgende Aktionen:

<table id="bkmrk-aktion-wirkung-neues" style="width: 100%; border-collapse: collapse;"><thead><tr style="background-color: #f5f5f5;"><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Aktion</th><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Wirkung</th></tr></thead><tbody><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Neues Passwort generieren**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Erzeugt ein neues Passwort (einmalige Anzeige). Das bisherige Passwort wird sofort ungültig – anschließend die Zugangsdaten im Router aktualisieren.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Deaktivieren / Aktivieren**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Deaktivierte Einträge nehmen keine Updates mehr an, bleiben aber vollständig erhalten (Zugangsdaten, DNS-Einträge, Logs). Ideal, um einen Zugang vorübergehend stillzulegen.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">**Eintrag löschen**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Entfernt den Zugang **endgültig** – inklusive der DNS-Einträge (A/AAAA) und aller Logs. Der Hostname ist danach nicht mehr auflösbar.</td></tr></tbody></table>

#### Tab „Logs"

Im Tab **„Logs"** siehst du die letzten 250 Updates deines Eintrags (ältere Einträge werden nach 3 Monaten automatisch entfernt). Die Status-Spalte bedeutet:

<table id="bkmrk-status-bedeutung-akt" style="width: 100%; border-collapse: collapse;"><thead><tr style="background-color: #f5f5f5;"><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Status</th><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Bedeutung</th></tr></thead><tbody><tr><td style="border: 1px solid #ddd; padding: 8px 12px;"><span style="background: #28a745; color: #fff; padding: 2px 8px; border-radius: 4px;">Aktualisiert</span></td><td style="border: 1px solid #ddd; padding: 8px 12px;">Neue IP-Adresse wurde erfolgreich in den DNS-Eintrag übernommen.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;"><span style="background: #dc3545; color: #fff; padding: 2px 8px; border-radius: 4px;">Login fehlgeschlagen</span></td><td style="border: 1px solid #ddd; padding: 8px 12px;">Benutzername oder Passwort falsch – Zugangsdaten im Gerät prüfen.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;"><span style="background: #ffc107; color: #000; padding: 2px 8px; border-radius: 4px;">Unbekannter Host</span></td><td style="border: 1px solid #ddd; padding: 8px 12px;">Der gesendete Hostname gehört nicht zu diesem Zugang – Hostnamen im Gerät prüfen.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;"><span style="background: #6c757d; color: #fff; padding: 2px 8px; border-radius: 4px;">Deaktiviert</span></td><td style="border: 1px solid #ddd; padding: 8px 12px;">Der Eintrag ist deaktiviert; das Update wurde nicht ausgeführt.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;"><span style="background: #343a40; color: #fff; padding: 2px 8px; border-radius: 4px;">IP gesperrt</span></td><td style="border: 1px solid #ddd; padding: 8px 12px;">Zu viele Fehlversuche in kurzer Zeit – die Sperre endet automatisch, sobald keine fehlerhaften Anfragen mehr eingehen.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;"><span style="background: #dc3545; color: #fff; padding: 2px 8px; border-radius: 4px;">Serverfehler</span></td><td style="border: 1px solid #ddd; padding: 8px 12px;">Vorübergehender Fehler auf unserer Seite – das Gerät wiederholt das Update automatisch.</td></tr></tbody></table>

<div id="bkmrk-hinweis%3A-erfolgreich" style="background-color: #e3f2fd; border-left: 4px solid #2196f3; padding: 12px 16px; margin: 16px 0;">**Hinweis:** Erfolgreiche Updates **ohne IP-Änderung** (Antwort `nochg`) werden nicht protokolliert – das Log zeigt nur echte Adresswechsel und Fehler. Ob dein Gerät sich regelmäßig meldet, erkennst du am Feld **„Letztes Update"**.</div>---

### IPv6 – gut zu wissen

- Der **AAAA-Eintrag** (IPv6) wird automatisch angelegt, sobald dein Gerät zum ersten Mal eine IPv6-Adresse meldet – du musst nichts einrichten.
- Meldet dein Gerät **vorübergehend keine IPv6** (z. B. direkt nach einer Neueinwahl), bleibt der letzte bekannte AAAA-Eintrag bestehen und wird beim nächsten IPv6-Update wieder aktualisiert.
- Verliert dein Anschluss **dauerhaft** IPv6, lösche den Eintrag am einfachsten und lege ihn neu an – oder wende dich an den Support.

---

### Häufige Probleme

<table id="bkmrk-problem-l%C3%B6sung-route" style="width: 100%; border-collapse: collapse;"><thead><tr style="background-color: #f5f5f5;"><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Problem</th><th style="border: 1px solid #ddd; padding: 8px 12px; text-align: left;">Lösung</th></tr></thead><tbody><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">Router meldet „Anmeldung fehlgeschlagen"</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Benutzername/Passwort prüfen. Falls das Passwort nicht mehr bekannt ist: auf der Detailseite **„Neues Passwort generieren"** und im Router aktualisieren.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">Status bleibt auf **„Wartet auf erstes Update"**</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Der Router hat sich noch nie gemeldet – Update-URL und Zugangsdaten prüfen, ggf. im Router die DynDNS-Funktion einmal aus- und wieder einschalten.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">Hostname zeigt auf eine alte IP</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Die DNS-Einträge haben eine Gültigkeit (TTL) von 5 Minuten – kurz warten. Zeigt „Letzte IPv4/IPv6" im Portal ebenfalls die alte Adresse, hat der Router noch kein Update gesendet.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">Antwort `abuse`</td><td style="border: 1px solid #ddd; padding: 8px 12px;">Zu viele Fehlversuche von deiner IP. Zugangsdaten im Gerät korrigieren – die Sperre läuft danach automatisch ab.</td></tr><tr><td style="border: 1px solid #ddd; padding: 8px 12px;">Gewünschte Domain fehlt bei der Anlage</td><td style="border: 1px solid #ddd; padding: 8px 12px;">DynDNS ist nur für Domains möglich, deren DNS über uns verwaltet wird. Externe Domains müssen zuerst transferiert bzw. auf unsere Nameserver umgestellt werden.</td></tr></tbody></table>

---

### DynDNS per Portal-API

Für Automatisierungen steht zusätzlich der API-Endpoint **`dyndns`** der Portal-API zur Verfügung (Accounts auflisten, anlegen, löschen, Passwort erneuern und IP-Updates per API-Token). Die vollständige Beschreibung findest du in der **API-Dokumentation** im Portal unter **API → Dokumentation**.

---

### Hilfe &amp; Support

Bei Fragen zur Einrichtung oder Problemen mit deinem DynDNS-Zugang wende dich bitte an den Support über den **Kontakt**-Link im Portal.