Verbinden Sie einen S3-kompatiblen Bucket mit dem externen Speicher von Nextcloud.

Um einen S3-kompatiblen Bucket in Nextcloud anzuzeigen, aktivieren Sie die mitgelieferte App „Externer Speicher“ (External Storage Support), fügen Sie in den Administrationseinstellungen eine Amazon S3- Einbindung hinzu und geben Sie die Bucket-, Zugriffsschlüssel-, geheimen Schlüssel- und Endpunktdetails des Anbieters ein. Bei Anbietern anderer Anbieter sind Hostname und Pfadformat in der Regel die wichtigsten Felder. Prüfen Sie, ob die Einbindung erfolgreich war (grüner Status), und testen Sie den Zugriff mit einer temporären Datei, bevor Sie weitere Zugriffsrechte gewähren.

Was ist vorzubereiten?

Dieses Verfahren erstellt eine externe Einbindung: Nextcloud verbindet sich mit einem bestehenden Bucket und stellt ihn als Ordner in der Dateien-App dar. Es werden keine Dateien in den Bucket migriert, der Bucket wird nicht zum primären Speicher von Nextcloud und das Nextcloud-Datenverzeichnis wird nicht ersetzt.

• Administratorzugriff: Die systemweite Einbindung wird in den Administrationseinstellungen von Nextcloud konfiguriert.
• Bucket-Name und Zugangsdaten: Besorgen Sie sich eine S3-Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel vom Speicheranbieter. Verwenden Sie vorzugsweise einen dedizierten Schlüssel mit nur den Berechtigungen, die für diesen Bucket und die beabsichtigten Operationen erforderlich sind.
• Verbindungsdetails: Ermitteln Sie den generischen Hostnamen des S3-Endpunkts und, falls vom Anbieter gefordert, die Region und den Pfad. Fügen Sie keine bucketspezifische URL an der Stelle ein, an der der Hostname abgefragt wird.
• Netzwerk und TLS: Der Nextcloud-Server muss den Endpunkt erreichen können. Verwenden Sie HTTPS, es sei denn, der Anbieter hat einen spezifischen, dokumentierten Grund für eine andere Konfiguration.

Das Administrationshandbuch von Nextcloud 35 beschreibt das Amazon S3-Backend für Amazon S3 und kompatible Dienste. Anbieter unterscheiden sich hinsichtlich des Verhaltens ihrer S3-API, des Endpunktformats, der Signaturregion und der erforderlichen Berechtigungen. Konsultieren Sie daher die jeweilige Einrichtungsseite des Anbieters, um diese Werte zu ermitteln. Beginnen Sie mit einem neuen oder leeren Bucket oder einem klar isolierten Testpräfix, wenn Sie sich nicht sicher sind, wie vorhandene Objekte angezeigt werden.

Unterstützung für externen Speicher aktivieren

1. Melden Sie sich als Nextcloud-Administrator an und öffnen Sie Apps .
2. Suchen Sie die mitgelieferte App zur Unterstützung externer Speichermedien und aktivieren Sie sie, falls sie deaktiviert ist. Die App ist in Nextcloud enthalten, aber standardmäßig deaktiviert.
3. Öffnen Sie Ihr Profilmenü, wählen Sie Einstellungen und anschließend unter Verwaltung die Option Externer Speicher .

Wenn das Backend nicht im Speichermenü angezeigt wird, überprüfen Sie, ob die App aktiviert ist und Ihr Konto über Administratorrechte verfügt. Die Menübezeichnungen können je nach Version leicht variieren; verwenden Sie die entsprechende Version des Nextcloud-Administrationshandbuchs, falls Ihre Installation nicht Version 35 ist.

S3-Halterung hinzufügen und konfigurieren

