Trang này được dịch bởi Cloud Translation API.

Định cấu hình hành vi lưu trữ

Với Lưu trữ Firebase, bạn có thể định cấu hình hành vi lưu trữ tùy chỉnh cho các yêu cầu đến trang web của mình.

Bạn có thể cấu hình những gì cho Hosting?

Chỉ định tệp nào trong thư mục dự án cục bộ mà bạn muốn triển khai cho Lưu trữ Firebase. Tìm hiểu cách thực hiện.
Cung cấp trang 404 / Không tìm thấy tùy chỉnh. Tìm hiểu cách thực hiện.
Thiết lập redirects cho các trang bạn đã di chuyển hoặc xóa. Tìm hiểu cách thực hiện.
Thiết lập rewrites cho bất kỳ mục đích nào sau đây:
- Hiển thị cùng một nội dung cho nhiều URL. Tìm hiểu cách thực hiện.
- Cung cấp một chức năng hoặc truy cập vùng chứa Cloud Run từ URL lưu trữ. Tìm hiểu cách thực hiện: chức năng hoặc vùng chứa .
- Tạo liên kết động miền tùy chỉnh. Tìm hiểu cách thực hiện.
Thêm headers để chuyển thông tin bổ sung về một yêu cầu hoặc phản hồi, chẳng hạn như cách trình duyệt xử lý trang và nội dung của trang (xác thực, bộ nhớ đệm, mã hóa, v.v.). Tìm hiểu cách thực hiện.
Thiết lập viết lại quốc tế hóa (i18n) để phân phát nội dung cụ thể dựa trên tùy chọn ngôn ngữ của người dùng và / hoặc quốc gia. Tìm hiểu cách thực hiện (trang khác).

Bạn xác định cấu hình Hosting của mình ở đâu?

Bạn xác định cấu hình Lưu trữ Firebase của mình trong tệp firebase.json . Firebase tự động tạo tệp firebase.json của bạn tại thư mục gốc của thư mục dự án khi bạn chạy lệnh firebase init .

Bạn có thể tìm thấy ví dụ cấu hình firebase.json đầy đủ (chỉ bao gồm Lưu trữ Firebase) ở cuối trang này. Lưu ý rằng tệp firebase.json cũng có thể chứa các cấu hình cho các dịch vụ Firebase khác .

Bạn có thể kiểm tra nội dung firebase.json đã triển khai bằng cách sử dụng API REST của Lưu trữ .

Thứ tự ưu tiên của các phản hồi Lưu trữ

Các tùy chọn cấu hình Lưu trữ Firebase khác nhau được mô tả trên trang này đôi khi có thể trùng lặp. Nếu có xung đột, Hosting sẽ xác định phản hồi của nó bằng cách sử dụng thứ tự ưu tiên sau:

Không gian tên dành riêng bắt đầu bằng phân đoạn đường dẫn /__/*
Chuyển hướng đã định cấu hình
Đối sánh chính xác nội dung tĩnh
Đã định cấu hình ghi lại
Trang 404 tùy chỉnh
Trang 404 mặc định

Nếu bạn đang sử dụng i18n viết lại , thứ tự ưu tiên xử lý đối sánh chính xác và 404 sẽ được mở rộng phạm vi để phù hợp với "nội dung i18n" của bạn.

Chỉ định tệp nào sẽ triển khai

Các thuộc tính mặc định - public và ignore - được bao gồm trong tệp firebase.json mặc định xác định tệp nào trong thư mục dự án của bạn sẽ được triển khai cho dự án Firebase của bạn.

Cấu hình hosting mặc định trong tệp firebase.json trông giống như sau:

"hosting": {
  "public": "public",  // the only required attribute for Hosting
  "ignore": [
    "firebase.json",
    "**/.*",
    "**/node_modules/**"
  ]
}

công cộng

