ddns-ipv64

ddns-ipv64

Docker app from Selfhosters

Overview

This Docker container is a DDNS updater for Free DynDNS - ipv64.net. If the ipv4 address at the site is changed, the new ipv4 address is sent to ipv64.net as an A-Record.

Readme

View on GitHub

docker-ddns-ipv64

Build Status Build Status Branch Master Docker Pulls Docker Image Version (latest semver) Website

 

DDNS Updater in Docker für DynDNS IPv64.net

Dieser Docker-Container ist ein DDNS-Updater für den DynDNS-Dienst von ipv64.net.
Bei einer Änderung der IPv4- oder IPv6-Adresse am Standort wird die neue Adresse automatisch als A- bzw. AAAA-Record an ipv64.net übermittelt.

Wenn Du dieses Docker-Projekt nutzen möchtest, passe bitte vor dem Start des Containers die Environment-Variablen entsprechend an.  

Nutzer von DS-Lite-Anschlüssen sollten beachten, dass in solchen Umgebungen oft keine echte öffentliche IPv4-Adresse verfügbar ist;
in diesem Fall kann es erforderlich sein, die IPv4-Aktualisierung zu deaktivieren, indem die Variable IPV4_ENABLED=no gesetzt wird.

 

Danke geht an :pray: @lodzen für die Unterstützung bei dem code für ipv6.

Erklärung

Domain

  • Hier bitte deine DOMAIN eintragen (ersetzen), die unter https://ipv64.net/dyndns erstellt wurde, z.B "deine-domain.ipv64.net"

    -e "DOMAIN_IPV64=deine-domain.ipv64.net"

  • Wenn Du mehrere DOMAINS eintragen willst, bitte mit Komma trennen:

    -e "DOMAIN_IPV64=deine-domain.ipv64.net,deine-domain.ipv64.de"

    💹 Hinweis: Wenn mehrere Domains verwendet werden, dann den Account Key bei DOMAIN_KEY= eintragen.

 

Domain Praefix

  • Wenn Du einen DOMAIN PRAEFIX verwenden willst, dann benutze die Variablen DOMAIN_PRAEFIX_YES=yes und DOMAIN_PRAEFIX

    -e "DOMAIN_PRAEFIX_YES=yes"

  • Hier bitte nur ein DOMAIN PRAEFIX (subdomain) eintragen (ersetzen), das unter https://ipv64.net/dyndns erstellt wurde:

    -e "DOMAIN_PRAEFIX=ddns"

⚠️ Solltest Du mehrere DOMAINS verwenden, dann bitte nur ein PRAEFIX eintragen (ersetzen) ⚠️

Bei mehreren Domains wird immer derselbe PRAEFIX verwendet.

Beispiel: ddns.deine-domain.ipv64.net und ddns.deine-domain.ipv64.de

 

Domain Key

  • Hier bitte dein DOMAIN KEY bzw. DynDNS Updatehash eintragen (ersetzen).
    Zu finden ist dieser unter https://ipv64.net/dyndns z.B "1234567890abcdefghijklmnopqrstuvwxyz"

    -e "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz"

    Sie können auch die Domain Update-URL oder Account Update-URL nutzen.
    Update-URL
    -e "DOMAIN_KEY=https://ipv64.net/nic/update?key=1234567890abcdefghijklmnopqrstuvwxyz"
    Account Update-URL
    -e "DOMAIN_KEY=https://ipv64.net/nic/update?key=1234567890abcdefghijklmnopqrstuvwxyz&domain=deine-domain.ipv64.net"

     

    Account Key oder Domain Key

    Account Key oder Domain Key

 

Docker CLI

docker run -d \
    --restart always \
    --name ddns-ipv64 \
    -e "TZ=Europe/Berlin" \
    -e "CRON_TIME=*/15 * * * *" \
    -e "CRON_TIME_DIG=*/30 * * * *" \
    -e "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz" \
    -e "DOMAIN_IPV64=deine-domain.ipv64.net" \
    alcapone1933/ddns-ipv64:latest

