📖 Guía de instalación
TizonaHub puede instalarse en sistemas Windows y Linux.
Ten en cuenta que el equipo donde realices la instalación actuará como servidor, por lo que podrás acceder a TizonaHub desde cualquier otro dispositivo conectado a la misma red a través del navegador.
🪟Windows
⚠️ Es importante establecer la red como Privada para que el resto de dispositivos puedan identificar al servidor. Para ello, ve a CONFIGURACIÓN > Red e Internet > Wi-Fi > Tu red y establece la red como privada:
- Descarga y ejecuta TizonaHubInstaller.
- Tal vez necesites hacer algunos ajustes en tu base de datos. Ver.
⚠️ Nota: Al ejecutar este instalador en Windows, puede que aparezca una advertencia de seguridad de SmartScreen. Esto ocurre porque el archivo no está firmado digitalmente. Puedes continuar haciendo clic en “Más información” > “Ejecutar de todas formas”. Haz clic aquí para más información.
🐧 Linux (Ubuntu-based distributions)
El instalador de TizonaHub está diseñado para funcionar únicamente en distribuciones basadas en Ubuntu, incluyendo Ubuntu, Ubuntu Server y Linux Mint. Si utilizas una distribución de Linux diferente, puede que tengas que realizar una instalación manual adaptada a tu entorno..
- Descarga el script de instalación (es necesario tener Python instalado). Haz clic aquí para descargar.
- Descomprime la descarga, abre una terminal y ejecuta el instalador con Python (python3 script.py).
- Ejecuta el instalador. Es muy probable que necesites ejecutar el siguiente comando:
ALTER USER 'dbUser'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
FLUSH PRIVILEGES;Esto permite al servidor usar el usuario de la base de datos que has indicado en la instalación. Sustituye dbUser por tu usuario y your_password por tu contraseña.
🗒️Variables de entorno
Podrás modificar estas variables en el archivo .env, dentro del directorio TizonaServer.
🔐 Compatibilidad con MySQL y el método de autenticación
TizonaHub utiliza conectores ampliamente soportados como pymysql en Python y mysql2 en Node.js. Por motivos de compatibilidad, estos conectores requieren que el usuario de base de datos utilice el método de autenticación clásico de MySQL, conocido como mysql_native_password.
🤔 ¿Por qué es esto necesario?
Desde MySQL 8, el instalador oficial de MySQL crea el usuario root usando un método más moderno llamado caching_sha2_password .
Este nuevo plugin ofrece mayor seguridad, pero
no es compatible
con varios conectores comunes, lo que impide establecer una conexión adecuada, incluso si la contraseña es correcta. Probablemente necesitarás realizar algunas configuraciones, tanto si estás siguiendo la guía del instalador como si ya tienes una base de datos configurada.
✅ ¿Cómo evitar este problema?
Durante la instalación de MySQL:
Cuando se solicite la contraseña para el usuario root asegúrate de marcar la opción: "Use Legacy
Authentication Method".
Después de la instalación:
Si ya has configurado tu usuario con el método moderno, abre una terminal de MySQL usando mysql -u root -p . Una vez dentro, ejecuta las siguientes consultas:
CREATE USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;Esto garantiza la plena compatibilidad con TizonaHub.
🔒 ¿Es esto inseguro?
No. Este método es perfectamente seguro para entornos privados o redes locales, que es el contexto para el cual está diseñado TizonaHub. No se recomienda en servidores expuestos públicamente a Internet, pero no representa ningún riesgo cuando se utiliza dentro de una red corporativa o doméstica siguiendo buenas prácticas de seguridad (contraseña segura, puertos protegidos, etc.).