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

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

Bạn có thể định cấu hình những gì cho mục Lưu trữ?

• Chỉ định các tệp trong thư mục dự án cục bộ mà bạn muốn triển khai cho tính năng Lưu trữ Firebase. Tìm hiểu cách thực hiện.

• Phân phát trang 404/Không tìm thấy tuỳ chỉnh. Tìm hiểu cách thực hiện.

• Thiết lập redirects cho các trang mà bạn đã di chuyển hoặc xoá. 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 cùng một nội dung cho nhiều URL. Tìm hiểu cách thực hiện.

  • Phân phát một hàm hoặc truy cập vào vùng chứa Cloud Run từ URL lưu trữ. Tìm hiểu cách thực hiện: hàm hoặc vùng chứa.

  • Tạo Đường liên kết động cho miền tuỳ chỉnh. Tìm hiểu cách thực hiện.

• Thêm headers để chuyển thông tin bổ sung về yêu cầu hoặc phản hồi, chẳng hạn như cách trình duyệt sẽ xử lý trang và nội dung của trang (xác thực, lưu vào bộ nhớ đệm, mã hoá, v.v.). Tìm hiểu cách thực hiện.

• Thiết lập tính năng quốc tế hoá (i18n) viết lại để phân phát nội dung cụ thể dựa trên lựa chọn ưu tiên về ngôn ngữ và/hoặc quốc gia của người dùng. Tìm hiểu cách thực hiện (trang khác).

Bạn xác định cấu hình Lưu trữ ở đâu?

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

Thận trọng: Nếu bạn chạy lại firebase init và chọn Lưu trữ, lệnh này sẽ ghi đè phần hosting của tệp firebase.json trở lại cấu hình mặc định.

Bạn có thể xem ví dụ về cấu hình firebase.json đầy đủ (chỉ bao gồm tính năng Lưu trữ Firebase) ở cuối trang này. Xin lưu ý rằng tệp firebase.json cũng có thể chứa 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 máy chủ lưu trữ.

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

Các lựa 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, tính năng Lưu trữ sẽ xác định phản hồi bằng thứ tự ưu tiên sau:

