Soluzione della community

Consenti alle app di ZimaOS di accedere alle unità esterne: percorsi host, percorsi dei container e mappatura dello spazio di archiviazione attuale

A November 2025 beginner tutorial showing how to identify a storage mount point and map it into an app with separate host and container paths. Community replies corrected the raw-mount approach, IceWhale clarified external media lives under /media by default, and the author later noted newer ZimaOS releases make the process easier.

Questo tutorial per principianti ha risolto una reale fonte di confusione: il nome e il percorso mostrati in File di ZimaOS non corrispondono automaticamente al percorso visualizzato da un'applicazione all'interno del suo container Docker. L'autore originale ha usato il terminale web per controllare i punti di mount dei dischi, poi ha mappato la cartella di archiviazione dell'host in Immich o Syncthing su un percorso del container più semplice, come /SYNC.

La discussione ha ricevuto in seguito una correzione importante: i percorsi di mount raw non dovrebbero essere considerati l'interfaccia preferita a lungo termine per l'archiviazione delle app quando ZimaOS può fornire un percorso gestito. L'attuale ZimaOS rende tutto questo molto più semplice rispetto al flusso di lavoro del 2025.

Il tutorial originale iniziava in Modalità sviluppatore

Schermata delle impostazioni di ZimaOS con Modalità sviluppatore e Terminale web visibili
Il tutorial di partenza utilizzava il terminale web integrato per identificare i punti in cui erano montati i dispositivi di archiviazione.

L'utente ha usato lsblk per controllare i punti di mount

Terminale di ZimaOS che mostra l'output di lsblk con i punti di mount dell'archiviazione evidenziati
Il campo importante era il punto di mount, ma le risposte successive hanno messo in guardia dal considerare ogni percorso di mount raw come una destinazione stabile per l'archiviazione delle app.

Apri le impostazioni dell'app e aggiungi un volume

Menu delle app di ZimaOS con Configurazione selezionata
Il pannello di configurazione dell'app è il punto in cui l'archiviazione dell'host viene esposta al container.

Le colonne Host e Container indicano cose diverse

Impostazioni dei volumi dell'app Syncthing che mostrano un percorso di archiviazione dell'host ZimaOS mappato su /SYNC all'interno del container
A sinistra c'è il percorso reale dell'host ZimaOS; a destra il percorso visualizzato dall'applicazione all'interno del container.

Se il percorso del container è /SYNC, l'applicazione dovrebbe usare /SYNC o una sottocartella come /SYNC/Photos. Non dovrebbe essere reindirizzata al percorso di mount dell'host.

impostazioni delle cartelle di Syncthing che usano /SYNC come percorso della cartella interna
Una volta mappato il volume, l'applicazione funziona solo con il percorso dal lato del container.

Una risposta della community ha messo in guardia dall'uso dei percorsi raw /mnt

Un altro partecipante ha osservato che i percorsi di mount raw diretti possono cambiare dopo l'aggiornamento dei dischi, la ricostruzione del pool o altre operazioni di archiviazione, oltre a poter eludere le ipotesi del livello di archiviazione di ZimaOS.

Il partecipante ha consigliato di mappare l'archiviazione stabile gestita da ZimaOS, come /DATA/Media oppure il percorso AppData previsto, invece di costruire un'app attorno a un identificatore arbitrario del mount raw.

IceWhale ha chiarito che i supporti esterni si trovano in /media per impostazione predefinita

Zima-Giorgio ha aggiunto che i percorsi dei supporti di archiviazione esterni si trovano sotto /media per impostazione predefinita. Questa nota ufficiale aiuta a distinguere l'archiviazione esterna dagli esempi di dati applicativi interni riportati sotto /DATA.

Le versioni attuali di ZimaOS rendono più esplicito il modello dei percorsi

Nell'agosto 2026, l'autore originale del tutorial ha detto a un utente successivo che le versioni più recenti di ZimaOS avevano reso questo processo molto più semplice.

Le indicazioni attuali di IceWhale spiegano come vengono mappati lo spazio di archiviazione host e i percorsi dei container di ZimaOS nelle impostazioni delle app. Parti da lì prima di creare manualmente i percorsi a partire dall'output dei montaggi di basso livello.

Usa il selettore di file o l'archiviazione gestita quando disponibile

Per le app normali, il flusso di lavoro attuale più sicuro consiste nel selezionare una cartella reale nello spazio di archiviazione ZimaOS desiderato nelle impostazioni dei volumi dell'app, scegliere o mantenere il percorso del container previsto dall'app, salvare, quindi usare quel percorso del container all'interno dell'applicazione.

Non usare un nodo di dispositivo raw come cartella dell'applicazione

Lo screenshot originale include un percorso che inizia con /dev/... in una mappatura sperimentale dei volumi. Un nodo di dispositivo a blocchi non equivale a una directory con un filesystem montato. Le applicazioni normali, come Syncthing e Immich, dovrebbero ricevere una cartella montata, non un dispositivo raw non montato.

/DATA è una posizione dati di ZimaOS, non un segnaposto per ogni disco

In seguito, un principiante ha chiesto se /DATA significa semplicemente «avvia ogni percorso da qui». Non è così. /DATA è una posizione dati gestita di ZimaOS utilizzata per le applicazioni e i dati degli utenti gestiti dal sistema. Lo spazio di archiviazione esterno separato può comparire in /media o a un altro percorso di archiviazione gestito, a seconda di come ZimaOS lo ha registrato.

La regola importante è selezionare la cartella host effettiva dallo spazio di archiviazione desiderato, quindi mapparla a un percorso stabile nel container.

In seguito l'autore del tutorial ha detto che le versioni più recenti di ZimaOS rendono tutto più semplice

Nell'agosto 2026, l'autore originale è tornato e ha detto a un altro principiante che le versioni più recenti di ZimaOS semplificano il flusso di lavoro. Quel commento successivo ribadisce il confine storico: usa gli screenshot del terminale del 2025 per comprendere i percorsi lato host e lato container, non come requisito per individuare manualmente ogni punto di montaggio attuale.

FAQ sull'accesso alle unità esterne

Quale lato di un volume Docker corrisponde al vero percorso del disco?

Il lato host.

Quale percorso dovrebbero usare internamente Immich, Syncthing o un'altra app?

Il percorso lato container configurato nella mappatura del volume.

Ogni app dovrebbe essere indirizzata direttamente a /mnt o a un nodo del dispositivo?

No. Preferisci percorsi di archiviazione gestiti e stabili quando ZimaOS li fornisce.

Dove ha detto IceWhale che i supporti esterni vengono montati per impostazione predefinita?

Zima-Giorgio ha detto che i supporti di archiviazione esterni si trovano in /media per impostazione predefinita.