So binden Sie S3-kompatiblen Speicher als externen Speicher in Nextcloud ein

Um einen S3-kompatiblen Bucket in Nextcloud einzubinden, aktivieren Sie die integrierte App für externe Speicherunterstützung, fügen Sie einen Amazon S3- Speichereintrag in den externen Speichereinstellungen des Administrators hinzu und geben Sie die Bucket-Zugangsdaten sowie die Endpunktdetails des Anbieters an. Nextcloud nutzt das Amazon S3-Backend für kompatible Dienste; Sie müssen keine separate App für jeden S3-Anbieter installieren. Die genauen Einstellungen für Hostname, Region und Pfadformat hängen vom jeweiligen Objektspeicheranbieter ab.

Diese Anleitung orientiert sich an der aktuellen Nextcloud-Administrationsdokumentation für die S3- und externen Speicher-Backends (Stand: 6. Oktober 2026). Die Bezeichnungen können je nach Serverversion und Theme leicht abweichen. Ein eingebundener Ordner kann erreichbar sein, sich aber dennoch anders verhalten als ein lokaler Nextcloud-Ordner, insbesondere wenn Dateien direkt im Bucket geändert werden.

Was sollten Sie überprüfen, bevor Sie den Bucket hinzufügen?

Bitte bestätigen Sie diese Angaben mit Ihrem S3-Anbieter, bevor Sie die Nextcloud-Einstellungen öffnen:

• Der Bucket-Name und die Anmeldeinformationen für einen Zugriffsschlüssel.
• Verwenden Sie den generischen S3-Endpunkt-Hostnamen des Anbieters, z. B. s3.example.net. Verwenden Sie den Endpunkt selbst, nicht eine bucketspezifische URL, die den Bucket-Namen bereits enthält.
• Die Region oder die Signaturregion, falls der Anbieter dies verlangt.
• https://bucket.endpoint/Ob Anfragen im virtuellen Hosting-Stil ( ) oder im Pfad-Stil ( https://endpoint/bucket) erfolgen sollen .
• Der HTTPS-Port, normalerweise 443, und ob Ihr Server diesen Endpunkt über seine Firewall und sein DNS erreichen kann.

Erstellen Sie einen dedizierten Zugriffsschlüssel für diese Einbindung und beschränken Sie dessen Berechtigungen auf den Bucket und die benötigten Aktionen. Fügen Sie keine Geheimnisse in ein Ticket, einen Screenshot oder den Shell-Verlauf ein. Die S3-Einrichtung von Nextcloud erfordert eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel; sie validiert nicht automatisch alle anbieterspezifischen Berechtigungsrichtlinien.

Ist das dasselbe, als würde man S3 als primären Speicher für Nextcloud festlegen?

Nein. Die Einbindung eines externen Speichers stellt einen bestehenden Bucket als Ordner in Nextcloud bereit. Dies ist nützlich, wenn Sie Dateien in einem Bucket durchsuchen oder verwalten möchten, während der Bucket weiterhin für andere S3-Tools zugänglich bleibt. Primärer Objektspeicher hingegen basiert auf einer anderen serverweiten Architektur mit anderen Betriebsgrundlagen. Wenn Sie zwischen den beiden wählen müssen, lesen Sie die Dokumentation zum primären Objektspeicher von Nextcloud , bevor Sie Änderungen an einem Produktionsdatenmodell vornehmen.

Wie fügt man die S3-kompatible Halterung in der Weboberfläche hinzu?

1. Unterstützung für externen Speicher aktivieren

Melden Sie sich als Nextcloud-Administrator an, öffnen Sie „Apps“ und aktivieren Sie die mitgelieferte App zur Unterstützung externer Speicher . Diese ist in Nextcloud enthalten, kann aber standardmäßig deaktiviert sein. Falls sie bereits aktiviert ist, fahren Sie mit den Speichereinstellungen fort.

2. Öffnen Sie die Administratorseite für externen Speicher.

Öffnen Sie Ihr Profilmenü, wählen Sie „Einstellungen“ und anschließend im Bereich „Administration“ die Option „Externer Speicher“ . Diese Seite ist für vom Administrator konfigurierte Speicherzugriffe vorgesehen. Ein Speicher, den ein Benutzer in seinen persönlichen Einstellungen konfiguriert, steht nur diesem Benutzer zur Verfügung; ein vom Administrator konfigurierter Speicherzugriff kann ausgewählten Benutzern und Gruppen zur Verfügung gestellt werden.

