N8N HidenCloud Deployment Script

Este proyecto proporciona un script de instalación automatizada de N8N para servidores HidenCloud, facilitando el despliegue de workflows de automatización en la nube.

📋 Descripción

N8N es una herramienta de automatización de flujos de trabajo que permite conectar diferentes servicios y APIs de forma visual. Este script simplifica el proceso de instalación y configuración de N8N en servidores HidenCloud.

¿Qué hace el script?

El script index.js automatiza los siguientes procesos:

1. Instalación automática de N8N usando npm
2. Inicialización del servicio N8N
3. Monitoreo del proceso con logs en tiempo real
4. Gestión de errores y manejo de excepciones

🚀 Instalación

Paso 1: Clonar el repositorio

git clone https://github.com/SteveMoya/N8N_Hidencloud.git
cd N8N_Hidencloud

Paso 2: Configurar variables de entorno

1. Copia el archivo de ejemplo:

cp .env.example .env

2. Edita el archivo .env con tus configuraciones:

nano .env

3. Configura las siguientes variables obligatorias:

# Configuración básica
TZ=America/Mexico_City  # Tu zona horaria
GENERIC_TIMEZONE=America/Mexico_City  # Tu zona horaria
WEBHOOK_URL=tu-dominio.com  # Tu dominio o IP pública
N8N_PORT=3000  # Puerto proporcionado por HidenCloud
N8N_SECURE_COOKIE=FALSE  # TRUE si usas HTTPS

# Configuración de seguridad
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=TRUE
N8N_RUNNERS_ENABLED=TRUE

Paso 3: Instalar dependencias

npm install

Paso 4: Configuración en HidenCloud

⚠️ IMPORTANTE - Configuración del Servidor HidenCloud:

Al configurar tu aplicación en el panel de HidenCloud, debes especificar:

• MAIN FILE: index.js (exactamente como se muestra)
• PUERTO: El puerto que HidenCloud te proporcione debe ser configurado en la variable de entorno N8N_PORT

Ejemplo de configuración:

Main File: index.js
Port: 3000 (o el puerto que te asigne HidenCloud)

🔧 Configuración Avanzada

Base de Datos PostgreSQL (Opcional)

Si deseas usar una base de datos PostgreSQL en lugar del SQLite por defecto, descomenta y configura estas variables en tu archivo .env:

DB_POSTGRESDB_DATABASE=postgres
DB_POSTGRESDB_HOST=tu-host-db.com
DB_POSTGRESDB_PASSWORD=tu-contraseña-segura
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_SCHEMA=public
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=FALSE
DB_POSTGRESDB_USER=tu-usuario-db
DB_TYPE=postgresdb

Variables de Entorno Detalladas

Variable	Descripción	Valor por Defecto	Requerido
TZ	Zona horaria del servidor	-	✅
GENERIC_TIMEZONE	Zona horaria genérica	-	✅
WEBHOOK_URL	Dominio o IP pública	-	✅
N8N_PORT	Puerto de la aplicación	5678	✅
N8N_SECURE_COOKIE	Cookies seguras (HTTPS)	FALSE	❌
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS	Permisos de archivos	TRUE	❌
N8N_RUNNERS_ENABLED	Habilitar runners	TRUE	❌

🏃‍♂️ Ejecución

Modo Desarrollo

node index.js

Modo Producción (en HidenCloud)

El script se ejecutará automáticamente cuando HidenCloud inicie tu aplicación usando el index.js como archivo principal.

📊 Monitoreo y Logs

El script proporciona logs detallados de la instalación y ejecución:

• ✅ Logs de instalación: Muestra el progreso de instalación de N8N
• 📝 Logs de ejecución: Output en tiempo real del proceso N8N
• ❌ Logs de errores: Manejo de errores y excepciones
• 🔚 Logs de finalización: Códigos de salida del proceso

🔍 Solución de Problemas

Errores Comunes

1. Error de Puerto: Asegúrate de que N8N_PORT coincida con el puerto asignado por HidenCloud
2. Error de Permisos: Verifica que N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=TRUE
3. Error de Timezone: Usa una zona horaria válida (ej: America/Mexico_City)
4. Error de Webhook: Asegúrate de que WEBHOOK_URL sea accesible públicamente

Verificación de Configuración

# Verificar variables de entorno
cat .env

# Verificar puerto disponible
netstat -tulpn | grep :3000

📁 Estructura del Proyecto

N8N_Hidencloud/
├── index.js          # Script principal de instalación
├── package.json      # Configuración del proyecto npm
├── .env.example      # Archivo de ejemplo para variables de entorno
├── .env             # Variables de entorno (crear desde .env.example)
└── README.md        # Este archivo

🔒 Seguridad

• 🔐 Variables de entorno: Nunca subas tu archivo .env al repositorio
• 🛡️ Permisos: El script enforce permisos seguros en archivos de configuración
• 🌐 HTTPS: Usa N8N_SECURE_COOKIE=TRUE cuando tengas certificados SSL

🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia ISC. Ver el archivo package.json para más detalles.

👤 Autor

SteveMoya

• GitHub: @SteveMoya
• Proyecto: N8N_Hidencloud

📞 Soporte

Si tienes problemas o preguntas:

1. Revisa la sección de Solución de Problemas
2. Abre un Issue en GitHub
3. Consulta la documentación oficial de N8N

---

⭐ ¡No olvides dar una estrella al proyecto si te fue útil!