Automatizza il DNS Dinamico Cloudflare con GhostlyDDns
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.

Indice
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.
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 | -vSchema 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.
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: autoLe 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.
[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 Linux systemd
Associa il timer al servizio per esecuzioni ripetute e usa il backoff esponenziale in caso di problemi di connettività Cloudflare.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetPianificatore 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.
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.
Risorse correlate
Consulta queste guide per migliorare la tua infrastruttura incentrata sulla privacy e la gestione DNS