使用 GhostlyDDns 自动化 Cloudflare 动态 DNS

最后更新 2026/1/29

价格

10 €约 ¥79.80

隐私优先的 .NET 10 命令行工具，保持 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 帮助自托管团队、代理机构和远程工作者，在 WAN 地址变更时自动更新 DNS，保障服务持续在线。

• 每次 ISP 租约更新后，保持家庭实验室 VPN 网关可达，无需暴露路由器进行远程管理。
• 在动态办公网络下运行应用，同时保持 Cloudflare 上的白标客户门户稳定。
• 保护广播设备或创意工作室，确保流媒体接入域名在移动备份启动时依然保持最新。
• 支持托管服务提供商使用单一轻量级自动化代理管理多个客户区域。

命令行指令

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 值为自动或大于 60，且每个启用的检测器至少配置一个端点。

日志与诊断

Serilog 提供结构化控制台输出和滚动文件日志，日志存储于 logs 目录，默认保留 30 天，可通过 YAML 配置自定义。

日志记录检测到的 IP 地址、无变更时跳过的更新、Cloudflare 状态码及指数退避触发的重试活动，确保 GhostlyDDns 适合无人值守生产环境。

部署指南

GhostlyDDns 附带 Linux systemd 计时器和 Windows 任务计划模板，帮助团队快速标准化自动化部署。

[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.target

[Unit]
Description=GhostlyDDns schedule

[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service

[Install]
WantedBy=timers.target

schtasks /Create ^
  /SC MINUTE /MO 5 ^
  /TN "GhostlyDDns" ^
  /TR "C:\\GhostlyDDns\\ghostly-ddns.exe run --config C:\\GhostlyDDns\\config.yaml" ^
  /RL HIGHEST ^
  /F

常见问题解答

部署前快速了解 GhostlyDDns 功能、Cloudflare 要求及操作规范。

下一步

选择合适的 GhostlyDDns 版本，从 Gumroad 下载二进制文件，并与 GhostlyInc 的其他隐私工具一起部署。

相关资源

查看这些指南，提升你的隐私基础设施和 DNS 管理能力