Eigener DynDNS auf Netcup-vServer mit API

DynDNS-Dienst für Netcup-Server mit der Netcup DNS-API

Netcup stellt für Abfragen und Änderungen der DNS-Daten eine API zur Verfügung. Lars-Sören Steck hat auf Github Code veröffentlich, der auf Clients ausgeführt werden kann und mit der API dynamische DNS-Einträge aktualisiert.

Ich habe das Repository mit meinem bisherigen Code zu einem DynDNS-Server für Netcup verwurstelt.

Funktion

Clients werden authentifiziert, im Erfolgsfall wird der DNS A-Record für hostname1.ddns in der Domäne example.com mit der Netcup-API aktualisiert (Bisher nur IPv4).

Voraussetzungen

• Einen eigenen Server bei Netcup, Shell-Zugang wäre toll
• Eine Domain, deren DNS-Verwaltung im Netcup CCP vorgenommen wird (kein externer NS)
• Apache Webserver mit PHP
• Apache mod_rewrite oder mod_alias für DynDNS-kompatible URLs (/nic/update?...)

Ich gehe davon aus, dass man – sofern man einen eigenen vServer besitzt – auch über die nötigen Kenntnisse im Umgang mit PHP, Apache, DNS-Einträgen und der Shell hat.

Installation

• DNS für example.com einrichten
• Eine Subdomain für den DynDNS einrichten, z.B. ddns.example.com, A-Eintrag oder CNAME für example.com
• einen Apache VHost für ddns.example.com einrichten, HTTPS ausdrücklich empfohlen
• Einen Key und ein Passwort für die Netcup DNS-API erstellen
• Das Archiv in den Ordner des VHosts entpacken.
• Die Ordner data und log für den Apache-User (meist www-data, Gruppe www-data) schreibbar machen
• Einstellungen vornehmen

Konfiguration

Bearbeiten von include/config.php, mindestens:

CUSTOMERNR     Netcup-Kundennummer
APIKEY         API-Key
APIPASSWORD    API-Passwort
DOMAIN         Domain mit von Netcup verwaltetem DNS, Beispiel 'example.com'
DDNS_ZONE      Subdomain von DOMAIN, die für den DynDNS-Server verwendet wird, Beispiel 'ddns'
DEBUG          true für gesprächige Ausgaben im Logfile, false für nur das Wichtigste

Bearbeiten von include/users.php:

$known_clients['hostname1'] = 'password1';
$known_clients['hostname2'] = 'password2';
...

Die User hostname1/hostname2 für die Hosts hostname1.ddns.example.com bzw. hostname2.ddns.example.com mit den Passwörtern password1/password2 sind somit aktiv.

Tests mit einem Browser

Ohne Authentifizierung wird die IP des Clients angezeigt:

• https://ddns.example.com/

Einfache Update-URL:

• https://ddns.example.com/?name=hostname1&pass=password1

DynDNS-kompatible URL:

• https://ddns.example.com/nic/update?name=hostname1&pass=password1
• https://ddns.example.com/nic/update?hostname=hostname1&pass=password1

Kürzeste URL:

• https://hostname1:password1@ddns.example.com

Beispiel: AVM FRITZ!Box

Eine FRITZ!Box funktioniert mit "Benutzerdefiniert" als DynDNS-Anbieter und folgenden Einstellungen:

Dies wird ausgewertet zu:

• https://[benutzername]:[passwort]@ddns.example.com/?hostname=<benutzername>&pass=<passwort>&hostname=<domainname>&myip=<ipaddr>

Beispiel: cURL

Eine simple Kommandozeile für einen Cronjob auf einem Client:

curl -v -s "https://hostname1:password1@ddns.example.com"

Beispiel: WGET

wget --http-user=hostname1 --http-passwd=password1 --no-check-certificate https://ddns.example.com

Server-Antworten