Yêu cầu
Thuộc tính public chỉ định thư mục nào sẽ triển khai cho Firebase Hosting. Giá trị mặc định là một thư mục có tên là public , nhưng bạn có thể chỉ định bất kỳ đường dẫn nào của thư mục, miễn là nó tồn tại trong thư mục dự án của bạn.

Sau đây là tên được chỉ định mặc định của thư mục để triển khai:

"hosting": {
  "public": "public"

  // ...
}

Bạn có thể thay đổi giá trị mặc định cho thư mục mà bạn muốn triển khai:

"hosting": {
  "public": "dist/app"

  // ...
}

Làm lơ

Không bắt buộc
Thuộc tính ignore chỉ định các tệp cần bỏ qua khi triển khai. Nó có thể lấy các địa cầu giống như cách mà Git xử lý .gitignore .gitignore

Sau đây là các giá trị mặc định cho các tệp để bỏ qua:

"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
  ]
}

Tùy chỉnh trang 404 / Không tìm thấy

Không bắt buộc
Bạn có thể gặp lỗi 404 Not Found tùy chỉnh khi người dùng cố gắng truy cập một trang không tồn tại.

Tạo một tệp mới trong thư mục public của dự án của bạn, đặt tên là 404.html , sau đó thêm nội dung 404 Not Found tùy chỉnh của bạn vào tệp.

Lưu trữ Firebase sẽ hiển thị nội dung của trang 404.html tùy chỉnh này nếu trình duyệt gây ra lỗi 404 Not Found trên miền hoặc miền phụ của bạn.

Định cấu hình chuyển hướng

Không bắt buộc
Sử dụng chuyển hướng URL để ngăn các liên kết bị hỏng nếu bạn đã di chuyển một trang hoặc để rút ngắn URL. Ví dụ: bạn có thể chuyển hướng một trình duyệt từ example.com/team đến example.com/about.html .

Chỉ định chuyển hướng URL bằng cách tạo thuộc tính redirects chứa một mảng đối tượng (được gọi là "quy tắc chuyển hướng"). Trong mỗi quy tắc, hãy chỉ định một mẫu URL, nếu khớp với đường dẫn URL yêu cầu, sẽ kích hoạt Lưu trữ phản hồi với chuyển hướng đến URL đích được chỉ định.

Đây là cấu trúc cơ bản cho thuộc tính redirects . Ví dụ này chuyển hướng các yêu cầu đến /foo bằng cách thực hiện một yêu cầu mới đến /bar .

"hosting": {
  // ...

  // Returns a permanent redirect to "/bar" for requests to "/foo" (but not "/foo/**")
  "redirects": [ {
    "source": "/foo",
    "destination": "/bar",
    "type": 301
  } ]
}

Xem ví dụ chi tiết hơn về thuộc tính redirects

"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
  } ]
}

Thuộc tính redirects chứa một mảng các quy tắc chuyển hướng, trong đó mỗi quy tắc phải bao gồm các trường trong bảng bên dưới.

Lưu trữ Firebase so sánh giá trị source hoặc regex với tất cả các đường dẫn URL khi bắt đầu mọi yêu cầu (trước khi trình duyệt xác định xem tệp hoặc thư mục có tồn tại tại đường dẫn đó hay không). Nếu tìm thấy kết quả trùng khớp, thì máy chủ gốc của Lưu trữ Firebase sẽ gửi phản hồi chuyển hướng HTTPS yêu cầu trình duyệt thực hiện yêu cầu mới tại URL destination .

Cánh đồng		Sự miêu tả
`redirects`
	`source` (khuyến nghị) hoặc `regex`	Mẫu URL, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt Lưu trữ áp dụng chuyển hướng Sử dụng `source` để chỉ định một toàn cầu (được khuyến nghị) . Sử dụng `regex` để chỉ định một biểu thức chính quy RE2 .
	`destination`	Một URL tĩnh nơi trình duyệt sẽ đưa ra một yêu cầu mới URL này có thể là một đường dẫn tương đối hoặc một đường dẫn tuyệt đối.
	`type`	Mã phản hồi HTTPS Sử dụng loại `301` cho 'Đã di chuyển vĩnh viễn' Sử dụng loại `302` cho 'Đã tìm thấy' (Chuyển hướng tạm thời)

