Copia de seguridad y restauración de n8n: un ejercicio de recuperación aislada
Practica la copia de seguridad y restauración de n8n con SQLite y la misma versión, comprobando inventario, credenciales y archivos en un destino aislado.
Comprobado con las fuentes citadas el .
Tu tarea de copia de seguridad y restauración de n8n
Este ejercicio editorial te propone ensayar la copia de seguridad y restauración de n8n: recuperar una instancia detenida en un destino independiente y comprobar después su inventario, una credencial de prueba almacenada y los archivos necesarios. El procedimiento propuesto no se ha ejecutado ni validado.
El procedimiento se limita a una única instancia autoalojada con SQLite y utiliza los controles de publicación y despublicación documentados para n8n 2.0. Los comandos de restauración de PostgreSQL, la recuperación de colas, la configuración de almacenamiento externo y las migraciones entre versiones quedan fuera de este ejercicio. n8n documenta que el arranque aplica las migraciones pendientes de la base de datos; usar versiones idénticas es una condición del ejercicio, no una garantía de compatibilidad. La documentación oficial citada no tiene fecha y refleja su estado en el momento de la consulta; las fechas de consulta que aparecen con las citas no son fechas de publicación.
Empieza únicamente con un destino preparado por un administrador que cumpla los requisitos siguientes. El aislamiento de red depende de tu infraestructura; su implementación queda fuera de la documentación proporcionada. Creemos que practicar la recuperación resulta más útil cuando el aislamiento es un requisito previo, en lugar de algo que los participantes deban improvisar.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, n8n-docs/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md at main · n8n-io/n8n-docs · GitHub, n8n/.agents/skills/db-migrations/SKILL.md at master · n8n-io/n8n · GitHub
Prepara el flujo de prueba y el inventario de la copia de seguridad
Antes de detener el origen, prepara un flujo de trabajo inocuo que utilice un nodo HTTP Request con una credencial almacenada para un servicio de prueba proporcionado por un administrador. Selecciona explícitamente su modo de autenticación y su credencial. Define la respuesta esperada y comprueba que se rechacen las solicitudes sin autenticar. Estos son datos de entrada propuestos para el ejercicio, no un instrumento de prueba validado.
Registra los inventarios de flujos de trabajo y usuarios, la versión de n8n, las rutas de almacenamiento y la configuración del despliegue. Si el ejercicio incluye datos del sistema de archivos, elige un archivo conocido y registra su contenido esperado. Utiliza el inventario siguiente para distinguir la copia de seguridad de SQLite del procedimiento de los elementos adicionales que pueda necesitar tu despliegue.
| Elemento | Qué conservar | Alcance del ejercicio |
|---|---|---|
| .n8n folder | Carpeta completa, incluidos los datos de SQLite predeterminados | Incluido en el procedimiento |
| Clave de cifrado | Configuración original o N8N_ENCRYPTION_KEY con el mismo valor | Necesaria para las credenciales |
| Configuración del despliegue | Configuración necesaria para recrear el despliegue | Dato de entrada obligatorio |
| Almacenamiento adicional | Ubicaciones configuradas para almacenar datos binarios y ejecuciones | Incluir si está configurado |
| Nodos personalizados | Directorios necesarios de nodos personalizados | Incluir si están configurados |
| Base de datos PostgreSQL | Copia de seguridad de la base de datos junto con los demás elementos | Fuera del procedimiento |
n8n documenta que las exportaciones de flujos de trabajo y credenciales mediante la CLI omiten usuarios, roles, historial de ejecuciones, variables y ajustes de la instancia. Considera esas exportaciones un elemento parcial, no un sustituto de la copia de seguridad de la instancia.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, skills/skills/n8n-credentials-and-security-official/references/HTTP_REQUEST_WITH_AUTH.md at main · n8n-io/skills · GitHub
Copia y restaura la instancia detenida
Sigue esta secuencia propuesta para el ensayo de copia de seguridad y restauración de n8n.
- Detén la instancia de n8n de origen antes de copiar SQLite y la carpeta .n8n.
- Copia la carpeta de usuario completa y conserva las rutas adicionales inventariadas, los directorios de nodos personalizados, la configuración del despliegue y la clave de cifrado.
- Restaura esos elementos en el destino detenido y previamente aislado, utilizando almacenamiento independiente para el destino.
- Restaura la configuración del despliegue, adaptando las rutas y direcciones del destino y conservando la misma clave de cifrado.
- Con la CLI configurada para utilizar la base de datos restaurada del destino, ejecuta n8n unpublish:workflow --all antes de iniciar el destino.
- Inicia el destino aislado y realiza las comprobaciones de verificación seleccionadas.
En el modelo de publicación y despublicación de n8n 2.0, despublicar es un control adicional para el arranque: no proporciona aislamiento de red ni impide la ejecución manual deliberada. La documentación de la CLI también advierte de que importar flujos de trabajo que estaban activos en instancias sin configuración multi-main puede dejar los disparadores cron en ejecución hasta que se reinicie la instancia, por lo que desactivarlos durante la importación no sustituye al aislamiento.
No utilices exportaciones de credenciales descifradas en este ejercicio: exponen los secretos en texto plano.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, n8n-docs/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md at main · n8n-io/n8n-docs · GitHub
Comprueba la recuperación y diagnostica los fallos
Utiliza los siguientes criterios editoriales de finalización para evaluar la instancia recuperada. En nuestra opinión, ver el lienzo de un flujo de trabajo no basta para dar por terminado el ejercicio; este debería exigir pruebas de que los elementos restaurados se pueden utilizar realmente.
Si falla la autenticación, comprueba la clave de cifrado original, el modo de autenticación de HTTP Request, el tipo de credencial y la credencial seleccionada. n8n documenta que una credencial puede ignorarse cuando la autenticación no está habilitada. Si faltan archivos o nodos, compara las ubicaciones restauradas y los directorios de nodos personalizados con tu inventario antes de modificar el flujo de trabajo.
Sources: n8n-docs/docs/deploy/host-n8n/keep-n8n-running/backup-and-restore.md at main · n8n-io/n8n-docs · GitHub, skills/skills/n8n-credentials-and-security-official/references/HTTP_REQUEST_WITH_AUTH.md at main · n8n-io/skills · GitHub
Registra qué demuestra el ensayo
Termina tu ejercicio de copia de seguridad y restauración de n8n con un registro de recuperación: identificación de la copia de seguridad, versión de origen, rutas restauradas, resultados de las comprobaciones y fallos pendientes de resolver. Completar el ejercicio demuestra únicamente las comprobaciones seleccionadas; no acredita la cobertura de todos los flujos de trabajo, credenciales o dependencias externas.
Reflexión propuesta: ¿qué elemento ausente impediría a otro administrador repetir la recuperación? Una respuesta útil identifica el elemento, dónde debe figurar en el procedimiento de copia de seguridad y cómo se comprobará en el próximo ensayo. Actualiza ese procedimiento antes de dar por terminado el ejercicio.
