Automatyzacja dynamicznego DNS Cloudflare z GhostlyDDns
Narzędzie CLI .NET 10 z naciskiem na prywatność, synchronizujące rekordy DNS Cloudflare z dynamicznym IP. Brak telemetrii, konfiguracja YAML, wsparcie wieloplatformowe.
GhostlyDDns to narzędzie wiersza poleceń .NET 8 skoncentrowane na prywatności, które synchronizuje istniejące rekordy A i AAAA Cloudflare z publicznym IP sieci brzegowej. Jest częścią pakietu Ghostly Tools i oferuje deweloperom, twórcom oraz użytkownikom samodzielnym niezawodną automatyzację dynamicznego DNS Cloudflare bez usług zarządzanych.
Środowisko monitoruje adres WAN, wykrywa zmiany IPv4 i IPv6 przez wiele punktów końcowych i wywołuje API Cloudflare tylko przy konieczności aktualizacji. Diagnostyka oparta na Serilog, kontrolowane opóźnienia i spójne kody wyjścia zapewniają zespołom pełną kontrolę podczas pracy bez nadzoru.
GhostlyDDns od Ghostly Tools, oprogramowanie zorientowane na prywatność od GhostlyInc, oferuje lekką warstwę automatyzacji dla sieci samodzielnie hostowanych, które wymagają stałej dokładności Cloudflare bez ujawniania danych uwierzytelniających zewnętrznym usługom SaaS.

Spis treści
Wersje i licencjonowanie
Wybierz wersję GhostlyDDns dopasowaną do swojego systemu operacyjnego. Każda licencja Gumroad obejmuje dożywotnie aktualizacje wszystkich wydań GhostlyDDns 1.x, a ta sama konfiguracja YAML działa we wszystkich wersjach.
Do każdej licencji dołączone są dożywotnie aktualizacje wszystkich wydań GhostlyDDns 1.x.
Najważniejsze funkcje
Działania z priorytetem prywatności
Uruchom GhostlyDDns całkowicie na własnej infrastrukturze bez telemetrii, powiązań kont czy zewnętrznych paneli sterowania.
Aktualizacje reagujące na zmiany
Wielopunktowe wykrywanie IP, pamięć podręczna i kontrolowane opóźnienia eliminują zbędne wywołania API Cloudflare.
Wieloplatformowe wdrożenie
Publikowane są pojedyncze pliki binarne .NET 8 dla Windows, Linux i ARM64, dzięki czemu ta sama konfiguracja działa wszędzie.
Przykłady zastosowań
GhostlyDDns pomaga zespołom samodzielnie hostującym, agencjom i pracownikom zdalnym utrzymać ciągłość działania, eliminując ręczne aktualizacje DNS przy zmianie adresów WAN.
- Utrzymuj dostępność bramek VPN w domowym laboratorium po każdej odnowie adresu ISP, bez narażania routerów na zdalne zarządzanie.
- Utrzymuj portale klientów white label na Cloudflare, korzystając z dynamicznych połączeń biurowych do uruchamiania stosu aplikacji.
- Chroń sprzęt nadawczy i studia kreatywne, aktualizując domeny do streamingu nawet podczas przełączania na mobilny backup.
- Wspieraj dostawców usług zarządzanych obsługujących wiele stref klientów za pomocą jednego lekkiego agenta automatyzacji.
Polecenia CLI
CLI GhostlyDDns oferuje dedykowane polecenia do tworzenia konfiguracji, testów, pojedynczych uruchomień i ciągłego monitoringu. Pomoc dostępna przez różne flagi.
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 | -vSchemat konfiguracji
Wszystkie ustawienia działają w jednym pliku YAML. Podaj token API Cloudflare, interwał odpytywania, preferencje wykrywania IP, retencję logów i rekordy do utrzymania. GhostlyDDns weryfikuje schemat przy starcie i generuje ostrzeżenia, gdy brakuje wartości.
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: autoReguły walidacji sprawdzają obecność tokena API, co najmniej jednego rekordu, wartości TTL jako auto lub powyżej 60 oraz co najmniej jeden punkt końcowy dla każdego aktywnego detektora.
Logowanie i diagnostyka
Serilog zapewnia strukturalny output konsoli oraz rotujące pliki logów w katalogu logs. Domyślnie przechowuje 30 plików dziennych, co można dostosować w konfiguracji YAML.
Logi rejestrują wykryte adresy IP, pominięte aktualizacje bez zmian, kody statusu Cloudflare oraz próby ponowienia zgodnie z polityką opóźnień. To zapewnia gotowość GhostlyDDns do pracy bez nadzoru.
Instrukcje wdrożenia
GhostlyDDns zawiera wskazówki dotyczące timerów systemd na Linux i szablonów Windows Task Scheduler, umożliwiając szybkie standaryzowanie automatyzacji.
Usługa systemd na Linux
Zainstaluj plik binarny w usr/local/bin, umieść konfigurację w etc/GhostlyDDns i uruchom agenta na dedykowanym koncie usługi.
[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 systemd na Linux
Połącz timer z usługą, aby planować powtarzające się uruchomienia i stosuj opóźnienia wykładnicze przy problemach z łącznością Cloudflare.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetHarmonogram zadań Windows
Zaimportuj oficjalny szablon XML lub utwórz zadanie z najwyższymi uprawnieniami, które uruchamia polecenie co kilka minut i restartuje się po błędzie.
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
/RL HIGHEST ^
/F- Ścieżka programu C GhostlyDDns ghostly-ddns.exe
- Argumenty run --config C GhostlyDDns config.yaml
- Logi zapisywane są obok pliku wykonywalnego w katalogu logs
Najczęściej zadawane pytania
Poznaj szybkie odpowiedzi na temat możliwości GhostlyDDns, wymagań Cloudflare i praktyk operacyjnych przed wdrożeniem produkcyjnym.
Informacje wsparcia GhostlyDDns
Kolejne kroki
Wybierz preferowaną wersję GhostlyDDns, pobierz plik z Gumroad i wdroż go razem z innymi narzędziami Ghostly Tools od GhostlyInc.
Powiązane materiały
Sprawdź przewodniki, które usprawnią prywatną infrastrukturę i zarządzanie DNS