Dateimanager für MinIO und selbst gehostetes S3: so verbindest du es mit Nubbo

Nubbo verbindet sich mit jedem S3-kompatiblen Speicher, der mit Signature V4 signiert, etwa MinIO, Ceph oder SeaweedFS, auf deinem eigenen Server oder bei einem anderen Provider. Du brauchst nur die Endpoint-URL, einen Schlüssel und die Region. 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 deinem Server 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 einen S3-kompatiblen Speicher 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. Der Endpoint muss eine öffentliche URL sein, die sowohl die Server von Nubbo als auch der Browser erreichen, und er braucht HTTPS, weil der Browser auf https://nubbo.app keine HTTP-Inhalte lädt. Nubbo lehnt Endpoints ab, die auf private oder lokale Adressen zeigen. Wenn dein Server keine Regionen hat, lass us-east-1 stehen.

Wähle, wie du verbindest

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

Automatische Verbindung

Schritt 1: erstelle den Schlüssel auf deinem Server

1. Prüfe, ob dein Server die S3-API mit Signature V4 unter einer öffentlichen HTTPS-URL bereitstellt, zum Beispiel https://s3.your-domain.com.
2. Erstelle einen Schlüssel, der Buckets erstellen und deren CORS ändern kann.
3. Notiere dir die Endpoint-URL und die Region. Wenn dein Server keine Regionen hat, verwende us-east-1.

Schritt 2: verbinde den Bucket in Nubbo

1. Öffne in Nubbo Buckets und klicke auf Bucket verbinden. Wähle Benutzerdefiniertes S3 / selbst gehostet und klicke auf Weiter.

   

2. Wähle Automatisch und klicke auf Weiter.

   

3. Füge im Schritt Dein Schlüssel den Access Key, den Secret Key, die Endpoint-URL und die Region ein. Klicke auf Schlüssel prüfen. Nubbo prüft, ob der Schlüssel funktioniert und Zugriff auf das ganze Konto hat.

   

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 nur Uploads und Downloads aus der App erlaubt, und behält die Regeln bei, die er schon hat.

   

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.

   

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 auf deinem Server vor

1. Erstelle den Bucket auf deinem Server (bei MinIO zum Beispiel mit mc mb).
2. Erstelle einen Schlüssel mit Lese- und Schreibrechten für diesen Bucket.
3. Notiere dir die Endpoint-URL und die Region.

Schritt 2: verbinde den Bucket in Nubbo

1. Klicke unter Buckets auf Bucket verbinden, wähle Benutzerdefiniertes S3 / selbst gehostet und dann Mit beschränktem Schlüssel.
2. Füge den Access Key, den Secret Key, den Endpoint und die Region ein. Klicke auf Schlüssel prüfen.
3. Gib den genauen Namen des Buckets ein und klicke auf Zugriff prüfen.
4. Der Assistent geht 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 daraus herunterzuladen. Es ist dieselbe Regel, die der Assistent im Schritt CORS anzeigt.

Wie du CORS einrichtest, hängt von der Software ab:

• MinIO (Community-Edition) akzeptiert kein CORS pro Bucket: Es nutzt eine globale Einstellung (MINIO_API_CORS_ALLOW_ORIGIN), die standardmäßig jeden Origin erlaubt. Wenn du sie nicht geändert hast, ist nichts zu tun: Klicke auf Hinzugefügt, prüfen, und die Prüfung ist erfolgreich. Wenn du sie geändert hast, nimm https://nubbo.app mit auf.
• Ceph und SeaweedFS akzeptieren CORS pro Bucket über die S3-API. Wende diese Regel mit deinem üblichen Tool an (zum Beispiel aws s3api put-bucket-cors mit deinem Endpoint) oder lass Nubbo das auf dem automatischen Weg erledigen.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Sobald die Regel bereit ist, geh zurück zu Nubbo und klicke auf Hinzugefügt, prüfen. Bei Ceph und SeaweedFS erledigt Versuchen, es für mich einzurichten das für dich, wenn dein Schlüssel CORS ändern darf.

Wenn etwas schiefgeht

Was es kostet

Wenn du deinen eigenen Speicher mit einem Provider vergleichst, findest du Preise und Limits in S3 vs. R2 vs. Spaces vs. Wasabi vs. Backblaze B2.