Automatisez le DNS dynamique Cloudflare avec GhostlyDDns
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.

Table des matières
É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.
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 | -vSché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.
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: autoLes 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é.
[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.targetTimer 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.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetPlanificateur 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.
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.
Ressources associées
Consultez ces guides pour améliorer votre infrastructure axée sur la confidentialité et la gestion DNS