Speicher-Engine: S3 (Pro)

File storage: S3(Pro)Professional Edition+

Einführung

Aufbauend auf dem Dateimanager-Plugin wird hier die Unterstützung für S3-Protokoll-kompatible Dateispeichertypen hinzugefügt. Jeder Objektspeicherdienst, der das S3-Protokoll unterstützt, lässt sich problemlos integrieren, wie zum Beispiel Amazon S3, Aliyun OSS, Tencent COS, MinIO, Cloudflare R2 und weitere. Dies erhöht die Kompatibilität und Flexibilität Ihrer Speicherdienste erheblich.

Funktionen

Client-seitiger Upload: Der Dateiupload erfolgt nicht über den NocoBase-Server, sondern direkt über den Dateispeicherdienst. Dies ermöglicht ein effizienteres und schnelleres Upload-Erlebnis.
Privater Zugriff: Standardmäßig werden signierte URLs mit Ablaufzeit verwendet. Für öffentliche Buckets können auch nicht signierte URLs erzeugt werden.

Anwendungsfälle

Sammlungsverwaltung für Dateien: Verwalten und speichern Sie alle hochgeladenen Dateien zentral. Es werden verschiedene Dateitypen und Speichermethoden unterstützt, was die Klassifizierung und das Auffinden von Dateien erleichtert.
Speicherung von Anhangsfeldern: Dient der Datenspeicherung von Anhängen, die in Formularen oder Datensätzen hochgeladen werden, und unterstützt die Verknüpfung mit spezifischen Datensätzen.

Plugin-Konfiguration

Aktivieren Sie das Plugin plugin-file-storage-s3-pro.
Klicken Sie auf "Einstellungen -> Dateimanager", um die Einstellungen des Dateimanagers aufzurufen.
Klicken Sie auf die Schaltfläche "Neu hinzufügen" und wählen Sie "S3 Pro" aus.

Nachdem das Pop-up-Fenster erscheint, sehen Sie ein Formular mit zahlreichen Feldern, die ausgefüllt werden müssen. Die relevanten Parameterinformationen für den jeweiligen Dateidienst finden Sie in der nachfolgenden Dokumentation. Bitte tragen Sie diese korrekt in das Formular ein.

URL-Konfiguration

Zusätzlich zu den allgemeinen Optionen „NocoBase-URL“, „Ursprüngliche URL“ und „Öffentlichen Zugriff erlauben“ des Dateimanagers können Sie in S3 Pro die Formate für Upload- und Zugriffs-URLs getrennt konfigurieren und festlegen, ob signierte URLs verwendet werden. Die allgemeinen Optionen werden in der Übersicht der Speicher-Engines erläutert.

Diese Optionen steuern unterschiedliche Schritte:

„NocoBase-URL / Ursprüngliche URL“ bestimmt, welche Adresse der Dateidatensatz zurückgibt
„Öffentlichen Zugriff erlauben“ bestimmt, ob beim Zugriff auf eine NocoBase-URL die Leseberechtigungen des Dateidatensatzes geprüft werden
„Signierte URL nicht verwenden“ bestimmt, ob der Objektspeicher die URL-Signatur prüft

Die Einstellungen können unabhängig kombiniert werden. Empfohlen wird standardmäßig die NocoBase-URL, „Öffentlichen Zugriff erlauben“ deaktiviert und die Verwendung signierter URLs aktiviert.

S3-Pro-URL-Konfiguration

Auswahlhilfe

Anwendungsfall	Datei-URL	Öffentlichen Zugriff erlauben	Signierte URL nicht verwenden
Dateien müssen Rollen- und Datenberechtigungen folgen, während der Bucket privat bleibt	NocoBase-URL	Nicht aktiviert	Nicht aktiviert
Eine öffentliche NocoBase-Dateiadresse wird benötigt, während der Bucket privat bleibt	NocoBase-URL	Aktiviert	Nicht aktiviert
Ein externer Dienst benötigt vorübergehenden Zugriff auf die Speicheradresse	Ursprüngliche URL	Nicht anwendbar	Nicht aktiviert; Access URL expiration konfigurieren
Ein öffentlicher Bucket oder ein CDN benötigt eine nicht signierte ursprüngliche Adresse	Ursprüngliche URL	Nicht anwendbar	Aktiviert