1. Geben Sie in der neuen Speicherzeile dem Mount einen einfachen Ordnernamen , z. B. „ Ordnername Archive“. Dies ist der Name, den Benutzer in Nextcloud sehen; es handelt sich nicht um einen Bucket-Namen oder einen Pfad. Verwenden Sie keine Schrägstriche.
2. Wählen Sie im Dropdown-Menü „Speicher-Backend“ Amazon S3 und als Authentifizierungsmethode den Zugriffsschlüssel aus .
3. Geben Sie den Bucket-Namen, die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel exakt so ein, wie sie ausgegeben wurden. Vermeiden Sie Leerzeichen, die beim Kopieren und Einfügen hinzugefügt wurden. Behandeln Sie den geheimen Zugriffsschlüssel wie ein Passwort; verwenden Sie ihn nicht in einem öffentlichen Ticket, im Shell-Verlauf oder in einem Screenshot eines Artikels.
4. Geben Sie bei Amazon-gehostetem Speicher die Bucket-Region ein. Bei einem Nicht-Amazon-Dienst geben Sie den generischen S3- Hostnamen (den Endpunkt-Host ohne Bucket-Präfix) ein. Geben Sie eine Region an, wenn der Anbieter eine Signaturregion explizit verlangt; beachten Sie die Dokumentation des Anbieters, wenn ein Wert wie z. B. „S3“ verwendet wird auto.
5. Lassen Sie SSL für HTTPS aktiviert. Belassen Sie den Port auf dem Standardwert, es sei denn, Ihr Provider gibt einen anderen Port an.
6. Versuchen Sie zunächst den Standard-Anfragestil für virtuelle Hosts. Aktivieren Sie den Pfadstil, wenn der Provider Anfragen im Format <Pfad> https://endpoint.example/bucketanstelle von <Pfad> erfordert https://bucket.endpoint.example. Die S3-Dokumentation des Providers ist die maßgebliche Quelle für diese Einstellung.
7. Die Legacy-Authentifizierung (v2) sollte deaktiviert bleiben, es sei denn, der Anbieter verlangt sie ausdrücklich. Nextcloud gibt v4 als Standard an und erklärt, dass v2 nur selten benötigt wird.
8. Unter „Verfügbar für“ wählen Sie nur die Benutzer oder Gruppen aus, die diese Einbindung sehen sollen. Eine in den Administratoreinstellungen erstellte Einbindung ist standardmäßig allgemein verfügbar. Beschränken Sie daher den Zugriff, bevor Sie private oder freigegebene Daten preisgeben.

Pflichtfelder werden nach dem Ausfüllen gespeichert. Ein grüner Statusindikator bedeutet, dass Nextcloud eine Verbindung herstellen kann; ein gelber oder roter Indikator bedeutet, dass die Einbindung nicht validiert werden konnte. Sollte weiterhin ein Fehler angezeigt werden, klicken Sie auf das Statussymbol oder laden Sie die Admin-Seite neu, um dies erneut zu überprüfen. Nextcloud weist darauf hin, dass eine fehlerhafte Einbindung bis zu zehn Minuten lang als nicht verfügbar markiert sein kann.

Das Reitverhalten bewusst wählen

Öffnen Sie das Optionsmenü der Zeile, um die Mount-Einstellungen einzusehen. Die Freigabe ist standardmäßig deaktiviert; aktivieren Sie sie nur, wenn Benutzer Dateien von diesem Mount freigeben sollen. Sie können den Mount auch für Referenzdaten auf schreibgeschützt setzen, Vorschauen aktivieren, wo sinnvoll, und festlegen, wie oft Nextcloud auf externe Änderungen prüft. Diese Optionen beeinflussen das Verhalten des Mounts in Nextcloud; sie ändern nicht die Bucket-Richtlinie des Speicheranbieters.

