🌐 dyndns-updater

Kleiner Docker-Container, der Cloudflare-A-Records (DNS-only) und eine bestehende FreeDNS-Update-URL mit der aktuellen öffentlichen IPv4-Adresse aktuell hält.

Details siehe SPEC.md (Architektur/Design) und PLAN.md (Umsetzungs-Tasks).

📋 Kurzüberblick

🏠 IP wird ausschließlich über die FritzBox TR-064-Schnittstelle ermittelt (nicht aus Webhook-Parametern übernommen)
⏰ Trigger: Container-Start, GET /webhook/update (kein Auth, rein intern), Fallback-Polling alle 15 Minuten
🔄 DNS-Update (Cloudflare + FreeDNS) nur bei tatsächlicher IP-Änderung
💚 Healthcheck-Heartbeat bei jedem Poll-Zyklus, unabhängig von einer IP-Änderung

🚀 Quickstart

cp .env.example .env
vim .env   # Werte eintragen
docker compose up -d

⚙️ Konfiguration (`.env`)

Alle Einstellungen erfolgen ausschließlich über Umgebungsvariablen (siehe .env.example). Pflichtfelder:

Variable	Zweck
`FRITZBOX_HOST`, `_USER`, `_PASSWORD`	🏠 TR-064-Zugang zur FritzBox (IP-Quelle)
`CLOUDFLARE_API_TOKEN`	☁️ Cloudflare-Token (Zone -> DNS -> Edit)
`CLOUDFLARE_ZONE_ID`	☁️ Cloudflare-Zone
`CLOUDFLARE_RECORDS`	📝 Kommagetrennte A-Record-Namen (DNS-only)

Optional: FREEDNS_UPDATE_URL, POLL_INTERVAL_MINUTES, HEALTHCHECK_PING_URL, TZ, LOG_LEVEL. Die IP kommt ausschließlich aus der FritzBox, nie aus Webhook-Parametern.

📧 E-Mail-Notification (optional)

Bei IP-Änderung wird eine HTML-E-Mail mit Emojis versendet, wenn SMTP-Konfiguration vorliegt:

Variable	Zweck
`SMTP_HOST`	📮 SMTP-Server (z.B. `smtp.gmail.com`)
`SMTP_PORT`	🚪 Port (Default: `587`)
`SMTP_USER`	👤 SMTP-Login
`SMTP_PASSWORD`	🔒 SMTP-Passwort
`NOTIFY_EMAIL_TO`	📬 Empfänger-Adresse
`NOTIFY_EMAIL_FROM`	📤 Absender-Adresse

🔧 Betrieb

💾 State (bewusst ohne Volume, ephemeral): zuletzt bekannte IP liegt als data/last-known-ip.json im Container. Bei jedem neu erstellten Container ist der State wieder leer, wodurch beim Start ein Force-Push erzwungen wird. Die Änderung wird erst nach erfolgreichem Update gespeichert.
🪝 Webhook: GET /webhook/update (kein Auth, intern, Port fest 8090) löst einen Zyklus aus.
💓 Healthz: GET /healthz für den Container-Healthcheck (genutzt vom Docker-HEALTHCHECK).
🏥 Healthchecks: Healthy Ping bei jedem Poll, Failure Ping bei IP-Fehler bzw. Teilfehler.
📊 Logs/Wartung: docker compose logs -f; Updates via Watchtower (Label im Compose).

🧪 Test/Quality

python3 -m venv .venv && . .venv/bin/activate   # virtuelles Umfeld
pip install -r requirements.txt -r requirements-dev.txt
ruff check .
ruff format --check .

🏗️ Build

Wird automatisch per GitHub Actions nach ghcr.io/skoelle/dyndns-updater gebaut (siehe .github/workflows/build-and-push.yml).

3.0 KiB Raw Permalink Blame History