Anleitungen

Dateimanager für Cloudflare R2: so verbindest du es mit Nubbo

So verbindest du einen Cloudflare R2 Bucket mit Nubbo: API-Token, Account ID, der Assistent Schritt für Schritt, die CORS-Regel und Hilfe bei Fehlern.

Nubbo verbindet sich mit Cloudflare R2 über ein R2 API-Token und die Account ID deines Kontos. In wenigen Minuten sind deine Buckets in einem Datei-Explorer mit direkten Uploads, Freigabelinks und Galerien. Diese Anleitung folgt dem Assistenten von Nubbo Schritt für Schritt, mit beiden Wegen: automatisch oder mit einem Schlüssel, der auf einen Bucket beschränkt ist.

Was du bekommst

  • Durchsuche den Bucket wie ein Laufwerk: Ordner, Ansichten, Suche, Papierkorb, Labels und Favoriten.
  • Lade Dateien direkt zwischen deinem Browser und Cloudflare R2 hoch und herunter. Die Dateien laufen nie über die Server von Nubbo.
  • Teile Dateien und Ordner mit Passwort, Ablaufdatum und Download-Limit, empfange Dateien in deinem Bucket und erstelle Galerien.
  • Deine Schlüssel werden mit AES-256-GCM verschlüsselt gespeichert und du kannst den Bucket jederzeit trennen.

Bevor du anfängst

Du brauchst ein Konto bei Cloudflare R2 und ein Nubbo-Konto. Jeder Bucket, den du verbindest, wird auf das Limit deines Plans angerechnet: Der kostenlose Plan erlaubt 2, Personal 5 und Pro hat kein Limit. Vor deinem ersten Bucket verlangt Cloudflare, dass du das R2-Abo im Dashboard aktivierst. Hat dein Bucket eine Jurisdiktion (EU, FedRAMP oder US), wählst du sie im Assistenten und Nubbo nutzt den Endpoint dieser Jurisdiktion.

Wähle, wie du verbindest

Der Assistent von Nubbo bietet zwei Wege. Beide enden gleich: mit dem Bucket verbunden und bereit für Uploads aus dem Browser.

AutomatischMit beschränktem Schlüssel
SchlüsselZugriff auf das ganze KontoAuf einen Bucket beschränkt
BucketNubbo nutzt einen deiner Buckets oder erstellt einenDu erstellst ihn zuerst
CORSNubbo fügt die Regel für dich hinzuDu fügst die Regel hinzu
Wann du ihn wählstDer schnellste WegWenn du keinen Zugriff auf das ganze Konto geben möchtest

Der beschränkte Schlüssel ist der geringste Zugriff, den Nubbo braucht: Object Read & Write auf einen Bucket. Damit kann Nubbo deine Buckets weder auflisten noch einen erstellen, also gibst du den Namen des Buckets ein und fügst die CORS-Regel selbst hinzu.

Automatische Verbindung

Schritt 1: erstelle den Schlüssel in Cloudflare R2

  1. Melde dich bei dash.cloudflare.com an und öffne R2 object storage. Das Dashboard kann die Menüs in deiner Sprache anzeigen.
  2. Öffne API Tokens und klicke auf Create Account API token. Du erreichst es auch über Overview, unter Account Details, Manage.
  3. Wähle die Berechtigung Admin Read & Write und erstelle das Token.
  4. Kopiere die Access Key ID und den Secret Access Key. Cloudflare zeigt das Secret nur einmal an. Verwende diese beiden Schlüssel, nicht den Wert des Tokens.
  5. Kopiere auch deine Account ID, die auf der Seite R2 Overview angezeigt wird.

