Solução do Discord

É possível adicionar um HDD ou SSD USB ao CasaOS?

A new CasaOS user asked whether a USB HDD or SSD could be added to the system and whether storage could also be used as an install target.

Sim: o CasaOS pode utilizar HDDs e SSDs USB, desde que o Linux os detete e monte. As questões práticas são o sistema de ficheiros, um caminho de montagem estável, as permissões, a alimentação e a forma como cada aplicação Docker mapeia a unidade.

Confirme que o Linux deteta o disco

lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINTS
sudo blkid

Se a unidade não tiver um ponto de montagem, resolva essa questão antes de diagnosticar problemas no CasaOS.

O CasaOS organiza o armazenamento em torno de /DATA

O instalador atual configura o suporte para meios amovíveis em torno das montagens /DATA do CasaOS. Os caminhos estáveis dentro de /DATA são mais fáceis de reutilizar em montagens de volumes das aplicações do que as localizações temporárias de montagem do ambiente de trabalho.

Escolha o sistema de ficheiros adequado à finalidade

Sistema de ficheiros Adequado para Desvantagem
ext4 Disco de servidor Linux sempre ligado Menos compatível com o Windows
NTFS Utilização partilhada com o Windows Comportamento diferente das permissões no Linux
exFAT Disco portátil para transferência Pouco adequado para bases de dados de aplicações

Mapeie a unidade para cada aplicação

Um disco visível no anfitrião não fica automaticamente visível dentro de todos os contentores. O Docker requer montagens explícitas de caminhos do anfitrião.

Utilize o armazenamento USB com cuidado

  • Alimente os HDDs de 3,5 polegadas através de uma caixa adequada.
  • Evite cabos soltos para bases de dados.
  • Não desligue discos montados durante operações de escrita.
  • Utilize montagens persistentes baseadas em UUID para caminhos críticos.
  • Mantenha cópias de segurança; um segundo disco não é automaticamente uma cópia de segurança.

A gestão de unidades do CasaOS apresenta o modelo de armazenamento. O catálogo de aplicações autoalojadas ajuda a identificar as aplicações que necessitam de caminhos de dados explícitos.

Se o armazenamento USB deixar de ser suficiente, o ZimaBoard 2 disponibiliza conectividade SATA nativa.

Faça com que a montagem sobreviva a reinícios

Para um disco de dados permanente, utilize um identificador estável, como o UUID do sistema de ficheiros, em vez de depender de um nome de dispositivo como /dev/sdb1, que pode mudar. Confirme o UUID com blkid e configure uma montagem persistente adequada à sua distribuição Linux.

Separe os discos de multimédia das bases de dados das aplicações

Um HDD USB é frequentemente adequado para ficheiros multimédia grandes, cópias de segurança ou arquivos. As bases de dados e os dados das aplicações sujeitos a escritas frequentes são mais sensíveis a desligamentos do cabo, reinícios da ponte USB e suspensão agressiva do disco. Manter /DATA/AppData num armazenamento interno fiável e utilizar o USB para multimédia em massa é muitas vezes uma configuração mais segura.

Verifique o proprietário depois da montagem

stat -c '%u:%g %a %n' /DATA/YourDrive

Se um contentor for executado com um PUID/PGID específico, certifique-se de que a pasta montada pode ser escrita por essa identidade. Sistemas de ficheiros como NTFS/exFAT podem utilizar opções de montagem em vez da propriedade Unix normal por ficheiro, pelo que devem ser diagnosticados de forma diferente do ext4.

Verifique o comportamento da alimentação e da ponte USB

Erros aleatórios das aplicações podem dever-se a problemas no transporte do armazenamento. No caso de discos mecânicos, utilize uma caixa com alimentação suficiente. Se um disco desaparecer sob carga, consulte os registos do kernel:

dmesg -T | tail -n 100

Reinícios USB ou erros de E/S repetidos apontam para problemas no cabo, na ponte, na alimentação ou na integridade do disco — não nas permissões do CasaOS.

Remova um disco de dados em segurança

Pare os contentores que utilizam o caminho, desmonte o sistema de ficheiros e só depois desligue-o. Remover um disco enquanto o Docker tem ficheiros abertos pode corromper bases de dados ou deixar as aplicações em estados inconsistentes.

Perguntas frequentes

O CasaOS pode funcionar num SSD?

O CasaOS funciona sobre o Linux. Se o sistema Linux compatível estiver instalado nesse SSD, o CasaOS também pode ser instalado aí.

O Jellyfin pode utilizar um HDD USB?

Sim. Mantenha o caminho de montagem estável e monte essa pasta como volume no contentor do Jellyfin.