# Erweiterte Optionen (optional):
#    -e "DOMAIN_IPV64=deine-domain.ipv64.net,deine-domain.ipv64.de" \
#    -e "DOMAIN_PRAEFIX_YES=yes" \
#    -e "DOMAIN_PRAEFIX=ddns" \
#    -e "IPV4_ENABLED=yes" \
#    -e "IPV6_ENABLED=no" \
#    -e "IP_CHECK=yes" \
#    -e "SHOUTRRR_URL=" \
#    -e "SHOUTRRR_SKIP_TEST=no" \
#    -e "NAME_SERVER=ns1.ipv64.net" \
#    -e "NETWORK_CHECK=yes" \
#    -e "CURL_USER_AGENT=DDNS-Updater-IPv64_github.com/alcapone1933/docker-ddns-ipv64_version_v0.1.10" \
#    -e "MAX_FILES=10" \
#    -e "MAX_LINES=1000" \
#    -e "PUID=1000" \
#    -e "PGID=1000" \

Docker Compose

services:
  ddns-ipv64:
    image: alcapone1933/ddns-ipv64:latest
    container_name: ddns-ipv64
    restart: unless-stopped
    environment:
      - "TZ=Europe/Berlin"
      - "CRON_TIME=*/15 * * * *"
      - "CRON_TIME_DIG=*/30 * * * *"
      - "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz"
      - "DOMAIN_IPV64=deine-domain.ipv64.net"
      # Erweiterte Optionen (optional):
      # - "DOMAIN_IPV64=deine-domain.ipv64.net,deine-domain.ipv64.de"
      # - "DOMAIN_PRAEFIX_YES=yes"
      # ⚠️ Hier bitte nur ein DOMAIN PRAEFIX (subdomain) eintragen (ersetzen) ⚠️
      # - "DOMAIN_PRAEFIX=ddns"
      # IPv4/IPv6 Kontrolle:
      # - "IPV4_ENABLED=yes"
      # - "IPV6_ENABLED=no"
      # Weitere Optionen:
      # - "IP_CHECK=yes"
      # - "SHOUTRRR_URL="
      # - "SHOUTRRR_SKIP_TEST=no"
      # - "NAME_SERVER=ns1.ipv64.net"
      # - "NETWORK_CHECK=yes"
      # - "CURL_USER_AGENT=DDNS-Updater-IPv64_github.com/alcapone1933/docker-ddns-ipv64_version_v0.1.10"
      # Log-Rotation:
      # - "MAX_FILES=10"
      # - "MAX_LINES=1000"
      # Benutzer-/Gruppen-IDs:
      # - "PUID=1000"
      # - "PGID=1000"

 

IPv6 Netzwerk in Docker einrichten

Hier Klicken

Für die vollständige Unterstützung von IPv6 in Docker müssen zusätzliche Konfigurationsschritte durchgeführt werden:

1. Docker Daemon für IPv6 konfigurieren

Erstelle oder bearbeite die Datei /etc/docker/daemon.json:

{
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:1::/64",
  "experimental": true,
  "ip6tables": true
}

2. Docker Service neustarten

Nach der Konfiguration muss der Docker-Dienst neugestartet werden:

sudo systemctl restart docker

3. Container mit IPv6-Netzwerk starten

Verwende das erstellte Netzwerk beim Starten des Containers:

docker run -d \
    --restart always \
    --name ddns-ipv64 \
    --network_mode bridge \
    -e "CRON_TIME=*/15 * * * *" \
    -e "CRON_TIME_DIG=*/30 * * * *" \
    -e "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz" \
    -e "DOMAIN_IPV64=deine-domain.ipv64.net" \
    -e "IPV4_ENABLED=yes" \
    -e "IPV6_ENABLED=yes" \
    alcapone1933/ddns-ipv64:latest

4. Docker Compose mit IPv6

Für Docker Compose füge die Netzwerk-Konfiguration hinzu:

