Dynamisches DNS, Verwaltung im Kundenbereich

Mit der Funktion Dynamisches DNS (DDNS) können Sie für Domains ohne zugehöriges Hosting direkt im Kundenbereich Subdomains anlegen und verwalten, die auf dynamische IP-Adressen zeigen.

Dieses Werkzeug ist besonders nützlich für den Fernzugriff auf Geräte zu Hause, Heimserver, NAS-Geräte, Sicherheitskameras oder jeden anderen Dienst, der aus dem Internet erreichbar sein muss, aber eine IP hat, die sich regelmäßig ändert.

Voraussetzungen

• Registrierte Domain in Ihrem Konto
• Kein zugehöriger Hosting-Dienst (für Domains mit Hosting verwenden Sie das dynamische DNS in cPanel)
• Gerät oder System, das regelmäßig HTTPS-Anfragen senden kann

Zugang zur Funktion

1. Melden Sie sich im Kundenbereich an
2. Öffnen Sie den Bereich Domains
3. Klicken Sie bei der Domain, die Sie einrichten möchten, auf Verwalten
4. Öffnen Sie im Seitenmenü der Detailseite in der Gruppe DNS und Domains den Punkt Dynamisches DNS

Grundeinrichtung

Füllen Sie in der Karte Neuer Eintrag die folgenden Felder aus:

• Subdomain: Name der Subdomain (optional, leer lassen für die Hauptdomain)
  • Beispiele: servidor, nas, dev, cam01
  • Für die Hauptdomain: Feld leer lassen
• Eintragstyp: Wählen Sie zwischen:
  • A (IPv4): für die öffentliche IPv4-Adresse des Anschlusses
  • AAAA (IPv6): für IPv6-Adressen (z. B. 2001:db8::1)

Klicken Sie auf DDNS-Eintrag erstellen, um das Token zu erzeugen. Der DNS-Eintrag wird angelegt oder aktualisiert, sobald die erste gültige Anfrage eingeht; bis dahin zeigt der Eintrag möglicherweise keine aktuelle IP.

Einschränkungen

• Höchstens 10 DDNS-Einträge pro Domain
• Keine Duplikate: Sie können nicht mehrere Einträge für dieselbe Subdomain und denselben Eintragstyp anlegen
• Nur Domains ohne Hosting: Die Funktion ist für Domains mit zugehörigem Hosting nicht verfügbar

DDNS-Einträge verwalten

Die angelegten Einträge werden darunter unter Konfigurierte Einträge aufgelistet, zusammen mit der Anzahl der genutzten von 10 verfügbaren Einträgen. Jede Zeile zeigt:

• Vollständiger Name: hostname.ihredomain.com
• Eintragstyp: A oder AAAA
• Aktuelle IP: zuletzt registrierte IP oder „noch keine IP“, wenn noch kein Aufruf eingegangen ist
• Letzte Aktualisierung: wie lange die letzte Änderung zurückliegt
• Status: eine Kennzeichnung Aktiv oder Pausiert

Aktualisierungs-URL

Jeder Eintrag hat seine eigene Aktualisierungs-URL mit der Schaltfläche Kopieren daneben. Kopieren Sie sie dort: Diese URL richten Sie auf Ihrem Gerät oder System ein, damit es die IP durch Aufrufe dieser URL aktuell hält. Sie hat dieses Format:

https://ddns.hostsuar.com/update/TOKEN_UNICO_32_CARACTERES

Darunter klappt Anwendungsbeispiele ansehen dieselbe URL fertig zusammengesetzt für cURL, Wget, den Browser und die Statusabfrage auf.

Behandeln Sie sie wie ein Passwort: Jeder, der das Token kennt, kann das Ziel des Eintrags ändern. Veröffentlichen Sie sie nicht und nehmen Sie sie nicht in zugängliche Protokolle auf; erzeugen Sie das Token neu, wenn es offengelegt wurde.

Einrichtung auf Geräten

Heimrouter

Wenn Ihr Router einen benutzerdefinierten DDNS-Anbieter mit HTTPS-URL unterstützt, können Sie ihn so einrichten:

1. Öffnen Sie die Konfiguration Ihres Routers
2. Suchen Sie den Abschnitt Dynamisches DNS oder DDNS
3. Wählen Sie Benutzerdefiniert oder Custom
4. Geben Sie die vollständige Aktualisierungs-URL ein
5. Legen Sie das Aktualisierungsintervall fest (empfohlen: 5–10 Minuten)

NAS-Geräte

Synology DiskStation

