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

Вам не нужно отказываться от своих уникальных, ориентированных на бренд доменных имен с 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 : Настройка собственного домена

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Обратите внимание, что вы можете нажать Cancel , чтобы безопасно закрыть окно Connect Domain и открыть его снова позже. Это не повлияет на время распространения, но вам будет предложено повторно ввести имя домена при повторном открытии окна.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • @
  • Имя домена apex (например, 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 поддоменов на одном пользовательском домене apex из-за ограничений на выпуск SSL-сертификатов.
Сертификат чеканки

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

Подключен

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