Clase 05 · Módulo 14
Respaldos y restauración
Respaldos y restauración
Qué logras en esta clase
Dejas tu instancia respaldada de forma que puedas reconstruirla en otra máquina, y lo compruebas.
- Exportas flujos y credenciales por línea de comandos.
- Guardas la clave de cifrado donde corresponde.
- Respaldas la base de datos.
- Restauras en una instalación de prueba.
02
La pregunta que ordena todo
Tu servidor desaparece hoy. ¿Cuánto tardas en tener todo funcionando en otro?
03
Las cuatro cosas que se respaldan
| Qué | Para qué |
|---|---|
| Flujos exportados | Reconstruir la lógica |
| Base de datos | Recuperar todo: flujos, credenciales, historial |
| Clave de cifrado | Poder abrir las credenciales |
Archivo Compose y .env | Levantar la instancia igual que antes |
Si falta una, la restauración queda a medias.
04
Dónde se ejecutan los comandos
Los comandos de esta clase son de la línea de comandos de n8n.
- Instalación con npm: se escriben tal cual,
n8ny el comando. - Docker: se antepone el acceso al contenedor.
docker exec -u node -it mi-n8n n8n export:workflow --allmi-n8n es el nombre de tu contenedor. Lo ves con docker ps.
05
Exportar los flujos
n8n export:workflow --backup --output=backups/latest/La opción --backup exporta todos los flujos, con formato legible y un archivo por flujo.
| Necesitas | Opción |
|---|---|
| Todos en un solo resultado | --all |
| Uno en particular | --id= con su identificador y --output=archivo.json |
| Solo la versión publicada | --published |
06
Los flujos van a un repositorio privado
Un archivo por flujo permite ver qué cambió entre un respaldo y otro.
- Crea un repositorio privado en GitHub (visto en Claude de verdad).
- Copia ahí la carpeta exportada.
- Sube los cambios con una nota que diga qué modificaste.
El control de versiones con Git integrado en n8n es de planes con licencia. En la edición comunitaria se hace así, exportando.
07
Antes de subir, revisa
Las credenciales no viajan dentro del flujo: solo su nombre e identificador. El riesgo está en lo que alguien escribió a mano en un nodo (clase 4).
08
Exportar las credenciales
n8n export:credentials --all --output=backups/credenciales.jsonSalen cifradas con la clave de tu instancia. Ese archivo solo sirve en una instalación que tenga la misma clave.
No va al repositorio de los flujos. Guárdalo en un lugar privado y distinto.
09
La variante peligrosa: --decrypted
Con --decrypted las credenciales salen en texto plano: todas las claves y tokens a la vista.
| Cifradas | Con --decrypted | |
|---|---|---|
| Sirven en | Instancia con la misma clave | Cualquier instancia |
| Riesgo si se filtran | Bajo sin la clave | Total |
Su uso legítimo es mudarte a una instalación con otra clave de cifrado. Borra el archivo apenas termines.
10
La clave de cifrado va aparte
Las credenciales se cifran con N8N_ENCRYPTION_KEY. Sin la clave, lo cifrado no se puede leer.
- Guárdala en tu gestor de contraseñas.
- Nunca junto al respaldo de la base ni de las credenciales.
- Si n8n la generó sola, está en la carpeta
.n8n.
Respaldo y clave juntos equivalen a no cifrar.
11
Respaldar la base de datos
La base contiene todo, incluido el historial de ejecuciones y las tablas de datos.
| Base | Cómo se respalda |
|---|---|
| SQLite | Copia del archivo que está en el volumen de n8n, con n8n detenido |
| Postgres | Volcado con pg_dump, la herramienta de Postgres |
Pídele a Claude el comando de pg_dump para tu archivo Compose y verifícalo contra la documentación de Postgres.
12
Exportar la base desde n8n
n8n trae además una exportación propia de las entidades de la base:
n8n export:entities --outputDir=./outputsSirve, por ejemplo, para pasar de SQLite a Postgres. El historial de ejecuciones queda fuera por defecto porque puede pesar mucho. Su pareja, import:entities, espera una base vacía.
13
No olvides los datos de negocio
El respaldo de n8n no incluye lo que tus flujos guardan afuera.
Las planillas de Google tienen historial de versiones, pero no te protege de perder la cuenta.
14
Dónde queda cada copia
Un respaldo guardado en el mismo servidor desaparece con el servidor.
15
Cada cuánto
| Qué | Frecuencia razonable |
|---|---|
| Base de datos | Diaria |
| Flujos | Cada vez que publicas un cambio |
| Credenciales | Cada vez que agregas o cambias una |
Clave, Compose y .env | Una vez, y al modificarlos |
Conserva varias copias de la base, no solo la última: un error puede tardar días en notarse.
16
Automatiza el respaldo fuera de n8n
El respaldo no debe depender de lo que respalda.
- Usa un script con el programador del sistema (módulo 12, clase 4).
- En n8n 2, Execute Command viene desactivado: otra razón para no hacerlo desde un flujo.
- El script deja un latido que otro vigila.
17
Un respaldo sin probar es una suposición
Solo sabes que funciona cuando levantaste una instancia desde cero con él. Restaura antes de necesitarlo.
18
Restaurar en una instalación de prueba
- Levanta un n8n nuevo en tu computador, con la misma
N8N_ENCRYPTION_KEY. - Importa las credenciales.
- Importa los flujos.
- Abre un flujo y confirma que sus nodos encuentran su credencial.
- Ejecuta a mano un flujo que solo lea datos.
n8n import:credentials --input=backups/credenciales.json
n8n import:workflow --separate --input=backups/latest/19
Lo que hace la importación
- Si ya existe un flujo o credencial con el mismo identificador, lo sobrescribe.
- Los flujos importados quedan sin publicar por defecto.
- Publicas cada uno desde el editor o con
n8n publish:workflow --id=y su identificador.
Que queden sin publicar es una ventaja: nada empieza a enviar mensajes antes de que revises.
20
Cuidado al probar con flujos reales
En la prueba, ejecuta a mano y solo lecturas. Al terminar, detén y borra esa instalación.
21
Si restauras sin la clave correcta
Los flujos se importan bien. Las credenciales no se pueden abrir, y habrá que crearlas de nuevo una por una en cada servicio.
Con diez credenciales es una tarde. Con cincuenta y clientes esperando, es una crisis. La documentación revisada no describe un procedimiento de rescate: cuida la clave.
22
Lo que te llevas
- Cuatro piezas: flujos, base, clave de cifrado y archivos de configuración.
- Flujos al repositorio privado; credenciales y base a otro lugar; clave en el gestor de contraseñas.
--decrypteddeja todo en texto plano: solo para mudanzas, y se borra.- Importar sobrescribe por identificador y deja los flujos sin publicar.
- El respaldo vale cuando ya lo restauraste una vez.
23
Hazlo ahora
En 15 minutos:
- Ejecuta
n8n export:workflow --backup --output=backups/latest/. - Abre un archivo exportado y busca si hay alguna clave escrita a mano.
- Ubica tu clave de cifrado y guárdala en tu gestor de contraseñas.
- Anota dónde quedará cada una de las cuatro piezas y agenda la prueba de restauración.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026