Hilfe & Anleitungen

Setup-Anleitungen für Router, DNS-Provider und die API.

Erste Schritte

  1. Konto anlegen und E-Mail-Adresse bestätigen.
  2. Im Dashboard auf Hostnamen → Erstellen einen Subdomain wie meinhaus.deinservice.de anlegen.
  3. Im Tab API-Keys einen API-Key erstellen (z.B. „Fritz!Box Wohnzimmer“) und sicher kopieren — er wird nur einmal angezeigt.
  4. Den Router gemäß Router-Setup konfigurieren — als Passwort den API-Key benutzen.

Router-Setup

Fritz!Box (AVM)

Internet → Freigaben → DynDNS

Anbieter:
Benutzerdefiniert
Update-URL:
https://api.dnsfollowme.uk/nic/update?hostname=<domain>&myip=<ipaddr>
Domainname:
meinhaus.deinservice.de
Benutzername:
deine E-Mail-Adresse
Passwort:
dein API-Key

Ubiquiti UniFi

Settings → Internet → WAN → Dynamic DNS

Service:
custom (oder dyndns)
Hostname:
meinhaus.deinservice.de
Username:
deine E-Mail-Adresse
Password:
dein API-Key
Server:
api.dnsfollowme.uk/nic/update?hostname=%h&myip=%i

Hinweis: UniFi sendet Updates nur bei tatsächlicher WAN-IP-Änderung. Zum manuellen Auslösen die DynDNS-Konfiguration deaktivieren, speichern, wieder aktivieren, speichern.

pfSense / OPNsense

Services → Dynamic DNS → Add

Service Type:
Custom
Update URL:
https://api.dnsfollowme.uk/nic/update?hostname=%h&myip=%IP%
Hostname:
meinhaus.deinservice.de
Username:
deine E-Mail-Adresse
Password:
dein API-Key

Synology NAS

Systemsteuerung → Externer Zugriff → DDNS → Hinzufügen

Anbieter:
Benutzerdefiniert
Hostname:
meinhaus.deinservice.de
Benutzername:
deine E-Mail-Adresse
Passwort:
dein API-Key
Server-URL:
https://api.dnsfollowme.uk/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

Andere Geräte (DynDNS2-kompatibel)

Jedes Gerät, das das DynDNS2-Protokoll spricht, funktioniert mit folgenden Eckdaten:

Update-URL:
https://api.dnsfollowme.uk/nic/update?hostname=<host>&myip=<ip>
Auth:
Basic Auth (E-Mail / API-Key)
IPv6 (optional):
zusätzlicher Parameter &myipv6=<ipv6>

Eigene Domain anbinden

Du kannst eine Domain einbinden, die du selbst bei einem unterstützten DNS-Provider hostest. Dein API-Token wird AES-256-GCM verschlüsselt gespeichert und nur für DNS-Updates dieser Domain genutzt.

Cloudflare

Voraussetzung: Domain ist auf Cloudflare delegiert (Nameserver bei Cloudflare).

  1. Auf dash.cloudflare.com/profile/api-tokens einen Token erstellen.
  2. Template „Edit zone DNS" nehmen — Permissions: Zone:DNS:Edit.
  3. Bei Zone Resources entweder Specific zone → deine-domain.de oder All zones.
  4. Token kopieren und im Dashboard unter Domains → Domain hinzufügen einfügen.

Hetzner DNS

Voraussetzung: Domain ist in der Hetzner DNS Konsole als Zone angelegt.

  1. Auf dns.hetzner.com/settings/api-token einen API-Token erstellen.
  2. Token kopieren — er wird nur einmal angezeigt.
  3. Im Dashboard unter Domains → Domain hinzufügen Provider „Hetzner DNS“ wählen und Token einfügen.

united-domains

Voraussetzung: Das kostenpflichtige DNS API-Add-on ist für die Zone bei united-domains aktiviert. Ohne das Add-on liefert der Token keine Zonen.

  1. DNS API als Add-on im united-domains Portfolio buchen.
  2. Im Kundenkonto den API-Key generieren.
  3. Im Dashboard unter Domains → Domain hinzufügen Provider „united-domains“ wählen und Key einfügen.

