Duck DNS : garder un nom fixe sur une IP qui change

Le problème qu’il règle, et rien d’autre

Votre box change d’IP publique à la reconnexion, parfois toutes les 24 heures, et le NAS que vous vouliez joindre depuis le bureau devient injoignable. Duck DNS traite ce seul cas : vous réservez un nom du type nas-maison.duckdns.org, une machine de votre réseau appelle une URL toutes les cinq minutes, et l’enregistrement A suit l’adresse du moment.

Le service est tenu par une poignée de bénévoles et financé par des dons, hébergé sur AWS. Il ne vend pas de nom de domaine, ne gère pas de MX, n’offre aucune interface d’édition de zone : il écrit un A, un AAAA et un TXT pour chacun de vos sous-domaines. C’est ce périmètre étroit qui le rend simple à automatiser.

La mise à jour tient en une requête HTTP GET. Celle-ci, lancée depuis la machine concernée, suffit à repointer le nom sur l’IP vue par le serveur :

curl "https://www.duckdns.org/update?domains=nas-maison&token=VOTRE-TOKEN&ip="

La réponse est un corps de texte de deux caractères, OK ou KO. Pas de JSON, pas de code de retour exploitable.

Mise en place sur un Raspberry Pi ou un NAS

Le parcours est court et ne demande ni carte bancaire ni mot de passe propre au service : la connexion passe par un compte tiers (Google, GitHub, Reddit…).

Le script officiel proposé sur le site utilise l’option curl -k, qui désactive la vérification du certificat TLS. Retirez-la. Sans elle, une interception de la requête permettrait de lire votre token en clair, et votre token vaut mot de passe : quiconque l’obtient repointe votre sous-domaine où il veut, y compris vers un serveur qui collectera vos identifiants.

  • Créer le sous-domaine depuis le tableau de bord et copier le token, un UUID affiché en haut de page.
  • Écrire un script duck.sh qui contient l’appel curl, le placer dans un répertoire dédié et le passer en chmod 700 : le token est en clair dedans.
  • Planifier l’appel avec cron : */5 * * * * /home/pi/duckdns/duck.sh >/dev/null 2>&1
  • Vérifier côté DNS avec dig +short nas-maison.duckdns.org, puis comparer avec l’IP publique réelle.
  • Relire le journal du script : un fichier duck.log contenant KO signale un token ou un nom de sous-domaine erroné, pas une panne réseau.

Les paramètres de l’URL de mise à jour

Un seul appel peut traiter plusieurs sous-domaines, séparés par des virgules. Le paramètre le plus utile est aussi le plus contre-intuitif : ip laissé vide ne signifie pas « pas d’adresse », mais « prends l’adresse source de ma requête ». C’est ce qui permet au script de fonctionner sans savoir quelle est son IP publique.

Côté famille d’adresses, forcez curl avec -4 ou -6 selon l’enregistrement que vous visez, sinon une machine en double pile mettra à jour l’un ou l’autre selon l’humeur de la résolution.

ParamètreValeur d’exempleEffet
domainsnas-maison ou nas-maison,camerales sous-domaines visés, écrits sans .duckdns.org
tokenl’UUID du tableau de bordauthentifie le compte, à traiter comme un mot de passe
ipvide, ou 203.0.113.5vide : Duck DNS retient l’IP source de la requête
ipv62001:db8::1met à jour l’enregistrement AAAA
verbosetruerenvoie OK ou KO, puis l’adresse retenue et UPDATED ou NOCHANGE
cleartrueefface l’enregistrement au lieu de l’écrire
txtla valeur d’un challenge ACMEécrit le TXT servi sur _acme-challenge.nas-maison.duckdns.org

Ne pas le confondre avec un résolveur DNS

La confusion est fréquente parce que le mot DNS est dans le nom. Changer de résolveur, avec 1.1.1.1 ou 9.9.9.9, modifie qui répond à vos questions DNS. Duck DNS fait l’inverse : il répond aux questions que les autres posent sur vos sous-domaines. Il est autoritaire, pas récursif. Le mettre dans les paramètres réseau de votre machine n’a aucun sens et ne résoudra rien.

Deuxième confusion, le nom : aucun lien avec DuckDuckGo, dont le résolveur n’existe pas. Troisième, les concurrents historiques No-IP et DynDNS. Le gratuit de No-IP impose de reconfirmer le nom d’hôte tous les 30 jours sous peine de suppression, ce que Duck DNS ne demande pas ; en échange, No-IP offre des options que Duck DNS n’a pas du tout, comme les enregistrements personnalisés.

Point à garder en tête si vous venez du WHOIS : un whois nas-maison.duckdns.org ne retourne rien sur vous. La requête remonte à duckdns.org et affiche le titulaire de ce domaine. Vous n’êtes pas propriétaire de votre nom, vous en êtes locataire gratuit et révocable. Un service en production, une marque, une adresse e-mail professionnelle n’ont pas leur place dessus.

À noter aussi : duckdns.org figure dans la section privée de la Public Suffix List, ce que vous pouvez vérifier dans le fichier publié sur publicsuffix.org. Conséquence pratique, un cookie posé sur votre sous-domaine ne peut pas être élargi à duckdns.org, et Let’s Encrypt compte chaque sous-domaine comme un domaine enregistré distinct pour ses quotas, donc vous ne subissez pas le plafond des milliers d’autres utilisateurs.

