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

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

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

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

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

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

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

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

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

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

   Заметка

   Preview окружения не поддерживают custom domains — используйте технические URL.

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

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

   app.example.com

   Совет

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

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

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

   • Managed NS — делегировать домен на nameservers ONREZA.
   • External DNS — оставить DNS у текущего провайдера и добавить записи вручную.

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

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

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

Managed NS

Для apex домена (example.com) рекомендуем Managed NS.

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

Nameserver
ns1.onreza.ru
ns2.onreza.ru

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

Заметка

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

Subdomain (app.example.com)

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

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

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

Apex domain (example.com)

В режиме External DNS для apex доменов (без www) добавьте TXT подтверждение владения и routing записи.

Вариант 1: A запись (универсальный)

Работает у любого DNS провайдера:

Тип	Имя	Значение
A	@	IPv4 адрес из интерфейса ONREZA
AAAA	@	IPv6 адрес из интерфейса ONREZA

Вариант 2: ALIAS/ANAME запись

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

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

Вариант 3: Поддомен + редирект

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

Совет

Managed NS обычно проще для apex доменов. External 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.app.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. Для Managed NS проверьте, что NS поменяны у регистратора, а не только внутри старой DNS-зоны
2. Для External DNS проверьте TXT подтверждение владения
3. Проверьте правильность CNAME/A/AAAA записи
4. Убедитесь что нет конфликтующих записей для того же имени
5. Подождите до 48 часов для распространения

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

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

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

См. также

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