La versión actual de ZimaOS permite activar SSH directamente desde la interfaz web. El tutorial de la comunidad se creó originalmente para un proceso más antiguo que requería una pantalla y un teclado conectados, pero posteriormente se actualizó para ZimaOS 1.2.5 y señaló explícitamente que ese flujo original había quedado obsoleto.
En un sistema actual, la ruta normal es Ajustes > Modo de desarrollador > Acceso SSH. ZimaOS también ofrece un Terminal basado en la web desde la misma sección orientada a desarrolladores, por lo que muchas tareas de línea de comandos ya no requieren un monitor externo ni un cliente SSH independiente.
Cómo activar SSH en la versión actual de ZimaOS
El tutorial actualizado de IceWhale indica tres pasos:
- Abre Ajustes.
- Ve a Modo de desarrollador.
- Cambia Acceso SSH a Activado.
La guía de SSH de ZimaOS actual documenta el mismo flujo del Modo de desarrollador y se actualizó en agosto de 2026.
Cómo conectarse después de activar SSH
Desde otro ordenador de la misma red de confianza, utiliza un cliente SSH y la IP de la red local del servidor ZimaOS:
ssh USERNAME@ZIMAOS_LAN_IPEl nombre de usuario exacto y el método de autenticación dependen de la cuenta que quieras utilizar. La documentación actual de SSH de ZimaOS indica que las cuentas de usuario de ZimaOS pueden utilizarse para iniciar sesión, mientras que el acceso root tiene una configuración de contraseña independiente. No des por sentado que existe una única contraseña root predeterminada universal.
Mantén SSH limitado a redes de confianza, a menos que configures intencionadamente una capa segura de acceso remoto. Activar SSH en la interfaz no significa que debas reenviar directamente el puerto 22 de tu router a Internet pública.
Usar el terminal web integrado sin un cliente SSH independiente
El tutorial actualizado de la comunidad también muestra un interruptor para el Terminal basado en la web. Esto permite a los administradores acceder a un shell desde la interfaz del navegador de ZimaOS sin abrir una aplicación de terminal independiente en otro ordenador.
La contraseña de root y el acceso SSH están relacionados, pero no son idénticos
Una referencia actual de ZimaSpace sobre SSH indica que la contraseña raíz debe crearse mediante el proceso de configuración de la consola local cuando se requiere autenticación como root, mientras que las cuentas de usuario de ZimaOS también pueden utilizarse para iniciar sesión mediante SSH. Esto significa que activar el interruptor de acceso SSH no crea mágicamente una credencial raíz universal.
Si tu objetivo es realizar tareas administrativas habituales, usa la cuenta con menos privilegios que permita llevarlas a cabo y eleva los privilegios solo cuando sea necesario. Evita activar el inicio de sesión remoto como root únicamente por comodidad.
Para conocer el comportamiento actual de las credenciales y las opciones de terminal, consulta la documentación de configuración de SSH de ZimaOS.
El método antiguo del monitor, Alt+F2 y passwd-root está obsoleto
La publicación de la comunidad conserva un procedimiento antiguo, pero lo coloca bajo un aviso claro de «Lo siguiente está obsoleto». Ese flujo de trabajo histórico requería:
- conectar un monitor y un teclado;
- cambiar a una consola con
Alt + F2; - iniciar sesión como
root; - ejecutar el procedimiento histórico
passwd-roothelper; - y después activar SSH.
No presentes esa secuencia como el procedimiento principal para una instalación actual de ZimaOS. El interruptor de la interfaz añadido en ZimaOS 1.2.5 se creó específicamente para eliminar esa inconveniencia para la mayoría de los usuarios.
Por qué ZimaOS trasladó SSH a la interfaz web
Las respuestas documentan claramente la decisión del producto. Los usuarios se quejaban de que configurar el acceso raíz mediante un monitor local era incómodo, especialmente en hardware NAS sin pantalla. IceWhale explicó inicialmente que esa fricción adicional tenía como objetivo proteger la seguridad de SSH y después indicó que el equipo estaba trabajando en un enfoque más cómodo.
Cuando otro usuario sugirió añadir controles para activar o desactivar SSH directamente en la interfaz web, el autor de IceWhale respondió que la función llegaría en la siguiente versión. Más tarde, la publicación original se actualizó con el flujo de trabajo del Modo de desarrollador de ZimaOS 1.2.5.
¿Qué ocurre si no tienes monitor?
Antes de que existiera la terminal del Modo de desarrollador integrada, la comunidad sugería instalar ttydBridge desde la tienda de aplicaciones de ZimaOS cuando la interfaz web ya era accesible. La documentación actual de ZimaOS todavía incluye ttydBridge como otra opción de acceso a la terminal, pero la Terminal web integrada ahora es más sencilla para muchos usuarios.
Si el interruptor de la terminal nativa está disponible en tu versión actual de ZimaOS, úsalo antes de añadir otra aplicación solo para acceder a un shell.
¿Existe una contraseña raíz predeterminada de ZimaOS?
Más tarde, la comunidad recibió una pregunta de un usuario que no podía autenticarse en la Terminal web y solicitaba una contraseña raíz predeterminada. El hilo no proporciona una credencial raíz predeterminada universal. La documentación actual de ZimaOS describe, en cambio, una configuración explícita de la cuenta y la contraseña.
No copies credenciales antiguas de CasaOS o de un dispositivo y las uses en ZimaOS suponiendo que funcionarán. Un inicio de sesión SSH fallido puede deberse a un nombre de usuario incorrecto, a una contraseña raíz que nunca se ha creado, al acceso SSH desactivado o a una cuenta que no tiene permitido autenticarse de forma remota.
SSH no sustituye todos los procedimientos de recuperación de fábrica
Una respuesta de 2025 preguntaba cómo restablecer a los valores de fábrica un ZimaBoard antiguo sin pantalla cuando la autenticación SSH no estaba disponible. Un miembro del equipo de IceWhale señaló la documentación de recuperación y dijo que ese flujo de recuperación específico aún requería una pantalla.
Cuando aparece un ZimaBoard antiguo en el contenido actual de la tienda, la ruta de migración del producto es el servidor de placa única ZimaBoard 2 actual. El enlace del producto no implica que las instrucciones de recuperación para el hardware antiguo y el producto actual sean idénticas.
Lista de comprobación de seguridad de SSH para ZimaOS
- Activa SSH solo cuando necesites acceso remoto al shell.
- Usa una contraseña única y segura o la autenticación compatible mediante claves para la cuenta.
- No supongas que root tiene una contraseña predeterminada.
- Prefiere una cuenta de usuario normal de ZimaOS para las tareas habituales, cuando sea compatible.
- No expongas directamente el puerto 22 a Internet público sin un diseño de seguridad deliberado.
- Vuelve a desactivar SSH si el servicio ya no es necesario.
- Mantén ZimaOS actualizado para que el Modo de desarrollador y el comportamiento de autenticación coincidan con la documentación actual.
Preguntas frecuentes sobre SSH en ZimaOS
¿Dónde activo SSH en ZimaOS?
En las versiones actuales de ZimaOS, abre Configuración > Modo de desarrollador y activa Acceso SSH. Este es el flujo actual introducido con ZimaOS 1.2.5.
¿Sigo necesitando un monitor para activar SSH?
No para el interruptor normal actual de acceso SSH cuando la interfaz web de ZimaOS está disponible. El flujo de activación antiguo mediante monitor y teclado de la publicación original de la comunidad está marcado explícitamente como obsoleto. Algunos escenarios de recuperación o relacionados con la contraseña raíz aún pueden requerir una consola local por separado.
¿Cuál es la diferencia entre el Terminal web y SSH?
El Terminal web proporciona acceso al shell dentro de la interfaz del navegador de ZimaOS. SSH permite que otro cliente SSH se conecte a través de la red. Ambos ofrecen acceso a la línea de comandos, pero utilizan diferentes vías de acceso y pueden tener distintos contextos de autenticación.
¿Cuál es la contraseña raíz predeterminada?
La fuente no proporciona una contraseña raíz predeterminada universal, y la documentación actual de ZimaOS describe una configuración explícita de la cuenta. No dependas de credenciales predeterminadas adivinadas.
¿Sigo necesitando ttydBridge?
Por lo general, no, si tu versión actual de ZimaOS ofrece el Terminal web integrado y satisface tus necesidades. ttydBridge sigue siendo una opción alternativa de acceso al terminal documentada por ZimaSpace.
