Подключите личный домен

Вам не нужно отказываться от уникальных доменных имён, отражающих ваш бренд, для приложений, развёрнутых на Firebase App Hosting . Вы можете использовать собственный домен (например, example.com или app.example.com ) вместо домена, сгенерированного Firebase, для вашего сайта, размещённого на Firebase. Firebase App Hosting предоставляет SSL-сертификат для каждого вашего домена.

Далее в этом документе вы узнаете, как подключить пользовательский домен одним из следующих способов:

• Перенести домен
• Подключить новый домен

Для обеспечения бесперебойной работы ваши записи DNS должны обновляться в определённом порядке. Следуйте инструкциям по миграции домена , чтобы предотвратить простои вашего приложения.

Если время простоя не является проблемой, например, когда вы подключаете новый домен к своему веб-приложению, следуйте инструкциям по подключению нового домена .

Прежде чем начать: типы записей DNS

Мастер настройки домена App Hosting может попросить вас добавить или удалить от 1 до 5 DNS-записей в зависимости от текущей конфигурации вашего домена. Тип записи определяет её функцию. Вот типы записей, которые может запросить App Hosting :

Тип	Описание	Эксклюзив
А	Эти записи содержат значения IPv4 (например, 8.8.8.8), которые сообщают браузерам, какой адрес использовать при попытке связаться с вашим доменом.	Да
АААА	Эти записи содержат значения IPv6 (например, 2001:4860:4860::8888) — другой тип адресной записи с примерно той же функцией, что и записи A. App Hosting в настоящее время не использует записи AAAA, но попросит вас удалить любые существующие записи из нашего домена, если таковые имеются.	Да
CNAME	Эти записи содержат отдельное доменное имя, которое следует использовать вместо вашего текущего домена для разрешения DNS-запросов. Записи CNAME разрешены только для поддоменов (например, www.example.com). App Hosting использует записи CNAME по двум причинам: Простая регистрация: если это возможно, App Hosting попросит вас выполнить CNAME для предварительно настроенного домена, который начинается с _custom-domain... . Проверка SSL-сертификата: App Hosting использует Cloud Certificate Manager для предоставления SSL-сертификатов для вашего пользовательского домена. Запись CNAME в поддомене _acme-challenge... позволяет Certificate Manager создавать и обновлять ваши сертификаты. После подключения эту запись нельзя удалять , иначе срок действия вашего сертификата истечёт.	Да
ТЕКСТ	Эти записи позволяют добавлять произвольные метаданные к вашему домену. App Hosting позволяет использовать TXT-запись специального формата, fah-claim=[UUID] , для указания того, какой пользовательский домен должен обслуживаться на вашем домене.	Нет
CAA	Эти записи служат списком разрешенных центров сертификации, уполномоченных выпускать SSL-сертификаты для вашего домена. App Hosting запрашивает записи CAA только в том случае, если ему запрещено выпускать сертификаты для вашего домена.	Нет

Прежде чем начать: ваше доменное имя

При добавлении или редактировании записей DNS разные провайдеры доменов ожидают, что вы введете разные значения в поле « Хост» (или «Имя хоста ») на своих сайтах управления DNS. Мастер настройки домена App Hosting требует ввести то же значение в поле «Имя» .

Ниже мы собрали распространённые рекомендации от популярных провайдеров. Подробные инструкции см. в документации вашего провайдера домена .

Тип домена	Пользовательское доменное имя
Апексный домен	Общие входные данные включают в себя: @ Верхнее доменное имя (например, example .com ) Оставьте поле «Хост» пустым
Поддомен	Общие входные данные включают в себя: Полное имя поддомена (например, app. example .com ) Только часть поддомена (например, только app , без . example .com )

Распространенные поставщики доменов

Ниже перечислены некоторые распространённые поставщики доменов и типы данных, которые могут потребоваться для каждого из них. Эта информация постоянно актуализируется, но подробные инструкции можно найти в документации вашего поставщика доменов .

Cloudflare

Хозяин	Вход
example.com.	@
www.example.com.	www

Google Cloud DNS

Хозяин	Вход
example.com.	.example.com.
www.example.com.	www .example.com.

ИмяДешёвый

Хозяин	Вход
example.com.	@
www.example.com.	www

Квадратное пространство

Хозяин	Вход
example.com.	@
www.example.com.	www

Перенести домен

Если вы хотите перенести свой домен от другого провайдера на App Hosting без простоев, вы можете воспользоваться функцией «Миграция домена» в консоли Firebase. Эта процедура включает в себя два этапа подготовки App Hosting к размещению контента на вашем домене перед перенаправлением трафика на серверы App Hosting .

Шаг 1: Добавьте пользовательский домен

1. Откройте страницу App Hosting вашего проекта.
2. Выберите серверную часть App Hosting с помощью параметра «Просмотр панели управления» .
3. Выберите вкладку «Настройки» , затем нажмите «Добавить пользовательский домен» .
4. Введите пользовательское доменное имя, которое вы хотите подключить к своему сайту App Hosting .
5. (Необязательно) Установите флажок, чтобы перенаправлять все запросы на пользовательском домене на второй указанный домен (например, чтобы example.com и www.example.com перенаправляли на один и тот же контент).
6. Нажмите «Продолжить настройку» , чтобы настроить записи DNS и завершить настройку вашего домена.

Шаг 2: Подготовка домена

