Автоматизация динамического DNS Cloudflare с GhostlyDDns

Последнее обновление 29.01.2026
Цена
10 €Примерно 966,50 ₽

Конфиденциальный 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 CLI для синхронизации DNS-записей Cloudflare с динамическим IP
CLI с приоритетом конфиденциальности, который поддерживает синхронизацию существующих записей A и AAAA в Cloudflare без использования внешних сервисов.

Редакции и лицензирование

Выберите сборку 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 предоставляет команды для создания конфигураций, тестовых запусков, однократного выполнения и постоянного мониторинга. Встроенная помощь доступна через несколько флагов.

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-файле. Укажите API-токен Cloudflare, интервал опроса, параметры обнаружения IP, хранение логов и записи для поддержки. GhostlyDDns проверяет схему при запуске и выдаёт предупреждения при отсутствии значений.

YAML
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, запустите агент от отдельного сервисного аккаунта.

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

systemd
[Unit]
Description=GhostlyDDns schedule

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

[Install]
WantedBy=timers.target

Планировщик задач Windows

Импортируйте официальный XML-шаблон или создайте задачу с максимальными правами, которая запускает команду run каждые несколько минут и перезапускается при сбое.

Task Scheduler
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