n8n — Motor de automatización¶

Sustituiría a Zapier y Make (Integromat). Conectaría servicios, programa tareas, genera informes y avisos automáticos. Es el asistente digital que trabaja contigo.

Como usuario¶

Qué podrás hacer¶

No se usa directamente — sus automatizaciones trabajan en silencio. Lo que hace:

Recordatorios de citas y tareas
Generación automática de documentos e informes
Envío de comunicaciones programadas
Procesamiento de datos de sensores
Orquestación del ciclo de vida de servicios (encender/apagar)

Cómo se accederá¶

Plataforma	Cómo
Navegador	Solo admin: https://n8n.sc
Ubuntu	No aplica para usuarios
Android	No aplica para usuarios
FireTV	No aplica
Usuarios	Solo notificaciones vía Matrix o ntfy

Primeros pasos (previstos)¶

Los usuarios no interactúan directamente con n8n. Reciben sus resultados a través de notificaciones en Matrix, ntfy, o correos automatizados. El admin configura y supervisa los workflows desde el navegador.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Matrix	Bot de comandos
ntfy	Notificaciones push
Node-RED	Datos de sensores
farmOS	Registros automáticos
Nextcloud	Dispara flujos al subir archivos
Immich	Notifica nuevas fotos
Ollama	Agentes nocturnos de IA
Mautic	Envío de campañas
FacturaScripts	Facturación automática
Joplin Server	Crearía notas automáticamente
Authentik	Auth
Caddy	Proxy

Servicios que lo hacen posible¶

PostgreSQL — base de datos de workflows y credenciales
ZFS — almacenamiento persistente
Authentik — autenticación
Caddy — proxy reverso

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	160
IP	10.10.20.160
Tier	B
Impacto	🔴 Crítico

Docker: n8nio/n8n:latest + PostgreSQL.

Almacenamiento persistente¶

ZFS (sistema de archivos con integridad de datos): rpool/datos/n8n → /opt/n8n/ Subdirectorios: config/ data/ logs/ Backup: PBS (sistema de copias de seguridad de Proxmox) diario + ZFS snapshot @15min + workflows versionados en Forgejo.

Healthcheck¶

curl https://n8n.sc/healthz

Logs y diagnóstico¶

docker logs --tail 100 n8n

Backup manual¶

zfs snapshot rpool/datos/n8n@manual-$(date +%Y%m%d)

Problemas comunes¶

Workflow no se ejecuta → Verificar credenciales en n8n.
n8n no arranca → Comprobar que PostgreSQL está corriendo.

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Caddy -->|TLS| n8n
    Authentik -->|OAuth2| n8n
    n8n -->|Webhook| Matrix
    n8n -->|Push| ntfy
    n8n -->|MQTT| Node-RED

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr2	5678	Caddy (LXC 102)

En Pi-hole¶

n8n.sc  →  10.10.20.160

En Caddy¶

n8n.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.160:5678
}

En Authentik¶

Provider: OAuth2/Proxy. Grupos: familia/empresa/admin.

Orquestación¶

Componente	Path
Rol Ansible	`roles/n8n/`
Playbook	`deploy-n8n.yml`
Módulo OpenTofu	`modules/n8n/`
Semaphore	Proyecto `n8n`
Forgejo Actions	`.forgejo/workflows/n8n.yml`
Repo Forgejo	`infra-core/`
Ficha versionada	`docs/fichas/programas/n8n.md`

n8n es el orquestador de la capa lógica (Tier B). No actúa sobre hardware directamente — eso es Node-RED. Los workflows críticos deben estar versionados en Forgejo. Si n8n cae, la capa física (Node-RED + MQTT (protocolo de mensajería ligera para IoT) + Shelly (actuador eléctrico WiFi)/ESP32 (microcontrolador WiFi para sensores)) sigue operando de forma autónoma.

Secciones relacionadas¶

🌐 Enlaces de interés¶

Sitio oficial · Documentación · GitHub