Dzięki Firebase Hosting możesz skonfigurować niestandardowe zachowanie hostingu dla żądań kierowanych do Twojej witryny.
Co możesz skonfigurować dla Hostingu?
Określ, które pliki w lokalnym katalogu projektu chcesz wdrożyć w Hostingu Firebase. Naucz się jak.
Wyświetl dostosowaną stronę 404/Nie znaleziono. Naucz się jak.
Skonfiguruj
redirects
dla stron, które przeniosłeś lub usunąłeś. Naucz się jak.Skonfiguruj
rewrites
w dowolnym z następujących celów:Wyświetlaj tę samą treść dla wielu adresów URL. Naucz się jak.
Obsługuj funkcję lub uzyskuj dostęp do kontenera Cloud Run z adresu URL hostingu. Dowiedz się, jak: funkcja lub pojemnik .
Utwórz łącze dynamiczne domeny niestandardowej. Naucz się jak.
Dodaj
headers
, aby przekazać dodatkowe informacje o żądaniu lub odpowiedzi, takie jak sposób, w jaki przeglądarki powinny obsługiwać stronę i jej zawartość (uwierzytelnianie, buforowanie, kodowanie itp.). Naucz się jak.Skonfiguruj przepisywanie internacjonalizacji (i18n), aby wyświetlać określoną treść w oparciu o preferencje językowe i/lub kraj użytkownika. Dowiedz się, jak (inna strona).
Gdzie definiujesz konfigurację hostingu?
Definiujesz konfigurację Firebase Hosting w pliku firebase.json
. Firebase automatycznie tworzy plik firebase.json
w katalogu głównym katalogu projektu po uruchomieniu polecenia firebase init
.
Pełny przykład konfiguracji firebase.json
(obejmujący tylko Hosting Firebase) znajdziesz na dole tej strony. Należy pamiętać, że plik firebase.json
może również zawierać konfiguracje innych usług Firebase .
Możesz sprawdzić wdrożoną zawartość firebase.json
za pomocą interfejsu API REST Hostingu .
Kolejność priorytetów odpowiedzi Hostingu
Różne opcje konfiguracji Firebase Hosting opisane na tej stronie mogą czasami się pokrywać. Jeśli wystąpi konflikt, Hosting określa swoją odpowiedź, stosując następującą kolejność priorytetów:
- Zarezerwowane przestrzenie nazw rozpoczynające się od segmentu ścieżki
/__/*
- Skonfigurowane przekierowania
- Dokładne dopasowanie treści statycznych
- Skonfigurowane przepisywanie
- Niestandardowa strona 404
- Domyślna strona 404
Jeśli używasz przepisywania i18n , zakres dokładnego dopasowania i kolejności obsługi 404 są rozszerzane, aby uwzględnić twoją „treść i18n”.
Określ, które pliki mają zostać wdrożone
Domyślne atrybuty — public
i ignore
— zawarte w domyślnym pliku firebase.json
definiują, które pliki w katalogu projektu powinny zostać wdrożone w projekcie Firebase.
Domyślna konfiguracja hosting
w pliku firebase.json
wygląda następująco:
"hosting": {
"public": "public", // the only required attribute for Hosting
"ignore": [
"firebase.json",
"**/.*",
"**/node_modules/**"
]
}
publiczny
Wymagany
Atrybut public
określa, który katalog należy wdrożyć w Hostingu Firebase. Wartość domyślna to katalog o nazwie public
, ale możesz określić ścieżkę dowolnego katalogu, o ile istnieje on w katalogu projektu.
Poniżej znajduje się domyślna określona nazwa katalogu do wdrożenia:
"hosting": {
"public": "public"
// ...
}
Możesz zmienić wartość domyślną na katalog, który chcesz wdrożyć:
"hosting": {
"public": "dist/app"
// ...
}
ignorować
Opcjonalny
Atrybut ignore
określa pliki, które mają być ignorowane podczas wdrażania. Może przyjmować glob w ten sam sposób, w jaki Git obsługuje .gitignore
.
Poniżej znajdują się domyślne wartości plików, które mają być ignorowane:
"hosting": {
// ...
"ignore": [
"firebase.json", // the Firebase configuration file (the file described on this page)
"**/.*", // files with a leading period should be hidden from the system
"**/node_modules/**" // contains dependencies used to create your site but not run it
]
}
Dostosuj stronę 404/Nie znaleziono
Opcjonalny
Możesz wyświetlić niestandardowy błąd 404 Not Found
gdy użytkownik spróbuje uzyskać dostęp do strony, która nie istnieje.
Utwórz nowy plik w public
katalogu swojego projektu, nadaj mu nazwę 404.html
, a następnie dodaj do pliku niestandardową treść 404 Not Found
.
Hosting Firebase wyświetli zawartość tej niestandardowej strony 404.html
, jeśli przeglądarka wywoła błąd 404 Not Found
w Twojej domenie lub subdomenie.
Skonfiguruj przekierowania
Opcjonalny
Użyj przekierowania adresu URL, aby zapobiec uszkodzeniu linków w przypadku przeniesienia strony lub skrócić adresy URL. Możesz na przykład przekierować przeglądarkę z example.com/team
na example.com/about.html
.
Określ przekierowania URL, tworząc atrybut redirects
zawierający tablicę obiektów (tzw. „reguły przekierowań”). W każdej regule określ wzorzec adresu URL, który, jeśli zostanie dopasowany do ścieżki adresu URL żądania, spowoduje, że Hosting odpowie przekierowaniem na podany docelowy adres URL.
Oto podstawowa struktura atrybutu redirects
. Ten przykład przekierowuje żądania do /foo
, wysyłając nowe żądanie do /bar
.
"hosting": {
// ...
// Returns a permanent redirect to "/bar" for requests to "/foo" (but not "/foo/**")
"redirects": [ {
"source": "/foo",
"destination": "/bar",
"type": 301
} ]
}
"hosting": {
// ...
// Add the "redirects" attribute within "hosting"
"redirects": [ {
// Returns a permanent redirect to "/bar" for requests to "/foo" (but not "/foo/**")
"source": "/foo",
"destination": "/bar",
"type": 301
}, {
// Returns a permanent redirect to "/bar" for requests to both "/foo" and "/foo/**"
"source": "/foo{,/**}"
"destination": "/bar"
"type": 301
}, {
// Returns a temporary redirect for all requests to files or directories in the "firebase" directory
"source": "/firebase/**",
"destination": "https://firebase.google.com/",
"type": 302
}, {
// A regular expression-based redirect equivalent to the above behavior
"regex": "/firebase/.*",
"destination": "https://firebase.google.com/",
"type": 302
} ]
}
Atrybut redirects
zawiera tablicę reguł przekierowań, przy czym każda reguła musi zawierać pola z poniższej tabeli.
Firebase Hosting porównuje wartość source
lub regex
ze wszystkimi ścieżkami URL na początku każdego żądania (zanim przeglądarka ustali, czy w tej ścieżce istnieje plik lub folder). Jeśli zostanie znalezione dopasowanie, serwer pochodzenia Firebase Hosting wysyła odpowiedź przekierowania HTTPS, informując przeglądarkę, aby wysłała nowe żądanie pod destination
adresem URL.
Pole | Opis | |
---|---|---|
redirects | ||
source (zalecane)lub regex | Wzorzec adresu URL, który, jeśli jest zgodny z początkowym adresem URL żądania, powoduje, że Hosting zastosował przekierowanie
| |
destination | Statyczny adres URL, pod którym przeglądarka powinna wysłać nowe żądanie Ten adres URL może być ścieżką względną lub bezwzględną. | |
type | Kod odpowiedzi HTTPS
|
Przechwytuj segmenty URL dla przekierowań
Opcjonalny
Czasami może zaistnieć potrzeba przechwycenia określonych segmentów wzorca adresu URL reguły przekierowania (wartości source
lub regex
), a następnie ponownego użycia tych segmentów w ścieżce destination
reguły.
Jeśli używasz pola source
(tzn. określasz glob dla wzorca adresu URL), możesz przechwytywać segmenty, dodając przedrostek :
w celu identyfikacji segmentu. Jeśli chcesz także przechwycić pozostałą ścieżkę URL po segmencie, umieść znak *
bezpośrednio po segmencie. Na przykład:
"hosting": { // ... "redirects": [ { "source": "/blog/:post*", // captures the entire URL segment beginning at "post" "destination": "https://blog.myapp.com/:post", // includes the entire URL segment identified and captured by the "source" value "type": 301 }, { "source": "/users/:id/profile", // captures only the URL segment "id", but nothing following "destination": "/users/:id/newProfile", // includes the URL segment identified and captured by the "source" value "type": 301 } ] }
Jeśli używasz pola wyrażenia regex
(tzn. określasz wyrażenie regularne RE2 dla wzorca adresu URL), możesz przechwytywać segmenty przy użyciu nazwanych lub nienazwanych grup przechwytywania RE2. Nazwane grupy przechwytywania mogą być użyte w polu destination
z przedrostkiem :
, podczas gdy do nienazwanych grup przechwytywania można odwoływać się za pomocą ich indeksu liczbowego w wartości regex
, indeksowanego od 1. Na przykład:
"hosting": { // ... "redirects": [ { "regex": "/blog/(?P<post>.+)", // if you're familiar with PCRE, be aware that RE2 requires named capture groups to begin with ?P "destination": "https://blog.myapp.com/:post", // includes the entire URL segment identified and captured by the `regex` value "type": 301 }, { "regex": "/users/(\d+)/profile", // uses the \d directive to only match numerical path segments "destination": "/users/:1/newProfile", // the first capture group to be seen in the `regex` value is named 1, and so on "type": 301 } ] }
Skonfiguruj przepisywanie
Opcjonalny
Użyj przepisania, aby wyświetlić tę samą treść dla wielu adresów URL. Przepisanie jest szczególnie przydatne w przypadku dopasowywania wzorców, ponieważ można zaakceptować dowolny adres URL pasujący do wzorca i pozwolić kodowi po stronie klienta zdecydować, co wyświetlić.
Możesz także użyć przepisywania do obsługi aplikacji korzystających z HTML5 pushState do nawigacji. Gdy przeglądarka próbuje otworzyć ścieżkę URL zgodną z określonym source
lub wzorcem adresu URL regex
, zamiast tego przeglądarka otrzyma zawartość pliku pod destination
adresem URL.
Określ przepisywanie adresów URL, tworząc atrybut rewrites
zawierający tablicę obiektów (tzw. „reguły przepisywania”). W każdej regule określ wzorzec adresu URL, który, jeśli zostanie dopasowany do ścieżki adresu URL żądania, spowoduje, że Hosting odpowie tak, jakby usługa otrzymała określony docelowy adres URL.
Oto podstawowa struktura atrybutu rewrites
. Ten przykład obsługuje index.html
dla żądań do plików lub katalogów, które nie istnieją.
"hosting": {
// ...
// Serves index.html for requests to files or directories that do not exist
"rewrites": [ {
"source": "**",
"destination": "/index.html"
} ]
}
"hosting": { // ... // Add the "rewrites" attribute within "hosting" "rewrites": [ { // Serves index.html for requests to files or directories that do not exist "source": "**", "destination": "/index.html" }, { // Serves index.html for requests to both "/foo" and "/foo/**" // Using "/foo/**" only matches paths like "/foo/xyz", but not "/foo" "source": "/foo{,/**}", "destination": "/index.html" }, { // A regular expression-based rewrite equivalent to the above behavior "regex": "/foo(/.*)?", "destination": "/index.html" }, { // Excludes specified pathways from rewrites "source": "!/@(js|css)/**", "destination": "/index.html" } ] }
Atrybut rewrites
zawiera tablicę reguł przepisywania, przy czym każda reguła musi zawierać pola z poniższej tabeli.
Hosting Firebase stosuje regułę przepisywania tylko wtedy, gdy plik lub katalog nie istnieje pod ścieżką URL pasującą do określonego wzorca adresu URL source
lub regex
. Gdy żądanie wyzwala regułę przepisywania, przeglądarka zwraca rzeczywistą zawartość określonego pliku destination
zamiast przekierowania HTTP.
Pole | Opis | |
---|---|---|
rewrites | ||
source (zalecane)lub regex | Wzorzec adresu URL, który, jeśli jest zgodny z początkowym adresem URL żądania, powoduje, że Hosting zastosuje przepisanie
| |
destination | Plik lokalny, który musi istnieć Ten adres URL może być ścieżką względną lub bezwzględną. |
Kieruj żądania do funkcji
Możesz użyć rewrites
, aby obsłużyć funkcję z adresu URL hostingu Firebase. Poniższy przykład jest fragmentem udostępniania treści dynamicznych przy użyciu funkcji Cloud Functions .
Na przykład, aby skierować wszystkie żądania ze strony /bigben
w witrynie Hostingowej w celu wykonania funkcji bigben
:
"hosting": {
// ...
// Directs all requests from the page `/bigben` to execute the `bigben` function
"rewrites": [ {
"source": "/bigben",
"function": {
"functionId": "bigben",
"region": "us-central1" // optional (see note below)
"pinTag": true // optional (see note below)
}
} ]
}
Jeśli
region
zostanie pominięty w blokufunction
konfiguracjihosting.rewrites
, interfejs CLI Firebase spróbuje automatycznie wykryć region na podstawie kodu źródłowego funkcji, który, jeśli nie zostanie określony, domyślnie będzieus-central1
. Jeśli kod źródłowy funkcji jest niedostępny, interfejs CLI próbuje wykryć region z wdrożonej funkcji. Jeśli funkcja znajduje się w wielu regionach, interfejs CLI wymaga określeniaregion
w konfiguracjihosting.rewrites
.
Funkcja
pinTag
jest dostępna tylko w Cloud Functions dla Firebase (2. generacji). Dzięki tej funkcji możesz mieć pewność, że każda funkcja generowania dynamicznej zawartości Twojej witryny będzie zsynchronizowana ze statycznymi zasobami Hostingu i konfiguracją Hostingu. Ponadto ta funkcja umożliwia podgląd przepisanych funkcji w kanałach podglądu Hostingu.Jeśli dodasz
"pinTag": true
do blokufunction
konfiguracjihosting.rewrites
, wówczas funkcja „pinned” zostanie wdrożona wraz z zasobami i konfiguracją statycznego hostingu, nawet jeśli uruchomiony jest. Jeśli wycofasz wersję swojej witryny, funkcja „przypięta” również zostanie wycofana.
firebase deploy --only hosting Ta funkcja opiera się na tagach Cloud Run , które mają limit 1000 tagów na usługę i 2000 tagów na region. Oznacza to, że po setkach wdrożeń najstarsze wersje witryny mogą przestać działać.
Po dodaniu tej reguły przepisywania i wdrożeniu w Firebase (przy użyciu firebase deploy
), Twoja funkcja jest dostępna za pośrednictwem następujących adresów URL:
Twoje subdomeny Firebase:
PROJECT_ID .web.app/bigben
iPROJECT_ID .firebaseapp.com/bigben
Wszelkie połączone domeny niestandardowe :
CUSTOM_DOMAIN /bigben
Podczas przekierowywania żądań do funkcji w Hostingu obsługiwane metody żądań HTTP to GET
, POST
, HEAD
, PUT
, DELETE
, PATCH
i OPTIONS
. Inne metody, takie jak REPORT
lub PROFIND
, nie są obsługiwane.
Kieruj żądania do kontenera Cloud Run
Możesz użyć rewrites
, aby uzyskać dostęp do kontenera Cloud Run z adresu URL hostingu Firebase. Poniższy przykład to fragment udostępniania treści dynamicznych przy użyciu Cloud Run .
Na przykład, aby skierować wszystkie żądania ze strony /helloworld
w witrynie hostingowej w celu uruchomienia i uruchomienia instancji kontenera helloworld
:
"hosting": {
// ...
// Directs all requests from the page `/helloworld` to trigger and run a `helloworld` container
"rewrites": [ {
"source": "/helloworld",
"run": {
"serviceId": "helloworld", // "service name" (from when you deployed the container image)
"region": "us-central1" // optional (if omitted, default is us-central1)
}
} ]
}
Dzięki tej funkcji możesz mieć pewność, że wersja usługi Cloud Run do generowania dynamicznej zawartości Twojej witryny będzie zsynchronizowana ze statycznymi zasobami hostingu i konfiguracją hostingu. Ta funkcja umożliwia także podgląd zapisów w Cloud Run w kanałach podglądu Hostingu.
Jeśli dodasz
"pingTag": true
do blokurun
konfiguracjihosting.rewrites
, Twoje statyczne zasoby i konfiguracja hostingu zostaną przypięte do najnowszej wersji usługi Cloud Run w momencie wdrożenia. Jeśli wycofasz wersję swojej witryny, wycofana zostanie także wersja „przypiętej” usługi Cloud Run.Ta funkcja opiera się na tagach Cloud Run , które mają limit 1000 tagów na usługę i 2000 tagów na region. Oznacza to, że po setkach wdrożeń najstarsze wersje witryny mogą przestać działać.
Po dodaniu tej reguły przepisywania i wdrożeniu w Firebase (przy użyciu firebase deploy
) obraz kontenera będzie dostępny za pośrednictwem następujących adresów URL:
Twoje subdomeny Firebase:
PROJECT_ID .web.app/helloworld
iPROJECT_ID .firebaseapp.com/helloworld
Wszelkie połączone domeny niestandardowe :
CUSTOM_DOMAIN /helloworld
Podczas przekierowywania żądań do kontenerów Cloud Run za pomocą Hostingu obsługiwane metody żądań HTTP to GET
, POST
, HEAD
, PUT
, DELETE
, PATCH
i OPTIONS
. Inne metody, takie jak REPORT
lub PROFIND
, nie są obsługiwane.
Aby uzyskać najlepszą wydajność, połącz usługę Cloud Run z Hostingiem, korzystając z następujących regionów:
-
us-west1
-
us-central1
-
us-east1
-
europe-west1
-
asia-east1
Przepisywanie do Cloud Run z Hostingu jest obsługiwane w następujących regionach:
-
asia-east1
-
asia-east2
-
asia-northeast1
-
asia-northeast2
-
asia-northeast3
-
asia-south1
-
asia-south2
-
asia-southeast1
-
asia-southeast2
-
australia-southeast1
-
australia-southeast2
-
europe-central2
-
europe-north1
-
europe-southwest1
-
europe-west1
-
europe-west12
-
europe-west2
-
europe-west3
-
europe-west4
-
europe-west6
-
europe-west8
-
europe-west9
-
me-central1
-
me-west1
-
northamerica-northeast1
-
northamerica-northeast2
-
southamerica-east1
-
southamerica-west1
-
us-central1
-
us-east1
-
us-east4
-
us-east5
-
us-south1
-
us-west1
-
us-west2
-
us-west3
-
us-west4
-
us-west1
-
us-central1
-
us-east1
-
europe-west1
-
asia-east1
Utwórz niestandardowe łącza dynamiczne domeny
Możesz użyć rewrites
, aby utworzyć niestandardowe linki dynamiczne domeny. Szczegółowe informacje na temat konfigurowania domeny niestandardowej dla łączy dynamicznych można znaleźć w dokumentacji Linków dynamicznych.
Używaj swojej domeny niestandardowej tylko w przypadku łączy dynamicznych
"hosting": { // ... "appAssociation": "AUTO", // required for Dynamic Links (default is AUTO if not specified) // Add the "rewrites" attribute within "hosting" "rewrites": [ { "source": "/**", // the Dynamic Links start with "https://CUSTOM_DOMAIN/" "dynamicLinks": true } ] }
Określ niestandardowe prefiksy ścieżek domeny, które będą używane w przypadku łączy dynamicznych
"hosting": { // ... "appAssociation": "AUTO", // required for Dynamic Links (default is AUTO if not specified) // Add the "rewrites" attribute within "hosting" "rewrites": [ { "source": "/promos/**", // the Dynamic Links start with "https://CUSTOM_DOMAIN/promos/" "dynamicLinks": true }, { "source": "/links/share/**", // the Dynamic Links start with "https://CUSTOM_DOMAIN/links/share/" "dynamicLinks": true } ] }
Konfigurowanie łączy dynamicznych w pliku firebase.json
wymaga następujących elementów:
Pole | Opis | |
---|---|---|
appAssociation | Należy ustawić na
| |
rewrites | ||
source | Ścieżka, której chcesz używać w przypadku łączy dynamicznych W przeciwieństwie do reguł przepisywania ścieżek do adresów URL, reguły przepisywania dla łączy dynamicznych nie mogą zawierać wyrażeń regularnych. | |
dynamicLinks | Musi być ustawione na true |
Skonfiguruj nagłówki
Opcjonalny
Nagłówki umożliwiają klientowi i serwerowi przekazywanie dodatkowych informacji wraz z żądaniem lub odpowiedzią. Niektóre zestawy nagłówków mogą wpływać na sposób, w jaki przeglądarka obsługuje stronę i jej zawartość, w tym na kontrolę dostępu, uwierzytelnianie, buforowanie i kodowanie.
Określ niestandardowe, specyficzne dla pliku nagłówki odpowiedzi, tworząc atrybut headers
zawierający tablicę obiektów nagłówków. W każdym obiekcie określ wzorzec adresu URL, który, jeśli zostanie dopasowany do ścieżki adresu URL żądania, spowoduje, że Hosting zastosuje określone niestandardowe nagłówki odpowiedzi.
Oto podstawowa struktura atrybutu headers
. W tym przykładzie zastosowano nagłówek CORS dla wszystkich plików czcionek.
"hosting": {
// ...
// Applies a CORS header for all font files
"headers": [ {
"source": "**/*.@(eot|otf|ttf|ttc|woff|font.css)",
"headers": [ {
"key": "Access-Control-Allow-Origin",
"value": "*"
} ]
} ]
}
"hosting": { // ... // Add the "headers" attribute within "hosting" "headers": [ { // Applies a CORS header for all font files "source": "**/*.@(eot|otf|ttf|ttc|woff|font.css)", "headers": [ { "key": "Access-Control-Allow-Origin", "value": "*" } ] }, { // Overrides the default 1 hour browser cache with a 2 hour cache for all image files "source": "**/*.@(jpg|jpeg|gif|png)", "headers": [ { "key": "Cache-Control", "value": "max-age=7200" } ] }, { // A regular expression-based rewrite equivalent to the above behavior "regex": ".+/\w+\.(jpg|jpeg|gif|png)$", "headers": [ { "key": "Cache-Control", "value": "max-age=7200" } ] }, { // Sets the cache header for 404 pages to cache for 5 minutes "source": "404.html", "headers": [ { "key": "Cache-Control", "value": "max-age=300" } ] } ] }
Atrybut headers
zawiera tablicę definicji, przy czym każda definicja musi zawierać pola z poniższej tabeli.
Pole | Opis | ||
---|---|---|---|
headers | |||
source (zalecane)lub regex | Wzorzec adresu URL, który, jeśli jest dopasowany do początkowego adresu URL żądania, powoduje, że Hosting zastosuje niestandardowy nagłówek
Aby utworzyć nagłówek pasujący do niestandardowej strony 404 , użyj | ||
tablica (pod-) headers | Niestandardowe nagłówki stosowane przez Hosting do ścieżki żądania Każdy podnagłówek musi zawierać parę | ||
key | Nazwa nagłówka, na przykład Cache-Control | ||
value | Wartość nagłówka, na przykład max-age=7200 |
Możesz dowiedzieć się więcej o Cache-Control
w sekcji Hosting, która opisuje udostępnianie treści dynamicznych i mikrousługi hostingowe. Możesz także dowiedzieć się więcej o nagłówkach CORS .
Kontroluj rozszerzenia .html
Opcjonalny
Atrybut cleanUrls
pozwala kontrolować, czy adresy URL powinny zawierać rozszerzenie .html
.
Jeśli ma true
, Hosting automatycznie usuwa rozszerzenie .html
z adresów URL przesyłanych plików. Jeśli w żądaniu dodane zostanie rozszerzenie .html
, Hosting wykonuje przekierowanie 301
na tę samą ścieżkę, ale eliminuje rozszerzenie .html
.
Oto jak kontrolować uwzględnianie .html
w adresach URL, dołączając atrybut cleanUrls
:
"hosting": {
// ...
// Drops `.html` from uploaded URLs
"cleanUrls": true
}
Kontroluj końcowe ukośniki
Opcjonalny
Atrybut trailingSlash
pozwala kontrolować, czy adresy URL treści statycznych powinny zawierać końcowe ukośniki.
- Gdy
true
Hosting przekierowuje adresy URL, dodając końcowy ukośnik. - Gdy
false
, Hosting przekierowuje adresy URL, aby usunąć końcowy ukośnik. - Jeśli nie określono inaczej, Hosting używa tylko końcowych ukośników dla plików indeksu katalogów (na przykład
about/index.html
).
Oto jak kontrolować końcowe ukośniki, dodając atrybut trailingSlash
:
"hosting": {
// ...
// Removes trailing slashes from URLs
"trailingSlash": false
}
Atrybut trailingSlash
nie wpływa na ponowne zapisywanie zawartości dynamicznej udostępnianej przez Cloud Functions lub Cloud Run.
Dopasowanie wzoru globu
Opcje konfiguracyjne Firebase Hosting w szerokim zakresie wykorzystują notację dopasowywania wzorców glob z extglob, podobnie jak Git obsługuje reguły gitignore
, a Bower obsługuje reguły ignore
. Ta strona wiki jest bardziej szczegółowym odniesieniem, ale poniżej znajdują się wyjaśnienia przykładów użytych na tej stronie:
firebase.json
— Pasuje tylko do plikufirebase.json
w katalogu głównym katalogupublic
**
— Dopasowuje dowolny plik lub folder w dowolnym podkatalogu*
— Dopasowuje tylko pliki i foldery w katalogu głównym katalogupublic
**/.*
— Dopasowuje dowolny plik rozpoczynający się od.
(zwykle ukryte pliki, np. w folderze.git
) w dowolnym podkatalogu**/node_modules/**
— Dopasowuje dowolny plik lub folder w dowolnym podkatalogu folderunode_modules
, który sam może znajdować się w dowolnym podkatalogu katalogupublic
**/*.@(jpg|jpeg|gif|png)
— dopasowuje dowolny plik w dowolnym podkatalogu, który kończy się dokładnie jednym z następujących:.jpg
,.jpeg
,.gif
lub.png
Przykład pełnej konfiguracji hostingu
Poniżej znajduje się przykład pełnej konfiguracji firebase.json
dla Hostingu Firebase. Należy pamiętać, że plik firebase.json
może również zawierać konfiguracje innych usług Firebase .
{
"hosting": {
"public": "dist/app", // "public" is the only required attribute for Hosting
"ignore": [
"firebase.json",
"**/.*",
"**/node_modules/**"
],
"redirects": [ {
"source": "/foo",
"destination": "/bar",
"type": 301
}, {
"source": "/firebase/**",
"destination": "https://www.firebase.com",
"type": 302
} ],
"rewrites": [ {
// Shows the same content for multiple URLs
"source": "/app/**",
"destination": "/app/index.html"
}, {
// Configures a custom domain for Dynamic Links
"source": "/promos/**",
"dynamicLinks": true
}, {
// Directs a request to Cloud Functions
"source": "/bigben",
"function": "bigben"
}, {
// Directs a request to a Cloud Run containerized app
"source": "/helloworld",
"run": {
"serviceId": "helloworld",
"region": "us-central1"
}
} ],
"headers": [ {
"source": "**/*.@(eot|otf|ttf|ttc|woff|font.css)",
"headers": [ {
"key": "Access-Control-Allow-Origin",
"value": "*"
} ]
}, {
"source": "**/*.@(jpg|jpeg|gif|png)",
"headers": [ {
"key": "Cache-Control",
"value": "max-age=7200"
} ]
}, {
"source": "404.html",
"headers": [ {
"key": "Cache-Control",
"value": "max-age=300"
} ]
} ],
"cleanUrls": true,
"trailingSlash": false,
// Required to configure custom domains for Dynamic Links
"appAssociation": "AUTO",
}
}