Blog InfluxIA

Backup automático de n8n en GitHub: guía paso a paso para exportar y sincronizar tus workflows a diario

Backup automático de n8n en GitHub: guía paso a paso para exportar y sincronizar tus workflows a diario

Backup automático de n8n en GitHub: guía paso a paso para exportar y sincronizar tus workflows a diario

Tiempo de lectura estimado: 10 min

Puntos clave

  • Evita perder tus escenarios: exporta y versiona tus workflows de n8n en GitHub de forma diaria.
  • Estructura clara por carpetas y archivos estables: usa {workflowId}.json para evitar duplicados al renombrar.
  • Sube solo si cambió algo: compara por hash y evita commits vacíos con la variante de Change Detection.
  • Arquitectura en dos bloques: obtén workflows y súbelos por separado para mejores logs y reintentos.
  • Empieza rápido con la plantilla Automated daily workflow backup to GitHub y personalízala.

Tabla de contenidos

Contexto y por qué es importante

Si usas n8n en un VPS propio, hay un riesgo real: si el servidor se cae o el disco se corrompe, puedes perder todos tus escenarios. Duele, y pasa.

Con un backup automático de n8n en GitHub, evitas ese susto:

  • Copia de seguridad n8n en GitHub y versionado automático.
  • Restauración en minutos desde los JSON.
  • Organización por carpetas y etiquetas. Historial de cambios claro.

Además, GitHub es gratuito y sencillo para esto. Ya hay flujos listos que exportan y sincronizan n8n con GitHub de forma diaria con un Schedule, como Automated daily workflow backup to GitHub. Si quieres evitar commits vacíos, hay plantillas con detección de cambios por hash: Automatic workflow and credentials backup to GitHub with Change Detection. Y si prefieres scripts, también hay guías y un Gist de exportación manual y por CLI.

En este tutorial haremos lo básico, bien hecho: exportar workflows de n8n a GitHub cada día, con estructura por etiquetas y archivos por ID. Sigue leyendo.

“Un buen backup hoy vale más que un ‘hubiéramos’ mañana.”

Requisitos previos

  • n8n instalado (self‑hosted o con acceso a su API).
  • Credenciales de la API de n8n activadas en Settings.
  • Cuenta de GitHub, repositorio dedicado y token de acceso (PAT) con permisos repo.
  • Decisiones de estructura:
    • Carpeta raíz: escenarios
    • Subcarpetas por etiquetas (opcional).
    • Nombre de archivo recomendado: {workflowId}.json
    • Alternativa: {name}.json (más legible, pero cambia si renombrás).

Tip: hay flujos listos para arrancar en minutos y luego personalizar: Automated daily workflow backup to GitHub.

Arquitectura de la automatización (visión general)

Para mantenerlo claro y mantenible, divide en dos partes:

  • Escenario 1: Schedule Trigger diario.
    • Lanza la ejecución.
    • Llama a la API de n8n para obtener “todos los workflows”.
  • Escenario 2 (o segunda sección del mismo):
    • Itera cada workflow.
    • Decide carpeta por etiquetas.
    • Compara con GitHub.
    • Crea o actualiza el archivo JSON.

¿Por qué en dos bloques?

  • Menos acoplamiento y menos fallos encadenados.
  • Logs más claros.
  • Puedes reintentar solo la parte de subida si algo falla.

Esta arquitectura sigue el patrón de los workflows de la comunidad para backup automático y detección de cambios: Change Detection. Si más adelante quieres incluir credenciales, variables o backups completos vía script, considera n8n-data-manager.

Paso a paso: programar backup diario en n8n

A continuación, crearás un flujo que corre cada día, recopila tus workflows y los sincroniza con GitHub. Es simple y robusto. Si prefieres empezar desde una plantilla y adaptarla, revisa Automated daily workflow backup to GitHub como base.

Configurar el Schedule Trigger

  • Nodo: Schedule Trigger.
  • Frecuencia: diaria.
  • Hora sugerida: 07:00 (ajústala a tu ventana de menor uso).
  • Consejo:
    • Si tienes muchas automatizaciones, programa en horas valle.
    • Si tu n8n está en otra zona horaria, valida el TZ del servidor.

