Studio

Собственные домены

С собственным доменом ваш лендинг, юридические страницы, пресс-кит, QR-коды и диплинки работают на домене, который принадлежит вам, например get.habitly.app, а HTTPS настраивается за вас. Собственные домены входят в план Studio, который включает до 25 доменов на рабочее пространство. Добавлять их могут владельцы и администраторы рабочего пространства.

Что работает на собственном домене

Каждый домен подключается к одному приложению:

URL	Что открывается
`https://get.habitly.app/`	Лендинг
`/go/{store}`	Отслеживаемое перенаправление в магазин, например `/go/google_play`
`/open/{path}`	Диплинки
`/privacy`, `/terms`	Политика конфиденциальности и условия использования, с необязательным `/{language}`
`/press`, `/press.zip`	Пресс-кит
`/qr.svg`, `/qr.png`	QR-код
`/.well-known/apple-app-site-association` `/.well-known/assetlinks.json`	Файлы ассоциации для Universal Links и Android App Links

В корне домена лендинг показывается всем. В отличие от mapps.one/habitly, корень домена не перенаправляет телефоны в магазин. Используйте умную ссылку, если нужно определение устройства, или get.habitly.app/go/app_store, если нужен один конкретный магазин. URL умной ссылки и QR-кода, которые показываются в панели управления и в API, по-прежнему используют mapps.one.

Перед началом

Используйте поддомен, например get., download. или app.. Стандарт DNS не позволяет создавать записи CNAME для корневого домена, такого как habitly.app.
Вам нужен доступ к настройкам DNS домена у регистратора или DNS-провайдера.
Домен можно подключить только один раз во всём mapps.one.

1. Добавьте домен

В панели управления откройте раздел Домены, нажмите Добавить домен, введите get.habitly.app и выберите приложение, которое будет открываться на этом домене. После этого панель управления покажет DNS-записи, которые нужно создать, включая токен подтверждения, уникальный для вашего домена.

2. Создайте DNS-записи

Тип	Имя	Значение	Назначение
TXT	`_mapps-verify.get.habitly.app`	`mapps-verify=your-token`	Подтверждает, что вы управляете доменом
CNAME	`get.habitly.app`	`domains.mapps.one`	Направляет трафик на mapps.one

Если ваш DNS-провайдер не позволяет создать запись CNAME для этого имени, создайте вместо неё запись A, указывающую на IP-адрес, который показан в панели управления.

Многие DNS-провайдеры автоматически дописывают корневой домен. В этом случае введите только часть перед ним: _mapps-verify.get для записи TXT и get для записи CNAME.

Используете Cloudflare? Переключите запись CNAME в режим DNS only (серое облако). Если запись проксируется, сертификат не удастся выпустить и посетители увидят ошибку.

3. Подтвердите домен

Нажмите Подтвердить сейчас рядом с доменом. Мы проверим запись TXT и то, куда указывает домен. Ожидающие домены также проверяются автоматически каждые 10 минут, поэтому можно закрыть страницу и вернуться позже. Изменения DNS обычно появляются в течение нескольких минут, но у некоторых провайдеров это занимает несколько часов.

Статус	Значение
Ожидает	Ожидается появление DNS-записей
Подтверждён	На домене работает ваше приложение
Ошибка	Запись отсутствует или указана неверно. Панель управления показывает причину. Исправьте запись и подтвердите домен снова.

После успешного подтверждения отправляется вебхук domain.verified.

HTTPS

Сертификат TLS выпускается автоматически, когда кто-то впервые открывает домен по HTTPS после подтверждения. Этот первый запрос может занять несколько секунд, а последующие выполняются быстро. Ничего не нужно загружать или продлевать.

Устранение неполадок

Проверьте, что видят остальные, с помощью dig или любого онлайн-инструмента для DNS-запросов:

dig +short TXT _mapps-verify.get.habitly.app
"mapps-verify=your-token"

dig +short CNAME get.habitly.app
domains.mapps.one.

Имя удвоено, например get.habitly.app.habitly.app: ваш провайдер дописал корневой домен. Введите только get.
Существует другая запись с тем же именем, например старая запись A. Удалите её, потому что у CNAME не может быть общего имени с другими записями.
Перед доменом стоит прокси или CDN: переключите запись в режим DNS only.
Записи CAA вашего домена, которые разрешают только определённый центр сертификации, могут блокировать выпуск сертификата. Удалите или дополните их.

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

Удалите домен в панели управления, затем удалите DNS-записи у своего провайдера. Если рабочее пространство переходит с плана Studio на другой план, его собственные домены перестают показывать страницы, пока вы снова не перейдёте на Studio. Ссылки на mapps.one продолжают работать.