Per montare un bucket compatibile con S3 in Nextcloud, abilita l'app integrata per il supporto dell'archiviazione esterna, aggiungi una voce di archiviazione Amazon S3 nelle impostazioni di archiviazione esterna dell'amministratore e fornisci le credenziali del bucket e i dettagli dell'endpoint del provider. Nextcloud utilizza il backend Amazon S3 per i servizi compatibili; non è necessario installare un'app separata per ogni provider S3. Il nome host, la regione e il formato del percorso esatti dipendono dal provider di object storage.
Questa guida si basa sulla documentazione di amministrazione di Nextcloud per i backend S3 e di archiviazione esterna, aggiornata al 6 ottobre 2026. Le etichette potrebbero differire leggermente a seconda della versione del server e del tema. Un mount può essere raggiungibile pur comportandosi in modo diverso da una cartella locale di Nextcloud, soprattutto quando i file vengono modificati direttamente nel bucket.
Cosa bisogna controllare prima di aggiungere il secchio?
Prima di aprire le impostazioni di Nextcloud, conferma questi dettagli con il tuo provider S3:
- Il nome del bucket e le credenziali per una chiave di accesso.
- Il nome host generico dell'endpoint S3 del provider, ad esempio
s3.example.net. Utilizzare l'endpoint stesso, non un URL specifico del bucket che contiene già il nome del bucket. - La regione o la regione di firma, se il fornitore ne richiede una.
- Indica se le richieste devono utilizzare lo stile virtual-hosted (
https://bucket.endpoint/) o lo stile path ( https://endpoint/bucket). - La porta HTTPS, solitamente la 443, e la possibilità per il server di raggiungere tale endpoint attraverso il firewall e il DNS.
Crea una chiave di accesso dedicata per questo mount e limita le sue autorizzazioni al bucket e alle azioni necessarie. Non incollare segreti in un ticket, in uno screenshot o nella cronologia della shell. La configurazione S3 di Nextcloud richiede un ID della chiave di accesso e una chiave di accesso segreta; non convalida automaticamente tutte le policy di autorizzazione specifiche del provider.
È la stessa cosa che impostare S3 come spazio di archiviazione primario di Nextcloud?
No. Un mount di storage esterno espone un bucket esistente come una cartella all'interno di Nextcloud. È utile quando si desidera esplorare o gestire i file in un bucket mantenendolo accessibile ad altri strumenti S3. Lo storage a oggetti primario è un'architettura a livello di server diversa, con presupposti operativi differenti. Se è necessario scegliere tra le due opzioni, consultare la documentazione di Nextcloud sullo storage a oggetti primario prima di modificare la progettazione dei dati in produzione.
Come si aggiunge il mount compatibile con S3 nell'interfaccia web?
1. Abilita il supporto per la memoria esterna
Accedi come amministratore di Nextcloud, apri App e abilita l' app di supporto per l'archiviazione esterna inclusa . È inclusa in Nextcloud, ma potrebbe essere disabilitata per impostazione predefinita. Se è già abilitata, procedi alle impostazioni di archiviazione.
2. Aprire la pagina di amministrazione relativa alla memoria esterna.
Apri il menu del tuo profilo, seleziona Impostazioni , quindi trova Archiviazione esterna nella sezione Amministrazione. Questa pagina è dedicata ai punti di montaggio configurati dall'amministratore. Un punto di montaggio configurato da un singolo utente nelle impostazioni personali è disponibile solo per quell'utente; un punto di montaggio amministrativo può essere disponibile per utenti e gruppi selezionati.
3. Crea un punto di montaggio e scegli il backend S3.
Nella nuova riga, inserisci un semplice nome di cartella , ad esempio Archive. Questo diventerà il nome della cartella visibile in Nextcloud e deve essere un nome, non un percorso; non inserire barre. Nel selettore del tipo di archiviazione, scegli Amazon S3 . In Autenticazione, scegli Chiave di accesso .
4. Inserisci il bucket e le credenziali
Inserisci il nome esatto del bucket, l'ID della chiave di accesso e la chiave di accesso segreta forniti dal tuo provider. Considera la chiave segreta come una password. La documentazione di Nextcloud specifica che i nomi dei bucket per questo backend devono rispettare i requisiti di denominazione di AWS S3, anche quando il servizio è ospitato altrove; i caratteri di sottolineatura non sono accettati. Se il nome del bucket fornito dal provider include un carattere di sottolineatura, verifica se il provider offre un nome di bucket compatibile prima di procedere alla risoluzione dei problemi relativi alle credenziali.
5. Imposta l'endpoint, la regione e lo stile della richiesta
Per i servizi S3 ospitati su Amazon, specificare la regione corretta. Per un servizio non Amazon, impostare il nome host generico del provider. Utilizzare i valori di endpoint e regione pubblicati dal provider; non esiste un valore di regione universale per tutti i prodotti compatibili con S3.
| Collocamento | Cosa inserire |
|---|
| Nome host | L'endpoint generico, ad esempio s3.example.net, senza il sottodominio o il percorso del bucket. |
| Porta | La porta TLS del provider; solitamente la 443. |
| Abilita SSL | Lasciare l'opzione abilitata se l'endpoint supporta HTTPS. Utilizzare un certificato attendibile. |
| Regione | Indicare la regione di firma del fornitore, se richiesta; lasciare il valore consigliato dal fornitore per i servizi compatibili. |
| Abilita stile percorso | Abilita solo se l'endpoint richiede richieste nel formato endpoint/bucketanziché bucket.endpoint. |
| Autenticazione legacy (v2) | Omettere questa opzione a meno che il provider non richieda espressamente la versione precedente della firma. L'impostazione predefinita è la v4. |
La guida S3 di Nextcloud attualmente in vigore specifica di utilizzare il nome host generico dell'endpoint per lo storage non Amazon. Descrive inoltre l'indirizzamento in stile percorso come dipendente dal provider. Non modificare lo stile percorso a caso se è possibile ottenere la modalità di indirizzamento prevista dalla documentazione S3 del provider.
6. Limitare chi può utilizzare la cavalcatura
Utilizza "Disponibile per" per assegnare l'accesso solo agli utenti o ai gruppi Nextcloud desiderati. Un mount configurato dall'amministratore potrebbe altrimenti essere disponibile a tutti. Dopo aver salvato, verifica le opzioni del mount: la modalità di sola lettura e i controlli di condivisione potrebbero essere appropriati per archivi o bucket condivisi. Il comportamento di condivisione può influire su chi può esporre i file tramite Nextcloud, quindi impostalo con attenzione.
7. Verificare che Nextcloud sia in grado di connettersi
Quando i campi obbligatori sono validi, la riga di archiviazione viene salvata automaticamente. Un indicatore di stato verde significa che Nextcloud può utilizzare l'archiviazione configurata; il rosso o il giallo indicano che la connessione o la configurazione richiedono attenzione. La pagina di amministrazione potrebbe contrassegnare temporaneamente un'archiviazione non disponibile per dieci minuti. Fare clic sull'icona di stato o ricaricare la pagina per avviare un nuovo controllo dopo aver corretto un valore.
8. Esegui un test con un file innocuo
Apri la cartella Files come utente autorizzato al mount. Verifica che la cartella sia visibile, crea o carica un piccolo file di prova, scaricalo nuovamente ed eliminalo se il bucket deve essere scrivibile. Se il mount deve essere di sola lettura, verifica che gli utenti possano leggere i file e che le scritture siano bloccate. Un indicatore verde da solo non garantisce che tutte le autorizzazioni utente o i comportamenti di lettura/scrittura previsti siano corretti.
Come si può verificare il montaggio dalla riga di comando?
Per le installazioni in cui si amministra il server, Nextcloud fornisce anche occcomandi per l'archiviazione esterna. Eseguire i comandi dalla directory di installazione di Nextcloud e utilizzare l'account del server web appropriato per il proprio sistema. Su molte installazioni Linux è www-data, ma le installazioni di pacchetti e container possono essere diverse.
sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>
Sostituire <mount_id>con l'ID mostrato dal comando list. Una verifica riuscita conferma che Nextcloud può stabilire la connessione configurata in quel momento. Per Nextcloud AIO o un'altra distribuzione in container, utilizzare la procedura documentata per tale distribuzione per eseguire il comando occall'interno del container dell'app anziché copiare il comando host senza modifiche.
Perché il montaggio potrebbe fallire anche quando i valori sembrano corretti?
| Sintomo | Primi controlli |
|---|
| Stato rosso o giallo | Verifica l'ortografia del bucket, la chiave e il segreto, il nome host dell'endpoint, la porta TLS, il DNS, il traffico in uscita del firewall e l'attendibilità del certificato. |
| Errore di firma o autorizzazione | Conferma con il fornitore la regione di firma e le autorizzazioni chiave. Verifica se il fornitore richiede l'indirizzamento in formato percorso. |
| Timeout della connessione | Verifica che l'host Nextcloud possa raggiungere l'endpoint S3 sulla porta configurata; l'accesso tramite browser dal tuo laptop non è sufficiente a dimostrare la connettività al server. |
| Mancano alcune cartelle o oggetti | Verifica la presenza di barre ripetute non supportate nei prefissi degli oggetti e valuta la possibilità di eseguire una scansione della memoria esterna. |
| Funziona per un amministratore ma non per un utente. | Verificare la disponibilità per gli incarichi, l'appartenenza al gruppo e accertarsi che l'utente stia aprendo il punto di montaggio corretto. |
Quando un servizio utilizza un certificato autofirmato, il server deve considerare attendibile tale certificato; disabilitare la verifica del certificato non è una soluzione sicura. Il manuale attuale di Nextcloud avverte inoltre che i delimitatori ripetuti come Photos//cat.pngnon sono supportati e che i prefissi interessati potrebbero essere ignorati.
Cosa succede quando i file vengono modificati direttamente nel bucket?
Nextcloud mantiene una cache interna dei file per l'archiviazione esterna. Se un altro strumento aggiunge, modifica o elimina oggetti direttamente in S3, Nextcloud potrebbe non rilevare immediatamente la modifica. La guida attuale sull'archiviazione esterna consiglia di eseguire scansioni periodiche per i tipi di archiviazione senza notifiche push. È possibile trovare l'ID di montaggio con files_external:listed eseguire:
sudo -E -u www-data php occ files_external:scan <mount_id>
Pianifica una scansione in base alla frequenza di aggiornamento necessaria e al carico che il tuo server può gestire. Una scansione non equivale a una notifica istantanea delle modifiche. Nextcloud documenta anche un rischio relativo ai metadati: una nuova scansione potrebbe interpretare una ridenominazione esterna come l'eliminazione di un vecchio oggetto più un nuovo oggetto, rimuovendo condivisioni lato Nextcloud, tag, commenti e cronologia delle attività associati alla vecchia voce. Per questo motivo, esegui le ridenominazioni tramite Nextcloud quando la conservazione di tali metadati è importante.
Come fai a sapere se la configurazione è completa?
- Il mount S3 mostra uno stato verde nella pagina Archiviazione esterna dell'amministratore.
- Gli utenti appartenenti al gruppo previsto possono visualizzare il punto di montaggio, mentre gli utenti non assegnati non possono.
- Un test di caricamento, download ed eliminazione si comporta come previsto, oppure le scritture vengono bloccate per un mount di sola lettura.
- Il server è in grado di rilevare le modifiche apportate al di fuori di Nextcloud dopo l'intervallo di scansione configurato.
- Le credenziali vengono memorizzate esclusivamente nella configurazione di Nextcloud e nell'account del provider, e l'accesso è limitato al bucket richiesto.
Per dettagli specifici sulla versione, consultare la guida ufficiale di Nextcloud per l'archiviazione esterna S3 , la guida di amministrazione dell'archiviazione esterna e il riferimento ufficiale del comando occ . I provider variano per quanto riguarda endpoint, regione, autorizzazioni e requisiti di indirizzamento, pertanto la loro documentazione di configurazione S3 rimane la fonte autorevole per tali valori.