Solução da comunidade

Como encontrar a palavra-passe do Crafty Controller no CasaOS

A CasaOS community note identifies the Crafty Controller credentials file under the Crafty app data directory and asks how the generated admin password should be changed.

Se o Crafty Controller estiver instalado a partir da App Store do CasaOS e não souber a palavra-passe do primeiro início de sessão, a palavra-passe não é uma predefinição universal como admin/admin. As versões modernas do Crafty geram uma palavra-passe de administrador aleatória e armazenam as credenciais iniciais num ficheiro de texto dentro do diretório de dados da aplicação Crafty.

A publicação de 2024 da comunidade IceWhale identificou a localização importante como DATA > AppData > crafty > config > default-creds.txt. A documentação atual do Crafty confirma a mesma ideia para o CasaOS e acrescenta uma correção importante: não edite default-creds.txt para alterar a sua palavra-passe. Esse ficheiro serve para consultar as credenciais iniciais geradas; não controla a palavra-passe ativa da conta depois de o Crafty arrancar.

Onde está a palavra-passe do Crafty Controller no CasaOS?

Abra a aplicação Ficheiros do CasaOS e navegue até ao diretório de dados da aplicação utilizado pela sua instalação do Crafty. A publicação original da comunidade indicava este caminho:

DATA
└── AppData
    └── crafty
        └── config
            └── default-creds.txt

A documentação oficial atual do Crafty descreve o caminho no CasaOS através da aplicação Ficheiros como a pasta APP_DATA pasta, depois o diretório do Crafty, o diretório app/config e, por fim, default-creds.txt. A capitalização exata ou as pastas intermédias podem variar se a definição da aplicação CasaOS tiver sido alterada ou se tiver personalizado o mapeamento do armazenamento da aplicação.

A documentação oficial de acesso ao painel do Crafty confirma que as credenciais geradas são armazenadas em default-creds.txt.

O que contém default-creds.txt?

Nas instalações atuais do Crafty 4, o ficheiro contém os dados de início de sessão administrativos iniciais. A documentação de instalação do Crafty para CasaOS descreve:

  • Nome de utilizador: normalmente admin.
  • Palavra-passe: uma palavra-passe gerada aleatoriamente para a instalação.

O Crafty deixou de usar palavras-passe predefinidas estáticas comuns porque uma palavra-passe administrativa previsível não é segura. O registo de alterações do Crafty 4 documenta a mudança para uma palavra-passe aleatória obrigatória na primeira execução.

Abra o ficheiro apenas num sistema local de confiança e evite publicar o seu conteúdo em capturas de ecrã ou discussões da comunidade. Qualquer pessoa que tenha a palavra-passe ativa de administrador pode potencialmente controlar servidores Minecraft, ficheiros, scripts e outras funções geridas pelo Crafty.

Não altere a palavra-passe editando default-creds.txt

Esta é a adição mais importante à publicação curta da comunidade. A documentação oficial do Crafty para CasaOS avisa explicitamente que default-creds.txt **não** controla a palavra-passe. Editar o ficheiro de texto após a instalação não atualizará de forma segura a palavra-passe armazenada pelo sistema de autenticação do Crafty.

Considere o ficheiro como uma nota de transferência da instalação:

  1. O Crafty gera a credencial inicial do administrador.
  2. O valor gerado é escrito em default-creds.txt para que o administrador possa iniciar sessão.
  3. Depois de iniciar sessão, as alterações de palavra-passe são geridas pelo próprio Crafty.

Não elimine a base de dados do Crafty nem recrie todo o contentor apenas porque pretende alterar uma palavra-passe de administrador que está a funcionar.

Como alterar a palavra-passe do Crafty depois de iniciar sessão

A documentação atual de gestão de utilizadores do Crafty coloca a administração de utilizadores e funções em Definições do painel. As versões atuais do Crafty disponibilizam controlos de gestão de contas no painel web, em vez de pedir aos utilizadores que editem o ficheiro de texto das credenciais.

Depois de iniciar sessão com as credenciais de administrador geradas:

  1. Abra o painel web do Crafty.
  2. Aceda a Definições do painel.
  3. Abra a área de gestão de utilizadores ou de contas.
  4. Selecione a conta de administrador ou o seu próprio perfil de utilizador.
  5. Utilize o controlo de alteração de palavra-passe disponibilizado pela versão do Crafty instalada.
  6. Guarde a nova palavra-passe e confirme que consegue iniciar sessão novamente antes de fechar a sessão atual.

A interface do Crafty mudou ao longo das versões 4 do Crafty, pelo que o ícone ou o nome exato da caixa de diálogo podem variar. O atual guia de configuração de utilizadores e funções do Crafty é a melhor referência para a interface numa versão moderna.

As versões mais recentes do Crafty também melhoram os fluxos de reposição de palavras-passe