Objetivo: iniciar la sincronización/backup automáticamente sin intervención.

Transición: con el disparo listo, toca pedirle a n8n la lista completa de workflows.

Conectar con la API de n8n

  • Nodo: n8n API.
  • Recurso: Workflows.
  • Operación: Get Many / Get all workflows.
  • Return All: true.
  • Resultado esperado: un item por cada escenario.

Notas útiles:

  • Comprueba que la credencial apunta al mismo entorno (producción vs staging).
  • Si usas un reverse proxy o ruta base, ajusta la URL de la API.

Transición: ya tienes todos los workflows. Ahora toca decidir cómo guardarlos.

Iterar sobre cada workflow

Usa un loop (por ejemplo, Split In Batches o un For Each) para procesar uno a uno. Para cada workflow:

  • Resolver etiquetas (tags):
    • Si existen: usa la primera etiqueta o combina varias para subcarpetas.
    • Si no hay etiquetas: guarda en escenarios/.
  • Definir el path en GitHub:
    • Variables clave: repoOwner, repoName, basePath (escenarios/), tagName (opcional).
    • Con tag: escenarios/{tagName}/{workflowId}.json
    • Sin tag: escenarios/{workflowId}.json
  • Elegir el nombre del archivo:
    • Recomendado: {workflowId}.json (ID estable; evita duplicados).
    • Alternativa: {name}.json (más legible, pero sensible a renombres).

Ejemplo práctico: Workflow con ID 42, nombre “Enviar reportes”, tag “reportes” → ruta: escenarios/reportes/42.json. Si lo renombrás, el ID sigue 42: no se duplica.

Transición: con el path decidido, falta comparar contra lo que ya está en GitHub.

Comprobación y comparación en GitHub

Objetivo: evitar commits innecesarios y subir solo lo que cambió.

  • Obtén el contenido del archivo en GitHub si existe (Get file/contents).
  • Compara el JSON actual (desde n8n) con el del repo:
    • Normaliza antes de comparar (orden de claves) o usa un hash del JSON.
    • Estados: same (sin cambios), different (cambios), new (nuevo archivo).

Sugerencia: usa una comparación por hash (MD5/SHA) del JSON limpio para precisión y velocidad. La plantilla con Change Detection aplica este patrón para reducir ruido en commits.

Transición: con el estado en la mano, decide qué hacer en cada caso.

Ramificaciones de actualización

  • same: no hagas nada y pasa al siguiente workflow.
  • different: edita el archivo en GitHub con el JSON nuevo.
    • Commit sugerido: update(different): wf 42 ‘Enviar reportes’ — 2025-01-12 07:00
  • new: crea el archivo en la ruta definida.
    • Commit sugerido: add(new): wf 42 ‘Enviar reportes’ — 2025-01-12 07:00

Tips rápidos:

  • Guarda siempre en UTF-8 y codifica Base64 si el nodo GitHub lo requiere.
  • Incluye timestamp en el mensaje para rastrear horarios de backup.
  • Si hay muchos cambios, agrúpalos en un único commit al final del loop.

En la siguiente parte, veremos configuración de GitHub, buenas prácticas y cómo resolver errores, con atajos y plantillas listas para usar: Automated daily workflow backup to GitHub, Gist CLI, y n8n-data-manager.

Configuración de GitHub (repositorio y credenciales)

Antes de sincronizar, deja GitHub listo y seguro.

  • Crea un repositorio privado
    • Nombre sugerido: n8n-backup.
    • Rama principal: main.
    • Añade un README simple para iniciar.
  • Genera un token de acceso personal (PAT)
    • Alcance: repo (completo).
    • Guárdalo en n8n como credencial de GitHub (no en texto plano).
  • Define la estructura del repo
    • Carpeta base: /escenarios/
    • Subcarpetas por etiquetas: /escenarios/{tag}/ (opcional).
    • Archivos: {workflowId}.json para estabilidad.
  • Variables en n8n
    • repoOwner: tu usuario u organización.
    • repoName: p. ej., n8n-backup.
    • basePath: escenarios/
    • branch: main (o la que uses).

