На этой странице представлены ответы на часто задаваемые вопросы (FAQ) о App Hosting .
Часто задаваемые вопросы App Hosting
Поддерживает ли App Hosting фреймворки, отличные от Next.js и Angular?
App Hosting предоставляет предварительно настроенную поддержку сборки и развертывания для Next.js и Angular, поскольку мы стремимся понимать эти фреймворки и интерпретировать их собственные конфигурации. Для ряда других фреймворков сообщество разработчиков поддерживает адаптеры фреймворков App Hosting . Кроме того, для любого приложения Node.js с скриптом сборки и запуска App Hosting будет пытаться выполнить сборку, но не может гарантировать надежный успех. См. Интеграция с фреймворками .
Какие регионы поддерживает Firebase App Hosting ?
Регионы App Hosting , вероятно, будут расширяться со временем. Актуальную информацию можно найти в разделе «Места App Hosting .
Могу ли я использовать GitLab или другие Git-провайдеры, помимо GitHub, для развертывания?
В настоящее время это невозможно, но поддержка других провайдеров включена в долгосрочный план развития App Hosting .
Почему я не могу найти свой репозиторий в пользовательском интерфейсе консоли Firebase?
Если ваш репозиторий не отображается в списке вариантов при создании нового бэкэнда в консоли Firebase, сначала попробуйте выбрать «Обновить список» . Если нужный репозиторий по-прежнему недоступен, возможно, вам потребуется добавить его, используя опцию «Предоставить доступ к новому репозиторию» в GitHub .
Кроме того, вы можете управлять репозиториями с помощью приложения Firebase App Hosting для GitHub. Для этого перейдите в свой профиль GitHub, выберите «Настройки» , а затем «Приложения» . В строке таблицы для приложения Firebase App Hosting нажмите «Настроить для управления репозиториями».
Почему мой сайт не отображается нормально в WebView мобильного приложения для Android?
Приложения, в которых до третьего квартала 2025 года был настроен пользовательский домен с помощью консоли Firebase, могут столкнуться с некорректным отображением сайта в Android WebView. Это происходит из-за того, что записи CNAME, использовавшиеся в тот период, были несовместимы с Android WebView.
Для решения этой проблемы удалите пользовательский домен из административной панели App Hosting и добавьте его заново. В обновленном интерфейсе консоли появятся 3 новые записи: запись типа A и запись типа TXT для домена, а также запись CNAME для поддомена проверки ACME (для сертификатов); используйте эти записи вместо предыдущей записи CNAME.
Как изменить репозиторий, связанный с моим проектом App Hosting ?
В настоящее время изменить репозиторий невозможно. Однако вы можете создать новый бэкенд, связанный с выбранным репозиторием, в рамках того же проекта или создать новый бэкенд в отдельном проекте.
Заголовочные файлы зависят от фреймворка. Делайте то же самое, что и обычно для вашего фреймворка.
Существует ли эмулятор для локальной разработки с использованием App Hosting ?
Да, вы можете выполнить локальное тестирование своего приложения перед развертыванием на App Hosting используя эмулятор App Hosting , который входит в состав Firebase Local Emulator Suite. См. раздел «Локальное тестирование развертывания приложения» .
Почему я вижу ошибки в App Hosting , но не в Cloud Build?
В таких случаях возможно, что ошибка возникла из-за Cloud Run. Для уверенности проверьте статус развертывания.
Как изменить или удалить связанный аккаунт GitHub?
Чтобы удалить связанную учетную запись GitHub, откройте Developer Connect , убедитесь, что ваш проект выбран, и удалите соединение firebase-app-hosting-github-oath а также соединение, начинающееся с apphosting-github-conn- . После открытия App Hosting в консоли Firebase вы сможете настроить новое соединение с GitHub.
Как настроить файлы cookie для моего сайта, App Hosting ?
Хотя на момент запуска предварительной версии App Hosting эта функция не была доступна, заголовок HTTP-ответа Set-Cookie теперь работает должным образом.
Общие ограничения и способы устранения неполадок App Hosting
- CDN App Hosting может включать в свои ключи кэширования только определенный набор заголовков запроса. Этот список включает заголовки NextJS
RSC , Next-Router-State-Tree , Next-Router-Prefetch , Next-Router-Segment-Prefetch и Next-Url , а также стандартные заголовки Cloud CDN Accept , Accept-Encoding , Access-Control-Request-Headers , Access-Control-Request-Method , Origin , Sec-Fetch-Dest , Sec-Fetch-Mode , Sec-Fetch-Site , X-Goog-Allowed-Resources и X-Origin . Если ответ содержит заголовок Vary со значением, не указанным в этом списке, наш CDN не будет его кэшировать. - Некэшированные статические файлы обслуживаются из Cloud Run ; в более поздней версии они будут храниться и обслуживаться из источника App Hosting для повышения производительности.
- В консоли Firebase при создании бэкэнда может периодически появляться ошибка «сборка не найдена и является недействительной».
- Все бэкенды в одном проекте используют одну и ту же организацию/учетную запись GitHub. Они могут быть подключены к разным репозиториям в рамках этой организации/учетной записи. Чтобы создать бэкенды, подключенные к разным учетным записям GitHub, поместите их в отдельные проекты.
Ограничения и устранение неполадок в приложениях Angular
Несмотря на то, что поддержка Angular в App Hosting активно разрабатывается и расширяется, она имеет следующие ограничения:
- Интернационализация (I18n ): Хотя основные функции интернационализации работают, прямая навигация на страницы SSR может привести к ошибкам.
- Локализация : Создание версий для разных языковых версий не поддерживается.
- Конструкторы : В настоящее время поддерживается только конструктор приложений.
- Инструменты для работы с средами разработки и монорепозиториями : проекты Angular, имеющие более одного целевого приложения, будут давать сбой. Для более полной поддержки монорепозиториев используйте Nx.
Ограничения и устранение неполадок Next.js
- По умолчанию встроенная оптимизация изображений NextJS отключена на хостинге приложений, если вы явно не установите параметр
images.unoptimized в значение false или не используете собственный загрузчик изображений. См. раздел «Оптимизация загрузки изображений в Next.js» . - URL-адреса, содержащие символы, закодированные с помощью процентного кодирования, декодируются Cloud Run . Это может вызвать проблемы с функциями, которые ожидают только закодированные URL-адреса, например, с параллельной маршрутизацией Next.js.
- В настоящее время App Hosting ограничивает кэширование для приложений NextJS с помощью промежуточного ПО . Со временем показатели попадания в кэш должны улучшиться.
- Пути URL, содержащие символы, закодированные с помощью процентного кодирования, декодируются Cloud Run. Это может вызвать проблемы с функциями, которые ожидают только закодированные пути URL, такими как параллельная маршрутизация Next.js.
