AltDNS — быстрый старт: установка, лицензия, первая зона

Что понадобится

Сервер: Debian 12/13 или Ubuntu, root-доступ, 1 ГБ RAM, открытые порты 53 (TCP/UDP), 80 и 443.
Домен: например dns.example.com — для панели, и рабочие домены, которые будете обслуживать.
Лицензия: файл license.json от поставщика. Без него работает триал 14 дней.

1Установка из одного файла (.run)

Получите инсталлятор и лицензию, скопируйте на сервер и запустите одной командой. Скрипт поставит PostgreSQL, PowerDNS, nginx и сам сервис, настроит API, TLS и бэкапы.

scp altdns-installer.run root@SERVER:/root/
ssh root@SERVER
chmod +x /root/altdns-installer.run
./altdns-installer.run --domain dns.example.com --email admin@example.com

В конце установщик печатает адрес панели, логин admin, пароль администратора и API-ключ. Они же сохраняются в файл /root/altdns-credentials.txt (права 600) — сразу перенесите пароль в менеджер паролей.

Установка идемпотентна: повторный запуск обновляет конфиги и сервис, не трогая данные. Для чистого стенда без домена добавьте --no-tls, для проверки плана — --dry-run.

Вариант из поставки: распакуйте каталог в /opt/altdns и выполните install-altdns.sh --domain dns.example.com --email admin@example.com — результат тот же.

2Активация лицензии

Войдите в панель и откройте Настройки → Лицензия. Вставьте JSON лицензии в поле активации и нажмите «Активировать»; там же видны статус, срок и лимиты (домены, зоны, API-ключи).

Если лицензия ещё не нужна — панель работает в триале 14 дней с ограниченными лимитами, затем 7 дней grace-периода. Статус всегда виден в Настройки → О продукте, там же версия панели и история изменений.

3Первый домен и зона

Порядок такой: сначала зона в PowerDNS, затем запись в реестре панели.

Зона: /dns → раскрытая строка зоны или кнопка добавления → укажите example.com. Можно включить автозаполнение — панель создаст SOA, NS, SPF, DKIM и DMARC-заготовки. До 200 зон можно добавить пакетно.
Домен: /domains → «Добавить пакетно» → одна строка на домен. Здесь хранятся группа, IP, статус, регистратор — это реестр панели, он питает проверки, алерты и прогрев.
Перенос существующих зон: импорт по AXFR с текущих NS прямо из интерфейса — панель заберёт записи и создаст зону.

4NS-записи у регистратора

В зоне заведите NS-записи на свои серверы (при автозаполнении они уже созданы), затем у регистратора домена укажите эти же NS. В списке зон панель показывает статус делегации и предупреждает, если NS не отвечают.

example.com.  3600  IN  NS  ns1.example.com.
example.com.  3600  IN  NS  ns2.example.com.

После смены NS подождите обновления TTL у провайдера. Проверить, что зона видна снаружи, можно в карточке домена — панель делает публичные DNS-запросы.

5Первая DNS-запись

В раскрытой зоне на /dns добавьте нужные записи: A/AAAA для хостов, MX для почты, TXT для SPF/DKIM/DMARC, CNAME для поддоменов. TTL по умолчанию 300–3600 секунд.

@      A      203.0.113.10    TTL 300
@      MX     10 mail.example.com.
www    A      203.0.113.11    TTL 300

Панель не даст создать CNAME там, где уже есть другие записи этого имени, и проверит формат IP, TTL и приоритетов. История правок хранится у каждой зоны.

6DKIM: ключ и TXT-запись

Откройте /dkim или карточку домена и сгенерируйте ключ (1024, 2048 или 4096 бит). Панель сразу опубликует публичную часть как TXT-запись вида s1._domainkey.example.com; приватный ключ хранится в панели и не отдаётся наружу.

Проверьте готовность домена одной кнопкой: SPF, DKIM, DMARC, PTR, DNSBL и делегация. DKIM-ключи можно ротировать: новый селектор, перекрытие и авто-уборка старых — в карточке ротации на /dmarc.

7Настройка гео-маршрутизации и failover

Гео и отказоустойчивость работают на уровне DNS: разным регионам можно отдавать разные IP, а при падении узла трафик автоматически уходит на backup. В раскрытой строке зоны нажмите кнопку маршрута и выберите режим.

Режим	Что делает
geo	Отдаёт IP по стране или континенту резолвера, с дефолтной веткой.
closest	Выбирает ближайший по сети IP из пула.
failover	Проверяет порт или URL и переключает на backup при сбое.
geo_failover	Гео-ветки, внутри каждой — свой health-check.

Перед сохранением панель покажет предпросмотр сгенерированного правила. База GeoIP и движок Lua-записей ставятся установщиком автоматически; подробности — в справке панели.

8Бэкапы и обновления

Установщик включает ежедневный бэкап: дампы баз панели и PowerDNS в /var/backups/altdns-db/<дата>/ в 04:15 с хранением 14 дней, вынос копий — отдельной задачей. Вручную и восстановление:

./backup-altdns.sh                       # бэкап баз и конфигов
./restore-altdns.sh /root/backups/altdns/<архив>.tar.gz   # восстановление

Обновление версии делается с бэкапом и health-check: ./upgrade-altdns.sh --src root@host:/path/to/dns. Сроки хранения истории и логов настраиваются в Настройки → Данные и ретеншен.

9Опционально: DNSSEC и вторичный NS

DNSSEC: включите в раскрытой зоне, скопируйте DS-записи и добавьте их у регистратора. Подпись и DS панель формирует сама; автопубликации DS и rollover нет — ключи меняются вручную.
Вторичный NS: укажите IP резервного сервера в DNS_ALLOW_AXFR_IPS и перезапустите деплой — зоны типа MASTER будут отдаваться ему по AXFR. На вторичном сервере включите DNS_SECONDARY=1 и создайте зону типа SLAVE с полем Master. Полные шаги и риски — в разделе «Вторичный NS» на странице /guide внутри панели.

10Где искать справку

Раздел	Что там
/guide	Полная справка: зоны, записи, DKIM, DNSSEC, вторичный NS, гео, мониторинг, DMARC, API, бэкапы.
/docs	Swagger-спецификация API и ключи доступа.
Настройки → О продукте	Версия панели, история изменений, лицензия и ресурсы.
Настройки → Помощь	Админ-гайд и гайд по миграции прямо в интерфейсе.

Не получается установка или делегация — напишите нам в Telegram (кнопка в шапке сайта), поможем разобрать конфигурацию. Условия лицензии — на странице Условия использования, порядок получения — Как получить продукт.

Быстрый старт: от установки до первой рабочей зоны.