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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Вам не нужно отказываться от своих уникальных доменных имен, ориентированных на бренд, для приложений, развернутых на 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] , чтобы указать, какой пользовательский домен он должен обслуживать на вашем домене.	Нет
САА	Эти записи выполняют функцию разрешенного списка для указания центров сертификации, которые уполномочены выпускать SSL-сертификаты для вашего домена. App Hosting запрашивает записи CAA только в том случае, если он иным образом заблокирован для выпуска сертификатов для вашего домена.	Нет

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

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

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

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

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

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

Клаудфлер

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

Google Облачный 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 без простоя, вы можете использовать поток Migrate a domain в Firebase Console. Этот поток проведет вас через двухэтапный процесс, который подготовит 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-провайдере со следующими входными данными для требуемых записей:
   • Имя : введите свое пользовательское доменное имя для записей. Указанный вами хост — это домен, на котором вы хотите обслуживать контент; этот домен может быть доменом apex или поддоменом. Ваш поставщик домена может указать этот термин как «Имя хоста», «Имя» или «Домен»
   • Тип записи : добавьте предоставленную запись DNS.
   • Значение : Назначьте предоставленное значение вашим записям. Ваш поставщик домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес». Содержимое поля значения зависит от типа записи: записи A и AAAA имеют IP-адреса в качестве значений, а записи TXT — это строки.
3. Выберите Проверить записи . App Hosting попытается обнаружить изменения, которые вы внесли в поставщика домена. Распространение изменений может занять до 24 часов. Вы можете проверить статус в представлении Настройки > Домены на панели управления бэкэнда.

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

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