0 Votes

DuckDNS

Modifié par john le 2026/09/19 18:12

Mise à jour du DNS dynamique : maintient le nom de domaine DuckDNS pointé vers l'IP publique de la box, qui peut changer.

Fonctionnement

Toutes les 5 minutes environ, le conteneur interroge DuckDNS, qui détecte l'IP publique (IPv4 uniquement) et met à jour le domaine si elle a changé.

Deux services utilisent le même jeton DuckDNS, pour deux rôles distincts :

ServiceRôle du jeton
DuckDNS (ce conteneur)Mettre à jour l'IP du domaine
SWAGValider le certificat wildcard Let's Encrypt par DNS (DUCKDNSTOKEN)

Si le jeton est régénéré sur le site de DuckDNS, le changer aux deux endroits.

Déploiement

Déployé depuis les modèles d'applications de Portainer (voir la section Portainer de Serveur principal). Configuration relevée avec docker inspect :

ÉlémentValeur
Conteneurduckdns
Imagelinuxserver/duckdns:latest
Réseaubridge
VolumesAucun
VariablesSUBDOMAINS=<DOMAINE>, TOKEN=<JETON>, TZ=Europe/Paris
  • La documentation demande le seul sous-domaine dans SUBDOMAINS (user pour user.duckdns.org) ; le domaine complet est accepté aussi.
  • Sans UPDATE_IP, la détection de l'IP passe par DuckDNS lui-même. Avec UPDATE_IP (ipv4, ipv6 ou both), elle passe par le service whoami de Cloudflare.

Vérifier

docker logs duckdns --tail 10

Chaque passage doit afficher successful, suivi de IP(s) unchanged ou de la nouvelle adresse.

Sauvegarde

Aucune donnée persistante : rien à sauvegarder. Le jeton se retrouve sur le tableau de bord du site DuckDNS.