Firexport / Anleitungen

Firestore-Sicherheitsregeln und -Indizes exportieren

Die Firebase Console zeigt Ihre Firestore-Sicherheitsregeln in einem Editor und Ihre Indizes in einer Tabelle, hat aber für keines von beiden einen Button, der es als Datei speichert. Die Dateien, die die Firebase CLI bereitstellt, heißen firestore.rules und firestore.indexes.json. Es gibt drei Wege, sie zu bekommen. Welcher passt, hängt davon ab, ob Sie aus einem Projektordner bereitstellen und welche Version der Regeln Sie brauchen.

Aktualisiert am 27. Oktober 2026. Firexport, die Erweiterung in Methode 1, ist von uns. Die Methoden 2 und 3 brauchen sie nicht.

1. Mit Firexport aus der Firebase Console exportieren

Firexport ist eine kostenlose Chrome-Erweiterung, die den Tabs Regeln (Rules) und Indexe (Indexes) von Firestore einen Exportieren-Button hinzufügt. Sie müssen sich nirgends anmelden, und aus Ihrer Datenbank wird nichts gelesen: Firexport speichert, was die Console ohnehin schon anzeigt.

Sicherheitsregeln

1. Installieren Sie Firexport aus dem Chrome Web Store.
2. Öffnen Sie in der Firebase Console Firestore Database > Regeln (Rules).
3. Um eine ältere Version zu exportieren, wählen Sie sie in der Liste links aus. Nicht veröffentlichte Änderungen im Editor werden in ihrem aktuellen Stand exportiert.
4. Klicken Sie auf Exportieren, ganz rechts in der Leiste über dem Editor. Firexport speichert den Text des Editors als firestore.rules.

Die Datei enthält genau das, was im Editor steht, Byte für Byte, samt Kommentaren und Leerzeilen. Das Exportieren von Regeln ist in jedem Tarif kostenlos.

Indizes

1. Öffnen Sie Firestore Database > Indexe (Indexes).
2. Klicken Sie auf Exportieren, neben Index hinzufügen (Add index).

• In der kostenlosen Version speichert Firexport die Tabelle, die Sie gerade sehen, als JSON, mit allen ihren Seiten: zusammengesetzte Indizes unter Manuell (Manual), Ausnahmen für Einzelfeldindizes unter Automatisch (Automatic). Das ist die Tabelle, so wie die Console sie zeigt – firebase deploy kann sie daher nicht lesen, und sie heißt nicht firestore.indexes.json.
• Mit Advanced speichert Firexport firestore.indexes.json: zusammengesetzte Indizes und Feldüberschreibungen zusammen, egal welche Tabelle gerade angezeigt wird, in dem Format, das firebase firestore:indexes ausgibt. Für eine benannte Datenbank heißt die Datei firestore.<database>.indexes.json.
• Ein Unterschied zur Datei der CLI: Ein Feld mit einer TTL-Richtlinie, aber ohne Indexausnahme fehlt darin, weil die Console solche Felder nicht lädt.

Exportieren Sie Firestore-Regeln und -Indizes direkt aus der Console – ohne die Firebase CLI zu installieren.

Zu Chrome hinzufügen – kostenlos

2. Mit der Firebase CLI herunterladen

Die Firebase CLI schreibt beide Dateien, wenn sie Firestore in einem Ordner einrichtet: firebase init firestore lädt die Regeln und Indizes herunter, die im Projekt bereitgestellt sind. Nur für die Indizes gibt firebase firestore:indexes eine firestore.indexes.json aus. Beides ist kostenlos und braucht Node.js.

npm install -g firebase-tools
firebase login

# Rules and indexes, into firestore.rules and firestore.indexes.json
firebase init firestore

# Or only the indexes
firebase firestore:indexes --project your-project-id > firestore.indexes.json

