Collega un bucket compatibile con S3 allo storage esterno di Nextcloud.

Per visualizzare un bucket compatibile con S3 in Nextcloud, abilita l'app di supporto per l'archiviazione esterna inclusa, aggiungi un mount Amazon S3 nelle impostazioni di amministrazione e inserisci il bucket del provider, la chiave di accesso, la chiave segreta e i dettagli dell'endpoint. Per un provider diverso da Amazon, i campi che richiedono maggiore attenzione sono solitamente il nome host e il formato del percorso. Verifica che il mount sia visualizzato in verde, quindi esegui un test con un file temporaneo prima di concedere l'accesso a tutti.

Cosa preparare

Questa procedura crea un mount esterno: Nextcloud si connette a un bucket esistente e lo presenta come una cartella in File. Non migra i file nel bucket, non imposta il bucket come spazio di archiviazione primario di Nextcloud, né sostituisce la directory dei dati di Nextcloud.

• Accesso amministratore: il montaggio a livello di sistema è configurato nelle impostazioni di amministrazione di Nextcloud.
• Nome del bucket e credenziali: Ottieni un ID della chiave di accesso S3 e una chiave di accesso segreta dal provider di storage. È preferibile una chiave dedicata con solo le autorizzazioni necessarie per questo bucket e le operazioni previste.
• Dettagli di connessione: Ottieni il nome host generico dell'endpoint S3 e, se richiesto dal provider, la regione e il formato del percorso. Non incollare un URL specifico del bucket dove viene richiesto il nome host.
• Rete e TLS: il server Nextcloud deve essere in grado di raggiungere l'endpoint. Utilizzare HTTPS a meno che il provider non fornisca un motivo specifico e documentato per una configurazione diversa.

Il manuale di amministrazione di Nextcloud 35 documenta il backend Amazon S3 per Amazon S3 e i servizi compatibili. I provider differiscono per comportamento dell'API S3, formato dell'endpoint, regione di firma e autorizzazioni richieste, quindi consulta la pagina di configurazione del provider per questi valori. Inizia con un bucket nuovo o vuoto, oppure con un prefisso di test chiaramente isolato, se non sei sicuro di come appariranno gli oggetti esistenti.

Abilita il supporto per la memoria esterna

1. Accedi come amministratore di Nextcloud e apri App .
2. Individua l' app di supporto per l'archiviazione esterna inclusa nel pacchetto e abilitala se è disabilitata. L'app è inclusa in Nextcloud ma è disabilitata per impostazione predefinita.
3. Apri il menu del tuo profilo, seleziona Impostazioni e scegli Archiviazione esterna in Amministrazione.

Se il backend non compare nel menu a tendina di archiviazione, verifica che l'app sia abilitata e che il tuo account disponga dei privilegi di amministratore. Le etichette dei menu possono variare leggermente tra le diverse versioni; utilizza la versione corrispondente del Manuale di amministrazione di Nextcloud se la tua installazione non è alla versione 35.

Aggiungi e configura il mount S3

1. Nella nuova riga di archiviazione, assegna al mount un semplice nome di cartella , ad esempio Archive. Questo è il nome che gli utenti vedono in Nextcloud; non è il nome di un bucket o un percorso. Non includere barre.
2. Seleziona Amazon S3 nel menu a tendina del backend di archiviazione e Chiave di accesso come metodo di autenticazione.
3. Inserisci il nome del bucket, l'ID della chiave di accesso e la chiave di accesso segreta esattamente come sono stati forniti. Evita di aggiungere spazi durante il copia e incolla. Tratta la chiave segreta come una password; non inserirla in un ticket pubblico, nella cronologia della shell o in uno screenshot di un articolo.
4. Per lo storage ospitato su Amazon, inserisci la regione del bucket. Per un servizio non Amazon, inserisci il suo nome host S3 generico (l'host dell'endpoint, senza il prefisso del bucket). Inserisci una regione se il provider richiede specificamente una regione di firma; segui la sua documentazione quando utilizza un valore come auto.
5. Mantieni selezionata l'opzione "Abilita SSL" per HTTPS. Lascia la porta predefinita a meno che il provider non ne specifichi una diversa.
6. Prova prima lo stile di richiesta predefinito per l'host virtuale. Abilita lo stile del percorso quando il provider richiede richieste con un formato simile a https://endpoint.example/bucketinvece di https://bucket.endpoint.example. La guida S3 del provider è la fonte di riferimento per questa impostazione.
7. Disattiva l'autenticazione Legacy (v2) a meno che il provider non la richieda esplicitamente. Nextcloud documenta la v4 come predefinita e afferma che la v2 è raramente necessaria.
8. In "Disponibile per" , seleziona solo gli utenti o i gruppi che devono visualizzare questo punto di montaggio. Un punto di montaggio creato nelle impostazioni di amministrazione è disponibile a tutti per impostazione predefinita, quindi limitane l'accesso prima di esporre dati privati ​​o condivisi.

