Solução da comunidade

Limpar após desinstalar o CasaOS sem afetar as partilhas Samba existentes

An October 2025 report where uninstalling CasaOS from Linux left the CasaOS-created Samba configuration active while the user's pre-existing smb.conf had been renamed, breaking Kodi access to shares that existed before CasaOS.

O tópico original tem apenas uma publicação, mas o problema que descreve é importante: um utilizador instalou o CasaOS no Linux, removeu posteriormente o CasaOS com o comando oficial de desinstalação e descobriu depois que a configuração do Samba que tinha antes do CasaOS já não funcionava. A investigação revelou que o smb.conf original tinha sido renomeado quando o CasaOS foi instalado, enquanto a configuração do Samba gerada pelo CasaOS continuou ativa após a desinstalação.

Como o tópico não tem uma resposta da equipa nem um inventário completo dos elementos removidos, esta página deve manter um âmbito restrito. Pode explicar o efeito confirmado no Samba e apresentar um método seguro de auditoria após a desinstalação, mas não deve inventar uma lista definitiva de todos os ficheiros que o CasaOS deixa em todas as distribuições Linux.

O que foi realmente confirmado

O utilizador tinha partilhas Samba antes do CasaOS. Essas partilhas funcionavam com o Kodi numa televisão. Alguns dias depois de desinstalar o CasaOS, o Kodi deixou de conseguir aceder-lhes.

O utilizador descobriu então que a instalação do CasaOS tinha movido ou renomeado a configuração original do Samba e instalado a sua própria configuração. O processo de desinstalação não restaurou automaticamente o smb.conf anterior, pelo que a máquina continuou a utilizar a configuração da era do CasaOS.

Desinstalar uma aplicação não é o mesmo que reverter o anfitrião

O CasaOS funciona sobre uma distribuição Linux e integra-se com serviços como o Docker, os caminhos de armazenamento e o Samba. Se a instalação substituir ou modificar um ficheiro de configuração, remover os binários do CasaOS não reconstrói necessariamente o anfitrião exatamente como estava antes da instalação.

Este é um princípio geral da administração Linux: “pacote removido” e “sistema restaurado à configuração anterior” são operações diferentes.

O desinstalador atual do CasaOS tem opções de remoção opcionais

O projeto CasaOS mantido pela IceWhale continua a disponibilizar casaos-uninstall como comando normal de remoção. O desinstalador atual pergunta separadamente se pretende remover o Docker, os contentores do CasaOS e os ficheiros do CasaOS.

Consulte o processo atual de remoção do CasaOS antes de desinstalar um sistema moderno, pois as perguntas apresentadas e o comportamento de limpeza podem mudar entre versões.

Antes de desinstalar, faça uma cópia de segurança da configuração ao nível do anfitrião

Se o CasaOS estiver a ser testado num servidor que já tenha serviços, guarde cópias da configuração importante do anfitrião antes da remoção. Alguns exemplos incluem:

  • configuração do Samba e definições das partilhas;
  • unidades systemd personalizadas;
  • configuração de proxy inverso;
  • ficheiros Docker Compose que não pertençam ao CasaOS;
  • configuração da firewall ou da rede;
  • definições de montagem e configuração do armazenamento.

Isto é especialmente importante num servidor Linux “real”, onde o CasaOS não é a única carga de trabalho.

Restaure o Samba comparando ficheiros conhecidos como funcionais

Se ainda existir um smb.conf anterior ao CasaOS com um nome de cópia de segurança ou renomeado, não substitua simplesmente a configuração ativa de imediato. Preserve primeiro ambas as versões, compare as definições das partilhas e valide a configuração pretendida.

Um erro de sintaxe pode deixar todas as partilhas do Samba indisponíveis. Se possível, utilize as próprias ferramentas de validação da configuração do Samba antes de reiniciar ou recarregar o serviço.

Não elimine /DATA nem o armazenamento do Docker como “limpeza” sem o inspecionar

O CasaOS armazena deliberadamente aplicações e dados do utilizador em localizações persistentes, para que a desinstalação da camada de gestão não destrua automaticamente os dados do utilizador. Após a remoção, esta medida de segurança pode parecer um conjunto de “restos”.

Não elimine recursivamente /DATA, volumes do Docker, dados de contentores ou pastas de aplicações até identificar quais os ficheiros que pertencem ao CasaOS e quais pertencem a aplicações de que ainda necessita.

Uma auditoria segura após a desinstalação

  1. Confirme que os serviços do CasaOS já não estão em execução.
  2. Reveja a configuração ativa do Samba e compare-a com as cópias de segurança anteriores ao CasaOS.
  3. Apresente a lista dos contentores restantes do CasaOS antes de eliminar dados do Docker.
  4. Inspecione os diretórios de dados persistentes em vez de os eliminar pelo nome.
  5. Verifique se algum serviço ao nível do anfitrião ainda referencia ficheiros criados pelo CasaOS.
  6. Remova os elementos restantes apenas depois de confirmar que não são necessários para outros serviços.

O que o tópico original não comprova

A publicação não prova que todas as desinstalações do CasaOS deixam o Samba para trás, não apresenta uma lista de todos os ficheiros restantes e não inclui uma resposta da IceWhale que esclareça se o comportamento foi considerado um erro. O facto confirmado é mais restrito: a configuração do Samba que este utilizador tinha antes do CasaOS não foi restaurada automaticamente.

Perguntas frequentes sobre a limpeza após a desinstalação do CasaOS

O casaos-uninstall remove necessariamente o Docker?

Não. O desinstalador mantido trata a remoção do Docker como uma escolha separada.

Porque deixaram de funcionar as antigas partilhas Samba do utilizador?

O smb.conf ativo continuou a ser a versão criada pelo CasaOS, em vez de voltar à configuração anterior ao CasaOS.

Devo eliminar todos os diretórios que pareçam pertencer ao CasaOS depois da desinstalação?

Não. Os diretórios persistentes podem conter dados de aplicações ou do utilizador que a desinstalação intencionalmente não destruiu.