• init fragt nach dem Projekt und den Dateinamen und schreibt eine firebase.json, die auf die Dateien verweist. Es lädt die zuletzt veröffentlichten Regeln herunter, keine ältere Version und keinen nicht veröffentlichten Entwurf.
• Für eine andere Datenbank als (default) hängen Sie --database <id> an firestore:indexes an. init fragt zwar, welche Datenbank eingerichtet werden soll, ruft die Regeln aber ohne den Namen der Datenbank ab – prüfen Sie also, ob firestore.rules aus der gewünschten Datenbank stammt.

3. Die Regeln aus der Console kopieren

Brauchen Sie die aktuellen Regeln nur einmal, reicht die Console. Öffnen Sie Firestore Database > Regeln (Rules), klicken Sie in den Editor, markieren Sie alles mit Strg+A (⌘A auf dem Mac), kopieren Sie es und fügen Sie es in eine Datei namens firestore.rules ein. Um eine ältere Version zu kopieren, wählen Sie sie vorher links aus.

Für Indizes gibt es keine solche Abkürzung. Der Tab „Indexe“ ist eine Tabelle, kein Text – eine Datei daraus heißt also, jeden Index von Hand in firestore.indexes.json zu schreiben.

Die Dateien wieder bereitstellen

Beide Dateien gehören neben eine firebase.json, die sie nennt – die, die firebase init firestore schreibt:

{
  "firestore": {
    "rules": "firestore.rules",
    "indexes": "firestore.indexes.json"
  }
}

Führen Sie dann firebase deploy --only firestore aus, oder firestore:rules bzw. firestore:indexes für nur eine der beiden.

• Hat das Projekt Indizes, die nicht in der Datei stehen, zeigt die CLI sie an und fragt, bevor sie sie löscht. --force löscht sie ohne Rückfrage. Eine TTL-Richtlinie, die in der Datei fehlt, wird nicht gelöscht.
• Fügen Sie --project hinzu, um dieselben Regeln und Indizes in einem anderen Projekt bereitzustellen, zum Beispiel von der Produktion ins Staging.
• Bereitgestellte Regeln gelten sofort für jeden Client – testen Sie Änderungen daher zuerst im Firestore-Emulator.

FAQ

Kann man Firestore-Sicherheitsregeln aus der Firebase Console herunterladen?

Nicht per Button. Der Tab Regeln (Rules) zeigt sie in einem Editor, aus dem Sie kopieren können, firebase init firestore lädt sie in firestore.rules herunter, und eine Browser-Erweiterung wie Firexport fügt einen Exportieren-Button hinzu, der sie als firestore.rules speichert.

Wie exportiere ich Firestore-Indizes nach firestore.indexes.json?

Führen Sie mit der Firebase CLI firebase firestore:indexes > firestore.indexes.json aus, oder exportieren Sie die Datei mit Firexport Advanced aus dem Tab Indexe (Indexes). Beide schreiben zusammengesetzte Indizes und Feldüberschreibungen in dem Format, das firebase deploy liest.

Wie kopiere ich Firestore-Indizes in ein anderes Projekt?

Exportieren Sie firestore.indexes.json aus dem ersten Projekt und führen Sie dann firebase deploy --only firestore:indexes --project mit der ID des anderen Projekts aus. Neue Indizes werden im Hintergrund erstellt, und Abfragen, die einen davon brauchen, schlagen fehl, bis er als Aktiviert (Enabled) angezeigt wird.

Kann ich eine ältere Version meiner Firestore-Regeln abrufen?

Ja, über die Console. Der Tab Regeln (Rules) listet links frühere Versionen auf; wählen Sie eine aus, um sie anzusehen, und kopieren Sie sie dann oder exportieren Sie sie mit Firexport. firebase init firestore lädt nur die zuletzt veröffentlichten Regeln herunter.

Kostet der Export von Regeln oder Indizes Firestore-Lesevorgänge?

Nein. Regeln und Indexdefinitionen sind keine Dokumente, ihr Speichern liest also nichts aus Ihrer Datenbank – ob über die Console, die CLI oder Firexport.