1. Выберите вкладку «Миграция домена» в мастере настройки домена .
2. Следуйте инструкциям на первом этапе «Подготовка домена» , который включает в себя набор изменений, необходимых для того, чтобы App Hosting обслуживал ваш предпочтительный бэкэнд и устанавливал безопасные TLS-подключения для вашего домена. Добавьте, удалите и сохраните записи вашего домена у вашего DNS-провайдера, используя следующие входные данные для необходимых записей:
   • Имя : введите имя вашего домена для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть доменом верхнего уровня или поддоменом. Ваш провайдер домена может использовать этот термин как «Имя хоста», «Имя» или «Домен».
   • Тип записи : добавьте предоставленную запись DNS.
   • Значение : присвойте предоставленное значение вашим записям. Ваш провайдер домена может указывать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес». Содержимое поля «Значение» зависит от типа записи; например, записи TXT представляют собой строки.
3. Выберите «Проверить записи» . App Hosting попытается обнаружить изменения, внесённые вами в домен провайдера. Распространение изменений может занять до 24 часов. Вы можете проверить статус в разделе «Настройки» > «Домены» на панели управления.

Шаг 3: Прямой доступ к App Hosting

1. После того, как App Hosting проверит обновления записей, полученные на предыдущем этапе, мастер перейдет к последнему этапу «Направление на App Hosting . На этом этапе отображаются обновления записей, которые необходимо внести для перенаправления трафика вашего домена на серверы App Hosting . Как и прежде, добавьте, удалите и сохраните записи вашего домена у вашего DNS-провайдера, указав следующие параметры для необходимых записей:
   • Имя : введите имя вашего домена для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть доменом верхнего уровня или поддоменом. Ваш провайдер домена может использовать этот термин как «Имя хоста», «Имя» или «Домен».
   • Тип записи : добавьте предоставленную запись DNS.
   • Значение : присвойте предоставленное значение вашим записям. Ваш провайдер домена может указывать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес». Содержимое поля «Значение» зависит от типа записи; например, записи TXT представляют собой строки.
2. Выберите «Проверить записи» . App Hosting попытается обнаружить изменения, внесённые вами в домен провайдера. Распространение изменений может занять до 24 часов. Вы можете проверить статус в разделе «Настройки» > «Домены» на панели управления.

Подключить новый домен

Если время простоя не является проблемой, например, когда вы подключаете новый домен к своему веб-приложению, следуйте инструкциям в этом разделе.

Шаг 1: Добавьте пользовательский домен

1. Откройте страницу App Hosting вашего проекта.
2. Выберите серверную часть App Hosting с помощью параметра «Просмотр панели управления» .
3. Выберите вкладку «Настройки» , затем нажмите «Добавить пользовательский домен» .
4. Введите пользовательское доменное имя, которое вы хотите подключить к своему сайту App Hosting .
5. (Необязательно) Установите флажок, чтобы перенаправлять все запросы на пользовательском домене на второй указанный домен (например, чтобы example.com и www.example.com перенаправляли на один и тот же контент).
6. Нажмите «Продолжить настройку» , чтобы настроить записи DNS и завершить настройку вашего домена.

Шаг 2: Проверка записей DNS

1. Мастер настройки домена в консоли Firebase покажет необходимые записи, которые необходимо обновить, чтобы направить вашу страницу в Firebase App Hosting. Добавьте, удалите и сохраните записи вашего домена в DNS-провайдере, используя следующие данные:
   • Имя : введите имя вашего домена для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть доменом верхнего уровня или поддоменом. Ваш провайдер домена может использовать этот термин как «Имя хоста», «Имя» или «Домен».
   • Тип записи : добавьте предоставленную запись DNS.
   • Значение : присвойте предоставленное значение вашим записям. Ваш провайдер домена может указывать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес». Содержимое поля «Значение» зависит от типа записи; например, записи TXT представляют собой строки.
2. Выберите «Проверить записи» . App Hosting попытается обнаружить изменения, внесённые вами в домен провайдера. Распространение изменений может занять до 24 часов. Вы можете проверить статус в разделе «Настройки» > «Домены» на панели управления.

Дождитесь предоставления SSL-сертификата.

App Hosting может потребовать до нескольких часов для подготовки SSL-сертификата для вашего домена после обновления записей DNS. В некоторых случаях это может занять до 24 часов после того, как вы перенаправите свой DNS на Firebase App Hosting .

Вы можете просмотреть этот сертификат с помощью инструментов безопасности браузера. Во время подготовки домена вы можете увидеть недействительный сертификат или столкнуться с проблемами подключения к нему. Это нормальная часть процесса, которая будет устранена после того, как сертификат вашего домена станет доступен.

Примечание: Firebase App Hosting автоматически повторно предоставляет SSL-сертификаты по мере необходимости для пользовательских доменов.

Описания статусов для пользовательских доменов

Статус	Описание
Требуется настройка	Возможно, вам придется изменить конфигурацию записей DNS. В большинстве случаев ваши записи DNS A не распространяются от поставщика доменного имени на серверы Firebase App Hosting . Совет по устранению неполадок: если прошло более 24 часов, проверьте, что вы направили свои записи в Firebase App Hosting . В более редких случаях SSL-запросы могут не работать, поскольку ваши записи DNS содержат записи A или CNAME, указывающие на других провайдеров хостинга. Совет по устранению неполадок: убедитесь, что ваши записи A указывают только на Firebase App Hosting , и удалите все записи CNAME.
В ожидании	Вы правильно настроили свой пользовательский домен, но Firebase App Hosting не предоставил SSL-сертификат. Иногда чрезмерно строгие записи CAA могут препятствовать созданию SSL-сертификата для вашего домена. Убедитесь, что центрам сертификации letsencrypt.org и pki.goog разрешено создавать SSL-сертификаты для вашего домена.
Сертификат чеканки	Для вашего домена создается SSL-сертификат.
Подключен	Ваш пользовательский домен имеет соответствующие записи DNS и сертификат SSL. Вы можете обслуживать контент своего сайта.