Format der Upload-URL

„Format der Upload-URL“ steuert die S3-URL, die der Client beim Hochladen von Dateien verwendet. Wählen Sie das von Ihrem Speicherdienst unterstützte Format. Das Formular zeigt anhand von Endpoint, Bucket und Pfad ein aktuelles Beispiel:

„Bucket as subdomain“: https://bucket-name.s3.example.com/path/to/object
„Bucket as subpath“: https://s3.example.com/bucket-name/path/to/object
„Ignore bucket“: https://upload.example.com/path/to/object

Format der Zugriffs-URL

„Format der Zugriffs-URL“ steuert, ob der Bucket beim Erzeugen einer Dateizugriffsadresse in der Domain, im Pfad oder gar nicht in der URL erscheint. Es stehen dieselben drei Formate wie für die Upload-URL zur Verfügung, sie können jedoch getrennt konfiguriert werden—zum Beispiel kann der Upload einen S3-Endpoint verwenden, während der Zugriff über eine CDN-Domain ohne Bucket erfolgt.

Diese Option wirkt sich auf ursprüngliche URLs sowie auf die Speicheradresse aus, zu der eine NocoBase-URL schließlich weiterleitet. Das Format der NocoBase-URL selbst ändert sich nicht.

Signierte URL nicht verwenden

S3 Pro verwendet standardmäßig signierte URLs. Eine erzeugte ursprüngliche URL enthält Signaturparameter, zum Beispiel:

https://bucket-name.s3.example.com/path/to/object?X-Amz-Signature=xxxx

Die signierte URL bleibt für die unter „Access URL expiration“ konfigurierte Dauer gültig, und der Bucket kann privat bleiben. Bei Verwendung einer NocoBase-URL erzeugt NocoBase nach erfolgreicher Berechtigungsprüfung eine signierte Adresse oder leitet dorthin weiter.

Wenn „Signierte URL nicht verwenden“ aktiviert ist, erzeugt S3 Pro eine Adresse ohne Signaturparameter. Bucket und hochgeladene Objekte müssen dann öffentlich lesbar sein; „Access URL expiration“ ist nicht mehr wirksam.

„Signierte URL nicht verwenden“ steuert nur die Signaturprüfung des Speicherdienstes und ändert keine NocoBase-Berechtigungen. Wenn die NocoBase-URL ausgewählt und „Öffentlichen Zugriff erlauben“ nicht aktiviert ist, muss die Anfrage weiterhin zuerst die NocoBase-Berechtigungsprüfung bestehen.

Konfiguration der Dienstanbieter

Amazon S3

Bucket-Erstellung

Öffnen Sie https://ap-southeast-1.console.aws.amazon.com/s3/home, um die S3-Konsole aufzurufen.
Klicken Sie rechts auf die Schaltfläche "Bucket erstellen".

Geben Sie den Bucket-Namen ein. Andere Felder können Sie in den Standardeinstellungen belassen. Scrollen Sie zum unteren Ende der Seite und klicken Sie auf die Schaltfläche "Erstellen", um den Vorgang abzuschließen.

CORS-Konfiguration

Gehen Sie zur Bucket-Liste, suchen Sie den soeben erstellten Bucket und klicken Sie darauf, um dessen Detailseite aufzurufen.

Klicken Sie auf den Tab "Berechtigungen" und scrollen Sie dann nach unten, um den Abschnitt für die CORS-Konfiguration zu finden.

Tragen Sie die folgende Konfiguration ein (Sie können diese bei Bedarf weiter anpassen) und speichern Sie sie.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

Abrufen von AccessKey und SecretAccessKey

Klicken Sie oben rechts auf der Seite auf die Schaltfläche "Sicherheitsanmeldeinformationen".

Scrollen Sie nach unten zum Abschnitt "Zugriffsschlüssel" und klicken Sie auf die Schaltfläche "Zugriffsschlüssel erstellen".