Nắm bắt các phân đoạn URL để chuyển hướng

Không bắt buộc
Đôi khi, bạn có thể cần nắm bắt các phân đoạn cụ thể của mẫu URL của quy tắc chuyển hướng ( source hoặc giá trị regex ), sau đó sử dụng lại các phân đoạn này trong đường dẫn destination của quy tắc.

Nắm bắt các phân đoạn URL khi sử dụng quả địa cầu

Nếu bạn đang sử dụng trường source (nghĩa là chỉ định toàn cầu cho mẫu URL của bạn), bạn có thể nắm bắt các phân đoạn bằng cách bao gồm tiền tố : để xác định phân đoạn. Nếu bạn cũng cần ghi lại đường dẫn URL còn lại sau phân đoạn, hãy bao gồm dấu * ngay sau phân đoạn. Ví dụ:

"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
  } ]
}

Nắm bắt các phân đoạn URL khi sử dụng biểu thức chính quy RE2

Nếu bạn đang sử dụng trường regex (nghĩa là chỉ định một biểu thức chính quy RE2 cho mẫu URL của bạn), bạn có thể nắm bắt các phân đoạn bằng cách sử dụng nhóm nắm bắt RE2 được đặt tên hoặc chưa được đặt tên. Các nhóm thu thập đã đặt tên có thể được sử dụng trong trường destination với tiền tố : trong khi các nhóm thu thập không tên có thể được tham chiếu bằng chỉ mục số của chúng trong giá trị regex , được lập chỉ mục từ 1. Ví dụ:

"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
  } ]
}

Định cấu hình ghi lại

Không bắt buộc
Sử dụng cách viết lại để hiển thị cùng một nội dung cho nhiều URL. Ghi lại đặc biệt hữu ích với đối sánh mẫu, vì bạn có thể chấp nhận bất kỳ URL nào phù hợp với mẫu và để mã phía máy khách quyết định nội dung sẽ hiển thị.

Bạn cũng có thể sử dụng các đoạn viết lại để hỗ trợ các ứng dụng sử dụng HTML5 pushState để điều hướng. Khi trình duyệt cố gắng mở một đường dẫn URL khớp với source hoặc mẫu URL regex được chỉ định, trình duyệt sẽ được cung cấp nội dung của tệp tại URL destination thay thế.

Chỉ định ghi lại URL bằng cách tạo thuộc tính rewrites có chứa một mảng đối tượng (được gọi là "quy tắc ghi lại"). Trong mỗi quy tắc, hãy chỉ định một mẫu URL, nếu khớp với đường dẫn URL yêu cầu, sẽ kích hoạt Lưu trữ phản hồi như thể dịch vụ được cung cấp URL đích đã chỉ định.

Đây là cấu trúc cơ bản cho một thuộc tính rewrites . Ví dụ này phục vụ index.html cho các yêu cầu đối với tệp hoặc thư mục không tồn tại.

"hosting": {
  // ...

  // Serves index.html for requests to files or directories that do not exist
  "rewrites": [ {
    "source": "**",
    "destination": "/index.html"
  } ]
}

Xem ví dụ chi tiết hơn về thuộc tính rewrites

"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"
} ]
}

Thuộc tính rewrites chứa một mảng các quy tắc viết lại, trong đó mỗi quy tắc phải bao gồm các trường trong bảng bên dưới.

