Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Подключить персональный домен

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 3. Вступите в эфир

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

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

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

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

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

Ключ вашего личного домена

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

Тип домена Ключ личного домена
Домен Apex

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

  • @
  • Домена апекс имя (например, example .com )
  • Оставив поле Host пустым
Поддомен

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Firebase может потребовать от вас вручную повторно подтвердить право собственности на домен в любой из следующих ситуаций:

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