Verbind een S3-compatibele bucket met Nextcloud externe opslag.

Om een ​​S3-compatibele bucket in Nextcloud weer te geven, activeert u de meegeleverde app 'External Storage Support', voegt u een Amazon S3- mount toe in de beheerdersinstellingen en voert u de bucket-, toegangssleutel-, geheime sleutel- en eindpuntgegevens van de provider in. Voor een provider die geen Amazon is, zijn de hostnaam en de padstijl meestal de velden die de meeste aandacht vereisen. Controleer of de mount groen is en test deze vervolgens met een tijdelijk bestand voordat u bredere toegang verleent.

Wat moet je voorbereiden?

Deze procedure creëert een externe koppeling: Nextcloud maakt verbinding met een bestaande bucket en presenteert deze als een map in Bestanden. Er worden geen bestanden naar de bucket gemigreerd, de bucket wordt niet de primaire opslag van Nextcloud en de Nextcloud-gegevensmap wordt niet vervangen.

• Beheerderstoegang: De systeemwijde koppeling wordt geconfigureerd in de beheerdersinstellingen van Nextcloud.
• Bucketnaam en inloggegevens: Vraag een S3-toegangssleutel-ID en een geheime toegangssleutel aan bij de opslagprovider. Kies bij voorkeur een speciale sleutel met alleen de machtigingen die nodig zijn voor deze bucket en de beoogde bewerkingen.
• Verbindingsgegevens: Vraag de algemene hostnaam van het S3-eindpunt op en, indien de provider dit vereist, de regio en de vereisten voor het padtype. Plak geen bucketspecifieke URL waar de hostnaam wordt gevraagd.
• Netwerk en TLS: De Nextcloud-server moet het eindpunt kunnen bereiken. Gebruik HTTPS, tenzij de provider een specifieke, gedocumenteerde reden heeft voor een andere configuratie.

De beheerdershandleiding van Nextcloud 35 beschrijft de Amazon S3-backend voor Amazon S3 en compatibele services. Aanbieders verschillen in hun S3 API-gedrag, eindpuntindeling, ondertekeningsregio en vereiste machtigingen. Raadpleeg daarom de configuratiepagina van de betreffende aanbieder voor deze waarden. Begin met een nieuwe of lege bucket, of een duidelijk geïsoleerde testprefix, als u niet zeker weet hoe bestaande objecten worden weergegeven.

Externe opslagondersteuning inschakelen

1. Meld u aan als Nextcloud-beheerder en open Apps .
2. Zoek de meegeleverde app voor externe opslag en schakel deze in als deze is uitgeschakeld. De app is standaard bij Nextcloud inbegrepen, maar is standaard uitgeschakeld.
3. Open je profielmenu, kies Instellingen en selecteer Externe opslag onder Beheer.

Als de backend niet in het dropdownmenu voor opslag verschijnt, controleer dan of de app is ingeschakeld en of uw account beheerdersrechten heeft. Menulabels kunnen per release enigszins verschillen; raadpleeg de bijbehorende versie van de Nextcloud-beheerhandleiding als uw installatie niet versie 35 is.

Voeg de S3-mount toe en configureer deze.

1. Geef in de nieuwe opslagrij de mount een eenvoudige mapnaam , bijvoorbeeld Archive. Dit is de naam die gebruikers in Nextcloud zien; het is geen bucketnaam of pad. Gebruik geen schuine strepen.
2. Selecteer Amazon S3 in het dropdownmenu voor de opslagbackend en 'Toegangssleutel' als authenticatiemethode.
3. Voer de bucketnaam, de toegangssleutel-ID en de geheime toegangssleutel exact in zoals ze zijn verstrekt. Vermijd spaties die tijdens het kopiëren en plakken zijn toegevoegd. Beschouw het geheim als een wachtwoord; plaats het niet in een openbaar ticket, shellgeschiedenis of schermafbeelding van een artikel.
4. Voor opslag die door Amazon wordt gehost, voert u de regio van de bucket in. Voor een service die niet van Amazon is, voert u de algemene S3- hostnaam in (de host van het eindpunt, zonder het bucketvoorvoegsel). Vul een regio in als de provider specifiek een ondertekeningsregio vereist; raadpleeg de documentatie van de provider wanneer deze een waarde zoals gebruikt auto.
5. Laat SSL ingeschakeld voor HTTPS. Laat de poort op de standaardwaarde staan, tenzij de provider een andere poort opgeeft.
6. Probeer eerst de standaard virtuele-hostaanvraagstijl. Schakel Padstijl in wanneer de provider aanvragen vereist die de vorm hebben van https://endpoint.example/bucketin plaats van https://bucket.endpoint.example. De S3-handleiding van de provider is de meest betrouwbare bron voor deze instelling.
7. Schakel Legacy (v2) authenticatie uit, tenzij de provider dit expliciet vereist. Nextcloud documenteert v4 als de standaard en geeft aan dat v2 zelden nodig is.
8. Selecteer bij 'Beschikbaar voor' alleen de gebruikers of groepen die deze mount mogen zien. Een mount die in de beheerdersinstellingen is aangemaakt, is standaard voor iedereen beschikbaar. Beperk de toegang daarom voordat u privé- of gedeelde gegevens openbaar maakt.