I campi obbligatori vengono salvati al termine della compilazione. Un indicatore di stato verde indica che Nextcloud è in grado di connettersi; un indicatore giallo o rosso indica che non è stato possibile convalidare il mount. Se lo stato di errore persiste, fare clic sull'icona di stato o ricaricare la pagina di amministrazione per ricontrollare. Nextcloud segnala che un mount con errore potrebbe risultare non disponibile per dieci minuti.

Scegli consapevolmente il comportamento di montaggio

Apri il menu delle opzioni della riga per rivedere le impostazioni a livello di mount. La condivisione è disabilitata per impostazione predefinita; abilitala solo se gli utenti devono condividere file da questo mount. Puoi anche impostare il mount in sola lettura per i dati di riferimento, abilitare le anteprime quando necessario e scegliere la frequenza con cui Nextcloud verifica la presenza di modifiche esterne. Queste opzioni influiscono sul comportamento del mount all'interno di Nextcloud; non modificano i criteri del bucket del provider di storage.

Non dare per scontato che l'aggiunta di un mount comporti la visualizzazione immediata delle modifiche nella console del provider in Nextcloud. Nextcloud mantiene una cache dei file. Quando i file vengono creati, modificati o eliminati al di fuori di Nextcloud, l'elenco memorizzato nella cache può rimanere obsoleto fino a quando una scansione non lo aggiorna. Per S3 e altri backend senza notifiche push del provider, Nextcloud documenta le scansioni periodiche con occ files_external:scan <mount_id>. Trova l'ID con occ files_external:list; esegui OCC dalla directory di installazione di Nextcloud come utente del server web, adattando l'utente e il wrapper del comando alla tua installazione.

Risolvere i problemi di connessione

• Stato rosso o giallo: ricontrollare l'ortografia esatta del bucket, la coppia di chiavi, il nome host dell'endpoint, la regione/regione di firma e l'accesso alla rete lato server. Confermare l'accesso DNS e HTTPS in uscita dall'host Nextcloud.
• Errore di firma o di autorizzazione: assicurati che la chiave sia attiva e autorizzata a elencare il bucket ed eseguire le operazioni necessarie agli utenti. Verifica che la regione corrisponda alle istruzioni di firma del provider. Una credenziale che consente il caricamento ma non l'elenco o l'ispezione del bucket potrebbe comunque non superare il test di connessione di Nextcloud.
• Endpoint o bucket non trovato: verifica che il nome host contenga l'endpoint generico e non un URL con il bucket già incluso. Chiedi al provider se richiede richieste in formato percorso, quindi attiva o disattiva tale opzione e ricontrolla.
• La connessione funziona ma mancano gli oggetti esistenti: verifica che la chiave possa elencare il bucket e che i nomi degli oggetti utilizzino percorsi supportati. Nextcloud avverte che le chiavi S3 contenenti delimitatori ripetuti, come Photos//cat.png, e il loro contenuto vengono ignorati.
• I file modificati direttamente presso il provider risultano mancanti: avviare una scansione dell'archivio esterno per il punto di montaggio. Quando possibile, eseguire le ridenominazioni e gli spostamenti di routine all'interno di Nextcloud; una nuova scansione potrebbe interpretare una ridenominazione remota come un'eliminazione più la creazione di un nuovo file, con conseguente perdita di condivisioni, tag, commenti o cronologia delle attività lato Nextcloud associati alla vecchia voce.

Verificare il montaggio in sicurezza

Attendi che lo stato del mount diventi verde. Apri File come utente con i privilegi consentiti, apri la cartella del mount, carica un piccolo file di prova con un nome univoco, scaricalo ed eliminalo tramite Nextcloud. Se possibile, verifica che l'oggetto previsto appaia nella vista bucket del provider. Quindi esegui un test con un secondo utente solo se l'accesso di gruppo è incluso nel piano. Infine, conferma che un utente al di fuori dell'ambito selezionato non possa visualizzare il mount. Rimuovi l'oggetto di prova e conserva le credenziali con i privilegi minimi.

Per le descrizioni dei campi specifiche per la versione, consultare la configurazione di Nextcloud 35 su Amazon S3 e la guida di amministrazione dello storage esterno di Nextcloud 35 .