Automatizza il DNS Dinamico Cloudflare con GhostlyDDns

Ultimo Aggiornamento 29/01/2026
Prezzo
10 €

Strumento CLI .NET 10 incentrato sulla privacy che sincronizza i record DNS Cloudflare con il tuo IP dinamico. Zero telemetria, configurazione YAML, supporto multipiattaforma.

GhostlyDDns è un agente da riga di comando dotnet 8 focalizzato sulla privacy che mantiene sincronizzati i record A e AAAA esistenti di Cloudflare con l'IP pubblico della tua rete edge. Fa parte della suite Ghostly Tools e offre a sviluppatori, creatori e self-host un'automazione affidabile del DNS dinamico Cloudflare senza servizi gestiti.

Il runtime monitora il tuo indirizzo WAN, rileva cambiamenti IPv4 e IPv6 tramite più endpoint e chiama l'API Cloudflare solo quando serve un aggiornamento. Diagnostica basata su Serilog, backoff esponenziale disciplinato e codici di uscita coerenti offrono l'osservabilità necessaria per operazioni senza supervisione.

GhostlyDDns di Ghostly Tools, software incentrato sulla privacy di GhostlyInc, offre un livello leggero di automazione per reti self-hosted che necessitano di precisione costante su Cloudflare senza esporre credenziali a servizi SaaS esterni.

GhostlyDDns CLI per sincronizzare i record DNS Cloudflare con un IP dinamico
Un CLI orientato alla privacy che mantiene sincronizzati i record A e AAAA esistenti di Cloudflare senza servizi esterni.

Edizioni e licenze

Scegli la versione di GhostlyDDns compatibile con il tuo sistema operativo. Ogni licenza Gumroad include aggiornamenti a vita per tutte le release GhostlyDDns 1.x e la stessa configurazione YAML funziona su tutte le edizioni.

Ogni licenza include aggiornamenti a vita per tutte le versioni GhostlyDDns 1.x.

Caratteristiche principali

Operazioni con priorità alla privacy

Esegui GhostlyDDns interamente sulla tua infrastruttura senza telemetria, vincoli di account o controlli esterni.

Aggiornamenti consapevoli delle modifiche

Rilevamento IP multi-endpoint, caching in memoria e backoff disciplinato eliminano chiamate API Cloudflare ridondanti.

Distribuzione multipiattaforma

I binari .NET 8 a file singolo sono disponibili per Windows, Linux e ARM64, così puoi usare la stessa configurazione ovunque.

Esempi di utilizzo

GhostlyDDns aiuta team self-hosted, agenzie e lavoratori remoti a mantenere l'uptime eliminando aggiornamenti DNS manuali quando gli indirizzi WAN cambiano.

  • Mantieni raggiungibili i gateway VPN del tuo homelab dopo ogni rinnovo ISP senza esporre i router a gestione remota.
  • Gestisci portali client white label su Cloudflare mentre l'applicazione gira da connessioni d'ufficio dinamiche.
  • Proteggi postazioni di trasmissione o studi creativi mantenendo aggiornati i domini di streaming anche durante il failover mobile.
  • Supporta i provider di servizi gestiti che operano su più zone clienti con un singolo agente di automazione leggero.

Comandi CLI

La CLI di GhostlyDDns offre comandi specifici per configurazione, test, esecuzioni singole e monitoraggio continuo. L'aiuto integrato è accessibile tramite vari flag.

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

Schema di configurazione

Tutte le impostazioni runtime risiedono in un unico file YAML. Inserisci il token API Cloudflare, intervallo di polling, preferenze di rilevamento IP, conservazione log e record da mantenere. GhostlyDDns valida lo schema all'avvio e segnala avvisi utili se mancano valori.

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

Le regole di validazione garantiscono la presenza di un token API, almeno un record definito, valori TTL auto o superiori a 60 e che ogni rilevatore abilitato abbia almeno un endpoint.

Registrazione e diagnostica

Serilog gestisce l'output strutturato in console e i log rotativi salvati nella cartella logs. La conservazione predefinita è di 30 file giornalieri, personalizzabile via YAML.

Le righe di log documentano IP rilevati, aggiornamenti saltati se non necessari, codici di stato Cloudflare e tentativi di retry secondo la politica di backoff esponenziale. Questi dati mantengono GhostlyDDns pronto per operazioni senza supervisione.

Guide di distribuzione

GhostlyDDns include indicazioni per timer systemd Linux e template Windows Task Scheduler per standardizzare l'automazione in pochi minuti.

Servizio Linux systemd

Installa il binario in usr local bin, posiziona la configurazione in etc GhostlyDDns e avvia l'agente con un account di servizio dedicato.

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 Linux systemd

Associa il timer al servizio per esecuzioni ripetute e usa il backoff esponenziale in caso di problemi di connettività Cloudflare.

systemd
[Unit]
Description=GhostlyDDns schedule

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

[Install]
WantedBy=timers.target

Pianificatore attività Windows

Importa il template XML ufficiale o crea un'attività con privilegi elevati che esegue il comando run ogni pochi minuti e si riavvia in caso di errore.

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
  • Percorso programma C GhostlyDDns ghostly-ddns.exe
  • Argomenti run --config C GhostlyDDns config.yaml
  • I log vengono scritti accanto all'eseguibile nella cartella logs

Domande frequenti

Scopri risposte rapide su funzionalità di GhostlyDDns, requisiti Cloudflare e pratiche operative prima della distribuzione in produzione.

Approfondimenti sul supporto GhostlyDDns

Prossimi passi

Scegli l'edizione GhostlyDDns preferita, scarica il binario da Gumroad e distribuiscilo insieme alle altre utility Ghostly Tools di GhostlyInc.

Consulta queste guide per migliorare la tua infrastruttura incentrata sulla privacy e la gestione DNS