SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor · Aggiornato 2026-10-23

Dove si trovano i file di Nextcloud in Docker

Scopri il percorso della directory dati nel container e il mount sul server host. Guida essenziale per il backup completo di config.php, database e file utente.

Dove Nextcloud in Docker archivia i file

Nextcloud in Docker archivia i file in una directory dati all'interno del container; la posizione reale sul server corrisponde al volume o al bind mount collegato. Con l'immagine linuxserver.io, lscr.io/linuxserver/nextcloud, i file utente risiedono in /data, mentre l'installazione di Nextcloud con il relativo config.php risiede in /config. Entrambi sono percorsi del container. Un comando visualizza il percorso host corrispondente, mentre il resto di questa guida tratta la parte più complessa: tutto ciò che non è contenuto nella directory dati.

Blocca il tag dell'immagine. I percorsi appartengono a una specifica immagine piuttosto che a Nextcloud, e un tag variabile può cambiare inaspettatamente. Al 20 ottobre 2026, il tag stabile corrente per questa immagine è 35.0.2, la terza release della versione major 35 di Nextcloud. L'immagine esegue l'aggiornamento di una sola versione major alla volta, quindi uno stack ancora alla 34.x passa alla 35 in un unico passaggio, operazione che richiede un backup preventivo.

services:
  nextcloud:
    image: lscr.io/linuxserver/nextcloud:35.0.2
    container_name: nextcloud
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - nextcloud_config:/config
      - nextcloud_data:/data
    ports:
      - 443:443
    restart: unless-stopped

  nextcloud-db:
    image: mariadb:11.8
    container_name: nextcloud-db
    environment:
      - MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}
      - MARIADB_DATABASE=nextcloud
      - MARIADB_USER=nextcloud
      - MARIADB_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
    volumes:
      - nextcloud_db:/var/lib/mysql
    restart: unless-stopped

volumes:
  nextcloud_config:
  nextcloud_data:
  nextcloud_db:

Le due password provengono da un file .env posizionato accanto al file compose, in modo da non essere incluse direttamente nel file compose stesso. Si tratta di tre volumi nella risposta, e solo uno di essi contiene i file utente.

Quei percorsi del container derivano dalla documentazione di quella specifica immagine. Un'immagine Nextcloud differente organizza il proprio filesystem in modo diverso e mantiene l'installazione sotto la propria web root; pertanto, un percorso copiato da un post su un forum è solo un'ipotesi. Verifica la configurazione reale dal container in esecuzione.

docker inspect nextcloud

La sezione Mounts di quell'output elenca ogni mount, con Source sul lato host e Destination sul lato container. Tale elenco risponde alla domanda per la tua configurazione, indipendentemente dall'immagine scelta.

Come trovo il percorso reale sull'host dietro al volume?

Un volume denominato è gestito da Docker, quindi non scegli tu il relativo percorso. Devi richiederlo a Docker.

docker volume ls
docker volume inspect nextcloud_nextcloud_data

Il nome è importante. Docker Compose antepone ai nomi dei volumi il nome del progetto, che per impostazione predefinita corrisponde al nome della directory che contiene il file Compose. Di conseguenza, un volume indicato come nextcloud_data nel file di solito esiste su disco con il nome nextcloud_nextcloud_data. docker volume ls mostra i nomi effettivi. L'output di inspect è simile al seguente, abbreviato:

[
    {
        "CreatedAt": "2026-08-18T09:12:44Z",
        "Driver": "local",
        "Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
        "Name": "nextcloud_nextcloud_data",
        "Scope": "local"
    }
]

Mountpoint è la risposta. Leggilo dal comando invece di presumerlo, perché può cambiare. Con Docker rootless, l'intera radice dei dati Docker si trova nella home directory dell'utente che esegue il daemon, quindi il percorso inizia da una posizione diversa.

Un bind mount elimina il problema. Scrivi - /srv/nextcloud/data:/data nel file Compose: il percorso sull'host è quello indicato da te, che docker inspect riporta come Source. La scelta modifica più del semplice percorso, perché volumi denominati e bind mount si comportano in modo diverso per proprietà e backup.

Perché la directory dei dati non è un backup