3. Erstellen Sie eine Mount-Konfiguration und wählen Sie das S3-Backend aus.

Geben Sie in der neuen Zeile einen einfachen Ordnernamen ein , z. B. „ Ordnername Archive“. Dieser Ordnername wird in Nextcloud angezeigt und darf kein Pfad sein; verwenden Sie keine Schrägstriche. Wählen Sie im Feld „Speichertyp“ Amazon S3 aus . Wählen Sie unter „Authentifizierung“ die Option „Zugriffsschlüssel“ .

4. Geben Sie den Bucket und die Anmeldeinformationen ein.

Geben Sie den genauen Bucket-Namen, die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel Ihres Anbieters ein. Behandeln Sie den geheimen Zugriffsschlüssel wie ein Passwort. Die Nextcloud-Dokumentation weist darauf hin, dass Bucket-Namen für dieses Backend den AWS-S3-Namenskonventionen entsprechen müssen, auch wenn der Dienst woanders gehostet wird; Unterstriche sind nicht zulässig. Falls der Bucket-Name Ihres Anbieters einen Unterstrich enthält, prüfen Sie, ob Ihr Anbieter einen kompatiblen Bucket-Namen anbietet, bevor Sie die Anmeldeinformationen überprüfen.

5. Endpunkt, Region und Anfragestil festlegen

Geben Sie für Amazon-gehostete S3-Dienste die korrekte Region an. Verwenden Sie für Dienste anderer Anbieter den generischen Hostnamen. Nutzen Sie die vom Anbieter veröffentlichten Endpunkt- und Regionswerte; es gibt keinen universellen Regionswert für alle S3-kompatiblen Produkte.

Nextclouds aktueller S3-Leitfaden empfiehlt ausdrücklich die Verwendung des generischen Hostnamens für Nicht-Amazon-Speicher. Er beschreibt die Pfadadressierung außerdem als anbieterabhängig. Verwenden Sie den Pfadstil nicht einfach nach Gefühl, wenn Sie den erwarteten Adressierungsmodus in der S3-Dokumentation des Anbieters finden.

6. Beschränken Sie den Personenkreis, der das Reittier benutzen darf.

Verwenden Sie „Verfügbar für“, um nur die gewünschten Nextcloud-Benutzer oder -Gruppen zuzuweisen. Eine vom Administrator konfigurierte Einbindung kann andernfalls allgemein verfügbar sein. Überprüfen Sie nach dem Speichern auch die Optionen der Einbindung: Der Nur-Lese-Modus und die Freigabeeinstellungen können für Archive oder freigegebene Buckets sinnvoll sein. Das Freigabeverhalten kann beeinflussen, wer Dateien über Nextcloud freigeben kann. Legen Sie es daher bewusst fest.

7. Bestätigen Sie, dass Nextcloud eine Verbindung herstellen kann.

Wenn die Pflichtfelder ausgefüllt sind, wird die Speicherzeile automatisch gespeichert. Ein grüner Statusindikator bedeutet, dass Nextcloud den konfigurierten Speicher nutzen kann; rot oder gelb bedeutet, dass die Verbindung oder Konfiguration überprüft werden muss. Die Admin-Seite kann einen fehlerhaften Speicher vorübergehend für zehn Minuten als nicht verfügbar markieren. Klicken Sie auf das Statussymbol oder laden Sie die Seite neu, um nach der Korrektur eines Wertes eine erneute Überprüfung auszulösen.

8. Mit einer harmlosen Feile testen.

Öffnen Sie „Dateien“ als Benutzer mit Zugriff auf den Mountpunkt. Prüfen Sie, ob der Ordner angezeigt wird, erstellen oder laden Sie eine kleine Testdatei hoch, laden Sie diese erneut herunter und löschen Sie sie, falls der Bucket beschreibbar sein soll. Falls der Mountpunkt schreibgeschützt sein soll, testen Sie, ob Benutzer Dateien lesen können und ob Schreibvorgänge blockiert sind. Ein grünes Symbol allein bestätigt nicht, dass alle Benutzerberechtigungen oder das beabsichtigte Lese-/Schreibverhalten korrekt sind.