Lưu trữ Firebase chỉ áp dụng quy tắc ghi lại nếu tệp hoặc thư mục không tồn tại ở đường dẫn URL khớp với source được chỉ định hoặc mẫu URL regex . Khi một yêu cầu kích hoạt quy tắc ghi lại, trình duyệt sẽ trả về nội dung thực của tệp destination được chỉ định thay vì chuyển hướng HTTP.

Cánh đồng Sự miêu tả

Cánh đồng	Sự miêu tả
`rewrites`
	`source` (khuyến nghị) hoặc `regex`	Mẫu URL, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt Máy chủ lưu trữ áp dụng việc ghi lại Sử dụng `source` để chỉ định một toàn cầu (được khuyến nghị) . Sử dụng `regex` để chỉ định một biểu thức chính quy RE2 .
	`destination`	Tệp cục bộ phải tồn tại URL này có thể là một đường dẫn tương đối hoặc một đường dẫn tuyệt đối.

rewrites

source (khuyến nghị)
hoặc regex

Mẫu URL, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt Máy chủ lưu trữ áp dụng việc ghi lại

Sử dụng source để chỉ định một toàn cầu (được khuyến nghị) .
Sử dụng regex để chỉ định một biểu thức chính quy RE2 .

destination

Tệp cục bộ phải tồn tại

URL này có thể là một đường dẫn tương đối hoặc một đường dẫn tuyệt đối.

Yêu cầu trực tiếp đến một chức năng

Bạn có thể sử dụng các đoạn rewrites để phân phát một chức năng từ URL Lưu trữ Firebase. Ví dụ sau là một đoạn trích từ việc cung cấp nội dung động bằng Chức năng đám mây .

Ví dụ: để hướng tất cả các yêu cầu từ trang /bigben trên trang Lưu trữ của bạn để thực thi chức năng bigben :

"hosting": {
  // ...

  // Directs all requests from the page `/bigben` to execute the `bigben` function
  "rewrites": [ {
    "source": "/bigben",
    "function": "bigben"
  } ]
}

Sau khi thêm quy tắc ghi lại này và triển khai vào Firebase (sử dụng firebase deploy ), chức năng của bạn có thể truy cập được qua các URL sau:

Các miền phụ Firebase của bạn:
PROJECT_ID .web.app/bigben và PROJECT_ID .firebaseapp.com/bigben
Mọi miền tùy chỉnh được kết nối:
CUSTOM_DOMAIN /bigben

Khi chuyển hướng yêu cầu đến các chức năng với Hosting, các phương thức yêu cầu HTTP được hỗ trợ là GET , POST , HEAD , PUT , DELETE , PATCH và OPTIONS . Các phương pháp khác như REPORT hoặc PROFIND không được hỗ trợ.

Yêu cầu trực tiếp đến một vùng chứa Cloud Run

Bạn có thể sử dụng các bản rewrites để truy cập vùng chứa Cloud Run từ URL Lưu trữ Firebase. Ví dụ sau là một đoạn trích từ việc cung cấp nội dung động bằng Cloud Run .

Ví dụ: để hướng tất cả các yêu cầu từ trang /helloworld trên trang Lưu trữ của bạn để kích hoạt việc khởi động và chạy phiên bản vùng chứa 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)
   }
 } ]
}

Sau khi thêm quy tắc ghi lại này và triển khai vào Firebase (sử dụng firebase deploy ), hình ảnh vùng chứa của bạn có thể truy cập được qua các URL sau:

Các miền phụ Firebase của bạn:
PROJECT_ID .web.app/helloworld và PROJECT_ID .firebaseapp.com/helloworld
Mọi miền tùy chỉnh được kết nối:
CUSTOM_DOMAIN /helloworld

Khi chuyển hướng yêu cầu đến các vùng chứa Cloud Run bằng Lưu trữ, các phương thức yêu cầu HTTP được hỗ trợ là GET , POST , HEAD , PUT , DELETE , PATCH và OPTIONS . Các phương pháp khác như REPORT hoặc PROFIND không được hỗ trợ.