1. Gehen Sie zu Systemsteuerung > Externer Zugriff > DDNS
2. Wählen Sie "Customize"
3. Geben Sie die Aktualisierungs-URL ein
4. Legen Sie das Intervall fest

QNAP

1. Öffnen Sie Control Panel > External Access > DDNS
2. Wählen Sie "Custom DDNS"
3. Richten Sie URL und Parameter ein

Eigene Skripte

Mit cURL (Linux/macOS)

#!/bin/bash
# Skript zum Aktualisieren des dynamischen DNS

URL="https://ddns.hostsuar.com/update/TU_TOKEN_AQUI"

# Mit automatischer IP-Erkennung aktualisieren
curl --fail --show-error --silent "$URL"

# Oder die IP manuell angeben
# curl -s "$URL?ip=TU_IP_AQUI"

Mit PowerShell (Windows)

$url = "https://ddns.hostsuar.com/update/TU_TOKEN_AQUI"
Invoke-WebRequest -Uri $url -UseBasicParsing

Cronjob (Linux)

Zur Ausführung alle 5 Minuten:

# Crontab bearbeiten
crontab -e

# Zeile hinzufügen:
*/5 * * * * /usr/bin/curl -s "https://ddns.hostsuar.com/update/TU_TOKEN"

Parameter der URL

Parameter IP

Sie können die IP auf zwei Arten angeben:

# Parameter ip
https://ddns.hostsuar.com/update/TOKEN?ip=192.0.2.44

# Parameter myip (Kompatibilität)
https://ddns.hostsuar.com/update/TOKEN?myip=192.0.2.44

Automatische Erkennung

Wenn Sie keinen Parameter angeben, erkennt das System automatisch die IP, von der die Anfrage kommt:

https://ddns.hostsuar.com/update/TOKEN

Status des DDNS-Eintrags abfragen

Neben dem Aktualisieren der IP können Sie den aktuellen Status jedes DDNS-Eintrags abfragen, ohne etwas zu ändern.

Abfrage-URL

https://ddns.hostsuar.com/status/TOKEN

Statusantwort

{
  "hostname": "servidor.ihredomain.com",
  "current_ip": "192.0.2.44",
  "type": "A",
  "enabled": true,
  "last_updated": "2025-01-15T14:30:45.000Z"
}

Felder der Antwort

• hostname: vollständiger Name der eingerichteten Subdomain
• current_ip: zuletzt registrierte IP-Adresse
• type: Typ des DNS-Eintrags (A oder AAAA)
• enabled: Status des Eintrags (true/false)
• last_updated: ISO-Datum der letzten Aktualisierung (null, wenn nie aktualisiert)

Anwendungsfälle

• Überwachung: prüfen, ob Ihr Gerät korrekt aktualisiert
• Debugging: die aktuell registrierte IP prüfen, ohne etwas zu ändern
• Automatisierung: in Skripte einbinden, um vor dem Aktualisieren zu prüfen

Antworten der API

Erfolgreiche Aktualisierung

{
  "success": true,
  "message": "DNS record updated successfully",
  "hostname": "servidor.ihredomain.com",
  "ip": "192.0.2.44",
  "type": "A"
}

IP unverändert

{
  "success": true,
  "message": "IP address is already up to date",
  "hostname": "servidor.ihredomain.com",
  "ip": "192.0.2.44",
  "type": "A"
}

Häufige Fehler

{
  "error": "Invalid token",
  "code": "INVALID_TOKEN"
}

{
  "error": "DDNS entry is disabled",
  "code": "DDNS_DISABLED"
}

{
  "error": "Invalid IP format for record type",
  "code": "INVALID_IP"
}

Erweiterte Verwaltung

Einen Eintrag pausieren oder aktivieren

Sie können jeden Eintrag pausieren oder aktivieren, ohne ihn zu löschen:

• Pausieren: stoppt neue Aktualisierungen, der letzte A- oder AAAA-Eintrag bleibt aber veröffentlicht
• Aktivieren: nimmt den normalen Betrieb wieder auf

Token neu erzeugen

Wenn Sie vermuten, dass Ihr Token kompromittiert wurde, können Sie ein neues Token erzeugen:

1. Klicken Sie auf Token neu erzeugen
2. Bestätigen Sie mit Neu erzeugen
3. Aktualisieren Sie die Konfiguration auf allen Ihren Geräten mit dem neuen Token

⚠️ Wichtig: Nach dem Neuerzeugen funktioniert das bisherige Token sofort nicht mehr.

