Skip to content

Installer DuckDNS avec portainer

Objectif

Utiliser DuckDNS pour attribuer un nom de domaine dynamique à votre adresse IP publique et mettre en place un conteneur Docker pour maintenir cette redirection automatiquement.

Prérequis

  • Accès à une machine Linux avec Docker et Portainer déjà installés

  • Connexion à l'interface Portainer via https://localhost:9443

  • Un compte DuckDNS (https://www.duckdns.org/)

  • Un sous-domaine créé dans DuckDNS

1. Se connecter à Portainer

Accéder à l'interface Web de Portainer à l'adresse suivante :

https://localhost:9443

Authentifiez-vous puis allez dans la section Stacks pour créer une nouvelle stack.

2. Créer une stack pour DuckDNS

Dans l'interface de création de stack, coller le contenu suivant :

version: "2.1"
services:
  duckdns:
    image: lscr.io/linuxserver/duckdns
    container_name: duckdns
    environment:
      - TZ=Europe/Paris
      - SUBDOMAINS=⭐⭐METTRE SON URL.DUCKDNS⭐⭐
      - TOKEN=⭐⭐METTRE LE TOKEN DUCKDNS⭐⭐
      - LOG_FILE=false # optionnel
    volumes:
      - /srv/docker/duckdns/config:/config # optionnel
    restart: unless-stopped

💡 Astuce : Le volume monté est optionnel mais peut permettre de conserver une trace des logs ou de la configuration locale.

3. Lancer la stack

  • Cliquer sur Deploy the stack

  • Aller dans la section Containers pour vérifier que le conteneur DuckDNS est bien en fonctionnement

4. Vérification

Se rendre sur l'adresse https://www.duckdns.org/ avec votre compte pour vérifier que l'IP publique est bien mise à jour automatiquement toutes les 5 minutes.

✅ Vérification supplémentaire :

  • Un fichier duck.log peut apparaître dans /srv/docker/duckdns/config si LOG_FILE=true est activé

Conclusion

DuckDNS est une solution simple et gratuite pour associer un nom de domaine dynamique à une IP changeante. Couplé à Docker et Portainer, il devient facile à déployer et à maintenir.