Puedes apoyarte en Automated daily workflow backup to GitHub para acelerar la puesta en marcha. Si quieres incluir detección de cambios por hash desde el día uno, mira la variante Change Detection.

Buenas prácticas y decisiones clave

  • Nombrado de archivos
    • Por ID: estable, evita duplicados al renombrar workflows.
    • Por nombre: más legible, pero crea archivos “nuevos” si cambias el título.
  • Organización por etiquetas
    • Útil para navegar: marketing, ventas, data, infra, etc.
    • Si un workflow tiene varias tags, elige una principal o guarda en varias rutas según tu criterio.
  • Commits claros y útiles
    • Formato sugerido: add(new) / update(different): wf {ID} ‘{Nombre}’ — {timestamp}.
  • Separar en dos escenarios: un bloque para obtención y otro para subida.
  • Seguridad
    • Repo privado.
    • PAT guardado como credencial en n8n.
    • Evita exponer URLs y tokens en mensajes de error.
  • Rendimiento y limpieza
    • Return All en la API y loop por lotes si son muchos workflows.
    • Normaliza el JSON antes de comparar (o usa hash).
    • Evita commits vacíos con Change Detection.
  • Versionado y ramas
    • Puedes enviar a una rama “backup” y hacer PRs a “main”.

Validación y pruebas

  1. Ejecuta manualmente el flujo
    • Lanza el Schedule Trigger en modo manual.
    • Verifica que el nodo n8n API devuelve todos tus workflows.
  2. Revisa el repositorio
    • Debe existir /escenarios/.
    • Archivos {id}.json presentes y legibles.
  3. Prueba la actualización
    • Cambia algo pequeño (p. ej., descripción) y reejecuta.
    • Debe aparecer un commit update(different) correspondiente.
  4. Confirma la detección de “sin cambios”
    • Ejecuta de nuevo sin tocar nada: no debe crear commits nuevos si comparas por hash.
    • Plantilla recomendada: Change Detection.

Si prefieres montar todo con una plantilla prehecha y personalizar, arranca con Automated daily workflow backup to GitHub. También puedes validar exportando manualmente por CLI (n8n export:workflow) y subiendo al repo, como muestra este Gist.

Extensiones y casos avanzados

Promoción a producción (deploy controlado)

  • Flujo: guarda en rama “dev”, abre PR hacia “main” y, al aprobar, restauras en n8n “prod”.
  • Herramientas: scripts/CLI y n8n-data-manager para backups/restores completos.

Backup selectivo

  • Filtra por etiqueta “backup” o por carpeta específica.
  • Útil si tienes muchos workflows y solo quieres proteger los críticos.

Incluir credenciales y variables

  • La variante con Change Detection puede respaldar workflows y credenciales.
  • Maneja esto con cuidado: repos privados y control estricto de acceso.

Restauración rápida

  • Desde GitHub: descarga el .json y usa “Import” en n8n, o n8n import:workflow.
  • Restauración completa o selectiva con n8n-data-manager y el Gist CLI.

Auditoría y entornos

  • Usa tags y ramas para separar dev/test/prod.
  • Cada cambio queda en Git con autor, fecha y diff.
  • Puedes sincronizar n8n con GitHub y exigir revisión por PR.

Otras forjas Git

  • GitLab/Bitbucket funcionan igual (nodos propios o HTTP Request).
  • La lógica de comparación y subida no cambia.