1. Không gian tên dành riêng bắt đầu bằng một phân đoạn đường dẫn /__/*
2. Lệnh chuyển hướng đã định cấu hình
3. Nội dung tĩnh khớp chính xác
4. Tính năng ghi lại đã định cấu hình
5. Trang 404 tuỳ chỉnh
6. Trang 404 mặc định

Lưu ý quan trọng: Trong mỗi thuộc tính redirects và rewrites, tính năng Lưu trữ sẽ áp dụng lệnh chuyển hướng hoặc ghi lại do quy tắc đầu tiên xác định với một mẫu URL khớp với đường dẫn được yêu cầu. Vì vậy, bạn cần chủ động sắp xếp các quy tắc trong mỗi thuộc tính redirects và rewrites. redirects đã định cấu hình vẫn được ưu tiên hơn rewrites.

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

Chỉ định những tệp cần triển khai

Các thuộc tính mặc định – public và ignore – có trong tệp firebase.json mặc định sẽ xác định những tệp trong thư mục dự á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 có dạng như sau:

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

công khai

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

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

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

  // ...
}

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

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

  // ...
}

bỏ qua

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. Việc này có thể xử lý các khối cầu giống như cách Git xử lý .gitignore.

Sau đây là các giá trị mặc định để 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
  ]
}

Tuỳ chỉnh trang 404/Not found

Không bắt buộc
Bạn có thể phân phát lỗi 404 Not Found tuỳ chỉnh khi người dùng cố gắng truy cập vào 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, đặt tên cho tệp đó là 404.html, sau đó thêm nội dung 404 Not Found tuỳ chỉnh vào tệp đó.

Dịch vụ Lưu trữ Firebase sẽ hiển thị nội dung của trang 404.html tuỳ chỉnh này nếu một trình duyệt kích hoạt lỗi 404 Not Found trên miền hoặc miền con của bạn.

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

Không bắt buộc
Sử dụng lệnh chuyển hướng URL để ngăn các đường 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 lệnh chuyển hướng URL bằng cách tạo thuộc tính redirects chứa một mảng các đối tượng (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 mà, nếu khớp với đường dẫn URL yêu cầu, sẽ kích hoạt dịch vụ Lưu trữ phản hồi bằng lệnh chuyển hướng đến URL đích đã chỉ định.

Đây là cấu trúc cơ bản của 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 tạo 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 dưới đây.

Dịch vụ Lưu trữ Firebase so sánh giá trị source hoặc regex với tất cả các đường dẫn URL ở đầu mỗi yêu cầu (trước khi trình duyệt xác định liệu 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 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 một yêu cầu mới tại URL destination.

Trường		Mô tả
redirects
	source (đề xuất) hoặc regex	Mẫu URL mà, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt tính năng Lưu trữ để áp dụng lệnh chuyển hướng Sử dụng source để chỉ định một hình cầu (nên dùng). Sử dụng regex để chỉ định biểu thức chính quy RE2.
	destination	URL tĩnh mà trình duyệt sẽ thực hiện yêu cầu mới URL này có thể là một đường dẫn tương đối hoặc tuyệt đối.
	type	Mã phản hồi HTTPS Sử dụng loại 301 cho "Đã chuyển vĩnh viễn" Dùng một loại 302 cho thuộc tính "Found" (Đã tìm thấy) (Chuyển hướng tạm thời)

Lưu ý quan trọng: Trong thuộc tính redirects, tính năng Lưu trữ sẽ áp dụng lệnh chuyển hướng do quy tắc đầu tiên xác định với một mẫu URL khớp với đường dẫn được yêu cầu. Vì vậy, bạn cần chủ động sắp xếp các quy tắc trong thuộc tính redirects.

Ghi lại phân đoạn URL để chuyển hướng

Không bắt buộc
Đôi khi, bạn có thể cần chụp các phân đoạn cụ thể trong mẫu URL của quy tắc chuyển hướng (giá trị source hoặc 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.

Ghi lại phân đoạn URL khi sử dụng khối cầu

Nếu đang sử dụng trường source (tức là chỉ định một hình cầu cho mẫu URL), bạn có thể chụp các phân đoạn bằng cách thêm tiền tố : để xác định phân đoạn. Nếu bạn cũng cần thu thập đường dẫn URL còn lại sau phân đoạn, hãy thêm * 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
  } ]
}

Ghi lại phân đoạn URL khi sử dụng biểu thức chính quy RE2

Nếu đang sử dụng trường regex (tức là chỉ định biểu thức chính quy RE2 cho mẫu URL của mình), thì bạn có thể nắm bắt các phân đoạn bằng cách sử dụng nhóm thu thập RE2 được đặt tên hoặc chưa đặt tên. Bạn có thể sử dụng nhóm thu thập đã đặt tên trong trường destination với tiền tố :, trong khi các nhóm thu thập chưa đặt tên có thể được tham chiếu bằng chỉ mục số 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 tính năng viết lại

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

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

Chỉ định việc viết lại URL bằng cách tạo thuộc tính rewrites chứa một mảng các đối tượng (gọi là "quy tắc viết lại"). Trong mỗi quy tắc, hãy chỉ định một mẫu URL mà (nếu khớp với đường dẫn URL yêu cầu) sẽ kích hoạt dịch vụ 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 của thuộc tính rewrites. Ví dụ này phân phát index.html cho các yêu cầu đến 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 ghi lại, trong đó mỗi quy tắc phải bao gồm các trường trong bảng dưới đây.

Tính năng 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 trong đường dẫn URL khớp với mẫu URL source hoặc regex đã chỉ định. 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 tế của tệp destination được chỉ định thay vì lệnh chuyển hướng HTTP.

Trường		Mô tả
rewrites
	source (đề xuất) hoặc regex	Mẫu URL mà, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt tính năng Lưu trữ để áp dụng việc ghi lại Sử dụng source để chỉ định một hình cầu (nên dùng). Sử dụng regex để chỉ định biểu thức chính quy RE2.
	destination	Phải có một tệp cục bộ URL này có thể là một đường dẫn tương đối hoặc tuyệt đối.

Lưu ý quan trọng: Trong thuộc tính rewrites, tính năng Lưu trữ sẽ áp dụng thao tác ghi lại theo quy tắc đầu tiên với một mẫu URL khớp với đường dẫn được yêu cầu. Vì vậy, bạn cần chủ động sắp xếp các quy tắc trong thuộc tính rewrites.

Yêu cầu trực tiếp đến một hàm

Bạn có thể sử dụng rewrites để phân phát hàm từ URL lưu trữ Firebase. Ví dụ sau là phần trích dẫn từ nội dung phân phát nội dung động bằng Cloud Functions.

Ví dụ: để chuyển hướng tất cả các yêu cầu từ trang /bigben trên trang web Lưu trữ của bạn nhằm thực thi hàm 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)
    }
  } ]
}

Cách region hoạt động trong khối function

Nếu bạn bỏ qua region trong khối function của cấu hình hosting.rewrites, Firebase CLI sẽ cố gắng tự động phát hiện khu vực từ mã nguồn của hàm (nếu bạn không chỉ định, giá trị mặc định sẽ là us-central1). Nếu không có mã nguồn của hàm, CLI sẽ cố gắng phát hiện khu vực từ hàm đã triển khai. Nếu hàm nằm ở nhiều khu vực, CLI yêu cầu bạn phải chỉ định region trong cấu hình hosting.rewrites.

Cách pinTag hoạt động trong khối function

Tính năng pinTag chỉ có trong Cloud Functions cho Firebase (thế hệ thứ 2). Với tính năng này, bạn có thể đảm bảo rằng mỗi chức năng dùng để tạo nội dung động cho trang web luôn được đồng bộ hoá với tài nguyên Lưu trữ tĩnh và cấu hình Lưu trữ. Ngoài ra, tính năng này cho phép bạn xem trước nội dung viết lại của mình đối với các hàm trên kênh lưu trữ Xem trước.

Nếu bạn thêm "pinTag": true vào khối function của cấu hình hosting.rewrites, thì hàm "đã ghim" sẽ được triển khai cùng với tài nguyên và cấu hình Lưu trữ tĩnh của bạn, ngay cả khi chạy firebase deploy --only hosting. Nếu bạn khôi phục một phiên bản của trang web, thì hàm "đã ghim" cũng sẽ được khôi phục.

Lưu ý: Nếu thêm pinTag vào một tính năng viết lại hiện có, trước tiên, bạn phải triển khai tính năng viết lại đã cập nhật cho kênh "đang hoạt động". Sau khi triển khai, bạn có thể xem trước các thay đổi đối với mã của hàm trong mục Lưu trữ kênh xem trước mà không ảnh hưởng đến quá trình sản xuất.

Tính năng này dựa trên thẻ Cloud Run, có giới hạn là 1.000 thẻ cho mỗi dịch vụ và 2.000 thẻ cho mỗi khu vực. Điều này có nghĩa là sau hàng trăm lần triển khai, các phiên bản cũ nhất của trang web có thể ngừng hoạt động.

Sau khi thêm quy tắc ghi lại này và triển khai cho Firebase (bằng firebase deploy), bạn có thể truy cập hàm của mình thông qua các URL sau:

• Các miền con Firebase của bạn:
  PROJECT_ID.web.app/bigben và PROJECT_ID.firebaseapp.com/bigben

• Bất kỳ miền tuỳ chỉnh nào đã kết nối:
  CUSTOM_DOMAIN/bigben

Khi chuyển hướng yêu cầu đến các hàm qua tính nă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 thức 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 rewrites để truy cập vào vùng chứa Cloud Run từ URL lưu trữ Firebase. Ví dụ sau đây là phần trích dẫn từ nội dung phân phát nội dung động bằng Cloud Run.

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

Cách pinTag hoạt động trong khối run

Với tính năng này, bạn có thể đảm bảo rằng bản sửa đổi dịch vụ Cloud Run để tạo nội dung động cho trang web sẽ luôn được đồng bộ hoá với tài nguyên Lưu trữ tĩnh và cấu hình Lưu trữ. Ngoài ra, tính năng này cho phép bạn xem trước nội dung viết lại trên các kênh xem trước của Cloud Run on lưu trữ.

Nếu bạn thêm "pinTag": true vào khối run của cấu hình hosting.rewrites, thì cấu hình và tài nguyên Lưu trữ tĩnh của bạn sẽ được ghim vào bản sửa đổi gần đây nhất của dịch vụ Cloud Run, tại thời điểm triển khai. Nếu bạn khôi phục một phiên bản trang web, thì bản sửa đổi dịch vụ Cloud Run "đã ghim" cũng sẽ được hoàn nguyên.

Tính năng này dựa trên thẻ Cloud Run, có giới hạn là 1.000 thẻ cho mỗi dịch vụ và 2.000 thẻ cho mỗi khu vực. Điều này có nghĩa là sau hàng trăm lần triển khai, các phiên bản cũ nhất của trang web có thể ngừng hoạt động.

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

• Các miền con Firebase của bạn:
  PROJECT_ID.web.app/helloworld và PROJECT_ID.firebaseapp.com/helloworld

• Bất kỳ miền tuỳ chỉnh nào đã kết nối:
  CUSTOM_DOMAIN/helloworld

Khi chuyển hướng các yêu cầu đến vùng chứa Cloud Run bằng tính nă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 thức khác như REPORT hoặc PROFIND không được hỗ trợ.

Để đạt được hiệu suất tốt nhất, hãy sắp xếp lại dịch vụ Cloud Run với tính năng Lưu trữ bằng cách sử dụng các khu vực sau:

• us-west1
• us-central1
• us-east1
• europe-west1
• asia-east1

Các hoạt động ghi lại thành Cloud Run từ tính năng Lưu trữ được hỗ trợ ở các khu vực sau:

• 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

Tạo đường liên kết động của miền tuỳ chỉnh

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

• Chỉ sử dụng miền tuỳ chỉnh của bạn cho Đường 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 tuỳ chỉnh để sử dụng cho Đường 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 Đường liên kết động trong tệp firebase.json yêu cầu các yêu cầu sau:

Trường		Mô tả
appAssociation		Bạn phải đặt thành AUTO Nếu bạn không đưa thuộc tính này vào cấu hình, giá trị mặc định cho appAssociation sẽ là AUTO. Khi bạn đặt thuộc tính này thành AUTO, dịch vụ Lưu trữ có thể tự động tạo các tệp assetlinks.json và apple-app-site-association khi có yêu cầu.
rewrites
	source	Đường dẫn mà bạn muốn sử dụng cho Đường liên kết động Không giống như các quy tắc ghi lại đường dẫn đến URL, quy tắc viết lại cho Đường liên kết động không được chứa biểu thức chính quy.
	dynamicLinks	Bạn phải đặt thành true

Lưu ý quan trọng: Đối với Đường liên kết động, hãy đặc biệt lưu ý về thứ tự ưu tiên lưu trữ.

• Đảm bảo rằng tiền tố URL đường liên kết động của bạn không xung đột với các cấu hình lưu trữ có mức độ ưu tiên cao hơn (ví dụ: nội dung tĩnh được lưu trữ luôn được ưu tiên hơn việc viết lại).
• Trong mỗi thuộc tính redirects và rewrites, tính năng Lưu trữ sẽ áp dụng lệnh chuyển hướng hoặc lệnh viết lại do quy tắc đầu tiên xác định với một mẫu URL khớp với đường dẫn được yêu cầu. Vì vậy, bạn cần chủ động sắp xếp các quy tắc trong mỗi thuộc tính redirects và rewrites.

Để biết thông tin chi tiết, hãy tham khảo tài liệu về Đường liên kết động.

Đị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ủ truyền thêm thông tin cùng với 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 cả chức năng kiểm soát quyền truy cập, xác thực, lưu vào bộ nhớ đệm và mã hoá.

Chỉ định tiêu đề phản hồi tuỳ chỉnh, dành riêng cho tệp bằng cách tạo thuộc tính headers 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 mà, nếu khớp với đường dẫn URL yêu cầu, sẽ kích hoạt tính năng Lưu trữ để áp dụng các tiêu đề phản hồi tuỳ chỉnh đã chỉ định.

Đây là cấu trúc cơ bản của thuộc tính headers. Ví dụ này áp dụng tiêu đề CORS cho mọi 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 dưới đây.

Trường			Mô tả
headers
	source (đề xuất) hoặc regex		Mẫu URL mà, nếu khớp với URL yêu cầu ban đầu, sẽ kích hoạt tính năng Lưu trữ để áp dụng tiêu đề tuỳ chỉnh Sử dụng source để chỉ định một hình cầu (nên dùng). Sử dụng regex để chỉ định biểu thức chính quy RE2. Để tạo tiêu đề cho khớp với trang 404 tuỳ chỉnh, hãy dùng 404.html làm giá trị source hoặc regex.
	mảng (sub-)headers		Những tiêu đề tuỳ chỉnh mà dịch vụ 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ụ: Cache-Control
		value	Giá trị cho tiêu đề, ví dụ: max-age=7200

Lưu ý: Việc so khớp mẫu URL cho tiêu đề tuỳ chỉnh được thực hiện trước khi áp dụng bất kỳ quy tắc ghi lại nào.

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

Lưu ý quan trọng: Tính năng Lưu trữ Firebase ghi đè cấu hình Strict-Transport-Security trên miền con Lưu trữ mặc định (như *.web.app). Tuy nhiên, mọi miền tuỳ chỉnh đã kết nối sẽ phân phát giá trị đã định cấu hình.

Kiểm soát .html tiện ích

Không bắt buộc
Thuộc tính cleanUrls cho phép bạn kiểm soát việc URL có nên chứa đuôi .html hay không.

Khi true, dịch vụ Lưu trữ sẽ tự động loại bỏ phần mở rộng .html khỏi các URL tệp đã tải lên. Nếu bạn thêm một phần mở rộng .html vào yêu cầu, thì tính năng Lưu trữ sẽ thực hiện lệnh chuyển hướng 301 đến cùng đường dẫn đó nhưng loại bỏ phần mở rộng .html.

Sau đây là cách kiểm soát việc đưa .html vào URL bằng cách thêm thuộc tính cleanUrls:

"hosting": {
  // ...

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

Kiểm soát dấu gạch chéo ở cuối

Không bắt buộc
Thuộc tính trailingSlash cho phép bạn kiểm soát việc URL nội dung tĩnh có được chứa dấu gạch chéo ở cuối hay không.

• Khi true, Dịch vụ lưu trữ chuyển hướng URL để thêm dấu gạch chéo ở cuối.
• Khi false, tính năng Lưu trữ sẽ chuyển hướng URL để xóa dấu gạch chéo ở cuối.
• Khi không chỉ định, tính năng Lưu trữ chỉ sử dụng dấu gạch chéo ở cuối 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 ở cuối 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 do Cloud Functions hoặc Cloud Run phân phát.

So khớp mẫu hình cầu

Các tuỳ chọn cấu hình của tính năng Lưu trữ Firebase tận dụng triệt để chú thích so khớp mẫu toàn cầu với định dạng 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à tài liệu tham khảo chi tiết hơn, nhưng sau đây là phần giải thích cho 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 gốc của thư mục public

• ** — Khớp với mọi tệp hoặc thư mục trong thư mục con tuỳ ý

• * – Chỉ khớp các tệp và thư mục trong gốc của thư mục public

• **/.* – So khớp mọi tệp bắt đầu bằng . (thường là các tệp ẩn, như trong thư mục .git) trong một thư mục con tuỳ ý

• **/node_modules/** – So khớp mọi tệp hoặc thư mục trong một thư mục con tuỳ ý của thư mục node_modules. Thư mục này có thể nằm trong thư mục con tuỳ ý của thư mục public

• **/*.@(jpg|jpeg|gif|png) – So khớp mọi tệp trong một thư mục con tuỳ ý kết thúc bằng đúng một trong các phần sau: .jpg, .jpeg, .gif hoặc .png

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

Sau đây là ví dụ về cấu hình firebase.json đầy đủ cho tính năng Lưu trữ Firebase. Xin lưu ý rằng tệp firebase.json cũng có thể chứa 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",

  }
}