Il manuale di Nextcloud indica cinque elementi che un backup deve conservare: la directory di configurazione, la directory delle app personalizzate, la directory dei dati, la directory del tema e il database. Con questa image, le directory di configurazione, delle app e del tema si trovano tutte in /config, mentre il database viene eseguito nel proprio container con il proprio volume. Se copi solo /data, hai salvato la parte meno importante del problema.

Il database è importante perché l’interfaccia web non elenca le directory. Elenca le righe della cache dei file. Per questo il manuale indica di eseguire una scansione dopo aver copiato manualmente i file nella directory dei dati. Se ripristini /data accanto a un database vuoto, ottieni byte senza indice: nessun utente, nessuna condivisione e nulla nell’elenco dei file. Se ripristini il database accanto a un /data vuoto, ogni riga punta a un file che non esiste più.

config.php contiene le credenziali del database e i domini attendibili. Contiene anche l’ID dell’istanza, che corrisponde al nome della directory dei dati dell’applicazione all’interno della directory dei dati. Verifica questi valori sull’istanza in esecuzione invece di basarti su valori ricordati.

docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceid

Il primo comando mostra la directory dei dati effettivamente utilizzata da questa istanza, che qui è /data. Questa image include un wrapper occ nel PATH, quindi eseguilo direttamente tramite docker exec. Non copiare la forma più lunga sudo e php occ dal manuale di Nextcloud, perché è scritta per un’installazione esterna a un container.

Cosa sta riempiendo silenziosamente il volume dati?

Le anteprime e la cronologia per utente risiedono nello stesso volume dei file e nessuna delle due compare nella cifra dello spazio di archiviazione visualizzata dall'utente nell'interfaccia web.

  • Le anteprime sono miniature generate. Risiedono nella cartella dei dati dell'applicazione all'interno della directory dei dati, denominata appdata_ seguita dall'ID dell'istanza.
  • I file eliminati rimangono nel cestino. trashbin_retention_obligation è impostato per default su auto, che li conserva per 30 giorni e li rimuove successivamente solo quando è necessario spazio. I file eliminati non vengono conteggiati nella quota normale dell'utente, ma il cestino ha un proprio limite: per default fino al 50% dello spazio di quota residuo dell'utente, o dello spazio libero su disco per un utente senza quota. Quando il cestino supera tale limite, Nextcloud rimuove prima gli elementi idonei più vecchi, mentre gli elementi entro i 30 giorni non vengono rimossi.
  • Anche le vecchie versioni rimangono. versions_retention_obligation è anch'esso impostato per default su auto, che riduce le versioni nel tempo e mantiene l'ultima in ogni finestra temporale, mentre un job in background rimuove le versioni oltre il periodo di conservazione o il cui file non esiste più. L'app Versions non utilizza mai più del 50% dello spazio attualmente libero per l'utente e, quando deve liberare spazio, elimina prima le versioni più vecchie mantenendo almeno le due più recenti. Una versione rinominata manualmente dall'utente è esclusa da tale scadenza automatica, ma l'utente può comunque eliminarla manualmente e occ versions:cleanup rimuove le versioni nominate insieme al resto.

Misura prima di eliminare qualsiasi cosa.

docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'

La prima riga fornisce un numero per ogni cartella utente più la cartella dei dati dell'applicazione. Se il numero relativo ai dati dell'applicazione è elevato, la causa sono le anteprime. I comandi di pulizia sottostanti sono documentati e ognuno di essi distrugge dati intenzionalmente.

docker exec -it nextcloud occ trashbin:cleanup --all-users
docker exec -it nextcloud occ versions:cleanup alice
docker exec -it nextcloud occ preview:cleanup

preview:cleanup rimuove ogni anteprima generata e Nextcloud le rigenera man mano che gli utenti aprono quei file, quindi lo spazio viene recuperato gradualmente e il costo è a carico della CPU. Se il volume è solo una parte di un problema di disco più ampio, vecchie immagini e cache di build obsoleta sono solitamente l'altra parte.

Perché i file che copio sull'host non compaiono in Nextcloud?