Solución de problemas comunes

  • 401/403 en GitHub
    • Revisa el PAT y que tenga alcance repo.
    • Confirma que la credencial en n8n apunta al token correcto.
  • 404 al leer/escribir archivos
    • Verifica repoOwner, repoName, branch y basePath.
    • Asegura que la carpeta existe o crea el archivo con ruta completa.
  • No aparecen todos los workflows
    • Activa Return All = true en el nodo n8n API.
    • Confirma que apuntas al entorno correcto (URL/base path).
  • Cambios no detectados
    • Normaliza el JSON antes de hashear.
    • Asegura que comparas el contenido real (descarga si GitHub devuelve base64).
    • Considera Change Detection.
  • Archivos grandes
    • Usa la opción de descarga completa antes de comparar.
    • Procesa en lotes (Split In Batches) para evitar timeouts.
  • Rate limit de GitHub
    • Agrupa commits o usa una rama temporal.
    • Aumenta la ventana entre peticiones si tienes cientos de workflows.
  • Errores intermitentes de red
    • Añade reintentos exponenciales en los nodos de HTTP/GitHub.
    • Separa el escenario en dos y relanza solo la parte de subida.

Si prefieres una plantilla lista, estas dos cubren la mayoría de casos: backup diario y backup con Change Detection.

Checklist final

  • Tengo programado el Schedule Trigger para backup diario en n8n.
  • El nodo n8n API devuelve todos los workflows (Return All = true).
  • El repo privado en GitHub existe y el PAT tiene permisos repo.
  • Definí la estructura: /escenarios/ y subcarpetas por etiquetas si aplica.
  • La lógica same/different/new funciona y evita commits vacíos.
  • Los commits incluyen estado, ID/nombre y timestamp.
  • Probé una restauración desde un .json.
  • Documenté repoOwner, repoName, branch y basePath dentro del flujo.

Conclusión

Montar un backup automático de n8n en GitHub te da paz mental. En minutos, puedes exportar workflows, versionarlos y restaurar si algo sale mal. Con un Schedule Trigger diario, tendrás sincronización constante, organización por etiquetas y un historial limpio para auditar cambios.

Empieza con una plantilla oficial y ajústala a tu realidad. Si necesitas extra, suma detección de cambios o scripts para restauraciones completas. Lo importante es no dejarlo para “después”. Configura hoy tu copia de seguridad n8n en GitHub y evita sustos mañana.

Recursos para arrancar:
Automated daily workflow backup to GitHub,
Change Detection,
Gist/CLI y
n8n-data-manager.

Preguntas frecuentes (FAQ)

¿Esto sirve en n8n Cloud?

Sí, mientras tengas acceso a la API y puedas crear credenciales. Ajusta la URL base y permisos. Las plantillas de la comunidad funcionan igual, por ejemplo Automated daily workflow backup to GitHub.

¿Se suben credenciales y variables?

En el flujo básico, solo workflows. Hay una variante que respalda credenciales con detección de cambios, úsala con repos privados y control estricto de acceso: Change Detection.

¿Puedo usar GitLab o Bitbucket?

Sí. Cambia el nodo a la API de tu forja o usa HTTP Request + autenticación. La comparación por hash y la estructura de carpetas se mantiene.

¿Cómo restauro un workflow?

Descarga el .json del repo y usa “Import” en n8n, o n8n import:workflow por CLI. Para restores completos, considera n8n-data-manager y el Gist CLI.

¿Cada cuánto conviene ejecutar el backup?

Diario es un buen punto. Si cambias mucho, hazlo cada hora. Vigila límites de API en GitHub y agrupa commits si es necesario.

¿Cómo evito commits innecesarios?

Compara por hash del JSON normalizado o usa la plantilla con Change Detection que ya lo implementa.

¿Qué pasa si renombro un workflow?

Si nombras por ID, el archivo no cambia de ruta y no se duplica. Por eso recomendamos {workflowId}.json.

¿Es seguro guardar esto en GitHub?

Sí, si el repo es privado y gestionas bien el PAT. Evita publicar credenciales. Revisa periódicamente accesos y rotación de tokens.

¿Cuánto espacio ocupa?

Suele ser poco. Los JSON de los workflows son ligeros. El versionado crecerá con el tiempo, pero es manejable para la gran mayoría.

¿Puedo sincronizar n8n con GitHub para “promover a producción”?

Sí. Trabaja por ramas, abre PRs y usa scripts de import. Es una forma simple de control de cambios con revisión humana; apóyate en n8n-data-manager.

Cover Image