Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

Настройте свой домен для хостинга

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

Шаг 1 : Добавьте домен

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

    • Если у вас есть только один хостинг-сайт, нажмите Добавить личный домен .
    • Если у вас несколько хостинговых сайтов , нажмите «Просмотр» для нужного сайта, а затем нажмите «Добавить личный домен» .
  2. Введите собственное доменное имя, которое вы хотите подключить к своему сайту хостинга.

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

  4. Нажмите «Продолжить» , чтобы начать процесс проверки.

Шаг 2. Подтвердите право собственности на домен

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. Подождите до 24 часов для распространения ваших обновленных записей TXT, затем нажмите Подтвердить .

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

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

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

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

Шаг 3. Начните жить

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

Дождитесь подготовки SSL-сертификата

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

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

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

Ваш персональный ключ домена

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

Тип домена Ключ личного домена
Домен вершины

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

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

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

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

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

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

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

Положение дел Описание
Требуется настройка

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

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

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

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

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

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

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

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

Требуется повторная проверка

Firebase может потребовать от вас повторно подтвердить право собственности на домен вручную, если запись TXT, добавленная при первоначальном подтверждении владения доменом, была изменена или удалена из настроек DNS вашего домена.

  • Обратите внимание, что в одном домене разрешено несколько записей TXT с токеном google-site-verification.
  • Мы требуем, чтобы запись TXT постоянно присутствовала в ваших настройках DNS, так как это доказывает, что вы являетесь владельцем домена и разрешаете нам назначать и обновлять SSL-сертификаты для вашего сайта.
Совет по устранению неполадок: посетите страницу хостинга вашего проекта, чтобы завершить процесс повторной проверки в течение указанного периода времени (обычно 30 дней), чтобы избежать автоматического отключения вашего личного домена от хостинга Firebase.