services:
  ddns-ipv64:
    image: alcapone1933/ddns-ipv64:latest
    container_name: ddns-ipv64
    restart: unless-stopped
    network_mode: bridge
    environment:
      - "TZ=Europe/Berlin"
      - "CRON_TIME=*/15 * * * *"
      - "CRON_TIME_DIG=*/30 * * * *"
      - "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz"
      - "DOMAIN_IPV64=deine-domain.ipv64.net"
      - "IPV4_ENABLED=yes"
      - "IPV6_ENABLED=yes"

⚠️ Wichtige Hinweise:

  • Nach Änderungen an der daemon.json muss Docker immer neugestartet werden.
  • Stelle sicher, dass dein Host-System IPv6-Konnektivität hat.

Alternative: IPv6 nutzen ohne Änderungen an daemon.json

Wenn du den Docker-Daemon nicht global auf IPv6 umstellen möchtest, kannst du ein eigenes IPv6-fähiges Docker-Netzwerk erstellen. Dies funktioniert sowohl mit Docker-CLI als auch mit Docker-Compose.

Variante A: Docker CLI

Zuerst ein dediziertes IPv6-Netzwerk anlegen und anschließend den Container darin starten:

docker network create \
  --ipv6 \
  --subnet "2001:db8:1::/64" \
  ddns-ipv64-net

docker run -d \
  --restart always \
  --name ddns-ipv64 \
  --network ddns-ipv64-net \
  -e "CRON_TIME=*/15 * * * *" \
  -e "CRON_TIME_DIG=*/30 * * * *" \
  -e "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz" \
  -e "DOMAIN_IPV64=deine-domain.ipv64.net" \
  -e "IPV4_ENABLED=yes" \
  -e "IPV6_ENABLED=yes" \
  alcapone1933/ddns-ipv64:latest

Variante B: Docker-Compose

services:
  ddns-ipv64:
    image: alcapone1933/ddns-ipv64:latest
    container_name: ddns-ipv64
    restart: unless-stopped
    environment:
      - "TZ=Europe/Berlin"
      - "CRON_TIME=*/15 * * * *"
      - "CRON_TIME_DIG=*/30 * * * *"
      - "DOMAIN_KEY=1234567890abcdefghijklmnopqrstuvwxyz"
      - "DOMAIN_IPV64=deine-domain.ipv64.net"
      - "IPV4_ENABLED=yes"
      - "IPV6_ENABLED=yes"
    networks:
      - ddns-ipv64-net
networks:
  ddns-ipv64-net:
    name: ddns-ipv64-net
    driver: bridge
    enable_ipv6: true
    ipam:
      driver: default
      config:
        - subnet: "2001:db8:1::/64"

Damit erhält der Container eine IPv6-Adresse, ohne dass systemweit IPv6 im Docker-Daemon aktiviert werden muss.

Volume Parameter

Name (Beschreibung) #Optional Wert Standard
Speicherort logs volume ddns-ipv64_data:/data
/dein Pfad:/data

 

Env Parameter

