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

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

Остальная часть этого документа описывает шаги по подключению личного домена одним из следующих способов:

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

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

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

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

Прежде чем начать: типы записей 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... позволяет диспетчеру сертификатов создавать и обновлять сертификаты за вас. После регистрации эту запись нельзя удалять , иначе срок действия вашего сертификата истечет.	Да
ТЕКСТ	Эти записи позволяют вам прикреплять произвольные метаданные к вашему домену. App Hosting позволяет вам использовать определенный формат записи TXT, fah-claim=[UUID] , чтобы указать, какой личный домен он должен обслуживать в вашем домене.	Нет
САА	Эти записи функционируют как список разрешений для указания центров сертификации, уполномоченных создавать сертификаты SSL для вашего домена. App Hosting запрашивает записи CAA только в том случае, если в противном случае ему запрещено создавать сертификаты для вашего домена.	Нет

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

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

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

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

Общие провайдеры доменов

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

Облачное сияние

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

Облачный DNS Google

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

НазваниеCheap

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

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

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

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

Если вы хотите обеспечить бесперебойную работу вашего приложения без простоев, вам необходимо настроить записи DNS в определенном порядке. После добавления домена вы сначала выполните процесс проверки записей DNS, а затем выполните еще один шаг проверки, чтобы направить текущие запросы на App Hosting .

Шаг 1. Добавьте личный домен

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

Шаг 2. Проверьте записи DNS

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

Шаг 3. Прямо на App Hosting

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

Важно! Обязательно удалите все записи A или CNAME, которые указывают на других поставщиков. Если какой-либо из этих типов записей существует, Firebase не сможет предоставить сертификат SSL.

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

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

Шаг 1. Добавьте личный домен

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

Шаг 2. Проверьте записи DNS

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

Важно! Обязательно удалите все записи A или CNAME, которые указывают на других поставщиков. Если какой-либо из этих типов записей существует, Firebase не сможет предоставить сертификат SSL.

Подождите, пока будет предоставлен 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. Вы можете обслуживать контент вашего сайта.