Кастомные домены

Каждый проект получает адрес <org>-<project>.layero.ru. Но можно привязать и свой домен, купленный у любого регистратора — например my-site.ru или shop.my-site.ru. Это не редирект: ваш домен начинает по-настоящему обслуживать проект, с собственным HTTPS-сертификатом.

Кастомный домен ведёт себя так же, как основной адрес: показывает тот деплой, на который указывает production-pointer. Promote и rollback работают на нём без изменений.

:::note Бета Раздел «Домены» сейчас в бета-доступе. В сайдбаре проекта он помечен как «Скоро» — нажмите в открывшемся окне кнопку «Бета-версия», чтобы зайти в рабочий мастер привязки. :::

Как подключить

1. Откройте проект → в сайдбаре Домены.
2. Введите домен — my-site.ru или shop.my-site.ru. Layero сам определит, корневой это домен или поддомен, и распознает вашего регистратора по DNS.
3. Нажмите Подключить. Появится карточка домена с пошаговым чеклистом и двумя DNS-записями, которые нужно добавить.
4. Откройте панель управления у вашего регистратора, добавьте записи (мастер показывает инструкцию под ваш конкретный регистратор) и сохраните.
5. Дальше ничего нажимать не нужно. Layero проверяет DNS каждые 10 секунд, сам выпускает сертификат и подключает домен. Карточка обновляет статус в реальном времени.

Какие DNS-записи нужны

Всего две. Тип первой зависит от того, корневой у вас домен или поддомен.

Домен	Запись «куда смотрит»	Запись подтверждения
Корневой (my-site.ru)	A → IP-адрес Layero	TXT _layero-verify
Поддомен (shop.my-site.ru)	CNAME → cname.layero.ru	TXT _layero-verify.shop

Точные значения (IP-адрес, значение TXT) мастер показывает в карточке домена — каждое значение копируется в один клик.

Третья запись для сертификата не нужна: Layero проверяет владение доменом по HTTP, как только домен начинает указывать на платформу.

Корневой домен и поддомен

• Корневой домен (my-site.ru) — нужна A-запись на IP Layero. Стандарт DNS запрещает CNAME в корне зоны, поэтому только A.
• Поддомен (shop.my-site.ru, test.my-site.ru) — CNAME на cname.layero.ru. Поддомен любого уровня (api.v2.my-site.ru тоже) работает так же.

Поддомен через CNAME — даже надёжнее: если инфраструктура Layero сменит IP, поддоменные домены переедут автоматически, ничего переписывать не придётся.

Инструкция под ваш регистратор

Мастер сам подбирает пошаговую инструкцию для популярных регистраторов: REG.RU, Cloudflare, Beget, GoDaddy, Namecheap. Для остальных — общая инструкция и поддержка.

Несколько важных нюансов:

• REG.RU с хостингом. Если у домена NS-серверы ns1.hosting.reg.ru, DNS-записи редактируются не в карточке домена, а в панели хостинга (ISPmanager). Мастер ведёт по этому пути. Для корня домена поле «Имя» оставляйте пустым — ISPmanager сам подставит домен.
• Cloudflare. Для добавленных записей выставьте Proxy status → «DNS only» (серое облачко). Оранжевое облако (proxy) ломает наш TLS — Cloudflare попытается подменить сертификат.
• TXT без кавычек. Значение TXT-записи вставляйте как есть, без кавычек по краям — большинство панелей оборачивают их сами.

Частые проблемы

• Парковочные записи регистратора. Многие регистраторы при покупке домена ставят свои «парковочные» A- и AAAA-записи. Их нужно удалить, иначе домен будет открываться через раз (часть запросов уйдёт на парковку).
• AAAA-запись (IPv6). Layero пока работает только по IPv4. Любая AAAA-запись на домене ломает выпуск сертификата (Let's Encrypt предпочитает IPv6) — удалите её. Мастер подскажет, если увидит AAAA.
• DNS обновляется не мгновенно. После сохранения у регистратора записи распространяются от 5 минут до часа. Layero дождётся сам — страницу можно не держать открытой.

Сколько ждать

Этап	Время
Распространение DNS у регистратора	5 минут – 1 час
Проверка владения + выпуск сертификата Let's Encrypt	30–90 секунд после того, как DNS виден
Подключение к серверу	~10 секунд

Итого: от пары минут до часа, и почти всё это время — ожидание DNS у вашего регистратора, на которое Layero повлиять не может.

Свой сертификат (BYOC)

Если у вас уже есть готовый TLS-сертификат для домена (например, EV-сертификат от вашего провайдера), его можно загрузить вместо выпуска через Let's Encrypt. В карточке домена — раздел «У меня уже есть сертификат»: вставьте PEM-сертификат и приватный ключ. HTTPS заработает сразу, без обращения к Let's Encrypt. Подтверждение владения доменом (TXT-запись) всё равно требуется.

Куда ведёт домен

По умолчанию кастомный домен показывает production-деплой проекта — то же, что и основной адрес. В карточке домена, в разделе «Куда ведёт этот домен», можно прицепить домен к конкретной ветке — удобно, чтобы, например, выделить ветку staging на отдельный поддомен.

Продление сертификата

Сертификат Let's Encrypt действует 90 дней. Layero продлевает его автоматически примерно за 30 дней до истечения — без вашего участия и без перерыва в работе сайта. Загруженные вручную сертификаты (BYOC) нужно обновлять самостоятельно.

Что Layero не делает

• Не покупает домены. Регистрируйте их у любого регистратора.
• Не управляет вашей DNS-зоной. Layero даёт точные инструкции, но записи добавляете вы.
• Не настраивает редирект www ↔ корень. Это решается на стороне регистратора или приложения.

Отвязка

В карточке домена — крестик в правом верхнем углу. Layero удалит сертификат и конфигурацию. DNS-записи в своей зоне уберите вручную.