Добавление домена

Пошаговое руководство по подключению custom domain к вашему проекту.

Предварительные требования

• Проект создан в ONREZA
• Успешный деплой (хотя бы один Live деплой)
• Доступ к DNS настройкам или панели регистратора домена

Шаг 1: Добавление домена в ONREZA

1. Откройте настройки домена

   Перейдите в проект → Settings → Domains

2. Выберите окружение

   Домены добавляются к конкретному окружению:

   • Production — для основного сайта
   • Preview — для preview окружения
   • Custom — для пользовательских окружений (staging, etc.)

   Заметка

   Development окружение не поддерживает custom domains.

3. Нажмите “Add Domain”

4. Введите домен

   app.example.com

   Совет

   Вводите домен без https:// и без trailing slash.

5. Подтвердите добавление

   Для внешнего домена ONREZA предложит режим DNS:

   • Делегирование домена — делегировать домен на nameservers ONREZA.
   • Внешний DNS — оставить DNS у текущего провайдера и добавить ALIAS/ANAME или CNAME вручную.

   ONREZA покажет инструкции для выбранного режима.

   Осторожно

   ONREZA сейчас не выдаёт A/AAAA записи для подключения пользовательских доменов. Для поддомена используйте CNAME, для apex домена используйте Делегирование домена или ALIAS/ANAME у DNS провайдера.

Шаг 2: Настройка DNS

После добавления домена настройте DNS по выбранному режиму.

Делегирование домена

Для apex домена (example.com) рекомендуем Делегирование домена.

Осторожно

Делегирование переносит управление всей DNS-зоной в ONREZA. Если у домена есть почта или другие записи — пересоздайте их в ONREZA до смены nameservers, иначе они перестанут работать. См. Почта при делегировании.

1. Откройте панель регистратора домена.
2. Найдите раздел Nameservers или DNS servers.
3. Замените текущие NS на:

Nameserver
ns1.onreza-dns.net
ns2.onreza-dns.net

После делегирования ONREZA автоматически публикует apex, www (если включён редирект) и служебные записи.

Заметка

Меняйте именно nameservers у регистратора. Если вы добавите NS записи внутри старой DNS-зоны, домен не будет делегирован.

Subdomain (app.example.com)

В режиме Внешний DNS для поддоменов создайте CNAME запись:

Тип	Имя	Значение
CNAME	app	cname.onreza.app

Также добавьте TXT запись подтверждения владения из интерфейса ONREZA.

Apex domain (example.com)

В режиме Внешний DNS для apex доменов (без www) добавьте TXT подтверждение владения и ALIAS/ANAME.

Если ваш DNS провайдер поддерживает ALIAS или ANAME:

Тип	Имя	Значение
ALIAS	@	cname.onreza.app

Если ALIAS/ANAME недоступны

Используйте Делегирование домена. ONREZA сейчас не выдаёт A/AAAA записи как поддерживаемый способ подключения.

Альтернатива: поддомен + редирект

1. Добавьте www.example.com как CNAME
2. Настройте редирект с example.com на www.example.com у регистратора

Совет

Делегирование домена обычно проще для apex доменов. Внешний DNS используйте, если не можете менять nameservers.

WWW domain

Для www.example.com:

Тип	Имя	Значение
CNAME	www	cname.onreza.app

Шаг 3: Проверка DNS

1. Дождитесь распространения DNS

   DNS изменения могут занять от нескольких минут до 48 часов.

2. Проверьте статус в ONREZA

   Статус изменится на Validating → Validated

3. Или запустите проверку вручную

   Нажмите Verify рядом с доменом

Проверка через терминал

# Проверить NS делегирование
dig example.com NS +short

# Проверить CNAME запись
dig app.example.com CNAME +short

# Проверить TXT подтверждение владения
dig _onreza-challenge.example.com TXT +short

Шаг 4: SSL сертификат

После проверки DNS, ONREZA автоматически:

1. Запросит SSL сертификат от Let’s Encrypt
2. Установит сертификат
3. Включит HTTPS

Совет

SSL сертификат выпускается автоматически. Обычно это занимает несколько минут после проверки DNS.

Добавление нескольких доменов

Вы можете добавить несколько доменов к одному окружению:

Production:
  - example.com
  - www.example.com
  - app.example.com

Все домены будут вести на один и тот же деплой.

WWW и Non-WWW

Вариант 1: Автоматический редирект (рекомендуется)

1. Добавьте основной домен (example.com)
2. Дождитесь валидации DNS и выпуска SSL
3. Включите “Redirect from WWW” в настройках домена
4. Запросы на www.example.com автоматически перенаправляются на example.com (301)

Совет

При включённом редиректе не нужно добавлять www.example.com отдельно — SSL сертификат и редирект настраиваются автоматически.

Вариант 2: Оба домена независимо

Если вам нужно чтобы оба домена работали без редиректа:

1. Добавьте оба домена (example.com и www.example.com)
2. Настройте DNS для каждого
3. Дождитесь валидации обоих
4. Оба будут работать независимо, указывая на один деплой

Поддомены ONREZA

Вы можете использовать поддомены платформы без настройки DNS:

myapp.onreza.app

Такие домены:

• Работают сразу, без DNS настройки
• Имеют автоматический SSL (wildcard)
• Считаются в лимит custom domains

Удаление домена

1. Откройте Settings → Domains
2. Найдите домен
3. Нажмите удалить (корзина)
4. Подтвердите

Осторожно

После удаления домен сразу перестанет работать. SSL сертификат будет отозван.

Troubleshooting

“Domain already in use”

Домен уже добавлен в другой проект. Удалите его там сначала.

DNS не проверяется

1. Для делегирования проверьте, что nameservers поменяны у регистратора, а не только внутри старой DNS-зоны
2. Для Внешнего DNS проверьте TXT подтверждение владения
3. Проверьте правильность CNAME или ALIAS/ANAME записи
4. Убедитесь что нет конфликтующих записей для того же имени
5. Подождите до 48 часов для распространения

Домен не открывается

1. Проверьте что DNS validated
2. Проверьте что SSL issued
3. Проверьте что есть Live деплой в этом окружении

→ Подробнее о DNS → Подробнее о SSL

См. также

• DNS настройка — детали DNS
• SSL сертификаты — HTTPS
• Окружения — домены по окружениям