Nextcloud legge l'indice dei file dal database, non direttamente dalla directory. La copia ha creato un file sul disco senza una riga corrispondente nel database, quindi l'interfaccia Web non ha nulla da elencare. Il manuale descrive esattamente questo caso: dopo avere copiato i file direttamente nella directory dei dati, è necessaria una scansione.

docker exec -it nextcloud occ files:scan --path="/alice/files/Photos"
docker exec -it nextcloud occ files:scan --unscanned -v
docker exec -it nextcloud occ files:scan --all

L'argomento --path mostra anche la struttura della directory dei dati: ogni utente ha una cartella con il proprio nome utente e, al suo interno, files contiene ciò che l'utente vede nell'interfaccia Web. Eseguire la scansione di un solo percorso quando si sa dove sono stati copiati i file. --all attraversa tutti gli utenti e può richiedere molto tempo su un'istanza di grandi dimensioni. --unscanned elabora soltanto i file contrassegnati come non ancora completamente scansionati. -v visualizza ogni file durante l'elaborazione; questa è la differenza tra un comando che sembra bloccato e uno di cui è possibile monitorare l'avanzamento.

La proprietà dei file determina se la scansione è sufficiente. Se l'utente del container non può scrivere un file, questo viene indicizzato ma non può essere spostato. Di conseguenza, l'elenco appare corretto, mentre la ridenominazione o l'eliminazione dall'interfaccia Web fallisce.

Perché le scritture non riescono dopo aver impostato PUID e PGID?

Perché il kernel confronta i numeri, non i nomi. PUID e PGID impostano l'ID numerico dell'utente (uid) e del gruppo (gid) con cui viene eseguito il processo nel container. Anche ogni file sull'host ha un proprietario numerico. Se i due numeri sono diversi, la scrittura viene negata, indipendentemente dai nomi visualizzati nei due ambienti.

docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_data

id abc stampa uid e gid effettivamente utilizzati dal container, cioè i valori PUID e PGID impostati. ls -ln stampa i proprietari numerici e -n è importante: il semplice ls -l converte quei numeri usando l'elenco degli utenti dell'host e mostra un nome che nel container non ha alcun significato. Confronta i due numeri.

Poi verifica la scrittura invece di procedere per tentativi.

docker exec -u abc -it nextcloud touch /data/writetest

Un Permission denied che assegna il nome /data è la conferma. Correggi la proprietà dall'interno del container, quindi esegui di nuovo lo stesso test.

docker exec -u 0 -it nextcloud chown -R abc:abc /data
docker exec -u abc -it nextcloud touch /data/writetest
docker exec -u abc -it nextcloud rm /data/writetest

Esegui l'operazione dall'interno per un motivo preciso. Con Docker rootless, gli ID utente del container vengono mappati attraverso l'intervallo subordinato in /etc/subuid, quindi uid 1000 all'interno del container corrisponde a un uid molto più alto sull'host. Un chown 1000:1000 eseguito sull'host imposta quindi un proprietario che il container non può utilizzare e la scrittura continua a non riuscire. Eseguire chown all'interno del container usa la stessa mappatura utilizzata dal processo Nextcloud, quindi i numeri corrispondono per costruzione. Per questo PUID e PGID devono corrispondere al proprietario sul disco prima di iniziare qualsiasi altra attività di debug.

Come eseguire un backup in modo che il ripristino funzioni davvero?

Acquisisci il database e le directory nello stesso momento. La modalità di manutenzione impedisce l'accesso, quindi nessun caricamento viene completato tra l'esportazione e la copia.

docker exec -it nextcloud occ maintenance:mode --on
docker exec nextcloud-db mariadb-dump --single-transaction -u nextcloud -p"$NEXTCLOUD_DB_PASSWORD" nextcloud > nextcloud-sqlbkp.sql
docker run --rm -v nextcloud_nextcloud_data:/data:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-data.tgz -C /data .
docker run --rm -v nextcloud_nextcloud_config:/config:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-config.tgz -C /config .
docker exec -it nextcloud occ maintenance:mode --off