Schritt 2: verbinde den Bucket in Nubbo

  1. Öffne in Nubbo den Bereich Buckets und klicke auf Bucket verbinden. Wähle Cloudflare R2 und klicke auf Weiter.

    Schritt Anbieter im Assistenten von Nubbo mit ausgewähltem Cloudflare R2 Schritt Anbieter im Assistenten von Nubbo mit ausgewähltem Cloudflare R2
  2. Wähle Automatisch und klicke auf Weiter.

    Schritt Verbindungsart mit den Optionen Automatisch und Mit beschränktem Schlüssel Schritt Verbindungsart mit den Optionen Automatisch und Mit beschränktem Schlüssel
  3. Füge im Schritt Dein Schlüssel die Access Key ID, den Secret Access Key und die Account ID ein. Nubbo bildet aus der Account ID den Endpoint deines Kontos. Die Region von R2 ist immer auto. Bevor du auf Schlüssel prüfen klickst, wähle die Jurisdiktion deines Buckets: Standard (keine Jurisdiktion) für die meisten Buckets oder EU, FedRAMP oder US. Der Endpoint ändert sich damit (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com für die EU) und die Liste zeigt nur Buckets dieser Jurisdiktion. Klicke auf Schlüssel prüfen. Nubbo prüft, ob der Schlüssel funktioniert und Zugriff auf das ganze Konto hat.

    Schritt Dein Schlüssel für Cloudflare R2 mit der Kurzanleitung und den Schlüsselfeldern Schritt Dein Schlüssel für Cloudflare R2 mit der Kurzanleitung und den Schlüsselfeldern
  4. Wähle einen deiner Buckets und klicke auf Diesen Bucket verwenden, oder markiere Neuen erstellen, gib einen Namen ein (und wähle die Region, falls danach gefragt wird) und klicke auf Erstellen und vorbereiten. Nubbo fügt dem Bucket eine CORS-Regel hinzu, die Uploads und Downloads nur aus der App erlaubt, und behält die bereits vorhandenen Regeln bei.

    Schritt Dein Bucket mit der Liste der Buckets und der Option Neuen erstellen Schritt Dein Bucket mit der Liste der Buckets und der Option Neuen erstellen
  5. Sieh dir die drei Prüfungen an, ändere bei Bedarf den Name in Nubbo und klicke auf Abschließen. Der Bucket erscheint unter Buckets und du kannst ihn im Explorer öffnen.

    Schritt Fertig mit den Prüfungen für Verbindung, Bucket und CORS Schritt Fertig mit den Prüfungen für Verbindung, Bucket und CORS

Wenn Nubbo die CORS-Regel mit deinem Schlüssel nicht hinzufügen kann, führt dich der Assistent zum Schritt CORS. Folge dann dem Abschnitt CORS-Regel hinzufügen.

Verbindung mit beschränktem Schlüssel

Schritt 1: bereite den Bucket und den Schlüssel in Cloudflare R2 vor

  1. Klicke in R2, Overview auf Create bucket und gib ihm einen Namen (Kleinbuchstaben, Zahlen und Bindestriche). Eine Region musst du nicht wählen. Wenn die Daten in der EU bleiben müssen, wähle die Jurisdiktion EU: Der Endpoint ändert sich damit.
  2. Öffne API Tokens und klicke auf Create Account API token.
  3. Wähle die Berechtigung Object Read & Write und beschränke sie auf deinen Bucket.
  4. Kopiere die Access Key ID, den Secret Access Key und deine Account ID.

Schritt 2: verbinde den Bucket in Nubbo

  1. Klicke unter Buckets auf Bucket verbinden, wähle Cloudflare R2 und dann Mit beschränktem Schlüssel.
  2. Füge die Access Key ID, den Secret Access Key und die Account ID ein. Bevor du auf Schlüssel prüfen klickst, wähle dieselbe Jurisdiktion wie beim Bucket. Klicke auf Schlüssel prüfen.
  3. Gib den exakten Namen des Buckets ein und klicke auf Zugriff prüfen.
  4. Der Assistent wechselt zum Schritt CORS mit der Regel, die du hinzufügen musst.

CORS-Regel hinzufügen

Die CORS-Regel erlaubt dem Browser, auf https://nubbo.app Dateien in deinen Bucket hochzuladen und aus ihm herunterzuladen. Es ist dieselbe Regel, die der Assistent im Schritt CORS anzeigt.

  1. Öffne in R2 den Bucket und gehe zu Settings.
  2. Klicke unter CORS Policy auf Add CORS policy und wähle den Tab JSON.
  3. Füge die Regel ein und klicke auf Save. Cloudflare kann bis zu 30 Sekunden brauchen, um sie anzuwenden.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Schritt CORS mit der Regel, die du dem Bucket hinzufügen musst Schritt CORS mit der Regel, die du dem Bucket hinzufügen musst

