ownCloud Server 10 kann über die App „Externer Speicher“ einen Amazon S3-Bucket als sekundären Speicherort einbinden. Aktivieren Sie dazu den externen Speicher, fügen Sie in den Administratoreinstellungen für Speicher eine Amazon S3-Einbindung hinzu, geben Sie den Bucket und die Zugangsdaten ein und vergewissern Sie sich, dass ownCloud die Einbindung als bereit meldet. Dadurch bleibt der Bucket in der Dateiansicht der Benutzer verfügbar; das primäre Datenverzeichnis von ownCloud wird nicht nach S3 verschoben.
Diese Anleitung beschreibt das S3-Backend für externen Speicher in ownCloud 10. Sie gilt für Amazon S3 und kann auch mit S3-kompatiblen Diensten funktionieren, sofern deren Endpunkt, Region und Adressierungsoptionen den Anforderungen des Anbieters entsprechen. Die Anbieterkompatibilität kann variieren. Überprüfen Sie daher die entsprechenden Werte mit dem Speicheranbieter, bevor Sie die Einbindung für Benutzer freigeben.
Externer S3-Speicher oder primärer Speicher?
Durch eine externe S3-Einbindung wird dem virtuellen Dateisystem von ownCloud ein Bucket als zusätzlicher Ordner hinzugefügt. Benutzer können – vorbehaltlich der Berechtigungen der Einbindung – neben den Dateien in ihrem normalen ownCloud-Speicher darauf zugreifen. Die separate S3-App für primären Objektspeicher stellt eine andere Bereitstellungsoption dar: Sie ändert den Speicherort der primären Dateiinhalte in ownCloud und hat zusätzliche Auswirkungen auf Einrichtung und Migration. Folgen Sie dieser Anleitung nur, wenn Sie eine sekundäre Einbindung wünschen.
Bevor Sie beginnen, vergewissern Sie sich, dass Ihre ownCloud Server 10-Installation für Ihre Umgebung unterstützt und auf dem neuesten Stand ist, dass der Server ausgehende HTTPS-Verbindungen zum S3-Endpunkt herstellen kann und dass Sie über Administratorrechte verfügen. Sie benötigen den Bucket-Namen, einen vom Anbieter akzeptierten Zugriffsschlüssel und geheimen Schlüssel sowie – falls Sie einen kompatiblen Dienst verwenden – die korrekten Einstellungen für Endpunkt, Region und Pfadstil.
1. Bucket und Zugangsdaten vorbereiten.
Erstellen oder wählen Sie den Bucket in der Konsole des Speicheranbieters aus. Wählen Sie für Amazon S3 die gewünschte AWS-Region und überprüfen Sie die Zugriffskontrollen, die Verschlüsselung, die Lebenszyklusregeln sowie die Anforderungen an Backup und Aufbewahrung. Ein Bucket ersetzt keinen unabhängigen Backup-Plan.
Verwenden Sie für diese ownCloud-Einbindung dedizierte Anmeldeinformationen und beschränken Sie diese auf den Bucket und die für den normalen Dateizugriff erforderlichen Aktionen. Vermeiden Sie die Verwendung von Root-Zugriffsschlüsseln. AWS empfiehlt, langfristige Zugriffsschlüssel zu vermeiden, wenn temporäre Anmeldeinformationen praktikabel sind. Falls die ownCloud-Einrichtung ein Zugriffsschlüsselpaar erfordert, schützen Sie das Geheimnis und befolgen Sie die Richtlinien Ihrer Organisation zur Rotation von Anmeldeinformationen. Bewahren Sie das Geheimnis sicher auf, da viele Anbieter es nur bei der Schlüsselerstellung anzeigen. Fügen Sie Anmeldeinformationen nicht in Tickets, Screenshots, die Shell-Historie oder das Beispiel in diesem Artikel ein.
Stellen Sie sicher, dass Netzwerkregeln, DNS und TLS-Prüfrichtlinien dem ownCloud-Server den Zugriff auf den Provider ermöglichen. Wenn Sie ein privates oder selbstsigniertes Zertifikat für einen kompatiblen Endpunkt verwenden, importieren Sie dessen Zertifikat gemäß der Dokumentation zur externen Speicherung in den vertrauenswürdigen Zertifikatsspeicher von ownCloud. Deaktivieren Sie die TLS-Verifizierung nicht, um einen Zertifikatfehler zu umgehen.
2. Externe Speicherunterstützung aktivieren
Melden Sie sich mit einem Administratorkonto bei ownCloud an. Öffnen Sie Einstellungen > Apps , suchen Sie nach „Unterstützung für externen Speicher“ und aktivieren Sie die App, falls sie noch nicht aktiv ist. Öffnen Sie anschließend Einstellungen > Admin > Speicher (die genaue Menübezeichnung kann je nach ownCloud 10-Version und -Design leicht variieren) und vergewissern Sie sich, dass die Konfiguration für externen Speicher verfügbar ist.
Die Unterstützung für externen Speicher bietet sekundäre Einbindungen. Laut ownCloud-Administratordokumentation wird die Einbindung automatisch gespeichert, sobald die erforderlichen Felder ausgefüllt sind. Eine grüne Statusanzeige bedeutet, dass der konfigurierte Speicher bereit ist; eine rote oder gelbe Anzeige bedeutet, dass ownCloud keine Verbindung herstellen oder die Konfiguration nicht validieren konnte. In diesem Fall ist die Einbindung noch nicht nutzbar.
3. Fügen Sie eine Amazon S3-Halterung hinzu.
Klicken Sie in den Administratoreinstellungen für den Speicher auf „Speicher hinzufügen “ und wählen Sie Amazon S3 aus . Geben Sie einen Ordnernamen für den Mountpunkt ein – diesen Namen sehen die Benutzer in ihrer Dateiliste. Geben Sie anschließend den S3-Zugriffsschlüssel, den geheimen Schlüssel und den Bucket-Namen exakt wie angegeben ein. Halten Sie das Feld für den geheimen Schlüssel geheim und vermeiden Sie Bildschirmfreigaben, solange dieses Feld sichtbar ist.
Für einen Standard-AWS-S3-Bucket verwenden Sie zunächst die üblichen Endpunkt- und Regionseinstellungen des Anbieters. Aktivieren Sie SSL, damit Anfragen über HTTPS erfolgen. Für einen S3-kompatiblen Dienst geben Sie die vom jeweiligen Dienst benötigten Werte für Hostname, Port und Region an. Verwenden Sie den dokumentierten Endpunkt des Dienstes, anstatt die URL anhand des Bucket-Namens zu erraten.
Wann sollte man die Pfadadressierung aktivieren?
Die Pfadadressierung ändert Anfragen von einem Bucket-spezifischen Hostnamen zu einem Dienst-Hostnamen, wobei der Bucket im URL-Pfad enthalten ist. Die Dokumentation des ownCloud S3-Backends weist darauf hin, dass dies im Allgemeinen für Amazon S3 nicht erforderlich ist und möglicherweise nicht mit neueren Amazon-Rechenzentren funktioniert. Es kann jedoch bei einigen Nicht-Amazon-Endpunkten hilfreich sein, bei denen das DNS-Routing für virtuelle Hosts nicht verfügbar ist. Befolgen Sie die Anweisungen des kompatiblen Anbieters. Falls die Einbindung fehlschlägt, überprüfen Sie den Endpunkt und den Adressierungsmodus gemeinsam, anstatt mehrere Einstellungen gleichzeitig zu ändern.
4. Beschränken Sie den Personenkreis, der das Reittier benutzen darf.
Wählen Sie unter „Verfügbar für“ die ownCloud-Benutzer oder -Gruppen aus, die den S3-Ordner sehen sollen. Eine Administratorfreigabe ist standardmäßig für alle Benutzer verfügbar, sofern nicht eingeschränkt. Gewähren Sie den Zugriff nur der vorgesehenen Zielgruppe, insbesondere wenn der Bucket freigegebene, regulierte oder operative Daten enthält.
Überprüfen Sie die Mount-Optionen, sobald die entsprechende Zeile erscheint. Je nach Konfiguration und ownCloud-Version können die Optionen unter anderem Lesezugriff, Vorschau, Verschlüsselungsintegration, Dateisystemprüfungen und die Aktivierung der Freigabe umfassen. Die Freigabe externer Mountpunkte ist in der dokumentierten Konfiguration standardmäßig deaktiviert. Aktivieren Sie sie nur, wenn Benutzer diese Dateien über ownCloud freigeben sollen und die Richtlinien Ihrer Organisation dies zulassen.
5. Überprüfen Sie die Verbindung mit einem kontrollierten Test.
Warten Sie auf das Statussymbol neben der Einbindung. Ein grüner Indikator signalisiert ersten Erfolg, stellt aber noch keinen vollständigen Datenpfadtest dar. Melden Sie sich als Benutzer an, der in der Liste „Verfügbar für“ enthalten ist , öffnen Sie „Dateien“ und prüfen Sie, ob der Einbindungsordner angezeigt wird. Laden Sie eine kleine, unkritische Testdatei hoch, öffnen oder laden Sie sie herunter, benennen Sie sie um, falls dies Teil des vorgesehenen Workflows ist, und löschen Sie sie nur, wenn Ihre Testrichtlinie das Löschen zulässt. Überprüfen Sie das resultierende Objekt in der Konsole oder den Audit-Protokollen des Anbieters.
Wiederholen Sie den Lesetest als Benutzer, der dem Mount nicht zugewiesen ist. Dieses Konto sollte keinen Zugriff erhalten, nur weil der Mount erstellt wurde. Wenn der Mount schreibgeschützt sein soll, überprüfen Sie, ob Schreibversuche blockiert werden. Dokumentieren Sie Endpunkt, Region, Mount-Name, vorgesehene Gruppen und den Inhaber der Anmeldeinformationen in Ihrer Betriebsdokumentation, ohne das Geheimnis selbst zu protokollieren.
Fehlerbehebung bei einer roten oder nicht verfügbaren Halterung
- Authentifizierungsfehler: Bitte prüfen Sie, ob Zugriffsschlüssel und Geheimnis zusammengehören, gültig sind und Zugriff auf den Bucket haben. Ersetzen Sie den Schlüssel gegebenenfalls über Ihre Anmeldeinformationen, falls er offengelegt wurde.
- Bucket- oder Berechtigungsfehler: Überprüfen Sie den Bucket-Namen, die Region und die Provider-Richtlinie. Die Identität benötigt möglicherweise zusätzliche Berechtigungen auf Bucket-Ebene für die von Ihnen getesteten Vorgänge.
- Verbindungszeitüberschreitung: Überprüfen Sie die ausgehenden Firewall-Regeln, die DNS-Auflösung, die Proxy-Konfiguration und ob der ownCloud-Host den Provider-Endpunkt über HTTPS erreichen kann.
- TLS- oder Zertifikatsfehler: Überprüfen Sie den Hostnamen und die Zertifikatskette. Importieren Sie bei privaten Zertifikaten das vertrauenswürdige Zertifikat gemäß der dokumentierten Vorgehensweise von ownCloud, anstatt die Validierung zu deaktivieren.
- Nur bei kompatiblen Diensten: Bitte überprüfen Sie den Hostnamen, den Port, die Regionszeichenfolge und die Pfadformateinstellungen des Endpunkts anhand der Dokumentation des jeweiligen Anbieters. Diese Werte sind anbieterspezifisch.
- Die Einbindung ist auch nach einer Korrektur weiterhin nicht verfügbar: Laut ownCloud-Dokumentation kann ein Problem mit der Verbindung zum externen Speicher bis zu zehn Minuten lang als nicht verfügbar angezeigt werden; klicken Sie auf das Statussymbol oder laden Sie die Admin-Seite neu, um eine erneute Überprüfung auszulösen.
Wichtige Einschränkung: Dateien, die direkt zu S3 hinzugefügt werden
Für S3 und kompatible Dateisysteme kann laut ownCloud 10.15 occ files:scanmanuell hinzugefügte Dateien nicht erneut gescannt werden. Dieselbe Dokumentation warnt davor, dass ownCloud Änderungen, die außerhalb von ownCloud vorgenommen wurden, möglicherweise nicht immer erkennt, insbesondere wenn diese tief in einer Ordnerhierarchie liegen. Um eine zuverlässige Dateisichtbarkeit und Metadaten zu gewährleisten, sollten Schreibvorgänge und Änderungen nach Möglichkeit über ownCloud durchgeführt werden. Falls ein externer Prozess in den Bucket schreiben muss, testen Sie die Sichtbarkeit und Konsistenz für Ihr spezifisches Backend und Ihre Version, bevor Sie sich auf diesen Workflow verlassen. Gehen Sie nicht davon aus, dass ein routinemäßiger POSIX-Dateiscan das Problem behebt.
Seien Sie auch beim Ändern oder Entfernen einer Produktions-Mountung vorsichtig. ownCloud weist darauf hin, dass das Ändern oder Entfernen einer externen Speicherkonfiguration die alten Metadateneinträge nicht automatisch aus der Datenbank löscht. Planen Sie die Änderung, überprüfen Sie Zugriff und Backups und konsultieren Sie die versionsspezifische Dokumentation, bevor Sie die Bereinigung durchführen. Vermeiden Sie es, die Mountung im Rahmen eines Fehlerbehebungsexperiments zu löschen, wenn Benutzer bereits darauf angewiesen sind.
Konfigurationscheckliste
- Die Unterstützung für externe Speichermedien ist aktiviert.
- Als Backend wurde Amazon S3 ausgewählt und der Name des Mount-Ordners ist eindeutig.
- Bucket, Region, Endpunkt und alle Pfadstileinstellungen stimmen mit dem Provider überein.
- HTTPS ist aktiviert und der Server vertraut dem Endpunktzertifikat.
- Der Schlüssel ist geschützt und auf den erforderlichen Bucket-Zugriff beschränkt.
- Nur die vorgesehenen Benutzer und Gruppen haben Zugriff auf das Mount.
- Ein berechtigter Benutzer kann den Ordner sehen und den erforderlichen Lese-/Schreibtest durchführen.
- Dem Team ist bewusst, dass direkte externe S3-Schreibvorgänge möglicherweise nicht erkannt oder erneut gescannt werden können
files:scan.
Offizielle Dokumentation
Die Dokumentation wurde am 6. Oktober 2026 geprüft. Die Seite „Externe Speicherkonfiguration“ von ownCloud 10.15 ist weiterhin die versionsspezifische Referenz für das App-Verhalten und die Einschränkungen. Die separate S3-Seite ist in der späteren ownCloud-Dokumentation verlinkt, da die S3-Seite von Version 10.15 aktuell eine Fehlermeldung liefert. UI-Bezeichnungen und Einstellungen für kompatible Anbieter können je nach Version variieren.