IONOS-DDNS

🌐 IONOS DynDNS Dual-Stack (Go)

Ein hochperformanter, in Go geschriebener Dynamic DNS Client für IONOS. Optimiert für moderne Dual-Stack Anschlüsse (IPv4 & IPv6) mit integriertem Web-Dashboard.

✨ Highlights

• Web-Dashboard: Behalte deine IP-Historie, API-Performance und System-Logs in Echtzeit via WebSockets im Blick.
• Dual-Stack Ready: Gleichzeitige Aktualisierung von A (IPv4) und AAAA (IPv6) Records.
• Intelligente Erkennung: Erkennt IPv6-Adressen direkt am Interface oder über externe DNS-Validierung.
• Parallele Verarbeitung: Schnelle Updates durch Go-Routines mit einstellbarem Worker-Limit (ideal für viele Subdomains).
• Multi-Architektur: Native Unterstützung für amd64 und arm64 (perfekt für Raspberry Pi, NAS & Server).
• Robust: Automatisches Retrying bei API-Fehlern und ordnungsgemäßes Beenden (Graceful Shutdown).

🚀 Quick Start (Docker Compose)

services:
  ionos-ddns:
    image: crazyus3r/ionos-ddns:latest
    container_name: ionos-ddns
    environment:
      - API_PREFIX=dein_ionos_prefix
      - API_SECRET=dein_ionos_secret
      - DOMAINS=meine-domain.de,sub.andere-domain.com
      - IP_MODE=BOTH # IPV4, IPV6 oder BOTH
    ports:
      - "8080:8080" # Dashboard & Healthcheck
    volumes:
      - ./config:/config # Speichert Logs, Historie und Übersetzungen
    restart: unless-stopped

🛠 Konfiguration (Umgebungsvariablen)

Example DOMAINS_CONFIG Multi-Provider

DOMAINS_CONFIG=[{"fqdn": "domainA, subdomainA, domainB","provider": "IPV64","ipv64_token": "${IPV64_TOKEN}"},{"fqdn": "domainA, subdomainA, domainB","provider": "IONOS","API_PREFIX": "${API_PREFIX}", "API_SECRET": "${API_SECRET}"}]

📊 Dashboard & Monitoring

​Das Dashboard ist unter http://server-ip:8080 erreichbar. Es zeigt den aktuellen Status der API-Verbindung, die Performance-Metriken und ein Echtzeit-Log der Systemereignisse.

​Logs & Historie

​Das Tool nutzt das Verzeichnis /config (im Docker-Container) zur Speicherung: ​/config/logs/dyndns.json: Detailliertes Ereignis-Log im JSON-Format. ​/config/logs/update.json: Kompakte Historie deiner IP-Wechsel pro Domain.

​Beispiel update.json:

{
  "meine-domain.de": {
    "ips": [
      {
        "time": "18.01.2026 13:22:00",
        "ipv4": "x.x.x.x",
        "ipv6": "x:x:x:x:248:1893:25c8:1946"
      }
    ]
  }
}

🏗 Manuelle Installation (Binaries)

​Du kannst die vorkompilierten Binaries für Linux (AMD64/ARM64) und Windows direkt aus den GitHub Releases herunterladen.

1. ​Lade die passende Datei für dein System herunter.
2. ​Setze die Umgebungsvariablen (z. B. via .env Datei oder export).
3. ​Starte das Programm: ./ionos-ddns

​🔐 API-Keys erstellen

​Logge dich in die IONOS Developer Konsole ein. ​Erstelle einen neuen Key (Typ: Public). ​Kopiere das Prefix und das Secret in deine Konfiguration.

​⚖️ Lizenz

​Dieses Projekt ist unter der MIT-Lizenz lizenziert.