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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подключено

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