Name (Beschreibung) Wert Standard Beispiel
Zeitzone TZ Europe/Berlin Europe/Berlin
Zeitliche Abfrage für die aktuelle IP CRON_TIME */15 * * * * */15 * * * *
Zeitliche Abfrage auf die Domain (dig DOMAIN_IPV64 A) CRON_TIME_DIG */30 * * * * */30 * * * *
DOMAIN KEY: DEIN DOMAIN KEY bzw. DynDNS Updatehash zu finden unter https://ipv64.net/dyndns DOMAIN_KEY ------------------ 1234567890abcdefghijklmnopqrstuvwxyz
DOMAIN KEY: Sie können auch die Domain Update-URL oder Account Update-URL nutzen DOMAIN_KEY ------------------ https://ipv64.net/nic/update?key=1234567890a
DEINE DOMAIN: z.b. deine-domain.ipv64.net zu finden unter https://ipv64.net/dyndns DOMAIN_IPV64 ------------------ deine-domain.ipv64.net
DEINE DOMAINS: z.b. deine-domain.ipv64.net, deine-domain.ipv64.de DOMAIN_IPV64 ------------------ deine-domain.ipv64.net,deine-domain.ipv64.de
DOMAIN PRAEFIX YES: Damit wird das Domain PRAEFIX aktiv genutzt DOMAIN_PRAEFIX_YES no yes (yes oder no)
DEIN DOMAIN PRAEFIX (subdomain): ⚠️ Nur ein Praefix verwenden ⚠️ z.b. ddns DOMAIN_PRAEFIX ------------------ ddns
IP CHECK: Die IP-Adresse der Domain wird überprüft IP_CHECK yes yes (yes oder no)
SHOUTRRR URL: Deine Shoutrrr URL als Benachrichtigungsdienst z.b ( gotify,discord,telegram,email) SHOUTRRR_URL ------------------ Shoutrrr-Beispiele
SHOUTRRR SKIP TEST: Beim Start des Containers wird keine Testnachricht gesendet SHOUTRRR_SKIP_TEST no no (yes oder no)
NAME SERVER: Der Nameserver, um die IP-Adresse Ihrer Domain zu überprüfen NAME_SERVER ns1.ipv64.net ns1.ipv64.net (ns2.ipv64.net zb. 1.1.1.1)
NETWORK CHECK: Es wird die Verbidung zu ipv64.net getestet NETWORK_CHECK yes yes (yes oder no)
PUID: Rechte für Benutzer-ID des Ornder /data im Container PUID 0 1000
PGID: Rechte für Gruppen-ID des Ornder /data im Container PGID 0 1000
IPV4_ENABLED: Wenn aktiviert, wird die öffentliche IPv4-Adresse an ipv64.net gesendet IPV4_ENABLED yes yes (yes oder no)
IPV6_ENABLED: Wenn aktiviert, wird die öffentliche IPv6-Adresse an ipv64.net gesendet IPV6_ENABLED no no (yes oder no)

 

Shoutrrr Beispiele

Die Nachricht wird fest vom Script erstellt.
Sie können den Betreff (titel) frei wählen wie im Beispiel genannt.
So könnte die Nachricht ausehen.

Betreff:   DDNS IPV64 IP UPDATE
# Die Nachricht wird fest vom Script erstellt.
Nachricht: DOCKER DDNS UPDATER IPV64.NET - IP UPDATE !!!
           DATUM  UPDATE !!! 
           Update IP=IP - Alte-IP=IP
           DOMAIN: DOMAIN

----------------------------------------------------------
Nachricht: DOCKER DDNS UPDATER IPV64.NET - IP UPDATE !!!
           2022-12-27 14:40:59  UPDATE !!!
           Update IP=1.0.0.1 - Alte-IP=1.1.1.1
           DOMAIN: deine-domain.ipv64.net

Nachricht: DOCKER DDNS UPDATER IPV64.NET - IP UPDATE !!!
           2022-12-27 14:40:59  UPDATE !!!
           Update IP=1.0.0.1 - Alte-IP=1.1.1.1
           DOMAIN mit PRAEFIX: ddnd.deine-domain.ipv64.net

Das sind Beispiele für Shoutrrr als Benachrichtigungsdienst, für weitere Services infos fidetest du hier Shoutrrr

Service Name URL Beispiel
gotify gotify://<url domain.de>/<token>/?title=<title>&priority=<priority>
discord discord://<token>@<webhook id>?title=<title>
telegram telegram://<token>@telegram/?chats=<chad_id>&title=<title>
smtp (email) smtp://<username>:<password>@<host>:<port>/?from=<sender_email>&to=<to_email>&subject=<subject>
Service Name URL Beispiel (Beispiel text)
gotify gotify://domain.de/123456abc/?title=DDNS+IPV64+IP+UPDATE&priority=5
discord discord://123456abc@555555555555555?title=DDNS+IPV64+IP+UPDATE
telegram telegram://1111111111:123456abc@telegram/?chats=5555555555&title=DDNS+IPV64+IP+UPDATE
smtp (email) smtp://noreply@domain.de:password@mail.domain.de:587/?from=noreply@domain.de&to=user@domain.de&subject=DDNS+IPV64+IP+UPDATE

 