Sobald sie gespeichert ist, kehre zu Nubbo zurück und klicke auf Hinzugefügt, prüfen. Wenn dein Schlüssel CORS ändern darf, erledigt Versuchen, es für mich einzurichten das für dich.

Wenn etwas schiefgeht

Meldung in NubboWas du tun kannst
„Dieser Schlüssel scheint auf einen Bucket beschränkt zu sein. Du kannst mit dem beschränkten Weg fortfahren oder einen Schlüssel mit Vollzugriff erstellen.“Klicke auf Mit beschränktem Schlüssel fortfahren, oder erstelle einen Schlüssel mit Zugriff auf das ganze Konto und klicke auf Anderen Schlüssel testen.
„Dein Schlüssel hat keine Berechtigung, Buckets zu erstellen.“Verwende einen Schlüssel mit Vollzugriff, oder erstelle den Bucket in deinem Panel und klicke auf Ich habe ihn in meinem Panel erstellt.
„Dieser Name wird bei diesem Provider bereits verwendet; versuche einen anderen.“Bucket-Namen sind beim gesamten Provider eindeutig: Wähle einen anderen.
„Dein Schlüssel hat keine Berechtigung, das einzurichten.“Füge die CORS-Regel von Hand hinzu, wie oben beschrieben.
„Es funktioniert noch nicht. Prüfe die Regel und teste erneut; manche Provider brauchen eine Minute, um sie anzuwenden.“Prüfe, ob der Origin genau https://nubbo.app ist, ohne Schrägstrich am Ende, warte eine Minute und prüfe erneut.
„Dieser Bucket wird bereits verwendet.“Dieser Bucket ist bereits in Nubbo verbunden, in deinem Konto oder in einem anderen.
„Ungültige Zugangsdaten. Überprüf den Access Key und den Secret Access Key.“Prüfe, ob du die Access Key ID und den Secret Access Key des Tokens eingefügt hast und nicht den Wert des Cloudflare API-Tokens.
„Bucket nicht gefunden. Überprüf den Namen und die Region.“Prüfe den Namen und ob die Jurisdiktion in Nubbo der des Buckets entspricht (R2 zeigt sie in den Settings des Buckets).

Was es kostet

R2 berechnet keinen Egress und hat ein monatliches kostenloses Kontingent. Wir erklären es in Kostenloses Kontingent von Cloudflare R2.

Häufige Fragen

Wo finde ich meine Cloudflare Account ID?

Auf der Seite R2 Overview unter Account Details. Es ist eine Zeichenfolge aus 32 Zeichen mit Ziffern und den Buchstaben a bis f.

Welche Berechtigung braucht das R2-Token?

Der geringste Zugriff, den Nubbo braucht, ist Object Read & Write, beschränkt auf deinen Bucket, mit dem Weg mit beschränktem Schlüssel: Du gibst den Namen des Buckets ein und fügst die CORS-Regel selbst hinzu. Der automatische Weg braucht Admin Read & Write, damit Nubbo deine Buckets auflisten, einen erstellen und dessen CORS einrichten kann.

Welche Region verwende ich bei R2?

Keine: R2 nutzt die Region auto und Nubbo stellt sie für dich ein. Die Location Hints von Cloudflare ändern nichts daran, wie der Bucket verbunden wird.

Kann ich einen R2-Bucket mit Jurisdiktion verbinden, etwa der EU?

Ja. Wähle im Schritt Dein Schlüssel die Jurisdiktion des Buckets (EU, FedRAMP oder US). Jede hat ihren eigenen Endpoint, etwa https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com, und zeigt nur die Buckets, die darin erstellt wurden.

Kosten Downloads aus Nubbo bei R2 Egress?

Nein. R2 berechnet keinen ausgehenden Datenverkehr. Downloads zählen allerdings als Lesevorgänge.

Quellen

Preise und Limits stammen von den unten verlinkten offiziellen Seiten. Provider ändern sie, prüfe sie also, bevor du dich festlegst.