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

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

Firebase Hosting предоставляет SSL-сертификат для каждого вашего домена и обслуживает ваш контент через глобальную сеть CDN.

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

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

Убедитесь, что вы завершили работу с мастером «Начало работы» на странице Firebase Hosting вашего проекта, чтобы в вашем проекте Firebase был сайт Firebase Hosting .

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

  1. На странице Hosting вашего проекта войдите в мастер подключения пользовательского домена:

    • Если у вас только один Hosting сайт, нажмите Добавить пользовательский домен .
    • Если у вас несколько сайтов Hosting , нажмите «Просмотр» для нужного сайта, затем нажмите «Добавить пользовательский домен» .

  2. Введите пользовательское доменное имя, которое вы хотите подключить к своему Hosting сайту.

  3. (Необязательно) Установите флажок, чтобы перенаправлять все запросы на пользовательском домене на второй указанный домен (например, чтобы example.com и www.example.com перенаправляли на один и тот же контент).

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

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

Если в мастере настройки подключения домена потребуется подтвердить свой домен Apex.

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

  1. На сайте вашего провайдера домена найдите страницу управления DNS.

  2. Добавьте и сохраните новую запись со следующими данными:

    • Тип : Добавить TXT-запись.

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

      Ваш провайдер домена может указывать этот термин как «Тип записи».

    • Хост : Введите ключ вашего домена APEX .

      Доказательство вашего права собственности на главный или корневой домен подтверждает ваше право собственности на все его поддомены.

      Ваш провайдер домена может указывать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : Скопируйте уникальное проверочное значение в поле.

      Firebase Hosting проверяет это значение, чтобы подтвердить ваше право собственности на домен.

      Ваш провайдер домена может указывать этот термин как «Данные».

  3. Подождите до 24 часов, пока обновленные записи TXT вступят в силу, затем нажмите кнопку «Проверить» .

    Обратите внимание, что вы можете нажать кнопку «Отмена» , чтобы безопасно закрыть окно «Подключение домена» и открыть его позже. Это не повлияет на время распространения, но вам будет предложено повторно ввести доменное имя при повторном открытии окна.

    По истечении достаточного времени распространения нажмите кнопку «Проверить» в окне «Подключить домен» консоли Firebase , чтобы начать процесс предоставления SSL-сертификата.

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

    Если при нажатии кнопки «Проверить» появляется сообщение об ошибке, ваши записи не были распространены или ваши значения могут быть неверными.

В мастере добавления пользовательского домена в консоли Firebase выберите Быстрая настройка или Расширенная настройка .

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

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

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

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

Ваш домен будет указан в качестве одного из альтернативных имён субъекта (SAN) в SSL-сертификате FirebaseApp. Вы можете просмотреть этот сертификат с помощью инструментов безопасности браузера. Во время подготовки домена вы можете увидеть недействительный сертификат, не содержащий вашего доменного имени. Это нормальная часть процесса, и проблема будет устранена после того, как сертификат вашего домена станет доступен.

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

Ваш пользовательский доменный ключ

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

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

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

  • @
  • Верхнее доменное имя (например, example .com )
  • Оставьте поле «Хост» пустым
Поддомен

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

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

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

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

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

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

Возможно, вам придется изменить конфигурацию записей DNS.

  • В большинстве случаев ваши записи DNS A не были переданы от поставщика доменного имени на серверы Firebase Hosting .
    Совет по устранению неполадок: если прошло более 24 часов, проверьте, что вы направили свои записи на Firebase Hosting .

  • В более редких случаях, особенно если вы используете расширенную настройку, проверки SSL могут не выполняться по следующим причинам:

    • Проблемы с SSL-сертификатом не решены, и токен (записи DNS TXT или загруженный файл, предоставленный на ваш сайт) теперь недействителен.
      Совет по устранению неполадок: нажмите «Просмотр» для домена, затем укажите новый токен для вашего существующего домена.
В ожидании

Вы правильно настроили свой пользовательский домен, но Firebase Hosting не предоставил SSL-сертификат.

Иногда следующие проблемы могут затормозить создание SSL-сертификата для пользовательского домена:

  • Ваши записи CAA слишком ограничительны.
    Совет по устранению неполадок: убедитесь, что центрам сертификации `letsencrypt.org` и `pki.goog` разрешено создавать SSL-сертификаты для вашего домена.
  • Ваш код вызова недействителен.
    Если вы используете расширенную настройку и миграция не удалась, ваш токен (и его код вызова) теперь недействительны.
    Совет по устранению неполадок: нажмите «Просмотр» для домена, затем укажите новый токен для вашего существующего домена.
  • Вы запросили сертификаты для слишком большого количества поддоменов.
    Совет по устранению неполадок: как правило, Firebase Hosting рекомендует не использовать более 20 поддоменов на одном главном пользовательском домене из-за ограничений на выпуск SSL-сертификатов.
Сертификат чеканки

Для вашего домена создается SSL-сертификат.

Подключен

Ваш пользовательский домен имеет соответствующие записи DNS и сертификат SSL.
Вы можете обслуживать контент своего сайта.