Vereiste velden worden opgeslagen zodra ze zijn ingevuld. Een groene statusindicator betekent dat Nextcloud verbinding kan maken; een gele of rode indicator betekent dat de koppeling niet gevalideerd kon worden. Als er een foutstatus blijft bestaan, klik dan op het statuspictogram of vernieuw de beheerderspagina om het opnieuw te controleren. Nextcloud merkt op dat een koppeling met een fout gedurende tien minuten als niet beschikbaar kan worden gemarkeerd.

Kies bewust voor het gewenste montagegedrag.

Open het optiemenu van de rij om de instellingen op mountniveau te bekijken. Delen is standaard uitgeschakeld; schakel dit alleen in als gebruikers bestanden van deze mount moeten delen. U kunt de mount ook instellen op alleen-lezen voor referentiegegevens, voorbeelden inschakelen waar nodig en kiezen hoe vaak Nextcloud controleert op externe wijzigingen. Deze opties beïnvloeden het gedrag van de mount binnen Nextcloud; ze wijzigen het bucketbeleid van de opslagprovider niet.

Ga er niet vanuit dat het toevoegen van een mount ervoor zorgt dat directe wijzigingen in de providerconsole onmiddellijk in Nextcloud verschijnen. Nextcloud beheert een bestandscache. Wanneer bestanden buiten Nextcloud worden aangemaakt, gewijzigd of verwijderd, kan de cachelijst verouderd blijven totdat een scan deze bijwerkt. Voor S3 en andere backends zonder pushnotificaties van de provider documenteert Nextcloud periodieke scans met occ files_external:scan <mount_id>. Zoek de ID met occ files_external:list; voer OCC uit vanuit de Nextcloud-installatiemap als de webservergebruiker en pas de gebruiker en de opdrachtwrapper aan uw installatie aan.

Los verbindingsproblemen op

• Rode of gele status: Controleer de exacte spelling van de bucket, het sleutelpaar, de hostnaam van het eindpunt, de regio/ondertekeningsregio en de netwerktoegang aan de serverzijde. Bevestig de DNS- en uitgaande HTTPS-toegang vanaf de Nextcloud-host.
• Handtekening- of autorisatiefout: Zorg ervoor dat de sleutel actief is en gemachtigd is om de bucket weer te geven en de benodigde bewerkingen uit te voeren. Controleer of de regio overeenkomt met de ondertekeningsinstructies van de provider. Een inloggegeven waarmee wel bestanden geüpload kunnen worden, maar waarmee de bucket niet kan worden weergegeven of geïnspecteerd, kan nog steeds mislukken bij de verbindingstest van Nextcloud.
• Eindpunt of bucket niet gevonden: Controleer of de hostnaam het generieke eindpunt bevat en niet een URL waarin de bucket al is opgenomen. Vraag de provider of deze verzoeken in padstijl vereist, schakel die optie in en controleer het opnieuw.
• De verbinding werkt, maar bestaande objecten ontbreken: controleer of de sleutel de bucket kan weergeven en of objectnamen ondersteunde paden gebruiken. Nextcloud waarschuwt dat S3-sleutels die herhaalde scheidingstekens bevatten, zoals Photos//cat.png, en de inhoud ervan, worden genegeerd.
• Bestanden die direct bij de provider zijn gewijzigd, ontbreken: Start een scan van de externe opslag voor de betreffende mount. Voer routinematige hernoemingen en verplaatsingen zoveel mogelijk binnen Nextcloud uit; een nieuwe scan kan een hernoeming op afstand interpreteren als een verwijdering plus een nieuw bestand, waardoor gedeelde mappen, tags, opmerkingen of activiteitsgeschiedenis die aan het oude bestand zijn gekoppeld, verloren kunnen gaan.

Controleer of de bevestiging veilig is.

Wacht tot de status van de mount groen wordt. Open Bestanden als een gebruiker met de toegestane rechten, open de mountmap, upload een klein testbestand met een unieke naam, download het en verwijder het via Nextcloud. Controleer indien mogelijk of het verwachte object wordt weergegeven in de bucketweergave van de provider. Test vervolgens met een tweede gebruiker, maar alleen als groepstoegang onderdeel is van het abonnement. Controleer ten slotte of een gebruiker buiten de geselecteerde rechten de mount niet kan zien. Verwijder het testobject en behoud de referenties met minimale rechten.

Voor versie-specifieke veldbeschrijvingen raadpleegt u de Nextcloud 35 Amazon S3-configuratie en de Nextcloud 35-beheerhandleiding voor externe opslag .