Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Beginnen Sie mit Cloud Storage im Web

Mit Cloud Storage für Firebase können Sie benutzergenerierte Inhalte wie Bilder und Videos hochladen und freigeben, sodass Sie Rich Media-Inhalte in Ihre Apps integrieren können. Ihre Daten werden in einem Google Cloud Storage- Bucket gespeichert - einer Objektspeicherlösung im Exabyte-Maßstab mit hoher Verfügbarkeit und globaler Redundanz. Mit Cloud Storage für Firebase können Sie diese Dateien sicher direkt von Mobilgeräten und Webbrowsern hochladen und so mühelos fleckige Netzwerke verwalten.

Voraussetzungen

Fügen Sie das Firebase SDK zu Ihrer App hinzu und konfigurieren Sie es.

Erstellen Sie einen Standard-Cloud-Speicher-Bucket

  1. Wählen Sie im Navigationsbereich der Firebase-Konsole Speicher aus , und klicken Sie dann auf Erste Schritte .

  2. Überprüfen Sie die Nachrichten zum Sichern Ihrer Cloud-Speicherdaten mithilfe von Sicherheitsregeln. Erwägen Sie während der Entwicklung, Ihre Regeln für den öffentlichen Zugriff einzurichten .

  3. Wählen Sie einen Speicherort für Ihren Standard-Cloud-Speicher-Bucket.

    • Diese Standorteinstellung ist der Standard-Ressourcenstandort Ihres Projekts für die Google Cloud Platform (GCP) . Beachten Sie, dass dieser Speicherort für GCP-Dienste in Ihrem Projekt verwendet wird, für die eine Standorteinstellung erforderlich ist, insbesondere für Ihre Cloud Firestore- Datenbank und Ihre App Engine- App (die erforderlich ist, wenn Sie Cloud Scheduler verwenden).

    • Wenn Sie keinen Speicherort auswählen können, verfügt Ihr Projekt bereits über einen Standardspeicherort für GCP-Ressourcen. Sie wurde entweder während der Projekterstellung oder beim Einrichten eines anderen Dienstes festgelegt, für den eine Standorteinstellung erforderlich ist.

    Wenn Sie sich im Blaze-Plan befinden, können Sie mehrere Buckets mit jeweils einem eigenen Standort erstellen .

  4. Klicken Sie auf Fertig .

Richten Sie den öffentlichen Zugriff ein

Cloud Storage für Firebase bietet eine deklarative Regelsprache, mit der Sie festlegen können, wie Ihre Daten strukturiert werden sollen, wie sie indiziert werden sollen und wann Ihre Daten gelesen und beschrieben werden können. Standardmäßig ist der Lese- und Schreibzugriff auf Cloud Storage eingeschränkt, sodass nur authentifizierte Benutzer Daten lesen oder schreiben können. Um zu beginnen, ohne die Authentifizierung einzurichten, können Sie Ihre Regeln für den öffentlichen Zugriff konfigurieren .

Dadurch kann der Cloud-Speicher auch für Benutzer geöffnet werden, auch für Personen, die Ihre App nicht verwenden. Achten Sie daher darauf, Ihren Cloud-Speicher beim Einrichten der Authentifizierung erneut einzuschränken.

Fügen Sie Ihrer App Ihre Bucket-URL hinzu

Wenn es noch nicht enthalten ist, müssen Sie Ihre Cloud Storage Bucket-URL zum Konfigurationsobjekt Ihrer Firebase-App hinzufügen.

  1. Wechseln Sie in der Firebase-Konsole zu Ihrem Speicher-Dashboard.

  2. Klicken Sie auf die Registerkarte Dateien und sehen Sie in der Kopfzeile des Datei-Viewers nach.

  3. Kopieren Sie die URL in Ihre Zwischenablage. Es hat normalerweise die Form project-id .appspot.com .

  4. storageBucket Sie Ihrem firebaseConfig Objekt in Ihrer App das storageBucket Attribut mit Ihrer Bucket-URL hinzu:

    Web v8

    // Set the configuration for your app
    // TODO: Replace with your app's config object
    var firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    firebase.initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    var storage = firebase.storage();

    Web v9

    import { initializeApp } from "firebase/app";
    import { getStorage } from "firebase/storage";
    
    // Set the configuration for your app
    // TODO: Replace with your app's config object
    const firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    const firebaseApp = initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    const storage = getStorage(firebaseApp);

Sie können Cloud Storage jetzt verwenden!

Nächster Schritt? Erfahren Sie, wie Sie eine Cloud-Speicherreferenz erstellen .

Erweiterte Einrichtung

Es gibt einige Anwendungsfälle, für die zusätzliche Einstellungen erforderlich sind:

Der erste Anwendungsfall ist perfekt, wenn Sie Benutzer auf der ganzen Welt haben und deren Daten in ihrer Nähe speichern möchten. Sie können beispielsweise Buckets in den USA, Europa und Asien erstellen, um Daten für Benutzer in diesen Regionen zu speichern und die Latenz zu verringern.

Der zweite Anwendungsfall ist hilfreich, wenn Sie Daten mit unterschiedlichen Zugriffsmustern haben. Beispiel: Sie können einen multiregionalen oder regionalen Bucket einrichten, in dem Bilder oder andere Inhalte gespeichert werden, auf die häufig zugegriffen wird, und einen Nearline- oder Coldline-Bucket, in dem Benutzersicherungen oder andere Inhalte gespeichert werden, auf die selten zugegriffen wird.

In beiden Anwendungsfällen möchten Sie mehrere Cloud-Speicher-Buckets verwenden .

Der dritte Anwendungsfall ist nützlich, wenn Sie eine App wie Google Drive erstellen, mit der Benutzer mehrere angemeldete Konten haben können (z. B. ein persönliches Konto und ein Arbeitskonto). Sie können eine benutzerdefinierte Firebase App- Instanz verwenden, um jedes weitere Konto zu authentifizieren.

Verwenden Sie mehrere Cloud-Speicher-Buckets

Wenn Sie einen anderen Cloud-Speicher-Bucket als den oben angegebenen Standard verwenden oder mehrere Cloud-Speicher-Buckets in einer einzigen App verwenden möchten, können Sie eine Instanz von firebase.storage erstellen, die auf Ihren benutzerdefinierten Bucket verweist:

Web v8

// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");

Web v9

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");

Arbeiten mit importierten Eimern

Wenn Sie einen vorhandenen Cloud-Speicher-Bucket in Firebase importieren, müssen Sie Firebase die Möglichkeit gewähren, mit dem im Google Cloud SDK gsutil Tool gsutil auf diese Dateien gsutil :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Sie finden Ihre Projektnummer wie in der Einführung zu Firebase-Projekten beschrieben .

Dies wirkt sich nicht auf neu erstellte Buckets aus, da für diese die Standardzugriffskontrolle festgelegt ist, um Firebase zuzulassen. Dies ist eine vorübergehende Maßnahme und wird in Zukunft automatisch durchgeführt.

Verwenden Sie eine benutzerdefinierte Firebase-App

Wenn Sie eine kompliziertere App mit einer benutzerdefinierten firebase.app.App erstellen, können Sie eine Instanz von firebase.storage.Storage erstellen, die mit dieser App initialisiert wurde:

Web v8

// 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");

Web v9

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");

Nächste Schritte