Hiện tại, bạn có thể sử dụng tính năng ghi lại Cloud Run với Hosting ở các khu vực sau:

asia-east1
asia-east2
asia-northeast1
asia-northeast2
asia-northeast3
asia-south1
asia-southeast1
asia-southeast2
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
europe-west6
northamerica-northeast1
southamerica-east1
us-central1
us-east1
us-east4
us-west1

Tạo liên kết động miền tùy chỉnh

Bạn có thể sử dụng các rewrites để tạo Liên kết động miền tùy chỉnh. Truy cập tài liệu Liên kết động để biết thông tin chi tiết về cách thiết lập miền tùy chỉnh cho Liên kết động .

Chỉ sử dụng miền tùy chỉnh của bạn cho các Liên kết động

"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
  } ]
}

Chỉ định tiền tố đường dẫn miền tùy chỉnh để sử dụng cho Liên kết động

"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
  } ]
}

Việc định cấu hình Liên kết động trong tệp firebase.json của bạn yêu cầu những điều sau:

Cánh đồng		Sự miêu tả
`appAssociation`		Phải được đặt thành `AUTO` Nếu bạn không bao gồm thuộc tính này trong cấu hình của mình, thì giá trị mặc định cho `appAssociation` là `AUTO` . Bằng cách đặt thuộc tính này thành `AUTO` , Hosting có thể tạo động các `assetlinks.json` và `apple-app-site-association` link khi chúng được yêu cầu.
`rewrites`
	`source`	Đường dẫn bạn muốn sử dụng cho Liên kết động Không giống như các quy tắc viết lại đường dẫn đến URL, quy tắc viết lại cho Liên kết động không được chứa các biểu thức chính quy.
	`dynamicLinks`	Phải được đặt thành `true`

Định cấu hình tiêu đề

Không bắt buộc
Tiêu đề cho phép máy khách và máy chủ chuyển thông tin bổ sung cùng với một yêu cầu hoặc phản hồi. Một số bộ tiêu đề có thể ảnh hưởng đến cách trình duyệt xử lý trang và nội dung của trang, bao gồm kiểm soát truy cập, xác thực, bộ nhớ đệm và mã hóa.

Chỉ định tiêu đề phản hồi tùy chỉnh, dành riêng cho tệp bằng cách tạo thuộc tính headers có chứa một mảng các đối tượng tiêu đề. Trong mỗi đối tượng, hãy chỉ định một mẫu URL, nếu khớp với đường dẫn URL yêu cầu, sẽ kích hoạt Lưu trữ áp dụng các tiêu đề phản hồi tùy chỉnh được chỉ định.

Đây là cấu trúc cơ bản cho thuộc tính headers . Ví dụ này áp dụng tiêu đề CORS cho tất cả các tệp phông chữ.

"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": "*"
    } ]
  } ]
}

Xem ví dụ chi tiết hơn về thuộc tính headers

"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"
    } ]
  } ]
}

Thuộc tính headers chứa một mảng các định nghĩa, trong đó mỗi định nghĩa phải bao gồm các trường trong bảng bên dưới.

Cánh đồng			Sự miêu tả
`headers`
	`source` (khuyến nghị) hoặc `regex`		Mẫu URL, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt Lưu trữ áp dụng tiêu đề tùy chỉnh Sử dụng `source` để chỉ định một toàn cầu (được khuyến nghị) . Sử dụng `regex` để chỉ định một biểu thức chính quy RE2 . Để tạo tiêu đề khớp với trang 404 tùy chỉnh của bạn, hãy sử dụng `404.html` làm `source` hoặc giá trị `regex` của bạn.
	mảng các `headers` (phụ)		Các tiêu đề tùy chỉnh mà Lưu trữ áp dụng cho đường dẫn yêu cầu Mỗi tiêu đề phụ phải bao gồm một cặp `key` và `value` (xem hai hàng tiếp theo).
		`key`	Tên của tiêu đề, ví dụ như `Cache-Control`
		`value`	Giá trị cho tiêu đề, ví dụ: `max-age=7200`