Die Antworten sind weitestgehend an den DynDNS-Standard (https://www.noip.com/integrate/response) angepasst:

• good IP_ADDRESS: Host aktualisiert
• nochg IP_ADDRESS: Keine Änderung seit letztem Update
• badauth: Benutzer und/oder Passwort ungültig
• 911: Interner Serverfehler (HTTP 500, IP-Datei nicht schreibbar, API-Fehler, etc.)

Nginx-Proxy

Hinter einem Nginx als Proxy ist $_SERVER['REMOTE_ADDR'] eventuell leer: In diesem Fall muss in include/functions.php in Zeile 9 stattdessen $_SERVER['HTTP_X_REAL_IP'] verwendet werden.

   // IP des HTTP-Clients verwenden
   //define("CLIENT_IP", $_SERVER['REMOTE_ADDR']);
   define("CLIENT_IP", $_SERVER['HTTP_X_REAL_IP']);

oder alternativ muss Nginx REMOTE_ADDR bereitstellen:

fastcgi_param  REMOTE_ADDR        $remote_addr;

beziehungsweise

fastcgi_param  REMOTE_ADDR        $http_x_real_ip;

Download

Version 0.1 vom 14.04.2020: nc_ddns_master.tar.bz2

31 andere Seiten unter 'Computer und Netzwerk'

• API für MAC-Adressen Hersteller (Älter als 730 Tage) - 01.02.2015
• Automatischer Proxy im Netzwerk mit PAC/WPAD (Älter als 730 Tage) - 09.11.2018
• Autoritativer DNS-Server mit dnsmasq (Älter als 730 Tage) - 10.02.2016
• Eigener DynDNS mit Bind, Apache und PHP (Älter als 730 Tage) - 03.03.2015
• Eigener DynDNS mit dnsmasq, Apache und PHP (Älter als 730 Tage) - 08.02.2016
• Freecom Musicpal Webradio (Älter als 730 Tage) (Mit 6 Unterseiten) - 29.03.2011
• Fujitsu Esprimo X923 Innereien (Älter als 730 Tage) - 30.10.2018
• Grav-Codeschnipsel: Mindesthaltbarkeitsdatum - 27.03.2021
• Grav-Plugin "File Exists" - 26.03.2021
• HP ProLiant Microserver N36L (Älter als 730 Tage) (Mit 2 Unterseiten) - 12.10.2011
• HTML5-Canvas mit Partikeln und Hintergrundbild - 28.04.2021
• Hunsn RM02 Firewall-Appliance (Mit 4 Unterseiten) - 03.04.2021
• Internetverbindung, Router und Hausnetz (Älter als 730 Tage) - 22.10.2018
• Keine Treiber-Installation unter Windows 8.1 möglich (Älter als 730 Tage) - 30.03.2020
• Lenovo A600 Innereien (Älter als 730 Tage) - 08.04.2011
• Live-Anzeige von Logdateien mit Websocket, Apache/Nginx und Javascript - 23.04.2021
• LoRaWAN-Gateway in 90518 Altdorf (Älter als 730 Tage) - 24.01.2020
• M740AV PHP-Skript (Älter als 730 Tage) - 31.10.2007
• OPNsense-Router: Durchsatz mit PC Engines APU-Board - 31.03.2021
• Prism WLAN-Karten für WPA flashen (Älter als 730 Tage) - 08.07.2006
• SSH auf Linksys/Belkin Access Points aktivieren (Älter als 730 Tage) - 23.02.2015
• Thinkpad T61 - WWAN/UMTS nachrüsten (Älter als 730 Tage) - 25.02.2011
• Time Capsule Elkos tauschen (Älter als 730 Tage) - 13.12.2012
• TP-Link CPE210 Umbau auf Rundstrahler (Älter als 730 Tage) - 25.09.2015
• TTL-seriell-Kabel für Router, NAS und anderes (Älter als 730 Tage) - 29.10.2010
• TTL-USB-Kabel für Router, NAS und anderes (Älter als 730 Tage) - 29.10.2010
• TTNMapper-Node mit Heltec "SX1276 Lora ESP32 v2" (Älter als 730 Tage) - 28.01.2020
• TTNMapper-Node mit TTGO "T-Beam Board v10" (Älter als 730 Tage) - 06.02.2020
• VMware ESXi 5.0 Server (Älter als 730 Tage) - 23.02.2012
• WaveShare SpotPear 3.2 Zoll LCD am Raspberry Pi (Älter als 730 Tage) - 11.02.2015
• Windows-Update komplett resetten (Älter als 730 Tage) - 30.10.2018