Nota cosa non contiene la riga di esportazione: un flag -t. Un TTY riscrive i caratteri di fine riga e un dump SQL che è passato attraverso un TTY si corrompe in un modo che viene rilevato soltanto durante il ripristino. Inoltre, una password specificata nella riga di comando è visibile nell'output di ps mentre il comando è in esecuzione. Per questo, leggila dal file .env nella shell invece di digitarla. Le immagini di database meno recenti includono mysqldump invece di mariadb-dump; il manuale documenta entrambe le opzioni.

Per eseguire il ripristino, carica il dump in un database vuoto, estrai entrambi gli archivi in volumi nuovi, avvia i container, quindi disattiva la modalità di manutenzione. Se le directory e il dump provengono da momenti diversi, la cache dei file e il database non sono coerenti e occ files:scan --all corregge soltanto una delle due direzioni. Individua i file che esistono senza una riga corrispondente. Non può ripristinare un file a cui fa riferimento una riga.

Conserva il risultato fuori dal server. Una copia che si trova nella stessa VPS viene persa insieme alla VPS. Per questo restic verso un repository esterno al server fa parte di questa procedura e uno snapshot del provider è uno strumento diverso da un backup. Se stai ancora configurando lo stack, un'installazione completa di Nextcloud su una VPS descrive il reverse proxy e il certificato TLS (transport layer security) che questa guida non tratta.

FAQ

Dove si trova la directory dei dati di Nextcloud in un container Docker?

Con l'immagine linuxserver.io si trova in /data all'interno del container, mentre l'installazione con config.php è in /config. Questi sono percorsi interni al container. Per il percorso sull'host, esegui docker inspect nextcloud e leggi il valore Source nella sezione Mounts, oppure esegui docker volume inspect sul volume e leggi Mountpoint. Altre immagini Nextcloud utilizzano percorsi differenti, quindi consulta la documentazione relativa al tag che hai bloccato e verifica con docker exec -it nextcloud occ config:system:get datadirectory.

Perché i file che copio nel volume non appaiono in Nextcloud?

Nextcloud elenca le righe dalla cache dei file nel suo database invece di leggere direttamente la directory; pertanto, un file che arriva senza passare per Nextcloud non ha una riga corrispondente e rimane invisibile. Esegui docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" per una singola cartella, oppure occ files:scan --all per ogni utente. Se i file appaiono ma non possono essere spostati o eliminati, la causa è la proprietà: l'utente del container deve avere i permessi di scrittura su di essi.

Una copia del volume dati è sufficiente per ripristinare Nextcloud?

No. Il volume dati contiene il contenuto dei file. Il database contiene l'indice dei file insieme a utenti e condivisioni, mentre config.php contiene le credenziali del database e l'ID dell'istanza. Un ripristino funzionante richiede la cartella dei dati, la cartella di configurazione, il database e le cartelle delle app personalizzate e dei temi, se utilizzate. Esegui il backup di tutti questi elementi nello stesso momento, poiché un database più recente dei file punterebbe a file inesistenti.

Perché il mio volume dati è molto più grande dei file che vedono i miei utenti?

Anteprime, file eliminati e vecchie versioni risiedono nello stesso volume e nessuno di essi appare nel conteggio visualizzato dall'utente. Misura lo spazio con docker exec -it nextcloud sh -c 'du -sh /data/*'. Per impostazione predefinita, il cestino conserva i file eliminati per almeno 30 giorni e li rimuove solo quando è necessario spazio, mentre l'app Versions può occupare fino alla metà dello spazio libero attualmente disponibile per un utente. Eliminali con occ trashbin:cleanup --all-users, occ versions:cleanup alice e occ preview:cleanup; tieni presente che le anteprime torneranno a crescere man mano che gli utenti apriranno i propri file.

Posso spostare la directory dei dati di Nextcloud su un altro disco?

Monta la nuova posizione sullo stesso percorso del container invece di modificare il percorso noto a Nextcloud. Ferma il container, copia il vecchio contenuto sul nuovo disco preservando la proprietà (cp -a o rsync -aAX), punta il volume o il bind mount alla nuova posizione nel tuo file compose, quindi riavvia. Nextcloud continuerà a vedere /data, quindi non è necessario modificare alcuna riga nel database. Verifica con docker exec -it nextcloud occ config:system:get datadirectory e un caricamento di prova.

Questo articolo ti è stato utile?