Automatisez le DNS dynamique Cloudflare avec GhostlyDDns

Dernière mise à jour 29/01/2026
Prix
10 €

Outil CLI .NET 10 axé sur la confidentialité, synchronisant les enregistrements DNS Cloudflare avec votre IP dynamique. Zéro télémétrie, configuration YAML, multi-plateforme.

GhostlyDDns est un agent en ligne de commande .NET 8 axé sur la confidentialité, qui synchronise les enregistrements A et AAAA Cloudflare existants avec l'IP publique de votre réseau. Il fait partie de la suite Ghostly Tools et offre aux développeurs, créateurs et auto-hébergeurs une automatisation fiable du DNS dynamique Cloudflare sans services managés.

Le runtime surveille votre adresse WAN, détecte les changements IPv4 et IPv6 via plusieurs points, et n'appelle l'API Cloudflare qu'en cas de mise à jour nécessaire. Diagnostics Serilog, backoff exponentiel rigoureux et codes de sortie cohérents assurent une observabilité optimale pour un fonctionnement autonome.

GhostlyDDns, logiciel axé sur la confidentialité de Ghostly Tools par GhostlyInc, offre une couche d'automatisation légère pour réseaux auto-hébergés nécessitant une précision Cloudflare constante sans exposer les identifiants à des services SaaS externes.

GhostlyDDns CLI synchronisant les enregistrements DNS Cloudflare avec une IP dynamique
Une CLI axée sur la confidentialité qui maintient la synchronisation des enregistrements Cloudflare A et AAAA existants sans services externes.

Éditions et licences

Choisissez la version GhostlyDDns adaptée à votre système. Chaque licence Gumroad inclut les mises à jour à vie pour toutes les versions 1.x et la même configuration YAML fonctionne sur toutes les éditions.

Les mises à jour à vie pour toutes les versions 1.x de GhostlyDDns sont incluses avec chaque licence.

Points forts

Fonctionnement axé sur la confidentialité

Exécutez GhostlyDDns entièrement sur votre infrastructure sans télémétrie, liaison de compte ni contrôle externe.

Mises à jour sensibles aux changements

Découverte IP multi-points, cache en mémoire et backoff discipliné éliminent les appels API Cloudflare redondants.

Déploiement multiplateforme

Des binaires .NET 8 en fichier unique sont publiés pour Windows, Linux et ARM64, permettant d'utiliser la même configuration partout.

Exemples d'utilisation

GhostlyDDns aide les équipes auto-hébergées, agences et télétravailleurs à maintenir la disponibilité en supprimant les mises à jour DNS manuelles lors des changements d'adresse WAN.

  • Gardez vos passerelles VPN homelab accessibles après chaque renouvellement d'IP ISP sans exposer les routeurs à la gestion à distance.
  • Maintenez des portails clients en marque blanche sur Cloudflare tout en exécutant la pile applicative depuis des connexions de bureau dynamiques.
  • Protégez vos équipements de diffusion ou studios créatifs en gardant les domaines d'ingestion streaming à jour même en basculement mobile.
  • Soutenez les fournisseurs de services managés gérant plusieurs zones clients avec un agent d'automatisation léger unique.

Commandes CLI

La CLI GhostlyDDns propose des commandes ciblées pour la configuration, tests, exécutions ponctuelles et surveillance continue. L'aide intégrée est accessible via plusieurs options.

CLI
ghostly-ddns init-config [--path|--p|-p <path>]
ghostly-ddns dry --config|--c|-c <path>
ghostly-ddns once --config|--c|-c <path>
ghostly-ddns run --config|--c|-c <path>
ghostly-ddns --help | --h | -h
ghostly-ddns --version | --v | -v

Schéma de configuration

Tous les paramètres d'exécution sont dans un seul fichier YAML. Fournissez le token API Cloudflare, intervalle de sondage, préférences de détection IP, rétention des logs et enregistrements à maintenir. GhostlyDDns valide le schéma au démarrage et génère des alertes exploitables en cas de valeurs manquantes.

YAML
cloudflare:
  api_token: CF_API_TOKEN

update:
  interval_seconds: 120

ip_detection:
  detect_ipv4: true
  detect_ipv6: false
  v4_endpoints:
    - https://api.ipify.org
    - https://ipv4.icanhazip.com
  v6_endpoints:
    - https://api6.ipify.org

logging:
  retention_days: 30

records:
  - name: home.example.com
    type: A
    proxied: true
    ttl: auto

Les règles de validation garantissent la présence d'un token API, au moins un enregistrement défini, des TTL auto ou supérieurs à 60, et chaque détecteur activé dispose d'au moins un point de terminaison.

Journalisation et diagnostics

Serilog alimente la sortie console structurée et les fichiers journaux rotatifs stockés dans le dossier logs. La rétention par défaut est de 30 fichiers journaliers, personnalisable via YAML.

Les logs enregistrent les IP détectées, mises à jour ignorées sans changement, codes statut Cloudflare et tentatives de reprise selon la politique de backoff exponentiel. Ces diagnostics assurent la robustesse en production.

Guides de déploiement

GhostlyDDns inclut des guides pour timers systemd Linux et modèles Windows Task Scheduler, permettant aux équipes de standardiser l'automatisation en quelques minutes.

Service systemd Linux

Installez le binaire dans usr/local/bin, placez la configuration dans etc/GhostlyDDns, et exécutez l'agent sous un compte service dédié.

systemd
[Unit]
Description=GhostlyDDns updater
After=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/ghostly-ddns run --config /etc/GhostlyDDns/config.yaml
Restart=on-failure
RestartSec=15

[Install]
WantedBy=multi-user.target

Timer systemd Linux

Associez le timer au service pour planifier des exécutions répétées et utilisez le backoff exponentiel en cas de perte de connexion Cloudflare.

systemd
[Unit]
Description=GhostlyDDns schedule

[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service

[Install]
WantedBy=timers.target

Planificateur de tâches Windows

Importez le modèle XML officiel ou créez une tâche avec privilèges élevés exécutant la commande run toutes les quelques minutes et redémarrant en cas d'échec.

Task Scheduler
schtasks /Create ^
  /SC MINUTE /MO 5 ^
  /TN "GhostlyDDns" ^
  /TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
  /RL HIGHEST ^
  /F
  • Chemin programme C GhostlyDDns ghostly-ddns.exe
  • Arguments run --config C GhostlyDDns config.yaml
  • Les logs sont écrits à côté de l'exécutable dans le dossier logs

Questions fréquentes

Découvrez des réponses rapides sur les capacités de GhostlyDDns, exigences Cloudflare et pratiques opérationnelles avant déploiement en production.

Informations sur le support GhostlyDDns

Étapes suivantes

Choisissez votre édition GhostlyDDns, téléchargez le binaire sur Gumroad et déployez-le avec les autres outils Ghostly Tools de GhostlyInc.

Consultez ces guides pour améliorer votre infrastructure axée sur la confidentialité et la gestion DNS