External Storage: S3 #

Die App bindet einen Bucket aus Amazon S3 oder einem S3-kompatiblen Objektspeicher als Ordner in die Dateiansicht ein. Die Dateien bleiben im Bucket. Zugriff, Freigaben und Synchronisation laufen über owncloud.online. Jeden Einhängepunkt richten Sie in der Oberfläche oder mit occ ein, config.php bleibt unverändert.

Soll S3 alle Dateien der Instanz aufnehmen statt nur einzelner Ordner, ist S3 Primary Object Storage die passende App.

Voraussetzungen #

Installation #

Im App-Menü Markt öffnen, External Storage: S3 suchen und Installieren wählen. Auf der Kommandozeile, im Installationsverzeichnis von owncloud.online:

# Kern-App für externe Speicher einschalten
sudo -u www-data php8.4 occ app:enable files_external

# App aus dem Marktplatz installieren, dabei wird sie eingeschaltet
sudo -u www-data php8.4 occ market:install files_external_s3

# nur nötig, wenn die App schon vorhanden, aber ausgeschaltet ist
sudo -u www-data php8.4 occ app:enable files_external_s3

Externe Speicher müssen außerdem eingeschaltet sein. Das ist das Häkchen Externen Speicher aktivieren unter Einstellungen → Administration → Speicher oder dieser Befehl:

sudo -u www-data php8.4 occ config:app:set core enable_external_storage --value yes

Einrichtung #

In der Oberfläche #

1. Einstellungen → Administration → Speicher öffnen, Abschnitt Externer Speicher.
2. Unter Ordnername den Namen eintragen, unter dem der Bucket in der Dateiansicht erscheint.
3. Bei Speicher hinzufügen den Eintrag Amazon S3 compatible (SDK v3) wählen. Als Authentifizierung steht Access key fest.
4. Die Felder unter Konfiguration ausfüllen, siehe Tabelle.
5. Unter Verfügbar für Konten oder Gruppen eintragen. Bleibt das Feld leer, gilt der Speicher für alle Konten.

Die App bringt keine Übersetzungen mit. Die Feldnamen erscheinen deshalb auch in der deutschen Oberfläche auf Englisch.

Enable SSL ist nicht vorbelegt. Ohne Häkchen spricht der Server den Objektspeicher unverschlüsselt über HTTP an, ohne Portangabe auf Port 80. Setzen Sie das Häkchen für Amazon S3 und für jeden Endpunkt, der HTTPS spricht.

Fehlt der Bucket, legt die App ihn beim ersten Zugriff an. Dafür braucht der Schlüssel das Recht, Buckets anzulegen. Hat er es nicht, legen Sie den Bucket vorher beim Anbieter an.

Die Art des Speichers wählen Sie unter „Speicher hinzufügen“. Jede Art hat eigene Felder, rot markiert sind leere Pflichtfelder.

Über das Zahnrad am Ende der Zeile öffnen sich die Erweiterten Einstellungen. Zwei davon sind für S3 wichtig:

Mit occ #

Einhängepunkt anlegen. Der Befehl gibt die ID des neuen Speichers aus:

sudo -u www-data php8.4 occ files_external:create /Archiv files_external_s3 amazons3::accesskey \
  -c bucket=archiv-2026 \
  -c hostname=s3.example.com \
  -c region=eu-central-1 \
  -c use_ssl=true \
  -c use_path_style=true \
  -c key=<ACCESS_KEY> \
  -c secret=<SECRET_KEY>

Der Secret Key landet so in der Shell-Historie. Wer das vermeiden will, trägt ihn in der Oberfläche ein.

Werte ändern und die Verbindung prüfen. 3 steht hier für die ID aus files_external:list:

sudo -u www-data php8.4 occ files_external:list
sudo -u www-data php8.4 occ files_external:config 3 port 9000
sudo -u www-data php8.4 occ files_external:config 3 use_path_style true
sudo -u www-data php8.4 occ files_external:verify 3

Konten, Gruppen und Einhängeoptionen setzen Sie wie bei jedem externen Speicher mit files_external:applicable und files_external:option. Alle Befehle stehen unter Externe Speicher.

Speicher durch Anwender einbinden lassen #

Setzen Sie unter Einstellungen → Administration → Speicher das Häkchen Benutzern erlauben, externen Speicher einzubinden und haken Sie darunter Amazon S3 compatible (SDK v3) an. Anwender finden dasselbe Formular dann unter Einstellungen → Persönlich → Speicher.

Nutzung #

Der Bucket erscheint als Ordner in der Dateiansicht und unter Externer Speicher in der linken Leiste. Anwender laden Dateien hoch und herunter, verschieben, löschen und synchronisieren sie wie in jedem anderen Ordner. Teilen geht nur, wenn der Administrator Freigaben einschalten gesetzt hat.

Grenzen und Hinweise #

• Ordner gibt es in S3 nicht. Die App legt dafür leere Objekte an, deren Name auf / endet. Löscht jemand einen Ordner, entfernt die App alle Objekte unter diesem Präfix, in Stapeln. Bei Ordnern mit vielen Objekten dauert das entsprechend.
• Die interne Speicher-ID bildet die App nur aus dem Bucket-Namen (amazon::<bucket>). Zwei Einbindungen mit gleichem Bucket-Namen teilen sich deshalb einen Dateicache, auch wenn sie auf verschiedene Dienste zeigen. Geben Sie jedem eingebundenen Bucket einen eigenen Namen.
• Für Vorschaubilder lädt der Server die Datei aus dem Bucket. Bei vielen großen Bildern kann es sinnvoll sein, Vorschau aktivieren in den erweiterten Einstellungen abzuschalten.

Fehlersuche #

Verbindungsfehler stehen mit Ursache im Serverprotokoll, siehe Serverprotokoll und Fehlermeldungen.