GhostlyDDns voor Cloudflare Dynamic DNS
GhostlyDDns houdt Cloudflare dynamic DNS onder uw controle
GhostlyDDns is een kleine .NET CLI die op uw eigen machine draait en bestaande Cloudflare A- en AAAA-records bijwerkt wanneer uw publieke IP verandert. Handig voor thuisservers, kantoornetwerken, labs en zelfgehoste diensten die een stabiele domeinnaam nodig hebben zonder DNS-controle aan een andere SaaS-provider over te dragen.
Overzicht
Dynamic DNS lost het probleem van wisselende IP-adressen op, niet elk hostingprobleem
Veel thuis- en kleine kantoorverbindingen krijgen af en toe een nieuw publiek IP. Dynamic DNS houdt een domein gericht op het actuele adres zodat een VPN, dashboard, testsite of zelfgehoste app bereikbaar blijft. GhostlyDDns richt zich op Cloudflare-zones en werkt de records bij die u al hebt aangemaakt.
Geschiktheidscontrole
Gebruik GhostlyDDns wanneer Cloudflare uw DNS-bron van waarheid is
De beste match is een netwerk waar het publieke adres kan veranderen, maar het domein moet blijven werken. Als uw router of hostingprovider de exacte Cloudflare-update al afhandelt, heeft u mogelijk geen extra agent nodig.
Waar GhostlyDDns helpt
- U gebruikt Cloudflare DNS en heeft al de A- of AAAA-records die u wilt onderhouden.
- Uw thuis-, kantoor-, lab- of fallback-netwerk krijgt een wisselend publiek IP-adres.
- U wilt het Cloudflare API-token lokaal opslaan in plaats van bij een derde partij DDNS-service.
- U heeft dezelfde configuratiestijl nodig op Windows, Linux of Linux ARM.
Waar een andere DDNS-oplossing eenvoudiger is
- Uw internetprovider geeft u een statisch publiek IP en DNS verandert zelden.
- Uw router werkt Cloudflare al veilig bij met beperkte rechten en nuttige logs.
- U heeft een gehost dashboard, teamtoegangscontrole, meldingen en beheerde ondersteuning nodig.
- U verwacht dat de tool in versie één Cloudflare-records vanaf nul aanmaakt.
Inhoudsopgave
Cloudflare-updates
GhostlyDDns werkt alleen bij als uw publieke IP daadwerkelijk verandert
De agent controleert uw publieke IPv4- en IPv6-adressen, vergelijkt deze met de laatst bekende waarde en roept de Cloudflare API alleen aan als een A- of AAAA-record een nieuw doel nodig heeft. Dit houdt de update-loop stil en voorkomt onnodig API-verkeer.
A-records volgen het huidige IPv4-adres
Gebruik A-records voor IPv4-diensten zoals een thuis VPN-endpoint, klein dashboard, reverse proxy of testsite.
AAAA-records kunnen IPv6 volgen als uw host dit heeft
Schakel IPv6 alleen in als de machine een stabiele gerouteerde IPv6-verbinding heeft. Anders deactiveer de IPv6-detector.
Cloudflare-aanroepen blijven wijzigingsbewust
GhostlyDDns vergelijkt eerst waarden en werkt Cloudflare alleen bij als het DNS-doel moet veranderen.
Privacy en veiligheid
Lokale uitvoering houdt gevoelige onderdelen dicht bij uw netwerk
GhostlyDDns heeft geen gehost controlepaneel nodig. Uw Cloudflare API-token blijft op de machine waar de agent draait, logs blijven lokaal en de update-loop kan achter uw eigen firewall, scheduler of systemd-service draaien.
Gebruik het kleinst mogelijke bruikbare Cloudflare API-token
Beperk het token tot de zone en DNS-bewerkingsrechten die GhostlyDDns echt nodig heeft. Gebruik geen account-breed token voor een eenvoudige DDNS-taak.
Bescherm het YAML-bestand als een geheim
De configuratie kan het Cloudflare API-token bevatten. Houd de bestandsrechten strikt en vermijd het plakken in screenshots, tickets of openbare logs.
De update-loop draait waar u deze plaatst
GhostlyDDns vereist geen extern controlepaneel. Uw scheduler, firewall, logs en retrybeleid blijven onderdeel van uw eigen setup.
Houd fouten in de gaten, niet elke normale uitvoering
Een stille succesvolle uitvoering wordt verwacht. Let op niet-nul exitcodes, herhaalde Cloudflare-fouten en detectie-eindpunten die niet meer reageren.
Installatieproces
De betrouwbare volgorde is eerst zone, dan token, daarna scheduler
Een goede DDNS-installatie begint met voorbereiding. Maak het record aan, beperk het Cloudflare-token tot de zone, test met een droge run en plan de agent in de scheduler die bij uw besturingssysteem past.
Maak het record aan
Voeg eerst het A- of AAAA-record toe in Cloudflare, kies de proxy-modus en gebruik een tijdelijke hostnaam tijdens het testen.
Beperk het token
Maak een Cloudflare API-token aan dat alleen DNS voor de bedoelde zone kan bewerken.
Voer een droge test uit
Gebruik het dry-commando om de configuratie, recordnamen, detectors en Cloudflare-toegang te bevestigen voordat u live bijwerkt.
Plan de agent in
Draai één keer via een timer of continu als service, controleer daarna logs en exitcodes bij de eerste IP-wijzigingen.
Configuratie
Eén YAML-bestand beschrijft het token, records, interval, IP-detectie en logs
Houd de configuratie eenvoudig en controleerbaar. Bewaar het token veilig, stel de polling-interval in op uw behoeften, schakel IPv6 alleen in als de host een echte IPv6-route heeft, en vermeld elk Cloudflare-record dat het publieke IP moet volgen.
Belangrijke CLI-commando's
Gebruik droge runs voordat u een herhalende taak inschakelt. Ze tonen wat GhostlyDDns zou bijwerken zonder de eerste installatie blind in productie te zetten.
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 --versionVoorbeeld YAML-configuratie
De exacte waarden hangen af van uw Cloudflare-zone en recordnamen, maar de configuratie blijft klein genoeg voor normale code-review.
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: autoImplementatie
Draai GhostlyDDns als een kleine infrastructuurservice
Voor Linux maakt een systemd-service en timer het eenvoudig om de agent te herstarten en te controleren. Voor Windows kan Taakplanner hetzelfde commando op vaste intervallen uitvoeren. Logs moeten in beide gevallen makkelijk te vinden zijn en het configuratiebestand mag niet voor iedereen leesbaar zijn.
Linux systemd-timer
Gebruik waar mogelijk een dedicated serviceaccount en bewaar de configuratie in een beveiligde map.
[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.targetWindows Taakplanner
Voer hetzelfde CLI-commando elke paar minuten uit en houd niet-nul exitcodes in uw normale workflow in de gaten.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\GhostlyDDns\ghostly-ddns.exe once --config C:\GhostlyDDns\config.yaml" ^
/RL HIGHEST ^
/FEditie
Kies de build die past bij waar de DDNS-agent draait
Elke licentie dekt GhostlyDDns updates voor de geselecteerde editie. Kies Windows voor een kleine kantoorcomputer, Linux voor een VPS of thuisserver, of Linux ARM voor energiezuinige apparaten die de DNS de hele dag actueel moeten houden.
Windows
Gebruik dit wanneer een Windows-machine online blijft en een Cloudflare-record actueel moet houden voor een klein netwerk.
Open Windows-editieLinux
Gebruik dit voor een VPS, thuisserver, labbox of reverse proxy-host die al onbemand draait.
Open Linux-editieLinux ARM
Gebruik dit voor ARM64-apparaten die altijd aanstaan en een kleine DDNS-agent met weinig overhead kunnen draaien.
Open Linux ARM-editieAan de slag
Begin met één testrecord voordat u productie-DNS automatiseert
Maak een tijdelijk subdomein, voer GhostlyDDns uit in droge modus, bevestig dat het Cloudflare-token alleen de bedoelde zone kan bewerken, en verplaats dan dezelfde configuratie naar het belangrijke record.
Veelgestelde vragen
Wat automatiseert GhostlyDDns?
GhostlyDDns werkt bestaande Cloudflare A- en AAAA-records bij wanneer uw publieke IPv4- of IPv6-adres verandert. Het vervangt Cloudflare DNS niet en creëert geen hostingplatform.
Maakt GhostlyDDns nieuwe Cloudflare-records aan?
Versie één is bedoeld om bestaande records bij te werken. Maak eerst de DNS-records aan in Cloudflare en laat GhostlyDDns hun doelen actueel houden.
Waar moet ik het Cloudflare API-token opslaan?
Bewaar het token op de machine waar GhostlyDDns draait en bescherm het YAML-bestand met strikte rechten. Het token mag alleen DNS voor de bedoelde zone bewerken.
Kan GhostlyDDns IPv6-records bijwerken?
Ja. Schakel IPv6-detectie in als de host een echte gerouteerde IPv6-adres heeft. GhostlyDDns kan AAAA-records bijwerken wanneer het gedetecteerde IPv6-adres verandert.
Wanneer is provider DDNS voldoende?
Provider DDNS kan voldoende zijn als uw router of hostingprovider Cloudflare al veilig bijwerkt, de benodigde records ondersteunt en betrouwbare logs levert.
Hoe vaak moet de agent draaien?
Een korte interval van twee tot vijf minuten is gebruikelijk voor thuis- en kantoornetwerken. Gebruik een langere polling-interval als snelle failover niet belangrijk is.