Solução da comunidade

Ambiente local do Portainer em falta no CasaOS após o Docker 29: pressão no disco, compatibilidade da API e recuperação

A November 2025 ZimaBlade post where a nearly full Debian/CasaOS system was also upgraded from Docker 28.5.2 to Docker 29.0.0. Portainer could no longer open its Local environment, an older Docker 24 CLI was rejected because API 1.43 was below the server minimum 1.44, and after reboot CasaOS appeared to lose its apps. The thread contains no confirmed final root cause.

Esta fonte contém várias falhas que ocorreram num curto espaço de tempo, pelo que não deve ser reescrita como um simples “erro do Portainer”. O disco do sistema tinha quase todo o espaço livre esgotado, o Docker e o containerd foram atualizados para versões principais mais recentes através do Debian, um teste com uma versão antiga da CLI do Docker foi rejeitado pelo daemon Docker 29, o Portainer perdeu o ambiente Local, o CasaOS continuou a mostrar “a carregar aplicações” e, posteriormente, um problema de arranque fez com que o painel parecesse quase uma instalação nova.

Nenhuma resposta na fonte confirma uma causa-raiz final. A interpretação mais segura é a de um problema de recuperação em várias camadas: preservar primeiro os dados existentes; depois identificar qual o sistema de arranque/sistema de ficheiros raiz ativo, se a raiz de dados do Docker ainda existe, se o daemon está saudável e se o Portainer/CasaOS são compatíveis com a API Docker atualizada.

O Disco do Sistema Já Estava Sob Forte Pressão de Espaço

O utilizador tinha apenas cerca de 1 GB livre num sistema de ficheiros raiz de 27 GB antes da limpeza. Entre os maiores consumidores estavam os dados overlay do Docker, os metadados do Jellyfin, os registos do sistema e os pacotes de desenvolvimento.

Pouco espaço livre pode fazer com que as operações de imagens/contentores do Docker, bases de dados, registos e serviços do CasaOS se comportem de forma imprevisível. Libertar espaço era necessário, independentemente do problema posterior da API do Docker.

A Atualização do Anfitrião Alterou o Docker de 28.x para 29.0.0

O histórico de pacotes do Debian mostrou atualizações de:

  • docker-ce;
  • docker-ce-cli;
  • containerd.io;
  • extras rootless do Docker.

Uma atualização principal do Docker Engine pode revelar problemas de compatibilidade em ferramentas de gestão que incluem ou negoceiam clientes de API mais antigos.

A Fonte Registou uma Incompatibilidade Real de Versões da API do Docker

Um contentor da CLI Docker 24.0.5 devolveu:

client version 1.43 is too old.
Minimum supported API version is 1.44

Essa mensagem é uma prova direta de que pelo menos um cliente antigo já não conseguia comunicar com o daemon Docker atualizado. Por si só, não prova que o Portainer utilizasse exatamente essa versão do cliente, mas torna a compatibilidade da API numa verificação prioritária.

O Facto de o Portainer Mostrar Local como Ativo e Depois o Perder É um Sintoma da Camada de Gestão

A fonte tentou recriar um ambiente Docker local através de /var/run/docker.sock, sem sucesso. Antes de eliminar o estado do Portainer, verifique:

docker info
docker ps
ls -l /var/run/docker.sock

Se a CLI do Docker funcionar, mas o Portainer não, concentre-se na versão do Portainer, na API e no acesso ao socket. Se o próprio Docker falhar, corrija primeiro o daemon.

“A Carregar Aplicações” no CasaOS Sugere que a Falha Era Mais Abrangente do que o Portainer

O CasaOS também teve dificuldades em enumerar aplicações. Isso pode acontecer se o Docker estiver indisponível, se a API do Docker tiver mudado de forma incompatível, se a raiz de dados do daemon estiver em falta ou se o anfitrião iniciado já não corresponder ao estado esperado do sistema.

O Evento Posterior “Selecionar Dispositivo de Arranque Adequado” Altera a Prioridade da Recuperação

Após um reinício, a máquina deixou de arrancar normalmente até o utilizador alterar a seleção de arranque. Quando voltou a arrancar, o CasaOS não tinha aplicações, embora o disco rígido de grande capacidade continuasse ligado.

Isso levanta a possibilidade de ter sido selecionado outro disco de arranque/sistema de ficheiros raiz ou de a partição/estado do sistema ter mudado. A fonte não prova qual destas situações ocorreu.

Preserve os Dados das Aplicações Antes de Reinstalar o CasaOS

O utilizador dava sobretudo importância a:

  • ficheiros de projetos em /home/casaos;
  • metadados do Jellyfin no AppData;
  • ficheiros multimédia no disco rígido;
  • configuração do Docker/CasaOS, quando recuperável.

Copie essas pastas persistentes para outro disco/sistema antes de reinstalar ou repor o Docker. Normalmente, recriar contentores é mais fácil do que recriar bases de dados e metadados de aplicações.

Não Faça uma Limpeza Agressiva do Docker sem Saber o que Ainda Está a Ser Referenciado

A remoção de imagens não utilizadas pode libertar espaço, mas eliminar volumes ou diretórios da raiz de dados pode remover o estado das aplicações que está a tentar salvar. Identifique primeiro os contentores, volumes, montagens bind e caminhos do AppData.

Considere as Atualizações do Debian e do Docker como Parte da Plataforma CasaOS

O CasaOS funciona sobre o anfitrião Linux subjacente. Uma atualização ampla com apt upgrade pode atualizar o Docker, o kernel, o systemd, a rede e os pacotes de armazenamento dos quais o CasaOS depende. Teste deliberadamente as atualizações principais do anfitrião e mantenha uma cópia de segurança do sistema/aplicações antes de as aplicar a um NAS funcional.

Perguntas Frequentes sobre a Recuperação do Portainer/CasaOS

A fonte provou que o Docker 29, por si só, causou todas as falhas?

Não. O sistema também estava quase sem espaço e, mais tarde, surgiu um problema relacionado com o dispositivo de arranque/estado do sistema.

Foi confirmada uma incompatibilidade da API do Docker?

Sim. Uma CLI Docker 24 que utilizava a API 1.43 foi rejeitada porque o daemon Docker 29 exigia, no mínimo, a versão 1.44.

O utilizador deve reinstalar o CasaOS antes de copiar o AppData?

Não. Preserve primeiro o AppData importante, os ficheiros do diretório pessoal e os ficheiros multimédia, sempre que os discos continuem acessíveis.