Klicken Sie auf "Zustimmen" (dies ist eine Demonstration mit dem Root-Konto; in einer Produktionsumgebung wird die Verwendung von IAM empfohlen).

Speichern Sie den auf der Seite angezeigten Zugriffsschlüssel (Access Key) und geheimen Zugriffsschlüssel (Secret Access Key).

Abrufen und Konfigurieren von Parametern

Die AccessKey ID und der AccessKey Secret sind die Werte, die Sie im vorherigen Schritt erhalten haben. Bitte tragen Sie diese genau ein.
Gehen Sie zum Eigenschaften-Panel der Bucket-Detailseite. Dort finden Sie den Bucket-Namen und die Region-Informationen.

Nicht signierter öffentlicher Zugriff (optional)

Konfigurieren Sie dies nur, wenn nicht signierte URLs benötigt werden, da Bucket und hochgeladene Objekte öffentlich lesbar sein müssen. Wenn lediglich eine öffentliche NocoBase-URL geteilt werden soll, aktivieren Sie „Öffentlichen Zugriff erlauben“ und verwenden Sie weiterhin signierte URLs; der Bucket muss nicht öffentlich sein.

Gehen Sie zum Berechtigungen-Panel, scrollen Sie zu "Objektbesitz", klicken Sie auf "Bearbeiten" und aktivieren Sie ACLs.

Scrollen Sie zu "Öffentlichen Zugriff blockieren", klicken Sie auf "Bearbeiten" und stellen Sie ein, dass ACLs die Kontrolle erlauben.

Aktivieren Sie „Signierte URL nicht verwenden“ in NocoBase.

Miniaturansicht-Konfiguration (Optional)

Diese Konfiguration ist optional und wird verwendet, um die Größe oder Qualität der Bildvorschau zu optimieren. Bitte beachten Sie, dass diese Bereitstellungslösung zusätzliche Kosten verursachen kann. Spezifische Gebühren entnehmen Sie bitte den relevanten AWS-Bedingungen.

Besuchen Sie Dynamische Bildtransformation für Amazon CloudFront.
Klicken Sie unten auf der Seite auf die Schaltfläche Launch in the AWS Console, um die Bereitstellung der Lösung zu starten.
Folgen Sie den Anweisungen, um die Konfiguration abzuschließen. Achten Sie besonders auf die folgenden Optionen:
1. Beim Erstellen des Stacks müssen Sie den Namen eines Amazon S3 Buckets angeben, der die Quellbilder enthält. Bitte geben Sie den Namen des zuvor von Ihnen erstellten Buckets ein.
2. Wenn Sie sich für die Bereitstellung der Demo-Benutzeroberfläche entscheiden, können Sie die Bildverarbeitungsfunktionen nach der Bereitstellung über diese Schnittstelle testen. Wählen Sie in der AWS CloudFormation-Konsole Ihren Stack aus, wechseln Sie zum Tab "Ausgaben", suchen Sie den Wert, der dem Schlüssel "DemoUrl" entspricht, und klicken Sie auf den Link, um die Demo-Oberfläche zu öffnen.
3. Diese Lösung verwendet die Node.js-Bibliothek sharp zur effizienten Bildverarbeitung. Sie können den Quellcode aus dem GitHub-Repository herunterladen und bei Bedarf anpassen.
Nach Abschluss der Konfiguration warten Sie, bis der Bereitstellungsstatus auf CREATE_COMPLETE wechselt.
Bei der NocoBase-Konfiguration sind folgende Punkte zu beachten:
1. Thumbnail rule: Tragen Sie bildverarbeitungsbezogene Parameter ein, zum Beispiel ?width=100. Details hierzu finden Sie in der AWS-Dokumentation.
2. Access endpoint: Tragen Sie den Wert von "Outputs -> ApiEndpoint" nach der Bereitstellung ein.
3. „Format der Zugriffs-URL“: Wählen Sie „Ignore bucket“, da der Bucket-Name bereits in der Konfiguration enthalten ist und in der Zugriffs-URL nicht mehr benötigt wird.

Konfigurationsbeispiel