GhostlyDDns för Cloudflare dynamisk DNS
GhostlyDDns ger kontroll över Cloudflare dynamisk DNS
GhostlyDDns är ett litet .NET CLI som körs på din egen maskin och uppdaterar befintliga Cloudflare A- och AAAA-poster när din publika IP ändras. Det är användbart för hemservrar, kontorsnätverk, labb och självhostade tjänster som behöver en stabil domän utan att överlåta DNS-kontroll till en annan SaaS-leverantör.
Översikt
Dynamisk DNS löser IP-förändringsproblemet, inte alla hostingproblem
Många hem- och småkontorsanslutningar får ny publik IP då och då. Dynamisk DNS håller en domän pekad på aktuell adress så VPN, dashboard, testsida eller självhostad app är nåbar. GhostlyDDns fokuserar på Cloudflare-zoner och uppdaterar redan skapade poster.
Passar bra
Använd GhostlyDDns när Cloudflare är din DNS-sanning
Bästa passformen är ett nätverk där den publika adressen kan ändras men domänen ska fungera. Om din router eller hostingleverantör redan hanterar exakt Cloudflare-uppdatering du behöver kan du slippa en extra agent.
När GhostlyDDns hjälper
- Du använder Cloudflare DNS och har redan de A- eller AAAA-poster du vill underhålla.
- Ditt hem-, kontors-, labb- eller reservnätverk får en förändrande publik IP.
- Du vill lagra Cloudflare API-token lokalt istället för i en tredjeparts DDNS-tjänst.
- Du behöver samma konfigurationsstil på Windows, Linux eller Linux ARM.
När en annan DDNS-lösning är enklare
- Din internetleverantör ger dig en statisk publik IP och DNS ändras sällan.
- Din router uppdaterar redan Cloudflare säkert med begränsade behörigheter och användbara loggar.
- Du behöver en hostad dashboard, teamåtkomstkontroller, aviseringar och hanterad support.
- Du förväntar dig att verktyget skapar Cloudflare-poster från början i version ett.
Innehållsförteckning
Cloudflare-uppdateringar
GhostlyDDns uppdaterar endast när din publika IP verkligen ändras
Agenten kontrollerar dina publika IPv4- och IPv6-adresser, jämför med senaste kända värde och anropar Cloudflare API endast när A- eller AAAA-posten behöver nytt mål. Detta håller uppdateringsloopen tyst och undviker onödig API-trafik.
A-poster följer den aktuella IPv4-adressen
Använd A-poster för IPv4-tjänster som hem-VPN, liten dashboard, reverse proxy eller testsida.
AAAA-poster kan följa IPv6 när din värd har det
Aktivera IPv6 endast när maskinen har en stabil routad IPv6-väg. Annars håll IPv6-detektorn avstängd.
Cloudflare-anrop är förändringsmedvetna
GhostlyDDns jämför värden först och uppdaterar Cloudflare endast när DNS-målet ska ändras.
Integritet och säkerhet
Lokal körning håller känsliga delar nära ditt nätverk
GhostlyDDns kräver ingen hostad kontrollpanel. Din Cloudflare API-token stannar på maskinen som kör agenten, loggarna är lokala och uppdateringsloopen kan köras bakom din egen brandvägg, schemaläggare eller systemd-tjänst.
Använd minsta användbara Cloudflare API-token
Begränsa token till zonen och DNS-redigeringsrättigheter som GhostlyDDns verkligen behöver. Återanvänd inte en kontoövergripande token för enkel DDNS.
Skydda YAML-filen som en hemlighet
Konfigurationen kan innehålla Cloudflare API-token. Håll filrättigheter strikta och undvik att klistra in den i skärmdumpar, ärenden eller offentliga loggar.
Uppdateringsloopen körs där du placerar den
GhostlyDDns kräver ingen extern kontrollpanel. Din schemaläggare, brandvägg, loggar och omförsökspolicy förblir en del av din egen setup.
Övervaka fel, inte varje normal körning
En tyst och framgångsrik körning förväntas. Håll koll på icke-noll exitkoder, upprepade Cloudflare-fel och detektionspunkter som slutar svara.
Installationsflöde
Den pålitliga vägen är zon först, token andra och schemaläggare tredje
En smidig DDNS-installation handlar mest om förberedelser. Skapa posten, begränsa Cloudflare-token till zonen, testa i torrkörning och schemalägg agenten enligt ditt operativsystem.
Skapa posten
Lägg till A- eller AAAA-posten i Cloudflare först, välj proxy-läge och använd ett tillfälligt värdnamn under testning.
Begränsa token
Skapa en Cloudflare API-token som endast kan redigera DNS för avsedd zon.
Kör en torrkörning
Använd torrkörningskommandot för att bekräfta konfiguration, postnamn, detektorer och Cloudflare-åtkomst innan liveuppdatering.
Schemalägg agenten
Kör en gång via timer eller kontinuerligt som tjänst, kontrollera sedan loggar och exitkoder vid de första IP-ändringarna.
Konfiguration
En YAML-fil beskriver token, poster, intervall, IP-detektion och loggar
Håll konfigurationen enkel och granskbar. Säkra token, ställ in pollingintervall efter behov, aktivera IPv6 endast vid riktig IPv6-rutt och lista varje Cloudflare-post som ska följa den publika IP:n.
Kärnkommandon i CLI
Använd torrkörningar innan du aktiverar upprepade jobb. De visar vad GhostlyDDns skulle uppdatera utan att göra första installationen till en blind produktionsändring.
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 --versionExempel på YAML-konfiguration
Exakta värden beror på din Cloudflare-zon och postnamn, men formen är tillräckligt liten för normal kodgranskning.
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: autoDistribution
Kör GhostlyDDns som en liten infrastrukturtjänst
För Linux gör en systemd-tjänst och timer agenten enkel att starta om och granska. För Windows kan Task Scheduler köra samma kommando med fasta intervall. I båda fallen ska loggar vara lätta att hitta och konfigurationsfilen får inte vara allmänt läsbar.
Linux systemd-timer
Använd dedikerat servicekonto när möjligt och håll konfigurationen i skyddad katalog.
[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 Task Scheduler
Kör samma CLI-kommando var femte minut och övervaka icke-noll exitkoder i din vanliga drift.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\GhostlyDDns\ghostly-ddns.exe once --config C:\GhostlyDDns\config.yaml" ^
/RL HIGHEST ^
/FUtgåvor
Välj version som passar där DDNS-agenten ska köras
Varje licens täcker GhostlyDDns uppdateringar för vald utgåva. Välj Windows för liten kontorsdator, Linux för VPS eller hemserver, eller Linux ARM för lågströmsenheter som ska hålla DNS uppdaterad hela dagen.
Windows
Använd detta när en Windows-maskin är online och ska hålla en Cloudflare-post aktuell för ett litet nätverk.
Öppna Windows-versionLinux
Använd detta för VPS, hemserver, labbmaskin eller reverse proxy som redan kör obevakade tjänster.
Öppna Linux-versionLinux ARM
Använd detta för ARM64-enheter som alltid är på och kan köra en liten DDNS-agent med låg belastning.
Öppna Linux ARM-versionKom igång
Börja med en testpost innan du automatiserar produktions-DNS
Skapa ett tillfälligt subdomän, kör GhostlyDDns i torrkörningsläge, bekräfta att Cloudflare-token bara kan redigera avsedd zon, och flytta sedan samma konfiguration till den viktiga posten.
Vanliga frågor
GhostlyDDns vanliga frågor
Korta svar om Cloudflare-poster, API-token, IPv6, scheman, loggar och när provider DDNS kan räcka.
Vad automatiserar GhostlyDDns?
GhostlyDDns uppdaterar befintliga Cloudflare A- och AAAA-poster när din publika IPv4- eller IPv6-adress ändras. Det ersätter inte Cloudflare DNS eller skapar en hostingplattform.
Skapar GhostlyDDns nya Cloudflare-poster?
Version ett är avsedd att uppdatera poster som redan finns. Skapa DNS-poster i Cloudflare först, låt sedan GhostlyDDns hålla deras mål aktuella.
Var ska jag lagra Cloudflare API-token?
Spara token på maskinen som kör GhostlyDDns och skydda YAML-filen med restriktiva rättigheter. Token ska endast kunna redigera DNS för avsedd zon.
Kan GhostlyDDns uppdatera IPv6-poster?
Ja. Aktivera IPv6-detektion när värden har en riktig routad IPv6-adress. GhostlyDDns kan uppdatera AAAA-poster när den upptäckta IPv6-adressen ändras.
När räcker provider DDNS?
Provider DDNS kan räcka när din router eller hostingleverantör redan uppdaterar Cloudflare säkert, stöder nödvändiga poster och ger pålitliga loggar.
Hur ofta ska agenten köras?
Kort intervall, som två till fem minuter, är vanligt för hem- och kontorsnätverk. Använd längre intervall om snabb failover inte är viktigt.