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

С 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 запросит подтверждение вашего главного домена, выполните его.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

К числу распространенных входных данных относятся:

  • @
  • Доменное имя верхнего уровня (например, example .com )
  • Оставьте поле "Хост" пустым.
Поддомен

К числу распространенных входных данных относятся:

  • Полное имя поддомена (например, app. example .com )
  • Только часть поддомена (например, только app , без . example .com ).
  • Для поддомена www.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 поддоменов на одном основном домене из-за ограничений на создание SSL-сертификатов.
Сертификат чеканки

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

Подключено

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