Wie kann man die Einbindung über die Kommandozeile überprüfen?

Für Installationen, bei denen Sie den Server selbst verwalten, bietet Nextcloud auch occBefehle für externen Speicher. Führen Sie die Befehle im Nextcloud-Installationsverzeichnis aus und verwenden Sie das für Ihr System passende Webserver-Konto. Bei vielen Linux-Installationen ist dies `/usr/bin/` www-data, aber Paket- und Containerinstallationen können abweichen.

sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>

Ersetzen Sie dies <mount_id>durch die ID, die vom Befehl `list` angezeigt wird. Eine erfolgreiche Überprüfung bestätigt, dass Nextcloud die konfigurierte Verbindung zu diesem Zeitpunkt herstellen kann. Verwenden Sie für Nextcloud AIO oder eine andere Containerbereitstellung die dokumentierte Methode dieser Bereitstellung, um den Befehl occinnerhalb des Anwendungscontainers auszuführen, anstatt den Host-Befehl unverändert zu kopieren.

Warum kann die Einbindung fehlschlagen, selbst wenn die Werte korrekt erscheinen?

Wenn ein Dienst ein selbstsigniertes Zertifikat verwendet, muss der Server diesem Zertifikat vertrauen; die Deaktivierung der Zertifikatsprüfung ist kein sicherer Ersatz. Das aktuelle Handbuch von Nextcloud weist außerdem darauf hin, dass wiederholte Trennzeichen wie beispielsweise Photos//cat.pngnicht unterstützt werden und betroffene Präfixe ignoriert werden können.

Was passiert, wenn Dateien direkt im Bucket geändert werden?

Nextcloud verwaltet einen internen Dateicache für externe Speicher. Wenn ein anderes Tool Objekte direkt in S3 hinzufügt, bearbeitet oder löscht, erkennt Nextcloud diese Änderung möglicherweise nicht sofort. Der aktuelle Leitfaden für externe Speicher empfiehlt regelmäßige Scans für Speichertypen ohne Push-Benachrichtigungen. Die Mount-ID finden Sie mit files_external:listfolgendem Befehl:

sudo -E -u www-data php occ files_external:scan <mount_id>

Planen Sie einen Scan entsprechend Ihren Aktualisierungsanforderungen und der Serverlast. Ein Scan ist nicht dasselbe wie sofortige Änderungsbenachrichtigungen. Nextcloud weist außerdem auf ein Metadatenrisiko hin: Ein erneuter Scan kann eine externe Umbenennung als gelöschtes altes Objekt und gleichzeitig als neues Objekt interpretieren. Dadurch werden Nextcloud-seitige Freigaben, Tags, Kommentare und der Aktivitätsverlauf des alten Eintrags entfernt. Führen Sie Umbenennungen daher immer über Nextcloud durch, wenn der Erhalt dieser Metadaten wichtig ist.

Woran erkennt man, dass die Einrichtung abgeschlossen ist?

• Die S3-Einbindung wird auf der Seite „Externer Speicher“ des Administrators als grün angezeigt.
• Benutzer der vorgesehenen Gruppe können die Halterung sehen, nicht zugewiesene Benutzer hingegen nicht.
• Ein Test-Upload, -Download und -Löschvorgang verhalten sich wie vorgesehen – oder Schreibvorgänge werden bei einer schreibgeschützten Einbindung blockiert.
• Der Server kann Änderungen erkennen, die außerhalb von Nextcloud vorgenommen wurden, und zwar nach dem konfigurierten Scanintervall.
• Die Zugangsdaten werden ausschließlich in der Nextcloud-Konfiguration und im Provider-Konto gespeichert, und der Zugriff ist auf den erforderlichen Bucket beschränkt.

Für versionsspezifische Details konsultieren Sie bitte den offiziellen Nextcloud S3-Leitfaden für externen Speicher , den Leitfaden zur Verwaltung des externen Speichers und die offizielle occ-Befehlsreferenz . Da sich die Anbieter hinsichtlich Endpunkt, Region, Berechtigungen und Adressierungsanforderungen unterscheiden, ist deren S3-Einrichtungsdokumentation für diese Werte weiterhin maßgebend.