GhostlyDDns per DNS dinamico Cloudflare
GhostlyDDns ti dà controllo sul DNS dinamico Cloudflare
GhostlyDDns è una piccola CLI .NET che gira sulla tua macchina e aggiorna i record A e AAAA Cloudflare esistenti quando cambia il tuo IP pubblico. Utile per server domestici, reti d'ufficio, laboratori e servizi self-hosted che necessitano di un dominio stabile senza affidare il DNS a terzi.
Panoramica
Il DNS dinamico risolve il problema dell'IP variabile, non tutti i problemi di hosting
Molte connessioni internet domestiche e di piccoli uffici ricevono un nuovo IP pubblico di tanto in tanto. Il DNS dinamico mantiene un dominio puntato all'indirizzo attuale, così VPN, dashboard, siti di test o app self-hosted restano raggiungibili. GhostlyDDns si concentra sulle zone Cloudflare e aggiorna i record già creati.
Verifica di compatibilità
Usa GhostlyDDns quando Cloudflare è la tua fonte DNS affidabile
La soluzione ideale è una rete con indirizzo pubblico variabile ma dominio sempre funzionante. Se il tuo router o provider gestisce già l'aggiornamento Cloudflare necessario, potresti non aver bisogno di un altro agente.
Dove GhostlyDDns è utile
- Usi il DNS Cloudflare e hai già i record A o AAAA che vuoi mantenere.
- La tua rete domestica, d'ufficio, di laboratorio o di riserva ha un IP pubblico variabile.
- Vuoi che il token API Cloudflare sia conservato localmente e non in un servizio DDNS di terze parti.
- Ti serve lo stesso stile di configurazione su Windows, Linux o Linux ARM.
Quando un'altra soluzione DDNS è più semplice
- Il tuo provider internet ti assegna un IP pubblico statico e il DNS cambia raramente.
- Il tuo router aggiorna già Cloudflare in modo sicuro con credenziali limitate e log utili.
- Hai bisogno di un dashboard ospitato, controlli accesso team, avvisi e supporto gestito.
- Ti aspetti che lo strumento crei record Cloudflare da zero nella versione uno.
Indice
Aggiornamenti Cloudflare
GhostlyDDns aggiorna solo quando il tuo IP pubblico cambia realmente
L'agente controlla i tuoi indirizzi IPv4 e IPv6 pubblici, li confronta con l'ultimo valore noto e chiama l'API Cloudflare solo se un record A o AAAA necessita di un nuovo target. Questo mantiene il ciclo di aggiornamento silenzioso ed evita traffico API inutile.
I record A seguono l'indirizzo IPv4 corrente
Usa record A per servizi IPv4 come endpoint VPN domestico, piccolo cruscotto, reverse proxy o sito di test.
I record AAAA possono seguire l'IPv6 se il tuo host lo supporta
Abilita IPv6 solo se la macchina ha un percorso IPv6 stabile e instradato. Altrimenti disattiva il rilevatore IPv6.
Le chiamate a Cloudflare rilevano i cambiamenti
GhostlyDDns confronta i valori e aggiorna Cloudflare solo se il target DNS deve cambiare.
Privacy e sicurezza
L'esecuzione locale mantiene le parti sensibili vicino alla tua rete
GhostlyDDns non richiede un pannello di controllo ospitato. Il token API Cloudflare resta sulla macchina che esegue l'agente, i log sono locali e il ciclo di aggiornamento può girare dietro il tuo firewall, scheduler o servizio systemd.
Usa il token API Cloudflare più limitato possibile
Limita il token alla zona e ai permessi DNS necessari a GhostlyDDns. Non riutilizzare un token globale per un semplice lavoro DDNS.
Proteggi il file YAML come un segreto
La configurazione può contenere il token API Cloudflare. Mantieni i permessi stretti e evita di incollarlo in screenshot, ticket o log pubblici.
Il ciclo di aggiornamento gira dove lo posizioni
GhostlyDDns non necessita di un pannello di controllo esterno. Scheduler, firewall, log e politica di retry restano parte della tua configurazione.
Monitora i fallimenti, non ogni esecuzione normale
Si prevede un'esecuzione silenziosa e senza errori. Controlla codici di uscita diversi da zero, fallimenti ripetuti di Cloudflare e endpoint di rilevamento che smettono di rispondere.
Flusso di configurazione
Il percorso affidabile è prima la zona, poi il token, infine lo scheduler
Una configurazione DDNS pulita richiede soprattutto preparazione. Crea il record, limita il token Cloudflare alla zona, esegui un test a secco e poi inserisci l'agente nel scheduler adatto al tuo sistema operativo.
Crea il record
Aggiungi prima il record A o AAAA in Cloudflare, scegli la modalità proxy e usa un hostname temporaneo durante i test.
Limita il token
Crea un token API Cloudflare che modifichi solo il DNS della zona prevista, nulla di più.
Esegui un controllo a secco
Usa il comando dry per confermare configurazione, nomi record, rilevatori e accesso Cloudflare prima di un aggiornamento live.
Pianifica l'agente
Esegui una volta da timer o continuamente come servizio, poi controlla log e codici di uscita durante i primi cambi IP.
Configurazione
Un unico file YAML descrive token, record, intervallo, rilevamento IP e log
Mantieni la configurazione semplice e verificabile. Conserva il token in modo sicuro, imposta l'intervallo di polling secondo le tue esigenze, abilita IPv6 solo se l'host ha un percorso IPv6 reale e elenca ogni record Cloudflare che deve seguire l'IP pubblico.
Comandi CLI principali
Esegui test a secco prima di abilitare un lavoro ripetuto. Mostrano cosa GhostlyDDns aggiornerebbe senza trasformare la prima configurazione in un cambiamento cieco in produzione.
ghostly-ddns init-config --path ./config.yaml
ghostly-ddns dry --config ./config.yaml
ghostly-ddns once --config ./config.yaml
ghostly-ddns run --config ./config.yaml
ghostly-ddns --help
ghostly-ddns --versionEsempio di configurazione YAML
I valori esatti dipendono dalla tua zona Cloudflare e dai nomi dei record, ma la struttura resta abbastanza piccola per una revisione del codice ordinaria.
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: autoDistribuzione
Esegui GhostlyDDns come un piccolo servizio infrastrutturale
Su Linux, un servizio systemd e un timer facilitano il riavvio e l'audit dell'agente. Su Windows, Task Scheduler esegue il comando a intervalli fissi. In entrambi i casi, i log devono essere facilmente accessibili e il file di configurazione non leggibile da tutti.
Timer Linux systemd
Usa un account di servizio dedicato quando possibile e conserva la configurazione in una directory protetta.
[Unit]
Description=Run GhostlyDDns
[Service]
Type=oneshot
ExecStart=/usr/local/bin/ghostly-ddns once --config /etc/GhostlyDDns/config.yaml
[Timer]
OnBootSec=60
OnUnitActiveSec=120
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetPianificatore attività Windows
Esegui lo stesso comando CLI ogni pochi minuti e monitora i codici di uscita diversi da zero nel tuo flusso operativo.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\GhostlyDDns\ghostly-ddns.exe once --config C:\GhostlyDDns\config.yaml" ^
/RL HIGHEST ^
/FEdizioni
Scegli la versione adatta al sistema dove girerà l'agente DDNS
Ogni licenza copre gli aggiornamenti GhostlyDDns 1.x per l'edizione scelta. Scegli Windows per un PC d'ufficio, Linux per VPS o server domestico, Linux ARM per dispositivi a basso consumo sempre attivi.
Windows
Usalo quando una macchina Windows resta online e deve mantenere aggiornato un record Cloudflare per una piccola rete.
Apri edizione WindowsLinux
Usalo per VPS, server domestici, box di laboratorio o host reverse proxy che già eseguono servizi senza supervisione.
Apri edizione LinuxLinux ARM
Usalo per dispositivi ARM64 sempre accesi che possono eseguire un piccolo agente DDNS con basso impatto.
Apri edizione Linux ARMInizia ora
Inizia con un record di test prima di automatizzare il DNS di produzione
Crea un sottodominio temporaneo, esegui GhostlyDDns in modalità test, verifica che il token Cloudflare modifichi solo la zona prevista, poi applica la stessa configurazione al record importante.
Domande frequenti
Cosa automatizza GhostlyDDns?
GhostlyDDns aggiorna i record A e AAAA Cloudflare esistenti quando cambia il tuo IP pubblico IPv4 o IPv6. Non sostituisce il DNS Cloudflare né crea una piattaforma di hosting.
GhostlyDDns crea nuovi record Cloudflare?
La versione uno aggiorna record già esistenti. Crea prima i record DNS in Cloudflare, poi lascia che GhostlyDDns mantenga i loro target aggiornati.
Dove devo conservare il token API Cloudflare?
Conserva il token sulla macchina che esegue GhostlyDDns e proteggi il file YAML con permessi restrittivi. Il token deve poter modificare solo il DNS della zona prevista.
GhostlyDDns può aggiornare i record IPv6?
Sì. Abilita il rilevamento IPv6 solo se l'host ha un indirizzo IPv6 instradato reale. GhostlyDDns può aggiornare i record AAAA quando l'indirizzo IPv6 rilevato cambia.
Quando basta il DDNS del provider?
Il DDNS del provider può bastare se il tuo router o hosting aggiorna Cloudflare in modo sicuro, supporta i record necessari e fornisce log affidabili.
Con quale frequenza deve girare l'agente?
Un intervallo breve di due-cinque minuti è comune per reti domestiche e uffici. Usa un intervallo più lungo se il failover rapido non è essenziale.