Este tutorial para principiantes resolveu uma fonte real de confusão: o nome e o caminho apresentados nos Ficheiros do ZimaOS não são automaticamente o caminho que uma aplicação vê dentro do seu contentor Docker. O autor original utilizou o terminal Web para inspecionar os pontos de montagem dos discos e, em seguida, mapeou a pasta de armazenamento do anfitrião para o Immich ou Syncthing através de um caminho de contentor mais simples, como /SYNC.
A discussão recebeu posteriormente uma correção importante: os caminhos de montagem brutos não devem ser tratados como a interface preferencial de longo prazo para o armazenamento das aplicações quando o ZimaOS pode fornecer um caminho de armazenamento gerido. O ZimaOS atual torna isto muito mais fácil do que o fluxo de trabalho de 2025.
O Tutorial Original Começou no Modo de Programador
O Utilizador Usou lsblk para Inspecionar os Pontos de Montagem
Abra as Definições da Aplicação e Adicione um Volume
As Colunas Anfitrião e Contentor Significam Coisas Diferentes
Se o caminho do contentor for /SYNC, então a aplicação deve utilizar /SYNC ou uma subpasta como /SYNC/Photos. Não deve ser apontado novamente para o caminho de montagem do anfitrião.
Uma resposta da comunidade alertou contra os caminhos brutos em /mnt
Outro participante salientou que os caminhos de montagem brutos diretos podem mudar após uma atualização do disco, uma reconstrução do conjunto ou outras operações de armazenamento, além de poderem contornar pressupostos da camada de armazenamento do ZimaOS.
O participante recomendou mapear armazenamento estável gerido pelo ZimaOS, como /DATA/Media ou a localização pretendida dos dados da aplicação, em vez de criar uma aplicação em torno de um identificador de montagem arbitrário.
A IceWhale esclareceu que os suportes externos ficam em /media por predefinição
Zima-Giorgio acrescentou que os caminhos dos suportes de armazenamento externo são colocados em /media por predefinição. Essa nota oficial ajuda a distinguir o armazenamento externo dos exemplos de dados internos das aplicações em /DATA.
As Versões Atuais do ZimaOS Tornam o Modelo de Caminhos Mais Explícito
Em agosto de 2026, o autor original do tutorial disse a um utilizador posterior que as versões mais recentes do ZimaOS tornaram este processo muito mais fácil.
As orientações atuais da IceWhale explicam como o armazenamento do anfitrião e os caminhos dos contentores do ZimaOS são mapeados nas definições das aplicações. Comece por aí antes de criar manualmente caminhos a partir do resultado de montagem de baixo nível.
Utilize o Seletor de Ficheiros ou o Armazenamento Gerido Quando Disponível
Para aplicações normais, o fluxo de trabalho atual mais seguro consiste em selecionar uma pasta real no espaço de armazenamento ZimaOS pretendido, nas definições de volumes da aplicação, escolher ou manter o caminho do contentor esperado pela aplicação, guardar e, em seguida, utilizar esse caminho do contentor dentro da aplicação.
Não Utilize um Nó de Dispositivo Bruto como Pasta de uma Aplicação
A captura de ecrã de origem inclui um caminho que começa por /dev/... num mapeamento de volumes experimental. Um nó de dispositivo de blocos não é o mesmo que um diretório de sistema de ficheiros montado. As aplicações normais, como o Syncthing e o Immich, devem receber uma pasta montada, não um dispositivo de disco bruto não montado.
/DATA É uma Localização de Dados do ZimaOS, Não um Espaço Reservado para Todos os Discos
Mais tarde, um principiante perguntou se /DATA significa simplesmente “iniciar todos os caminhos aqui”. Não significa isso. /DATA é uma localização de dados gerida pelo ZimaOS, utilizada para aplicações e dados de utilizador geridos pelo sistema. O armazenamento externo separado pode surgir em /media ou para outro caminho de armazenamento gerido, consoante a forma como o ZimaOS o registou.
A regra importante é selecionar a pasta real do anfitrião no espaço de armazenamento pretendido e, em seguida, mapeá-la para um caminho estável do contentor.
O Autor do Tutorial Disse Mais Tarde que as Versões Mais Recentes do ZimaOS Tornam Isto Mais Fácil
Em agosto de 2026, o autor original regressou e disse a outro principiante que as versões mais recentes do ZimaOS simplificam o processo. Esse comentário posterior reforça o limite histórico: utilize as capturas de ecrã do terminal de 2025 para compreender os caminhos do anfitrião e do contentor, não como uma exigência para descobrir manualmente todos os pontos de montagem atuais.
Perguntas frequentes sobre o acesso a unidades externas
Qual dos lados de um volume Docker corresponde ao caminho real do disco?
O lado do anfitrião.
Que caminho deve o Immich, o Syncthing ou outra aplicação utilizar internamente?
O caminho do lado do contentor configurado no mapeamento de volumes.
Todas as aplicações devem apontar diretamente para /mnt ou para um nó de dispositivo?
Não. Prefira caminhos de armazenamento estáveis e geridos quando o ZimaOS os disponibilizar.
Onde disse a IceWhale que o armazenamento externo é montado por predefinição?
Zima-Giorgio afirmou que o armazenamento externo se encontra em /media por predefinição.
