Community-Lösung

DDNS Updater auf ZimaOS installieren

A community member shared a DuckDNS configuration for ddns-updater and later added screenshots showing how to locate, edit, restore, and restart the persistent config.

Was das Community-DDNS-Setup erreichen sollte

Der Community-Beitrag enthielt ein config.json-Beispiel für die Anwendung ddns-updater mit DuckDNS. Die grundlegende Idee ist weiterhin gültig: Der Updater benötigt einen Anbieter, eine Domain, ein Zugangsdaten- oder Token-Feld sowie eine Richtlinie für die IP-Version. Außerdem muss die dauerhafte Konfiguration an einem Ort gespeichert werden, an dem der Container sie nach einem Neustart lesen kann.

Einen aktuellen, auf ZimaOS ausgerichteten Überblick finden Sie im DuckDNS-Hardware- und Einrichtungsleitfaden sowie im aktuellen Verzeichnis der ZimaOS-App-Store-Anforderungen.

Das aktuelle Schema von ddns-updater verwenden

Das Upstream-Projekt dokumentiert die anbieterspezifische Konfiguration. Kopieren Sie daher nicht blind ein altes Beispiel, wenn sich das Schema des Anbieters geändert haben könnte. Die aktuelle DuckDNS-Dokumentation erfordert eine DuckDNS-Domain und ein Token und unterstützt Optionen für die IP-Version. Die maßgebliche Referenz ist die DuckDNS-Dokumentation von ddns-updater. Die README des Hauptprojekts dokumentiert außerdem die unterstützten Anbieter und das Verhalten der dauerhaften Konfiguration in der Projektdokumentation von ddns-updater.

{
  "settings": [
    {
      "provider": "duckdns",
      "domain": "your-name.duckdns.org",
      "token": "YOUR_TOKEN",
      "ip_version": "ipv4"
    }
  ]
}

Ersetzen Sie die Platzhalter durch Ihre eigenen Werte und veröffentlichen Sie niemals das echte Token in Screenshots, Forenbeiträgen, Git-Repositories oder Support-Tickets.

Wo Sie die Konfiguration unter ZimaOS finden

ZimaOS-DDNS-Updater-Appmenü mit Konfigurations- und Neustartoptionen
Community-Screenshot aus dem DDNS-Updater-Tutorial mit dem Appmenü für den Zugriff auf die Einstellungen und den Neustart des Dienstes.
ZimaOS-Dateien-Appsymbol zum Auffinden der DDNS-Updater-Anwendungsdaten
Community-Screenshot der Dateien-App, mit der zur dauerhaften Konfiguration von DDNS Updater navigiert wird.
ZimaOS-Dateienoberfläche mit dem Ordner AppData auf dem Speicherlaufwerk
Community-Screenshot des AppData-Ordners auf dem ZimaOS-Speicherlaufwerk vor dem Öffnen des Datenverzeichnisses von DDNS Updater.
ZimaOS-AppData-Verzeichnis mit hervorgehobenem ddns-updater-Ordner
Community-Screenshot mit dem hervorgehobenen ddns-updater-Ordner in AppData, in dem die dauerhaften Anwendungsdateien gespeichert sind.
ZimaOS-Dateienoberfläche mit der DDNS-Updater-Datei config.json
Community-Screenshot mit der Datei config.json im Datenverzeichnis von DDNS Updater; der ursprüngliche Verfasser empfiehlt, vor der Bearbeitung eine Sicherungskopie zu erstellen.

Im ursprünglichen Thread wurde auf den Pfad appdata/ddns-updater verwiesen. Der genaue Hostpfad kann jedoch davon abhängen, wie die App installiert wurde und wie ihr Speicher eingebunden ist. Anstatt von einem festen Pfad auszugehen, öffnen Sie die App-Einstellungen in ZimaOS und ermitteln Sie das dauerhafte Volume, das dem Konfigurationspfad des Containers zugeordnet ist. Sichern Sie die aktuelle Datei, bevor Sie sie bearbeiten.

So überprüfen Sie die Aktualisierung

  1. Stellen Sie sicher, dass der Container ohne einen JSON-Analysefehler startet.
  2. Prüfen Sie die Updater-Protokolle auf Authentifizierungs- oder Domainfehler des Anbieters.
  3. Lösen Sie den Hostnamen über ein anderes Netzwerk oder einen öffentlichen DNS-Resolver auf.
  4. Vergleichen Sie den zurückgegebenen A- oder AAAA-Eintrag mit Ihrer aktuellen öffentlichen Adresse.
  5. Starten Sie die App einmal neu, um zu bestätigen, dass die Konfiguration dauerhaft gespeichert ist.

DDNS sorgt lediglich dafür, dass ein Hostname auf eine Adresse verweist. Dadurch entsteht nicht automatisch ein sicherer Fernzugriff. Wenn Sie auf einen Heimserver aus der Ferne zugreifen möchten, vergleichen Sie dies mit dem in Zima Client für den Fernzugriff beschriebenen Verbindungsmodell, bevor Sie Dienste direkt erreichbar machen.

Änderungen am Anbieter und IPv6

Wenn Sie Cloudflare oder einen anderen Anbieter verwenden, entfernen Sie die DuckDNS-spezifischen Felder und folgen Sie dem Schema dieses Anbieters. Die aktuelle Cloudflare-Konfiguration verwendet beispielsweise Felder wie eine Zonenkennung und ein API-Token. Die maßgebliche Quelle ist die Dokumentation zum Cloudflare-Anbieter des Upstream-Projekts.

FAQ

Warum fehlt mein Ordner appdata/ddns-updater?

Der dauerhafte Hostpfad kann sich von dem im Community-Beispiel verwendeten Pfad unterscheiden. Prüfen Sie die Volume-Zuordnung der App, anstatt einen vermuteten Systempfad anzulegen.

Kann ich IPv4 und IPv6 verwenden?

Ja, konfigurieren Sie die Option für die IP-Version jedoch entsprechend der aktuellen Dokumentation des Anbieters und bestätigen Sie, dass Ihr Internetanbieter die von Ihnen zu veröffentlichende Adressfamilie tatsächlich bereitstellt.

Ist DDNS dasselbe wie ein VPN?

Nein. DDNS ordnet einen Hostnamen einer wechselnden IP-Adresse zu. Authentifizierung, Verschlüsselung, Firewall-Regeln und das Design des Fernzugriffs sind davon getrennte Aspekte.