使用 GhostlyDDns 自動化 Cloudflare 動態 DNS
專注隱私的 .NET 10 CLI 工具,保持 Cloudflare DNS 紀錄與動態 IP 同步。無遙測,YAML 配置,跨平台支援。
GhostlyDDns 是一款專注隱私的 .NET 8 命令列代理,能保持現有 Cloudflare A 與 AAAA 紀錄與您網路邊緣的公開 IP 同步。它屬於 Ghostly Tools 套件,為開發者、創作者及自架主機者提供可靠的 Cloudflare 動態 DNS 自動化方案,無需託管服務。
執行時會監控您的 WAN 位址,透過多個端點偵測 IPv4 和 IPv6 變更,僅在需要更新時呼叫 Cloudflare API。採用 Serilog 診斷、嚴謹的指數退避機制及一致的退出代碼,確保團隊能有效監控無人值守運作。
GhostlyInc 推出的 Ghostly Tools 中的 GhostlyDDns,是一款專注隱私的輕量自動化軟體,適合自架網路持續維護 Cloudflare 精準度,且不需將憑證暴露給外部 SaaS 服務。

目錄
版本與授權
選擇符合您作業系統的 GhostlyDDns 版本。每張 Gumroad 授權包含所有 GhostlyDDns 1.x 版本的終身更新,且相同 YAML 配置可跨版本使用。
每張授權均包含所有 GhostlyDDns 1.x 版本的終身更新。
功能重點
隱私優先運作
GhostlyDDns 完全在您的基礎架構上執行,無遙測、無帳號綁定,也無外部控制平臺。
變更感知更新
多端點 IP 偵測、記憶體快取與嚴謹退避機制,避免重複呼叫 Cloudflare API。
跨平台部署
發佈單一檔案 .NET 8 執行檔,支援 Windows、Linux 與 ARM64,讓您在各平台共用相同配置檔。
使用案例
GhostlyDDns 協助自架團隊、代理商及遠端工作者,透過自動更新避免 WAN 位址變更時的手動 DNS 維護,確保服務不中斷。
- 每次 ISP 租約更新後,保持自家實驗室 VPN 閘道可連線,且不需將路由器暴露於遠端管理。
- 在 Cloudflare 維護白標客戶入口網站,同時從動態辦公網路連線執行應用程式堆疊。
- 即使啟動行動備援,也能保持直播串流接收域名最新,保障廣播設備或創意工作室的穩定運作。
- 支援管理多個客戶區域的託管服務提供商,僅需一個輕量自動化代理即可。
CLI 指令
GhostlyDDns CLI 提供配置腳手架、模擬執行、單次執行及持續監控等專用指令,多種旗標可呼叫內建說明。
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 | -v配置架構
所有執行時設定集中於單一 YAML 檔案,包含 Cloudflare API 令牌、輪詢間隔、IP 偵測偏好、日誌保留及需維護的紀錄。GhostlyDDns 啟動時會驗證架構,並在缺值時發出可操作警告。
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: auto驗證規則確保 API 令牌存在、至少定義一筆紀錄、TTL 值為自動或大於六十,且每個啟用的偵測器至少有一個端點。
日誌與診斷
Serilog 提供結構化主控台輸出及滾動檔案日誌,存放於 logs 目錄。預設保留三十天日誌,可透過 YAML 配置自訂。
日誌記錄偵測到的 IP 位址、無變更時跳過更新、Cloudflare 狀態碼及指數退避重試活動,確保 GhostlyDDns 適合無人值守生產環境。
部署指南
GhostlyDDns 附帶 Linux systemd 計時器及 Windows 工作排程範本指引,讓團隊能在數分鐘內標準化自動化流程。
Linux systemd 服務
將執行檔安裝於 usr local bin,配置檔放置於 etc GhostlyDDns,並以專用服務帳號執行代理程式。
[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.targetLinux systemd 計時器
將計時器與服務配對,排程重複執行,並在 Cloudflare 連線不穩時使用指數退避。
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetWindows 工作排程
匯入官方 XML 範本,或建立具最高權限的工作,每隔幾分鐘執行 run 指令,失敗時自動重啟。
schtasks /Create ^
/SC MINUTE /MO 5 ^
/TN "GhostlyDDns" ^
/TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
/RL HIGHEST ^
/F- 程式路徑 C GhostlyDDns ghostly-ddns.exe
- 參數 run --config C GhostlyDDns config.yaml
- 日誌寫入執行檔旁的 logs 目錄中
常見問題
部署前快速了解 GhostlyDDns 功能、Cloudflare 要求及操作實務。
GhostlyDDns 支援說明
後續步驟
選擇您偏好的 GhostlyDDns 版本,從 Gumroad 下載執行檔,並與其他 GhostlyInc 的隱私工具一同部署。
相關資源
探索這些指南,提升您的隱私基礎架構與 DNS 管理