Bạn có thể tìm hiểu thêm về Cache-Control trong phần Lưu trữ mô tả việc cung cấp nội dung động và lưu trữ các dịch vụ nhỏ. Bạn cũng có thể tìm hiểu thêm về tiêu đề CORS .

Kiểm soát phần mở rộng `.html`

Không bắt buộc
Thuộc tính cleanUrls cho phép bạn kiểm soát xem các URL có nên bao gồm phần mở rộng .html hay không.

Khi true , Lưu trữ sẽ tự động loại bỏ phần mở rộng .html khỏi URL của tệp được tải lên. Nếu phần mở rộng .html được thêm vào trong yêu cầu, Hosting sẽ thực hiện chuyển hướng 301 đến cùng một đường dẫn nhưng loại bỏ phần mở rộng .html .

Dưới đây là cách kiểm soát việc đưa .html vào URL bằng cách bao gồm thuộc tính cleanUrls :

"hosting": {
  // ...

  // Drops `.html` from uploaded URLs
  "cleanUrls": true
}

Kiểm soát dấu gạch chéo sau

Không bắt buộc
Thuộc tính trailingSlash cho phép bạn kiểm soát xem các URL nội dung tĩnh có nên bao gồm dấu gạch chéo ở cuối hay không.

Khi true , Hosting sẽ chuyển hướng các URL để thêm dấu gạch chéo.
Khi false , Lưu trữ sẽ chuyển hướng URL để loại bỏ dấu gạch chéo ở cuối.
Khi không xác định, Hosting chỉ sử dụng dấu gạch chéo cho các tệp chỉ mục thư mục (ví dụ: about/index.html ).

Dưới đây là cách kiểm soát dấu gạch chéo bằng cách thêm thuộc tính trailingSlash :

"hosting": {
  // ...

  // Removes trailing slashes from URLs
  "trailingSlash": false
}

Thuộc tính trailingSlash không ảnh hưởng đến việc ghi lại nội dung động được cung cấp bởi Cloud Functions hoặc Cloud Run.

Đối sánh mô hình quả cầu

Các tùy chọn cấu hình Lưu trữ Firebase sử dụng rộng rãi ký hiệu khớp mẫu hình cầu với extglob, tương tự như cách Git xử lý các quy tắc gitignore và Bower xử lý các quy tắc ignore . Trang wiki này là một tài liệu tham khảo chi tiết hơn, nhưng sau đây là giải thích về các ví dụ được sử dụng trên trang này:

firebase.json - Chỉ khớp với tệp firebase.json trong thư mục gốc của thư mục public
** - Đối sánh bất kỳ tệp hoặc thư mục nào trong một thư mục con tùy ý
* - Chỉ khớp các tệp và thư mục trong thư mục gốc của thư mục public
**/.* - Đối sánh với bất kỳ tệp nào bắt đầu bằng . (thường là các tệp ẩn, như trong .git ) trong một thư mục con tùy ý
**/node_modules/** - Đối sánh bất kỳ tệp hoặc thư mục nào trong thư mục con tùy ý của thư mục node_modules , bản thân nó có thể nằm trong thư mục con tùy ý của thư mục public
**/*.@(jpg|jpeg|gif|png) - Đối sánh bất kỳ tệp nào trong một thư mục con tùy ý kết thúc bằng chính xác một trong các ký tự sau: .jpg , .jpeg , .gif hoặc .png

Ví dụ về cấu hình lưu trữ đầy đủ

Sau đây là một ví dụ cấu hình firebase.json đầy đủ cho Firebase Hosting. Lưu ý rằng tệp firebase.json cũng có thể chứa các cấu hình cho các dịch vụ Firebase khác .

{
  "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",

  }
}