O CoolStore ainda pode ser adicionado ao CasaOS através da função Adicionar fonte da App Store, utilizando o URL ZIP atual publicado pelo repositório do CoolStore. No entanto, é uma loja de terceiros, não uma fonte selecionada pela IceWhale, por isso analise a imagem, os volumes, as portas e o responsável pela manutenção de cada aplicação antes de a instalar.
O tutorial do fórum de 2023 é agora demasiado antigo para ser utilizado como única instrução. O repositório do CoolStore publica atualmente um URL de fonte mantido, enquanto o ecossistema mais amplo de lojas de aplicações do CasaOS/ZimaOS evoluiu para protocolos de loja mais recentes e uma validação mais rigorosa.
URL atual da fonte do CoolStore
O repositório atual do projeto indica:
https://casaos-appstore.paodayag.dev/coolstore.zipO repositório CasaOS CoolStore deve ser considerado a fonte oficial de referência, em vez de uma ligação encurtada de um tutorial antigo.
Como adicionar o CoolStore ao CasaOS
- Abra o painel do CasaOS.
- Abra a App Store.
- Selecione Adicionar fonte.
- Cole o URL ZIP atual do CoolStore.
- Aguarde pela atualização da fonte.
- Confirme que as aplicações do CoolStore aparecem antes de instalar qualquer uma.
Se a opção Adicionar fonte indicar sucesso, mas não aparecerem aplicações
Atualize a página da App Store e verifique se a fonte continua registada. O CasaOS já teve problemas de compatibilidade com lojas de terceiros quando os formatos das fontes ou as raízes das lojas foram alterados, pelo que uma mensagem de sucesso nem sempre comprova que a loja foi analisada corretamente.
Não trate as aplicações de lojas de terceiros como aplicações oficiais do CasaOS
Uma loja comunitária pode disponibilizar excelente software, mas o manifesto da aplicação pode ser mantido por uma pessoa diferente do programador da aplicação original. Antes da instalação, verifique:
- a origem da imagem Docker;
- a estratégia de versões/etiquetas;
- os mapeamentos de volumes para caminhos do anfitrião;
- o modo privilegiado ou o acesso a dispositivos;
- as portas publicadas;
- o histórico de atualizações.
Prefira a documentação Docker original para aplicações críticas
Se estiver a instalar uma base de dados, um proxy inverso, um gestor de palavras-passe ou outro serviço importante, compare o manifesto do CoolStore com a documentação Docker atual do projeto original. As versões disponibilizadas por terceiros podem ficar desatualizadas após alterações importantes no projeto original.
Compreenda a nova direção das lojas de aplicações
A documentação atual para programadores da App Store da IceWhale define agora um protocolo de loja v2 mais recente, com store.json, index.json, Compose por aplicação, metadados e recursos gerados. As lojas ZIP legadas podem continuar a existir por motivos de compatibilidade, mas já não são o único formato de loja de aplicações.
A atual documentação para programadores da App Store explica a nova arquitetura das lojas.
Remover uma fonte de loja sem eliminar os dados das aplicações
A remoção de uma fonte de loja deve ser tratada separadamente da desinstalação das aplicações instaladas a partir dela. Um contentor que já esteja em execução não desaparece automaticamente só porque a fonte do catálogo foi removida.
Faça uma cópia de segurança dos dados importantes das aplicações antes de desinstalar uma aplicação disponibilizada pela comunidade.
Quando é preferível utilizar o Docker manualmente
Se uma aplicação do CoolStore estiver desatualizada ou solicitar permissões de risco, instale manualmente a definição Compose do projeto original. Assim, torna-se mais fácil auditar as etiquetas das imagens, os volumes, as redes e os segredos.
O guia de Docker personalizado disponibiliza a mesma abordagem de implementação transparente.
Faça uma cópia de segurança da aplicação antes de mudar de pacote de loja
Se já instalou uma aplicação do CoolStore e pretende substituí-la pela versão de outra loja, não parta do princípio de que ambos os manifestos utilizam os mesmos caminhos do anfitrião, variáveis de ambiente ou nomes de contentores. Exporte ou faça primeiro uma cópia de segurança dos dados persistentes da aplicação e, em seguida, compare as duas definições Compose antes de desinstalar qualquer coisa.
Como avaliar se uma entrada de loja é fiável
Verifique se a imagem Docker subjacente continua a receber atualizações, se o manifesto da loja fixa uma versão adequada e se os utilizadores recentes relatam instalações bem-sucedidas. Uma loja pode continuar acessível enquanto um pacote específico ficou silenciosamente desatualizado.
No caso de serviços sensíveis do ponto de vista da segurança, verifique também se o manifesto não solicita o modo privilegiado, a rede do anfitrião, dispositivos diretos ou montagens amplas do sistema de ficheiros sem uma justificação clara.
Perguntas frequentes
O CoolStore é uma loja oficial do CasaOS?
Não. É uma loja comunitária de terceiros.
Que URL devo utilizar?
Utilize o URL ZIP atual publicado no repositório GitHub do CoolStore, em vez de uma ligação encurtada antiga.
A adição do CoolStore irá modificar o próprio CasaOS?
Adiciona outra fonte de catálogo de aplicações. As aplicações individuais podem continuar a solicitar portas, volumes, privilégios ou acesso ao anfitrião, por isso analise cada manifesto separadamente.
E se uma aplicação do CoolStore estiver desatualizada?
Utilize a documentação Docker/Compose do projeto original ou outro pacote de loja mantido, em vez de forçar a utilização de um manifesto antigo.
