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

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

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройка личного домена

Если появится запрос в мастере настройки подключения домена , подтвердите свой домен вершины.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Связанный

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