====== DynDNS ======

===== Einführung =====
----

DynDNS (Dynamic DNS) ist ein Dienst, der es ermöglicht, einen festen Domainnamen mit einer sich ändernden IP-Adresse zu verknüpfen. Das ist praktisch, wenn man auf Geräte oder Server in einem Netzwerk mit dynamischer IP-Adresse (z. B. bei Heimanschlüssen) zugreifen möchte. Der Dienst aktualisiert automatisch den DNS-Eintrag, sobald sich die öffentliche IP-Adresse ändert, sodass der Domainname immer erreichbar bleibt.

----

===== Update über den Router =====

----
FIXME
----

==== AVM Fritz!Box ====

----
FIXME
----

==== Ubiquiti: UniFi ====

----
FIXME
----

===== Update mit ddclient (Linux Server) =====

[[https://ddclient.net/|ddclient]] \\
[[https://github.com/ddclient/ddclient|GitHub]] \\

ddclient ist ein Open-Source-Dienstprogramm, das verwendet wird, um Dynamic DNS (DDNS)-Einträge zu aktualisieren. Es wird hauptsächlich genutzt, um eine Domain mit einer dynamischen IP-Adresse zu verknüpfen. Dies ist besonders hilfreich für Nutzer, die keine statische IP-Adresse haben (wie sie oft von Internetanbietern für Privatanschlüsse bereitgestellt wird), aber dennoch von außen auf ihre Geräte oder Netzwerke zugreifen möchten.
\\
===== Installation ddclient =====



==== Schritt 1: Installation von ddclient ====

=== System aktualisieren ===
<code>
sudo apt update && sudo apt upgrade -y
</code>

=== ddclient installieren ===
<code>
sudo apt install ddclient -y
</code>

=== Installation prüfen ===
<code>
ddclient --version
</code>

----

==== Schritt 2: Konfiguration von ddclient ====

=== Konfigurationsdatei öffnen ===
Die Hauptkonfigurationsdatei befindet sich unter <code>/etc/ddclient.conf</code>.
<code>
sudo nano /etc/ddclient.conf
</code>

=== Inhalt der Datei anpassen ===
Beispiel für Strato (Dynamic DNS):
<code>
daemon=300                         # Aktualisierungsintervall in Sekunden
syslog=yes                         # Logs in syslog speichern
mail=root                          # Mail bei Problemen an root senden
mail-failure=root                  # Fehlerberichte an root senden
pid=/var/run/ddclient.pid          # Speicherort der PID-Datei
ssl=yes                            # SSL-Verschlüsselung verwenden
use=web                            # Öffentliche IP von einer Webquelle abrufen
web=checkip.dyndns.com/            # Webseite zur Abfrage der öffentlichen IP
web-skip=IP Address                # Textmuster, um die IP-Adresse zu extrahieren
server=dyndns.strato.com           # Strato-DNS-Server
protocol=dyndns2                   # Protokolltyp
login=deine_domain.de              # Benutzername (Domainname)
password='dein_passwort'           # Passwort für die Strato-DNS-Verwaltung
deine_domain.de                    # Die zu aktualisierende Domain
</code>

=== Datei speichern und schließen ===
Drücke <code>Ctrl + O</code>, dann <code>Enter</code>, um zu speichern, und <code>Ctrl + X</code>, um den Editor zu schließen.

----

==== Schritt 3: Cache zurücksetzen (optional) ====
Falls Änderungen an der Konfiguration vorgenommen wurden, sollte der Cache geleert werden:
<code>
sudo rm -f /var/cache/ddclient/ddclient.cache
</code>

----

==== Schritt 4: Dienst aktivieren und starten ====

=== ddclient als Dienst starten ===
<code>
sudo systemctl enable ddclient
sudo systemctl start ddclient
</code>

=== Status überprüfen ===
<code>
sudo systemctl status ddclient
</code>

----

==== Schritt 5: Testlauf durchführen ====
Du kannst <code>ddclient</code> manuell im Debug-Modus ausführen, um sicherzustellen, dass alles korrekt funktioniert:
<code>
sudo ddclient -daemon=0 -debug -verbose -noquiet
</code>

----

==== Schritt 6: Logs überprüfen ====
Wenn Probleme auftreten, überprüfe die Logs:
<code>
sudo tail -f /var/log/syslog
</code>

----

==== Schritt 7: Anpassung der Web-IP-Abfrage (optional) ====
Falls du die öffentliche IP nicht von einer Webquelle wie <code>checkip.dyndns.com</code> abrufen möchtest, kannst du:

- **Einen anderen Webdienst angeben:** Passe die Zeile <code>web=...</code> in der Konfiguration an.
- **Die IP vom Router abrufen:** Verwende <code>use=cmd</code> und ein benutzerdefiniertes Skript, um die IP direkt vom Router abzurufen. FIXME Anleitung folgt!

----

Mit dieser Anleitung sollte <code>ddclient</code> korrekt installiert und eingerichtet sein.



===== Konfiguration / Befehle=====

<code | ddclient Config>
sudo nano /etc/ddclient.conf
</code>

<code | ddclient Neustart>
sudo service ddclient restart
</code>

<code | Update erzwingen mit Debug Ausgabe>
sudo ddclient -daemon=0 -debug -verbose -noquiet -force
</code>
\\
=== STRATO Config ===


<code | Config für STRATO>
# Configuration file for ddclient generated by debconf
# Pfad: /etc/ddclient.conf

# Interval in Sekunden, in dem ddclient ausgeführt wird, um die IP-Adresse zu überprüfen und zu aktualisieren
daemon=300  # Alle 5 Minuten

# Schreibe Ereignisse in das Systemlog (/var/log/syslog)
syslog=yes

# E-Mail-Benachrichtigungen senden (Standardempfänger ist "root")
mail=root  # Sende allgemeine Benachrichtigungen an den root-Benutzer
mail-failure=root  # Sende Fehlerbenachrichtigungen ebenfalls an root

# Speicherort für die PID-Datei, um sicherzustellen, dass nicht mehrere Instanzen von ddclient laufen
pid=/var/run/ddclient.pid

# Aktiviere SSL/TLS für sichere Verbindungen
ssl=yes

# Methode zur Ermittlung der externen IP-Adresse
use=web                            # Hole die öffentliche IP-Adresse von einem Webdienst (Standard: checkip.dyndns.com)
web=checkip.dyndns.com/            # Webseite zur Abfrage der öffentlichen IP
web-skip=IP Address                # Textmuster, um die IP-Adresse zu extrahieren

# DynDNS-Server, der aktualisiert werden soll
server=dyndns.strato.com  # DynDNS-Server von Strato

# Verwendetes Protokoll für den DynDNS-Server
protocol=dyndns2  # DynDNS2-Protokoll für die Kommunikation mit Strato

# Anmeldedaten für den DynDNS-Server
login=domain.de  # Benutzername (oft die Domain)
password='password'  # Passwort für die Authentifizierung (achte auf Anführungszeichen bei Sonderzeichen)

# Hostname, der aktualisiert werden soll
subdomain.domain.de  # Die spezifische Domoin und/oder Subdomain, die beim DynDNS-Dienst aktualisiert werden soll

</code>