O ZimaOS atual permite ativar o SSH diretamente a partir da interface Web. O tutorial da comunidade foi originalmente criado com base num processo mais antigo que exigia um monitor e um teclado ligados, mas foi posteriormente atualizado para o ZimaOS 1.2.5 e assinalou explicitamente esse processo original como obsoleto.
Num sistema atual, o caminho normal é Definições > Modo de programador > Acesso SSH. O ZimaOS também disponibiliza um Terminal baseado na Web na mesma área orientada para programadores, pelo que muitas tarefas da linha de comandos já não requerem um monitor externo nem um cliente SSH separado.
Como ativar o SSH no ZimaOS atual
O tutorial atualizado da IceWhale apresenta três passos:
- Abra as Definições.
- Aceda a Modo de programador.
- Mude Acesso SSH para Ativado.
O guia SSH do ZimaOS atual documenta o mesmo processo através do Modo de programador e foi atualizado em agosto de 2026.
Como ligar depois de ativar o SSH
A partir de outro computador na mesma rede fidedigna, utilize um cliente SSH e o endereço IP da LAN do servidor ZimaOS:
ssh USERNAME@ZIMAOS_LAN_IP
O nome de utilizador e o método de autenticação exatos dependem da conta que pretende utilizar. A documentação SSH atual do ZimaOS indica que as contas de utilizador do ZimaOS podem ser utilizadas para iniciar sessão, enquanto o acesso root tem um processo separado de definição da palavra-passe. Não parta do princípio de que existe uma única palavra-passe root predefinida universal.
Mantenha o SSH limitado a redes fidedignas, a menos que configure intencionalmente uma camada segura de acesso remoto. Ativar o SSH na interface não significa que deva reencaminhar diretamente a porta 22 do router para a Internet pública.
Utilizar o terminal Web integrado sem um cliente SSH separado
O tutorial da comunidade atualizado também mostra um interruptor para o Terminal baseado na Web. Isto permite aos administradores aceder a uma shell a partir da interface do navegador do ZimaOS, sem abrir uma aplicação de terminal separada noutro computador.
A palavra-passe de root e o acesso SSH estão relacionados, mas não são idênticos
Uma referência atual da ZimaSpace sobre SSH afirma que a palavra-passe root tem de ser criada através do processo de configuração na consola local quando a autenticação root for necessária, embora também seja possível utilizar contas de utilizador do ZimaOS para iniciar sessão por SSH. Isto significa que ativar o botão Acesso SSH não cria magicamente uma credencial root universal.
Se o seu objetivo for a administração de rotina, utilize a conta com menos privilégios que permita executar a tarefa e eleve os privilégios apenas quando necessário. Evite ativar o início de sessão remoto como root apenas por conveniência.
Para obter informações atuais sobre o comportamento das credenciais e as opções de terminal, consulte a documentação de configuração do SSH do ZimaOS.
O método antigo do monitor, Alt+F2 e passwd-root está obsoleto
A publicação da comunidade preserva um procedimento mais antigo, mas coloca-o sob um aviso claro “O seguinte está obsoleto”. Esse fluxo de trabalho histórico exigia:
- ligar um monitor e um teclado;
- mudar para uma consola com
Alt + F2; - iniciar sessão como
root; - executar o procedimento histórico
passwd-roothelper; - e, em seguida, ativar o SSH.
Não apresente essa sequência como o procedimento de primeira linha para uma instalação atual do ZimaOS. O botão de alternância adicionado no ZimaOS 1.2.5 foi criado especificamente para eliminar esse inconveniente para a maioria dos utilizadores.
Por que motivo o ZimaOS transferiu o SSH para a IU Web
As respostas documentam claramente a decisão relativa ao produto. Os utilizadores queixaram-se de que configurar o acesso root através de um monitor local era inconveniente, especialmente em hardware NAS sem monitor. Inicialmente, a IceWhale explicou que essa dificuldade adicional se destinava a proteger a segurança do SSH, mas afirmou depois que a equipa estava a trabalhar numa abordagem mais conveniente.
Quando outro utilizador sugeriu adicionar diretamente à IU Web controlos para ativar/desativar o SSH, o autor da IceWhale respondeu que a funcionalidade chegaria na versão seguinte. A publicação original foi posteriormente atualizada com o fluxo de trabalho do Modo de Programador do ZimaOS 1.2.5.
E se não tiver um monitor?
Antes de existir o terminal do Modo de Programador integrado, a comunidade sugeria instalar o ttydBridge a partir da Loja de Aplicações do ZimaOS quando a IU Web já estava acessível. A documentação atual do ZimaOS continua a indicar o ttydBridge como outra opção de acesso ao terminal, mas o Terminal Web integrado é agora mais simples para muitos utilizadores.
Se o botão de alternância do terminal nativo estiver disponível na sua versão atual do ZimaOS, utilize-o antes de adicionar outra aplicação apenas para aceder a uma shell.
Existe uma palavra-passe root predefinida do ZimaOS?
Mais tarde, a comunidade recebeu uma pergunta de um utilizador que não conseguia autenticar-se no Terminal baseado na Web e pediu uma palavra-passe root predefinida. A discussão não fornece credenciais root predefinidas universais. A documentação atual do ZimaOS descreve antes uma configuração explícita da conta e da palavra-passe.
Não copie credenciais antigas do CasaOS ou de dispositivos semelhantes para o ZimaOS presumindo que funcionarão. Um início de sessão SSH falhado pode resultar do nome de utilizador incorreto, de uma palavra-passe root que nunca foi criada, do acesso SSH desativado ou de uma conta que não tem permissão para autenticar remotamente.
O SSH não substitui todos os procedimentos de recuperação de fábrica
Uma resposta de 2025 perguntava como repor as definições de fábrica de um ZimaBoard antigo sem um ecrã, quando a autenticação SSH não estava disponível. Um membro da equipa IceWhale indicou a documentação de recuperação e afirmou que esse procedimento de recuperação específico continuava a exigir um ecrã.
Quando um ZimaBoard antigo aparece no conteúdo atual da Loja, a via de migração do produto é o servidor de placa única ZimaBoard 2 atual. A ligação do produto não implica que as instruções de recuperação do hardware antigo e do produto atual sejam idênticas.
Lista de verificação de segurança do SSH para o ZimaOS
- Ative o SSH apenas quando precisar de acesso remoto à shell.
- Utilize uma palavra-passe única e forte ou a autenticação suportada baseada em chaves para a conta.
- Não presuma que o root tem uma palavra-passe predefinida.
- Prefira uma conta de utilizador normal do ZimaOS para tarefas de rotina, quando suportado.
- Não exponha diretamente a porta 22 à Internet pública sem um plano de segurança deliberado.
- Desative novamente o SSH se o serviço já não for necessário.
- Mantenha o ZimaOS atualizado para que o Modo de programador e o comportamento da autenticação correspondam à documentação atual.
Perguntas frequentes sobre o SSH do ZimaOS
Onde ativo o SSH no ZimaOS?
Nas versões atuais do ZimaOS, abra Definições > Modo de programador e ative Acesso SSH. Este é o procedimento atual introduzido com o ZimaOS 1.2.5.
Ainda preciso de um monitor para ativar o SSH?
Não para a opção normal atual Acesso SSH, quando a interface Web do ZimaOS está disponível. O procedimento antigo de ativação através de monitor e teclado, descrito na publicação original da comunidade, está explicitamente marcado como obsoleto. Alguns cenários de recuperação ou relacionados com a palavra-passe root podem continuar a exigir acesso separado à consola local.
Qual é a diferença entre o Terminal Web e o SSH?
O Terminal Web fornece acesso à shell através da interface do ZimaOS no navegador. O SSH permite que outro cliente SSH estabeleça ligação através da rede. Ambos permitem o acesso à linha de comandos, mas utilizam vias de acesso diferentes e podem ter contextos de autenticação distintos.
Qual é a palavra-passe root predefinida?
A fonte não fornece uma palavra-passe root predefinida universal e a documentação atual do ZimaOS descreve, em vez disso, uma configuração explícita da conta. Não dependa de credenciais predefinidas presumidas.
Ainda preciso do ttydBridge?
Normalmente, não, se a sua versão atual do ZimaOS disponibilizar o Terminal Web integrado e este satisfizer as suas necessidades. O ttydBridge continua a ser uma opção alternativa de acesso ao terminal documentada pela ZimaSpace.