Eintrag löschen

So löschen Sie einen DDNS-Eintrag vollständig:

1. Klicken Sie auf Löschen
2. Bestätigen Sie den Vorgang
3. Der Eintrag und der zugehörige DNS-Eintrag werden endgültig gelöscht

Fehlerbehebung

Wie dynamisches DNS funktioniert

Wichtig ist: DDNS verwaltet nur DNS-Einträge, die auf IP-Adressen zeigen. Der Dienst:

• Setzt eine TTL von 60 Sekunden, um schnelle Aktualisierungen zu ermöglichen
• Stellt keine SSL/HTTPS-Zertifikate bereit: Diese müssen auf dem Zielserver eingerichtet werden
• Löst nur Namen in IPs auf: Webinhalte oder Dienste müssen unter der Ziel-IP laufen

DNS-Propagation und Cache

Obwohl wir für DDNS-Einträge eine TTL von 60 Sekunden setzen, können einige Faktoren die Geschwindigkeit der Aktualisierung beeinflussen:

DNS-Caches

Der Eintrag verwendet eine TTL von 60 Sekunden, dennoch können frühere Antworten in Resolvern, Routern, Systemen und Anwendungen bestehen bleiben. Es gibt keine allgemein garantierte Frist, bis alle die bisherige Adresse nicht mehr verwenden.

Häufige Probleme

Die IP wird nicht aktualisiert

1. Token prüfen: Stellen Sie sicher, dass Sie das richtige Token verwenden
2. Status prüfen: Der Eintrag muss aktiv sein
3. Verbindung prüfen: Das Gerät muss Internetzugang haben
4. IP prüfen: Für A-Einträge IPv4, für AAAA-Einträge IPv6 verwenden
5. Caches prüfen: Warten Sie mindestens die TTL ab und fragen Sie mehrere Resolver ab; eine frühere Antwort kann in einem Cache länger bestehen bleiben

Fehler „Nicht sicher“ oder HTTPS-Probleme

• DDNS stellt kein SSL bereit: HTTPS-Zertifikate müssen auf Ihrem Server eingerichtet werden
• Let's Encrypt verwenden: für kostenlose Zertifikate auf Ihrem Server

Fehler „ungültiges Token“

• URL prüfen: Kopieren Sie genau die URL, die im Kundenbereich angezeigt wird
• Token neu erzeugen: Wenn das Problem bestehen bleibt, erzeugen Sie ein neues Token

Die Domain wird aufgelöst, aber es gibt keinen Inhalt

• Server prüfen: Der Webdienst muss unter der Ziel-IP laufen
• Ports prüfen: Stellen Sie sicher, dass die nötigen Ports offen sind
• Firewall: Prüfen Sie die Firewall-Einstellungen in Router und Server

Bevor Sie eine IP veröffentlichen

Prüfen Sie, dass die Domain die DNS-Zone verwendet, die dieses Werkzeug verwaltet, und dass der gewählte Name nicht bereits einen anderen Dienst bereitstellt. Die Adresse 192.0.2.44 in den Beispielen ist für Dokumentation reserviert: Ersetzen Sie sie durch die tatsächliche öffentliche IP; mit ihr erreichen Sie Ihr Gerät nicht.

Bei automatischer Erkennung führen Sie die Anfrage von dem Anschluss aus, dessen Ziel Sie veröffentlichen möchten. Ein VPN, ein Proxy oder ein externer Server können die erkannte IP verändern. Prüfen Sie bei einem AAAA-Eintrag, dass die Anfrage oder der Parameter einer öffentlichen IPv6 des Dienstes entspricht und nicht einer temporären Adresse eines anderen Geräts.

DDNS beseitigt kein CGNAT und öffnet keine Ports im Router. Wenn die IP aktualisiert wird, der Dienst aber keine Verbindung herstellt, prüfen Sie die Erreichbarkeit aus einem anderen Netz, bevor Sie das Token neu erzeugen. Die Menüs von NAS und Routern unterscheiden sich je nach Modell und Version: Prüfen Sie, dass sie die URL und die Aktualisierungsmethode zulassen, statt davon auszugehen, dass jede Option „DDNS“ kompatibel ist.

Vermeiden Sie in Automatisierungen, das Token in öffentliche Logs zu schreiben, behandeln Sie HTTP-Fehler und fragen Sie den Status ab, wenn Sie den letzten Wert bestätigen müssen. Das Pausieren der Aktualisierungen behält die veröffentlichte IP bei; es trennt den Dienst nicht.