Usa la interfaz web de ZimaOS para los cambios de puerto habituales
El tutorial oficial de la comunidad indica que, normalmente, el puerto del panel de ZimaOS debe cambiarse desde la interfaz web. El procedimiento de la CLI que aparece a continuación está pensado para situaciones de emergencia o recuperación, como cuando el puerto se cambió accidentalmente o un cambio intencionado hizo que el panel dejara de estar disponible.
Cuándo resulta útil el método de recuperación mediante la CLI
El tutorial identifica dos casos habituales: el puerto del panel se cambió por error o se cambió intencionadamente y la nueva configuración ya no funciona como se esperaba. El objetivo de recuperación es el puerto 80, con la finalidad de restablecer el acceso al panel de ZimaOS.
Este tutorial se publicó en abril de 2025. Las rutas de configuración y los nombres de los servicios pueden cambiar en versiones posteriores, por lo que debes confirmar el comportamiento actual en la página actual de ZimaOS antes de usar este procedimiento histórico de recuperación en una versión considerablemente más reciente.
Restablece el puerto del panel desde la CLI local
Este procedimiento modifica un archivo de configuración del sistema y reinicia un servicio de ZimaOS. Anota la configuración actual antes de editarla y asegúrate de tener una copia de seguridad de los datos importantes antes de realizar tareas de recuperación a nivel del sistema.
1. Conecta un teclado y un monitor
El tutorial comienza con acceso físico directo a la máquina con ZimaOS. Conecta un teclado y un monitor para poder trabajar localmente aunque el panel no esté disponible a través de la red.
2. Abre la CLI y cambia a root
Pulsa Alt + F3 para cambiar a la interfaz de línea de comandos, inicia sesión y, a continuación, eleva los privilegios a root:
sudo -i3. Abre la configuración de la puerta de enlace
Usa el editor VI para abrir el archivo de configuración de la puerta de enlace:
vi /etc/casaos/gateway.iniBusca la línea que define el puerto del panel. El tutorial utiliza un valor cambiado como el siguiente:
port = 8080Restablécelo a:
port = 80Para guardar el archivo en VI, pulsa Esc, escribe :wq y pulsa Intro.
4. Reinicia el servicio de puerta de enlace de ZimaOS
Aplica el cambio de configuración reiniciando el servicio de puerta de enlace:
systemctl restart zimaos-gateway.serviceDespués de que se reinicie el servicio, intenta abrir de nuevo el panel usando el puerto restaurado.
Por qué se utiliza el puerto 80 en este tutorial
La guía de recuperación restablece específicamente el panel al puerto 80 como objetivo conocido para recuperar el acceso. Esto no significa que todas las implementaciones deban usar permanentemente el puerto 80; una vez restaurado el acceso, la administración habitual del puerto debe realizarse mediante la interfaz web descrita en el tutorial.
Preguntas frecuentes
¿Debo usar la CLI cada vez que quiera cambiar el puerto del panel de ZimaOS?
No. El tutorial presenta explícitamente la interfaz web como el método habitual y el flujo de trabajo mediante la CLI como una opción de emergencia o recuperación.
¿Qué archivo de configuración edita el tutorial?
El procedimiento de abril de 2025 edita /etc/casaos/gateway.ini. Como esta es una ruta del sistema específica de una versión, verifícala antes de aplicar el mismo paso a una versión más reciente de ZimaOS.
¿Qué servicio se reinicia después de cambiar el puerto?
El tutorial reinicia zimaos-gateway.service con systemctl para que la nueva configuración de la puerta de enlace surta efecto.
¿Qué debo hacer si el panel sigue sin cargarse?
El tutorial original no proporciona una secuencia de diagnóstico más detallada después de reiniciar la puerta de enlace. Evita cambiar repetidamente otros ajustes del sistema que no estén relacionados; en su lugar, confirma las indicaciones de ZimaOS específicas de tu versión y solicita asistencia proporcionando el puerto exacto, la configuración y el estado del servicio que hayas observado.
