Lưu trữ đám mây cho Firebase cho phép bạn tải lên và chia sẻ nội dung do người dùng tạo, chẳng hạn như hình ảnh và video, cho phép bạn tạo nội dung đa phương tiện vào ứng dụng của mình. Dữ liệu của bạn được lưu trữ trong bộ chứa Google Cloud Storage — giải pháp lưu trữ đối tượng quy mô exabyte với tính khả dụng cao và dự phòng toàn cầu. Lưu trữ đám mây cho Firebase cho phép bạn tải trực tiếp các tệp này lên một cách an toàn từ thiết bị di động và trình duyệt web, xử lý các mạng bị lỗi một cách dễ dàng.
điều kiện tiên quyết
Nếu bạn chưa cài đặt, hãy cài đặt SDK Firebase JS và khởi tạo Firebase .
Tạo nhóm Lưu trữ đám mây mặc định
Từ ngăn điều hướng của bảng điều khiển Firebase , chọn Lưu trữ , sau đó nhấp vào Bắt đầu .
Xem lại thông báo về việc bảo mật dữ liệu Bộ nhớ đám mây của bạn bằng các quy tắc bảo mật. Trong quá trình phát triển, hãy xem xét việc thiết lập các quy tắc của bạn để truy cập công khai .
Chọn một vị trí cho bộ chứa Lưu trữ đám mây mặc định của bạn.
Cài đặt vị trí này là vị trí tài nguyên Google Cloud Platform (GCP) mặc định cho dự án của bạn. Lưu ý rằng vị trí này sẽ được sử dụng cho các dịch vụ GCP trong dự án của bạn, yêu cầu cài đặt vị trí, cụ thể là cơ sở dữ liệu Cloud Firestore và ứng dụng App Engine của bạn (bắt buộc nếu bạn sử dụng Trình lập lịch biểu đám mây).
Nếu bạn không thể chọn một vị trí thì dự án của bạn đã có một vị trí tài nguyên GCP mặc định. Nó được đặt trong khi tạo dự án hoặc khi thiết lập một dịch vụ khác yêu cầu cài đặt vị trí.
Nếu bạn đang sử dụng gói Blaze, bạn có thể tạo nhiều nhóm , mỗi nhóm có vị trí riêng.
Nhấp vào Xong .
Thiết lập quyền truy cập công cộng
Lưu trữ đám mây cho Firebase cung cấp ngôn ngữ quy tắc khai báo cho phép bạn xác định cách cấu trúc dữ liệu, cách lập chỉ mục dữ liệu và thời điểm dữ liệu của bạn có thể được đọc và ghi vào. Theo mặc định, quyền truy cập đọc và ghi vào Cloud Storage bị hạn chế nên chỉ người dùng được xác thực mới có thể đọc hoặc ghi dữ liệu. Để bắt đầu mà không cần thiết lập Xác thực , bạn có thể định cấu hình các quy tắc của mình để truy cập công khai .
Điều này làm cho Cloud Storage mở cho bất kỳ ai, ngay cả những người không sử dụng ứng dụng của bạn, vì vậy hãy đảm bảo hạn chế lại Cloud Storage của bạn khi bạn thiết lập xác thực.
Thêm URL bộ chứa của bạn vào ứng dụng của bạn
Nếu nó chưa được bao gồm, thì bạn cần thêm URL bộ chứa Cloud Storage của mình vào đối tượng cấu hình của ứng dụng Firebase .
Chuyển đến trang tổng quan Bộ nhớ của bạn trong bảng điều khiển Firebase .
Nhấp vào tab Tệp , sau đó xem tiêu đề của trình xem tệp.
Sao chép URL vào khay nhớ tạm của bạn. Nó thường ở dạng
project-id .appspot.com
.Đối với đối tượng
firebaseConfig
trong ứng dụng của bạn, hãy thêm thuộc tínhstorageBucket
với URL bộ chứa của bạn:
API mô-đun web
import { initializeApp } from "firebase/app"; import { getStorage } from "firebase/storage"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... storageBucket: '' }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Cloud Storage and get a reference to the service const storage = getStorage(app);
API không gian tên web
import firebase from "firebase/app"; import "firebase/compat/storage"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... storageBucket: '[your-storage-bucket-url]' }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Cloud Storage and get a reference to the service const storage = firebase.storage();
Bạn đã sẵn sàng bắt đầu sử dụng Cloud Storage!
Bước tiếp theo? Tìm hiểu cách tạo tham chiếu Lưu trữ đám mây .
thiết lập nâng cao
Có một vài trường hợp sử dụng yêu cầu thiết lập bổ sung:
- Sử dụng các nhóm Lưu trữ đám mây ở nhiều vùng địa lý
- Sử dụng các thùng Lưu trữ đám mây trong các lớp lưu trữ khác nhau
- Sử dụng bộ chứa Cloud Storage với nhiều người dùng được xác thực trong cùng một ứng dụng
Trường hợp sử dụng đầu tiên là hoàn hảo nếu bạn có người dùng trên khắp thế giới và muốn lưu trữ dữ liệu của họ ở gần họ. Chẳng hạn, bạn có thể tạo các bộ chứa ở Hoa Kỳ, Châu Âu và Châu Á để lưu trữ dữ liệu cho người dùng ở những khu vực đó nhằm giảm độ trễ.
Trường hợp sử dụng thứ hai hữu ích nếu bạn có dữ liệu với các kiểu truy cập khác nhau. Ví dụ: bạn có thể thiết lập bộ chứa đa khu vực hoặc khu vực để lưu trữ ảnh hoặc nội dung thường xuyên truy cập khác và bộ chứa tuyến gần hoặc bộ chứa lạnh lưu trữ các bản sao lưu của người dùng hoặc nội dung không được truy cập thường xuyên khác.
Trong một trong hai trường hợp sử dụng này, bạn sẽ muốn sử dụng nhiều bộ chứa Lưu trữ đám mây .
Trường hợp sử dụng thứ ba sẽ hữu ích nếu bạn đang xây dựng một ứng dụng, chẳng hạn như Google Drive, cho phép người dùng có nhiều tài khoản đã đăng nhập (ví dụ: tài khoản cá nhân và tài khoản công việc). Bạn có thể sử dụng phiên bản Ứng dụng Firebase tùy chỉnh để xác thực từng tài khoản bổ sung.
Sử dụng nhiều nhóm Lưu trữ đám mây
Nếu bạn muốn sử dụng bộ chứa Cloud Storage khác với bộ chứa mặc định được cung cấp ở trên hoặc sử dụng nhiều bộ chứa Cloud Storage trong một ứng dụng, bạn có thể tạo một phiên bản firebase.storage
tham chiếu bộ chứa tùy chỉnh của bạn:
Web modular API
import { getApp } from "firebase/app"; import { getStorage } from "firebase/storage"; // Get a non-default Storage bucket const firebaseApp = getApp(); const storage = getStorage(firebaseApp, "gs://my-custom-bucket");
Web namespaced API
// Get a non-default Storage bucket var storage = firebase.app().storage("gs://my-custom-bucket");
Làm việc với các thùng nhập khẩu
Khi nhập bộ chứa Lưu trữ đám mây hiện có vào Firebase, bạn sẽ phải cấp cho Firebase khả năng truy cập các tệp này bằng công cụ gsutil
, có trong Google Cloud SDK :
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Bạn có thể tìm thấy số dự án của mình như được mô tả trong phần giới thiệu về dự án Firebase .
Điều này không ảnh hưởng đến các nhóm mới được tạo, vì các nhóm này đã đặt kiểm soát truy cập mặc định để cho phép Firebase. Đây là một biện pháp tạm thời và sẽ được thực hiện tự động trong tương lai.
Sử dụng ứng dụng Firebase tùy chỉnh
Nếu bạn đang xây dựng một ứng dụng phức tạp hơn bằng firebase.app.App
tùy chỉnh, bạn có thể tạo một phiên bản của firebase.storage.Storage
được khởi tạo với ứng dụng đó:
Web modular API
import { getStorage } from "firebase/storage"; // Get the default bucket from a custom firebase.app.App const storage1 = getStorage(customApp); // Get a non-default bucket from a custom firebase.app.App const storage2 = getStorage(customApp, "gs://my-custom-bucket");
Web namespaced API
// Get the default bucket from a custom firebase.app.App var storage = customApp.storage(); // Get a non-default bucket from a custom firebase.app.App var storage = customApp.storage("gs://my-custom-bucket");
Bước tiếp theo
Chuẩn bị khởi chạy ứng dụng của bạn:
Bật Kiểm tra ứng dụng để giúp đảm bảo rằng chỉ ứng dụng của bạn mới có thể truy cập vào bộ chứa lưu trữ của bạn.
Thiết lập cảnh báo ngân sách cho dự án của bạn trong Google Cloud Console.
Theo dõi bảng điều khiển Sử dụng và thanh toán trong bảng điều khiển Firebase để có được bức tranh tổng thể về việc sử dụng dự án của bạn trên nhiều dịch vụ Firebase. Bạn cũng có thể truy cập bảng điều khiển Sử dụng bộ nhớ đám mây để biết thêm thông tin sử dụng chi tiết.
Xem lại danh sách kiểm tra khởi chạy Firebase .