O Crafty continuou a melhorar a gestão de contas após a publicação original sobre o CasaOS, em 2024. Em 2026, o projeto Crafty acrescentou funcionalidades relacionadas com palavras-passe temporárias, controlos de reposição de palavras-passe e alterações obrigatórias de palavras-passe. Essa é outra razão para não considerar o ficheiro original de credenciais como o mecanismo de gestão de palavras-passe a longo prazo.

Se a sua versão atual do Crafty disponibilizar uma caixa de diálogo dedicada para repor a palavra-passe de outra conta, utilize esse fluxo administrativo autenticado em vez de modificar ficheiros no contentor. Para a sua própria conta, utilize o controlo de alteração de palavra-passe disponível no painel.

E se o caminho do CasaOS for diferente?

Os caminhos das aplicações no CasaOS podem variar quando uma aplicação é importada manualmente, movida para outro disco ou instalada a partir de uma loja de aplicações não normalizada. Se não encontrar o caminho exato da comunidade, inspecione os mapeamentos de volumes da aplicação Crafty no CasaOS e localize o diretório do anfitrião que está associado ao armazenamento de configuração do Crafty.

O ficheiro que procura continua a chamar-se:

default-creds.txt

Não efetue uma pesquisa abrangente de ficheiros acessível através da Internet nem exponha o ficheiro através de uma pasta partilhada. Pesquise apenas no diretório de dados local da aplicação Crafty.

E quanto a uma instalação normal do Crafty no Linux?

O título da comunidade diz Linux, enquanto a própria publicação utiliza um caminho ao estilo do CasaOS. A documentação oficial do Crafty também fornece um exemplo para Linux. Numa instalação Linux padrão, é apresentado um comando semelhante a:

sudo cat /var/opt/minecraft/crafty/crafty-4/app/config/default-creds.txt

O seu caminho real pode ser diferente se o Crafty tiver sido instalado noutro local. Utilize o caminho correspondente à sua implementação, em vez de copiar o exemplo cegamente.

O acesso ao painel do Crafty pode utilizar HTTPS

O Crafty Controller é uma interface de gestão com privilégios elevados sobre servidores de jogos e ficheiros. Mantenha-o restrito a redes de confiança ou a uma camada de acesso remoto devidamente protegida. Se a sua implementação disponibilizar o painel através de HTTPS com um certificado local, o seu navegador poderá apresentar um aviso de certificado até configurar um certificado em que confie.

Não exponha diretamente o painel de administração do Crafty à Internet pública, protegido apenas pela palavra-passe gerada para o primeiro início de sessão. Altere a palavra-passe depois do primeiro início de sessão e utilize os controlos de acesso compatíveis com a sua rede e a versão atual do Crafty.

Lista de verificação para recuperar a palavra-passe do Crafty

  1. Abra a aplicação Ficheiros do CasaOS.
  2. Localize o diretório de dados da aplicação Crafty.
  3. Abra config/default-creds.txt.
  4. Utilize o admin as credenciais para iniciar sessão.
  5. Não edite default-creds.txt para alterar a palavra-passe ativa.
  6. Abra as Definições do painel ou o ecrã de gestão da conta do Crafty.
  7. Altere a palavra-passe do administrador através da interface autenticada do Crafty.
  8. Guarde a nova palavra-passe num gestor de palavras-passe.
  9. Mantenha o painel do Crafty restrito a utilizadores e redes de confiança.

Perguntas frequentes sobre a palavra-passe do Crafty Controller

Qual é a palavra-passe predefinida do Crafty Controller?

As versões modernas do Crafty 4 geram uma palavra-passe inicial aleatória para o administrador, em vez de utilizarem uma palavra-passe universal. Obtenha-a em default-creds.txt no diretório de configuração do Crafty.

Qual é o nome de utilizador predefinido do Crafty?

A documentação oficial do Crafty identifica a conta de administrador gerada como admin para o fluxo de instalação padrão.

Posso alterar a minha palavra-passe do Crafty editando default-creds.txt?

Não. A documentação do Crafty para CasaOS avisa especificamente que o ficheiro não controla a palavra-passe. Utilize os controlos de gestão da conta ou da palavra-passe no painel web do Crafty.

E se default-creds.txt estiver em falta?

Primeiro, confirme o mapeamento atual dos volumes da aplicação e o diretório de configuração. Uma instalação personalizada do CasaOS pode colocar os dados do Crafty noutro local que não seja o caminho AppData padrão. Confirme também que está a consultar a instância correta do Crafty, e não um diretório antigo ou não utilizado de dados da aplicação.

Devo alterar a palavra-passe gerada?

Sim. A documentação atual do Crafty recomenda alterar a palavra-passe gerada depois de iniciar sessão com sucesso. Utilize uma palavra-passe forte e exclusiva e guarde-a de forma segura.