Автоматизация динамического DNS Cloudflare с GhostlyDDns
Конфиденциальный CLI-инструмент .NET 10 для синхронизации DNS-записей Cloudflare с вашим динамическим IP. Без телеметрии, конфигурация YAML, кроссплатформенность.
GhostlyDDns — это конфиденциальный командный агент на dotnet 8, который синхронизирует существующие записи A и AAAA Cloudflare с публичным IP вашего сетевого края. Входит в состав Ghostly Tools и обеспечивает разработчикам, создателям и хостерам надёжную автоматизацию динамического DNS Cloudflare без использования управляемых сервисов.
Среда выполнения отслеживает ваш WAN-адрес, обнаруживает изменения IPv4 и IPv6 через несколько точек и обращается к API Cloudflare только при необходимости обновления. Диагностика на базе Serilog, контролируемое экспоненциальное ожидание и стабильные коды выхода обеспечивают необходимую наблюдаемость для автономной работы.
GhostlyDDns от Ghostly Tools — это конфиденциальное ПО от GhostlyInc, предоставляющее лёгкий уровень автоматизации для самоуправляемых сетей, которым нужна постоянная точность Cloudflare без раскрытия учётных данных внешним SaaS-сервисам.

Содержание
Редакции и лицензирование
Выберите сборку GhostlyDDns, соответствующую вашей ОС. Каждая лицензия Gumroad включает пожизненные обновления для всех версий GhostlyDDns 1.x, а одна и та же конфигурация YAML работает во всех редакциях.
Пожизненные обновления для всех версий GhostlyDDns 1.x включены в каждую лицензию.
Основные функции
Операции с приоритетом конфиденциальности
Запускайте GhostlyDDns полностью на своей инфраструктуре без телеметрии, привязки аккаунта и внешних управляющих систем.
Обновления с учётом изменений
Обнаружение IP с нескольких точек, кэширование в памяти и контролируемое ожидание исключают избыточные вызовы API Cloudflare.
Кроссплатформенное развертывание
Однофайловые бинарники .NET 8 выпускаются для Windows, Linux и ARM64, что позволяет использовать одну конфигурацию везде.
Примеры использования
GhostlyDDns помогает командам, агентствам и удалённым сотрудникам поддерживать доступность, устраняя ручные обновления DNS при смене WAN-адресов.
- Обеспечьте доступность VPN-шлюзов домашней сети после каждого обновления IP у провайдера без удалённого управления роутерами.
- Поддерживайте белые клиентские порталы на Cloudflare, работая с динамическими офисными подключениями.
- Защитите вещательное оборудование или студии, поддерживая актуальность доменов потоковой передачи даже при переключении на мобильный резерв.
- Поддерживайте MSP, управляющих несколькими зонами клиентов, с помощью одного лёгкого агента автоматизации.
Команды CLI
CLI GhostlyDDns предоставляет команды для создания конфигураций, тестовых запусков, однократного выполнения и постоянного мониторинга. Встроенная помощь доступна через несколько флагов.
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-файле. Укажите API-токен Cloudflare, интервал опроса, параметры обнаружения 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 — auto или больше 60, а у каждого активного детектора есть минимум одна точка.
Логирование и диагностика
Serilog обеспечивает структурированный вывод в консоль и ротацию файлов логов в каталоге logs. Хранение по умолчанию — 30 файлов, настраивается через YAML.
Логи фиксируют обнаруженные IP, пропущенные обновления при отсутствии изменений, коды статуса Cloudflare и повторные попытки по политике экспоненциального ожидания. Это обеспечивает готовность GhostlyDDns к автономной работе.
Инструкции по развертыванию
GhostlyDDns поставляется с рекомендациями по таймерам systemd для Linux и шаблонам планировщика задач 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.targetТаймер Linux systemd
Свяжите таймер со службой для повторных запусков и используйте экспоненциальное ожидание при сбоях подключения к Cloudflare.
[Unit]
Description=GhostlyDDns schedule
[Timer]
OnUnitActiveSec=120
AccuracySec=1s
Unit=ghostly-ddns.service
[Install]
WantedBy=timers.targetПланировщик задач Windows
Импортируйте официальный 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 и разверните вместе с другими конфиденциальными утилитами Ghostly Tools от GhostlyInc.
Связанные материалы
Изучите эти руководства для улучшения конфиденциальной инфраструктуры и управления DNS