Anleitungen

Dateimanager für Amazon S3: verbinde es mit Nubbo

So verbindest du einen Amazon S3-Bucket mit Nubbo: der nötige IAM-Schlüssel, der Assistent Schritt für Schritt, die CORS-Regel und Hilfe bei Fehlern.

Nubbo verbindet sich mit Amazon S3 über einen IAM-Zugriffsschlüssel. In wenigen Minuten ist dein Bucket in einem Datei-Explorer mit direkten Uploads, Freigabelinks und Galerien, ohne dass du etwas öffentlich machen musst. 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 Amazon S3 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 Amazon S3 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. Einige AWS-Regionen sind standardmäßig deaktiviert und müssen im Konto aktiviert werden, bevor du sie nutzt (zum Beispiel Mailand, Zürich oder Kapstadt). Wenn du den Bucket in einer davon erstellen willst, aktiviere sie zuerst. Block Public Access musst du nicht abschalten: Nubbo hält den Bucket privat.

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.

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

Automatische Verbindung

Schritt 1: erstelle den Schlüssel in Amazon S3

  1. Melde dich in der AWS-Konsole an und öffne IAM. Verwende einen IAM-Benutzer, nie den Root-Benutzer des Kontos.
  2. Gehe zu Benutzer und klicke auf Benutzer erstellen. Gib ihm einen Namen, zum Beispiel nubbo, und klicke auf Weiter.
  3. Wähle unter Berechtigungen festlegen die Option Richtlinien direkt anfügen, suche AmazonS3FullAccess, markiere es und erstelle den Benutzer.
  4. Öffne den Benutzer, gehe zum Tab Sicherheits-Anmeldeinformationen und klicke unter Zugriffsschlüssel auf Zugriffsschlüssel erstellen.
  5. Wähle als Anwendungsfall eine Anwendung, die außerhalb von AWS läuft (oder Andere, falls es nicht aufgeführt ist) und klicke auf Weiter und Zugriffsschlüssel erstellen.
  6. Klicke auf CSV-Datei herunterladen. Nur dieses eine Mal zeigt dir AWS den Secret Access Key.

Schritt 2: verbinde den Bucket in Nubbo

  1. Öffne in Nubbo Buckets und klicke auf Bucket verbinden. Wähle Amazon S3 und klicke auf Weiter.

    Schritt Anbieter im Assistenten von Nubbo mit ausgewähltem Amazon S3 Schritt Anbieter im Assistenten von Nubbo mit ausgewähltem Amazon S3
  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. Klicke im Schritt Dein Schlüssel auf Datei hochladen und wähle die heruntergeladene CSV aus, oder füge ihren Inhalt in das Textfeld ein. Nubbo liest den Access Key und das Secret aus, damit du sie nicht von Hand kopieren musst. Prüfe, ob die Region die deiner Buckets ist. 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 Amazon S3 mit der Kurzanleitung und den Schlüsselfeldern Schritt Dein Schlüssel für Amazon S3 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 nur Uploads und Downloads aus der App erlaubt, und behält die Regeln bei, die er schon hat.

    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 Amazon S3 vor

  1. Wähle in der Konsole oben in der Leiste die Region, öffne S3 und klicke unter Allzweck-Buckets auf Bucket erstellen. Gib ihm einen Namen (3 bis 63 Zeichen: Kleinbuchstaben, Zahlen, Punkte und Bindestriche) und erstelle ihn mit aktiviertem Block Public Access.
  2. Erstelle in IAM einen Benutzer ohne Berechtigungen (Benutzer, Benutzer erstellen).
  3. Öffne den Benutzer, Tab Berechtigungen, Berechtigungen hinzufügen, Inline-Richtlinie erstellen. Wechsle zum JSON-Editor, füge diese Richtlinie ein, ersetze YOUR-BUCKET durch den Namen deines Buckets und speichere sie unter einem Namen.
  4. Erstelle den Schlüssel unter Sicherheits-Anmeldeinformationen, Zugriffsschlüssel erstellen, wie bei der automatischen Verbindung, und lade die CSV herunter.
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
    }
  ]
}

Schritt 2: verbinde den Bucket in Nubbo

  1. Klicke unter Buckets auf Bucket verbinden, wähle Amazon S3 und dann Mit beschränktem Schlüssel.
  2. Lade die CSV des Schlüssels hoch oder füge ihren Inhalt ein und wähle die Region des Buckets. 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.

  1. Öffne in der S3-Konsole den Bucket und gehe zum Tab Berechtigungen.
  2. Scrolle nach unten zu Cross-Origin Resource Sharing (CORS) und klicke auf Bearbeiten.
  3. Füge die Regel ein und klicke auf Änderungen speichern.
[
  {
    "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, geh zurück zu Nubbo und klicke auf Hinzugefügt, prüfen. Manche Provider brauchen eine Minute, um sie anzuwenden. 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
„Ungültige Zugangsdaten. Überprüf den Access Key und den Secret Access Key.“Kopiere beide Schlüssel erneut, ohne Leerzeichen am Anfang oder am Ende.
„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.
„Bucket nicht gefunden. Überprüf den Namen und die Region.“Prüfe den genauen Namen des Buckets und ob die gewählte Region die des Buckets ist.
„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.
„Der Bucket befindet sich in einer anderen Region. Überprüf die konfigurierte Region.“Wähle im Schritt Dein Schlüssel die Region, in der sich der Bucket befindet.
„Wir konnten in dieser Datei keine Schlüssel finden; füge sie von Hand ein.“Lade die CSV hoch, die du beim Erstellen des Schlüssels heruntergeladen hast, oder füge ihren Inhalt unverändert ein.

Was es kostet

Amazon S3 berechnet Speicher, Anfragen und ausgehenden Datenverkehr. Wir erklären es mit Beispielen in Preise von Amazon S3.

Häufige Fragen

Muss ich meinen S3-Bucket öffentlich machen, um Nubbo zu nutzen?

Nein. Nubbo hält den Bucket privat und Block Public Access kann aktiviert bleiben. Uploads und Downloads laufen über Presigned URLs, die ablaufen.

Welche Berechtigungen braucht der AWS-Schlüssel?

Für den automatischen Weg die Richtlinie AmazonS3FullAccess. Mit einem beschränkten Schlüssel reicht eine Inline-Richtlinie, die nur Zugriff auf deinen Bucket gibt: Objekte auflisten, lesen, schreiben und löschen.

Kann ich die Schlüssel des AWS-Root-Benutzers verwenden?

Das ist keine gute Idee und AWS rät davon ab. Erstelle einen IAM-Benutzer nur für Nubbo; seinen Schlüssel kannst du dann deaktivieren, ohne etwas anderes anzurühren.

Warum hat Nubbo keine Felder für den AWS-Schlüssel?

Weil AWS dir den Schlüssel als CSV gibt. Nubbo liest sie direkt: Du lädst sie hoch oder fügst ihren Inhalt ein und kopierst das Secret nie von Hand.

Kann ich mehrere S3-Buckets verbinden?

Ja. Jeder Bucket wird auf das Limit deines Plans angerechnet: Der kostenlose Plan erlaubt 2, Personal 5 und Pro hat kein Limit, und sie können aus verschiedenen AWS-Konten stammen.

Quellen

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