Gehen Sie nicht davon aus, dass Änderungen in der Provider-Konsole nach dem Hinzufügen einer Mount-Datei sofort in Nextcloud sichtbar werden. Nextcloud verwendet einen Dateicache. Werden Dateien außerhalb von Nextcloud erstellt, geändert oder gelöscht, kann der Cache veraltet sein, bis er durch einen Scan aktualisiert wird. Für S3 und andere Backends ohne Provider-Push-Benachrichtigungen protokolliert Nextcloud regelmäßige Scans occ files_external:scan <mount_id>. Die Scan-ID finden Sie mit dem occ files_external:listBefehl `sc`. Führen Sie OCC im Nextcloud-Installationsverzeichnis als Webserver-Benutzer aus und passen Sie Benutzername und Befehlszeile an Ihre Installation an.

Beheben Sie Verbindungsprobleme

• Roter oder gelber Status: Überprüfen Sie die genaue Schreibweise des Buckets, das Schlüsselpaar, den Hostnamen des Endpunkts, die Region/Signaturregion und den serverseitigen Netzwerkzugriff. Bestätigen Sie den DNS- und ausgehenden HTTPS-Zugriff vom Nextcloud-Host.
• Signatur- oder Autorisierungsfehler: Stellen Sie sicher, dass der Schlüssel aktiv ist und die Berechtigung besitzt, den Bucket aufzulisten und die benötigten Aktionen durchzuführen. Prüfen Sie, ob die Region den Signaturvorgaben des Anbieters entspricht. Eine Anmeldeinformation, die zwar Uploads ermöglicht, aber nicht zum Auflisten oder Überprüfen des Buckets berechtigt, kann dennoch den Verbindungstest von Nextcloud nicht bestehen.
• Endpunkt oder Bucket nicht gefunden: Stellen Sie sicher, dass der Hostname den generischen Endpunkt enthält und nicht eine URL, die den Bucket bereits enthält. Fragen Sie Ihren Anbieter, ob er Pfadanfragen erfordert, und deaktivieren Sie diese Option gegebenenfalls. Überprüfen Sie anschließend erneut.
• Die Verbindung funktioniert, aber vorhandene Objekte fehlen: Prüfen Sie, ob der Schlüssel den Bucket auflisten kann und ob die Objektnamen unterstützte Pfade verwenden. Nextcloud weist darauf hin, dass S3-Schlüssel mit wiederholten Trennzeichen, wie z. B. Kommas Photos//cat.png, und deren Inhalt ignoriert werden.
• Dateien, die direkt beim Provider geändert wurden, fehlen: Starten Sie eine Überprüfung des externen Speichers für die Einbindung. Führen Sie routinemäßige Umbenennungen und Verschiebungen nach Möglichkeit innerhalb von Nextcloud durch; eine erneute Überprüfung kann eine externe Umbenennung als Löschung und gleichzeitig als neue Datei interpretieren, wodurch Nextcloud-seitige Freigaben, Tags, Kommentare oder der Aktivitätsverlauf des alten Eintrags verloren gehen können.

Prüfen Sie, ob die Halterung sicher befestigt ist.

Warten Sie, bis der Mount-Status grün wird. Öffnen Sie „Dateien“ als Benutzer mit den entsprechenden Berechtigungen, öffnen Sie den Mount-Ordner, laden Sie eine kleine, eindeutig benannte Testdatei hoch, laden Sie diese herunter und löschen Sie sie über Nextcloud. Überprüfen Sie, ob das erwartete Objekt in der Bucket-Ansicht des Anbieters angezeigt wird. Testen Sie anschließend mit einem zweiten Benutzer, sofern Gruppenzugriff im Tarif enthalten ist. Stellen Sie abschließend sicher, dass ein Benutzer außerhalb der ausgewählten Berechtigungen den Mount nicht sehen kann. Entfernen Sie das Testobjekt und verwenden Sie die minimal erforderlichen Anmeldeinformationen.

Versionsspezifische Feldbeschreibungen finden Sie im Nextcloud 35 Amazon S3-Konfigurationshandbuch und im Nextcloud 35-Administrationshandbuch für externen Speicher .