Du kannst die Shoutrrr URL auch generieren lassen

# $ docker run --rm -it alcapone1933/shoutrrr generate
#Error: no service specified
#Usage:
#  shoutrrr generate [flags]
#
#Flags:
#  -g, --generator string       The generator to use (default "basic")
#  -h, --help                   help for generate
#  -p, --property stringArray   Configuration property in key=value format
#  -s, --service string         The notification service to generate a URL for
#
#Available services:
#  opsgenie, slack, teams, generic, googlechat, join, bark, logger, matrix, discord, mattermost, rocketchat, pushbullet, pushover, smtp, telegram, zulip, gotify, hangouts, ifttt

# docker run --rm -it alcapone1933/shoutrrr generate gotify

docker run --rm -it alcapone1933/shoutrrr generate

# TEST
# $ docker run --rm -it alcapone1933/shoutrrr send --verbose --url "< Shoutrrr URL >" --message "DOCKER DDNS UPDATER IPV64.NET"

docker run --rm -it alcapone1933/shoutrrr send --verbose --url "< Shoutrrr URL >" --message "DOCKER DDNS UPDATER IPV64.NET"
DEMO Shoutrrr URL generieren

 

DEMO

Install ddns-ipv64 on Unraid in a few clicks.

Find ddns-ipv64 in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for ddns-ipv64 Review the template variables and paths Click Install
Explore Unraid OS

Requirements

List of all Parameters that can be configured https://github.com/alcapone1933/docker-ddns-ipv64?tab=readme-ov-file#env-parameter

Categories

Tools > UtilitiesNetwork > DNS

Download Statistics

225,174
Total Downloads
4,249
This Month
11,039
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all
Utilities appsDNS apps

Links

Projectgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
alcapone1933/ddns-ipv64:latest
Registry
https://hub.docker.com/r/alcapone1933/ddns-ipv64
Last Updated2026-03-30
First Seen2024-10-18

Runtime arguments

Network
bridge
Privileged
false

Template configuration

Polling frequency IP addressVariable

Polling frequency of the current IP address

Target
CRON_TIME
Default
*/15 * * * *
Value
*/15 * * * *
Polling frequenz DomainVariable

Polling frequenz for the domain (dig DOMAIN_IPV64 A)

Target
CRON_TIME_DIG
Default
*/30 * * * *
Value
*/30 * * * *
Domain(s) ipv64Variable

YOUR DOMAINS: e.g. your-domain.ipv64.net, your-domain.ipv64.de

Target
DOMAIN_IPV64
Domain KeyVariable

DOMAIN KEY: YOUR DOMAIN KEY or DynDNS update hash can be found at https://ipv64.net/dyndns.php

Target
DOMAIN_KEY
Domain Präfix yes|noVariable

DOMAIN PRAEFIX YES: This means that the domain PRAEFIX is actively used

Target
DOMAIN_PRAEFIX_YES
Default
yes|no
Domain PräfixVariable

YOUR DOMAIN PRAEFIX (subdomain). Use only one prefix (e.g. ddns)

Target
DOMAIN_PRAEFIX
IP checkVariable

IP CHECK: The IP address of the domain is checked

Target
IP_CHECK
Default
yes|no
Shoutrrr URLVariable

SHOUTRRR URL: Your Shoutrrr URL as notification service e.g. ( gotify,discord,telegram,email)

Target
SHOUTRRR_URL
Shoutrrr URL Skip TestVariable

SHOUTRRR_SKIP_TEST: No test message is sent when the container is started

Target
SHOUTRRR_SKIP_TEST
Name ServerVariable

NAME_SERVER: : The name server to check the IP address of your domain

Target
NAME_SERVER
Default
ns1.ipv64.net
Value
ns1.ipv64.net
Location logs and scriptPathrw
Target
/data
Default
/mnt/user/appdata/ddns-ipv64
Value
/mnt/user/appdata/ddns-ipv64