Rate Limit: 1.200 Requests/Stunde pro Token.

API & Endpoints

DynDNS2-Endpoint

Der Router-kompatible Update-Endpoint:

GET https://api.dnsfollowme.uk/nic/update?hostname=<host>&myip=<ipv4>[&myipv6=<ipv6>]
Authorization: Basic base64(<email>:<api-key>)

Mögliche Antworten:

good <ip>Update erfolgreich übernommen
nochg <ip>IP unverändert, kein DNS-Update nötig
nohostHostname existiert nicht oder ist nicht aktiv
badauthE-Mail oder API-Key falsch
badparamUngültige Parameter (z.B. fehlerhafte IP)
911Serverfehler — später erneut versuchen

Test mit curl

curl -u "deine@email.de:dyndns_..." \
  "https://api.dnsfollowme.uk/nic/update?hostname=meinhaus.deinservice.de&myip=1.2.3.4"

HTTPS aktivieren (Self-Hosting)

Wenn du den Service auf einem eigenen Server hostest und über öffentliche Domains erreichbar machst, holt Caddy automatisch Let's-Encrypt-Zertifikate. UniFi und einige andere Router akzeptieren als DynDNS-Endpoint nur HTTPS — dafür ist das Pflicht.

  1. Zwei DNS-A-Records (z.B. app.deinservice.de und api.deinservice.de) auf deinen Server zeigen lassen.
  2. Port 80 + 443 müssen vom Internet erreichbar sein (Firewall, Port-Forwarding).
  3. In der .env:
    APP_DOMAIN=app.deinservice.de
    API_DOMAIN=api.deinservice.de
    ACME_EMAIL=admin@deinservice.de
    CADDY_CONFIG=Caddyfile.prod
  4. docker compose up -d --build

Caddy erneuert die Zertifikate automatisch ~30 Tage vor Ablauf — kein Cronjob nötig.

Häufige Fragen

Mein Router schickt keine Updates — was tun?

Die meisten Router (UniFi, Fritz!Box) senden Updates nur bei tatsächlichem WAN-IP-Wechsel. Zum manuellen Auslösen die DynDNS-Konfiguration im Router einmal deaktivieren, speichern, wieder aktivieren, speichern. Im Dashboard im Tab Hostnamen → Verlauf siehst du, ob Updates ankommen.

Mein API-Key — wie verwende ich den?

Im Router als Passwort eintragen, statt deines Account-Passworts. Die E-Mail-Adresse bleibt der Benutzername. Der API-Key kann jederzeit revoziiert werden, ohne dein Account-Passwort zu ändern.

Kann ich IPv6 nutzen?

Ja. Hänge an die Update-URL den Parameter "&myipv6=<deine-ipv6>" an — der Service legt zusätzlich einen AAAA-Record an. Free und Pro können beides parallel nutzen.

Was passiert wenn ich meinen API-Key verloren habe?

API-Keys werden nur als Hash gespeichert und können nicht wiederhergestellt werden. Den alten Key im Dashboard löschen, einen neuen erstellen und im Router eintragen.

Wieviele Hostnamen / Domains darf ich anlegen?

Free: 3 Hostnamen, 1 eigene Domain, 3 API-Keys. Pro: unbegrenzt. Business: unbegrenzt + Team Login.

Was bedeutet die Domain-Verifizierung?

Beim Anlegen einer eigenen Domain ruft der Service mit dem angegebenen Token den DNS-Provider auf und prüft, ob die Zone existiert und der Token Zugriff darauf hat. Ist das erfolgreich, gilt die Domain als verifiziert und kann sofort genutzt werden.

Wie aktiviere ich Zwei-Faktor-Authentifizierung?

Unter Einstellungen → Zwei-Faktor-Authentifizierung. Beim Setup zeigt der Service einen QR-Code, den du mit Google Authenticator, Authy, Bitwarden oder 1Password scannst. Bei Aktivierung bekommst du 8 einmalig benutzbare Backup-Codes für den Notfall — sicher speichern. API-Keys für /nic/update sind von 2FA nicht betroffen — Router brauchen weiter nur E-Mail + API-Key.