Ce qui casse en pratique

Le cas de panne numéro un n’a rien à voir avec Duck DNS. Le nom résout correctement, dig renvoie la bonne IP, et le service reste injoignable : vous êtes derrière un CGNAT. Regardez l’adresse WAN affichée par votre box. Si elle tombe dans 100.64.0.0/10, la plage partagée définie par la RFC 6598, l’IP publique n’est pas la vôtre, elle est mutualisée avec d’autres abonnés, et aucune redirection de port ne peut fonctionner. Duck DNS pointera fidèlement sur un équipement de l’opérateur. Il faut alors une IP publique auprès du FAI, ou un tunnel sortant.

Le deuxième piège est le monitoring. Un token expiré ou un sous-domaine mal orthographié renvoie un HTTP 200 avec KO dans le corps. Une supervision qui ne regarde que le code de statut verra vert pendant des semaines. Testez la chaîne de caractères, pas le statut.

Côté propagation, l’enregistrement a un TTL très court, de l’ordre de la minute, que vous pouvez lire avec dig +noall +answer nas-maison.duckdns.org. Cela ne garantit rien : un résolveur d’entreprise qui plancher ses TTL, ou un client qui garde sa résolution en mémoire, continuera de taper l’ancienne adresse plusieurs minutes après le changement.

Les limites du gratuit sont assumées : 5 sous-domaines par compte, aucun enregistrement personnalisé. Pour utiliser votre propre nom de domaine, la seule voie est un CNAME de www.mondomaine.fr vers nas-maison.duckdns.org. L’apex, mondomaine.fr tout court, ne peut pas recevoir de CNAME d’après la RFC 1034, sauf si votre hébergeur DNS propose un ALIAS ou un ANAME.

Pour un certificat, le paramètre txt ouvre le challenge DNS-01 et donc le wildcard sur *.nas-maison.duckdns.org, ce qu’utilise le module Duck DNS de Home Assistant. Attention : le service ne conserve qu’une valeur TXT par sous-domaine. Demander dans un même certificat le nom nu et son wildcard fait écraser un challenge par l’autre. Demandez-les en deux fois.

Dernier point, structurel : c’est un service bénévole et gratuit, sans engagement de disponibilité. S’il tombe, votre nom ne résout plus. Notez votre IP publique du moment quelque part, gardez un second fournisseur de DNS dynamique configuré en parallèle si l’accès est important, et ne faites pas dépendre un service critique de cette seule brique.

Duck DNS est un service de DNS dynamique gratuit qui vous attribue un sous-domaine en duckdns.org pointant en permanence vers l’IP publique du moment de votre connexion. Un script appelle une URL de mise à jour avec un token, Duck DNS réécrit l’enregistrement A, et votre NAS ou votre Raspberry Pi reste joignable sous le même nom même si votre box change d’adresse.

Questions fréquentes

Duck DNS est-il vraiment gratuit, et jusqu’où ?

Oui, sans offre payante ni publicité. La limite est de 5 sous-domaines par compte et des enregistrements réduits au strict nécessaire (A, AAAA, TXT). Le financement repose sur des dons, ce qui implique l’absence de garantie de disponibilité et d’assistance.

Faut-il réactiver le sous-domaine périodiquement, comme chez No-IP ?

Non. C’est l’un des arguments concrets du service : aucune confirmation tous les 30 jours. En revanche, un sous-domaine jamais mis à jour pendant une longue période peut finir recyclé, donc laissez le cron tourner même sur une machine peu utilisée.

Puis-je utiliser mon propre nom de domaine avec Duck DNS ?

Indirectement. Vous posez un CNAME depuis un sous-domaine de votre zone, par exemple maison.mondomaine.fr, vers nas-maison.duckdns.org. L’apex du domaine ne peut pas recevoir de CNAME, il vous faut un ALIAS ou un ANAME chez votre hébergeur DNS pour cet usage.

Pourquoi mon service est injoignable alors que dig renvoie la bonne IP ?

Dans l’ordre de probabilité : un CGNAT chez votre opérateur (adresse WAN en 100.64.0.0/10), une redirection de port absente sur la box, ou un pare-feu local. Le DNS a fait son travail, le problème est en aval. Testez le port depuis l’extérieur avant d’accuser Duck DNS.

Comment savoir si une mise à jour a échoué ?

Ajoutez verbose=true à l’URL et lisez le corps de la réponse, qui donne OK ou KO puis l’adresse retenue et UPDATED ou NOCHANGE. Conservez la sortie dans un fichier de journal : le code HTTP reste 200 même quand le token est refusé.

Testez vos connaissances

Quiz rapide Question 1 sur 3

Que renvoie Duck DNS quand le token est invalide ?

À lire aussi

box internet · changer adresse ip · certificat ssl · cloudflare dns 1 1 1 1

Newsletter

Recevez nos guides IP & réseau

Nouveaux outils, définitions et astuces sécurité, directement par email. Pas de spam, désinscription en un clic.