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

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

В оставшейся части этого документа описаны шаги по подключению личного домена.

Настройте свой домен для App Hosting

Убедитесь, что вы выполнили основные задачи по настройке App Hosting , чтобы в вашем проекте Firebase появился сайт Firebase App Hosting .

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

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

Шаг 2. Настройте собственный домен

  1. Мастер добавления пользовательского домена в консоли Firebase покажет необходимые записи, которые необходимо обновить, чтобы направить вашу страницу на хостинг приложений Firebase. Добавляйте, удаляйте и сохраняйте записи из вашего домена у вашего DNS-провайдера, используя следующие входные данные:

    • Введите : добавьте предоставленную запись DNS.

    • Хост : введите ключ собственного домена для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или поддоменом. Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : присвойте предоставленное значение своим записям. Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес». Содержимое поля значения зависит от типа записи: записи A и AAAA имеют IP-адреса в качестве значений, а записи TXT представляют собой строки.

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

Подождите, пока будет предоставлен SSL-сертификат.

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

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

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

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

Ваш личный доменный ключ

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

Тип домена Пользовательский ключ домена
Домен Апекс

Общие входные данные включают в себя:

  • @
  • Доменное имя вершины (например, example .com ).
  • Оставляем поле Хост пустым
Субдомен

Общие входные данные включают в себя:

  • Полное имя субдомена (например, app. example .com ).
  • Только часть поддомена (например, только app , без учета . example .com ).

Общие поставщики доменов

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

Описания статусов для личных доменов

Статус Описание
Требуется настройка

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