Вам не нужно отказываться от своих уникальных доменных имен, ориентированных на бренд, с помощью Firebase Hosting . Вы можете использовать собственный домен (например, example.com или app.example.com ) вместо домена, сгенерированного Firebase, для вашего сайта, размещенного на Firebase.
Firebase Hosting предоставляет сертификат SSL для каждого из ваших доменов и передает ваш контент через глобальную CDN.
В оставшейся части документа описаны шаги по подключению личного домена.
Настройте свой домен для Hosting
Убедитесь, что вы завершили работу мастера «Начало работы» на странице Firebase Hosting вашего проекта, чтобы у вас был сайт Firebase Hosting в вашем проекте Firebase.
Шаг 1. Добавьте личный домен.
На странице Hosting вашего проекта войдите в мастер подключения личного домена:
Если у вас только один Hosting сайт, нажмите «Добавить личный домен» .
Если у вас несколько Hosting сайтов , нажмите «Просмотреть» для нужного сайта, затем нажмите «Добавить личный домен» .
Введите собственное доменное имя, которое вы хотите подключить к своему Hosting сайту.
(Необязательно) Установите флажок, чтобы перенаправлять все запросы из личного домена на второй указанный домен (например, example.com и www.example.com перенаправляются на один и тот же контент).
Нажмите «Продолжить» , чтобы настроить записи DNS и завершить настройку личного домена.
Шаг 2. Настройка личного домена
Если появится запрос в мастере настройки подключения домена , подтвердите свой домен вершины.
Эти шаги гарантируют, что ваш домен еще не связан с проектом Firebase и что вы являетесь владельцем указанного домена.
На сайте вашего провайдера домена найдите страницу управления DNS.
Добавьте и сохраните новую запись со следующими входными данными:
Введите : добавьте запись TXT.
Firebase Hosting требует, чтобы эта запись TXT постоянно присутствовала в настройках DNS, чтобы доказать ваше право собственности на домен и разрешить Firebase назначать и обновлять сертификаты SSL для вашего сайта.
Ваш провайдер домена может указать этот термин как «Тип записи».
Подтверждение вашего права собственности на вершинный домен или корневой домен подтверждает ваше право собственности на все его поддомены.
Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».
Значение : скопируйте уникальное значение проверки в поле.
Firebase Hosting проверяет это значение, чтобы подтвердить ваше право собственности на домен.
Ваш провайдер домена может указать этот термин как «Данные».
Подождите до 24 часов для распространения обновленных записей TXT, затем нажмите «Подтвердить» .
Обратите внимание, что вы можете нажать «Отмена» , чтобы безопасно закрыть окно «Подключить домен» и открыть его позже. Это не влияет на время распространения, но вам будет предложено повторно ввести имя домена при повторном открытии окна.
По прошествии достаточного времени распространения, нажав «Проверить» в окне «Подключить домен» консоли Firebase , вы сможете начать процесс предоставления SSL-сертификата.
В большинстве случаев распространение ваших записей и проверка вашего домена произойдет в течение нескольких часов, в зависимости от вашего провайдера домена. Подробные инструкции по добавлению записей TXT и времени распространения см. в документации вашего провайдера домена.
Если при нажатии «Проверить» появляется сообщение об ошибке, ваши записи не были распространены или ваши значения могут быть неверными.
В мастере добавления пользовательского домена консоли Firebase выберите «Быстрая настройка» или «Расширенная настройка» .
Быструю настройку можно использовать для новых доменов, которые в данный момент не получают трафик, или для доменов, которые вы пытаетесь перенести с другого Hosting . Расширенную настройку можно использовать, если у вас уже есть домен, получающий запросы от другого хостинг-провайдера, и вам нужна миграция без простоев.
Мастер расширенной настройки поможет вам установить сертификат SSL и заявление о праве собственности, чтобы позволить Hosting обслуживать трафик в домене до получения трафика.
Быстрая настройка
Мастер добавления пользовательского домена в консоли Firebase покажет необходимые записи, которые необходимо обновить, чтобы направить вашу страницу на Firebase Hosting . Добавляйте, удаляйте и сохраняйте записи из вашего домена у вашего DNS-провайдера, используя следующие входные данные:
Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или поддоменом.
Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».
Значение : назначьте предоставленные IP-адреса значению записей.
Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».
Подождите, пока ваш SSL-сертификат будет предоставлен . Это может занять до 24 часов после того, как вы направите свой DNS на Firebase Hosting . В большинстве случаев распространение ваших записей и предоставление SSL-сертификата произойдет в течение нескольких часов, в зависимости от вашего провайдера домена.
Расширенная настройка
Режим расширенной настройки мастера добавления пользовательского домена позволяет вам настроить Hosting для безопасного обслуживания вашего домена, прежде чем вы будете направлять трафик на его серверы. В общем, для успешного обслуживания трафика в домене Hosting нужны три вещи:
Запись о праве собственности: запись TXT сообщает Hosting какой сайт обслуживать в домене.
Сертификат SSL: сертификат для конкретного домена, который обеспечивает зашифрованную связь между серверами Hosting и конечными пользователями.
IP-записи хостинга: одна или несколько записей A и AAAA, которые направляют все запросы к домену на серверы Hosting .
Расширенная настройка поможет вам настроить домен так, чтобы Hosting заранее позаботился о первых двух требованиях, чтобы он был готов обслуживать правильный контент до того, как начнет получать трафик для вашего домена. Этот мастер представляет этот процесс как двухэтапный рабочий процесс:
Подготовить домен
Обновить записи DNS . Добавьте одну или несколько записей в свой домен:
Право собственности: запись TXT в форме `hosting-site=[site_id]`.
CAA (необязательно): пара записей CAA, которые позволяют центрам сертификацииHosting создавать сертификат SSL для вашего домена. Отображается только в том случае, если Hosting обнаруживает существующие записи CAA, которые не позволяют ему предоставить сертификат.
Настройка SSL-сертификата . Мастер предоставляет запрос ACME , который центры сертификации Hosting будут использовать для создания SSL-сертификата для вашего домена. Вы можете выбрать между вызовом DNS или HTTP:
Задача DNS : посетите сайты управления DNS вашего провайдера домена. Добавьте запись TXT с ключом субдомена вызова ACME и указанным значением. Разрешите до 24 часов на распространение ваших записей TXT.
HTTP-задание : загрузите предоставленный текстовый файл на существующий сайт по указанному URL-адресу и проверьте его существование.
Hosting сам попытается проверить вызовы ACME, прежде чем запрашивать проверку у своего центра сертификации. Если центр сертификации не может подтвердить ваши проблемы по какой-либо причине, например, из-за периодических проблем с обслуживанием. Hosting должен будет создать для вас новый набор задач. После успешной проверки Hosting может потребоваться до нескольких часов, чтобы предоставить сертификат SSL и разрешить его распространение.
Прямо на Hosting
После того, как Hosting установит ваше право собственности на домен и предоставит сертификат SSL, вернитесь к своему провайдеру DNS и добавьте записи DNS A/AAAA, направляющие запросы на Hosting :
Тип : добавить запрошенные записи DNS A/AAAA.
Хост : введите собственный ключ домена для обеих записей.
Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или поддоменом. Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».
Значение : присвойте одно значение каждой записи DNS A/AAAA, чтобы указать ваш домен на указанные IP-адреса.
Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».
Подождите, пока будет предоставлен 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 TXT
ТЕКСТ
example .com
значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А
example .com
199.36.158.100
А
www
199.36.158.100
Облачный DNS Google
Тип
Хозяин
Ценить
Входы записи DNS TXT
ТЕКСТ
example .com
значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А
example .com
199.36.158.100
А
www
199.36.158.100
НазваниеCheap
Тип
Хозяин
Ценить
Входы записи DNS TXT
ТЕКСТ
@
значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А
@
199.36.158.100
А
www
199.36.158.100
Квадратное пространство
Тип
Хозяин
Ценить
Входы записи DNS TXT
ТЕКСТ
@
значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А
@
199.36.158.100
А
www
199.36.158.100
Описания статуса настройки для личных доменов
Статус
Описание
Требуется настройка
Возможно, вам придется изменить конфигурацию записей 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. Вы можете обслуживать контент вашего сайта.