Instalación Automática de n8n en Debian 13

Este script instala y configura n8n en un servidor con Debian 13 (instalación mínima), incluyendo Nginx como proxy inverso, certificado TLS gratuito de Let's Encrypt y una configuración segura que garantiza que las URLs de los webhooks sean accesibles.

Requisitos previos

• Servidor con Debian 13 (instalación mínima)
• Dominio público apuntando a la IP del servidor
• Puertos 80 y 443 abiertos en el firewall
• Acceso como usuario root

Instrucciones de uso

Desde el usuario root, ejecuta los siguientes comandos:

nano /root/setup-n8n.sh
# (pega el contenido del run.sh en el repo)
chmod +x /root/setup-n8n.sh
/root/setup-n8n.sh

# Ver y gestionar respaldos
n8n-admin

# Crear respaldo manual inmediato
n8n-backup

El script solicitará interactivamente:

• Email para Let's Encrypt
• Dominio público (ej: midominio.duckdns.com)
• Usuario para la autenticación básica de n8n
• Contraseña para la autenticación básica de n8n

Características de la instalación

• HTTPS automático con renovación mediante Certbot
• URLs limpias sin puerto 5678 en los webhooks
• Autenticación básica activa por defecto
• Datos persistentes en /opt/n8n-data
• Permisos correctos (UID 1000, compatible con la imagen oficial de n8n)
• Configuración optimizada para n8n versión 2.4+

Notas importantes

• El script instala automáticamente todas las dependencias necesarias (Nginx, Docker, Certbot).
• No se crean usuarios innecesarios; el contenedor se ejecuta con los permisos adecuados.
• Las URLs de prueba (/webhook-test/) y producción (/webhook/) estarán libres de puerto.
• El certificado de Let's Encrypt se renueva automáticamente cada 60 días.
• Si se supera el límite de emisión de certificados de Let's Encrypt (5 por dominio en 7 días), se debe esperar el tiempo indicado antes de volver a ejecutar el script.

Solución de problemas

Si durante la instalación se obtiene el error "too many certificates", significa que se ha alcanzado el límite de Let's Encrypt. En ese caso:

• Espere hasta la fecha indicada en el mensaje de error.
• O utilice un subdominio diferente para pruebas.
• O use el entorno de staging de Let's Encrypt con la bandera --staging (certificados no válidos para producción).