El cliente lionbackup
La copia se realiza mediante un cliente ligero escrito en Go que se proporciona como cliente de código abierto.
Qué hace el cliente
El cliente se encarga de toda la parte local de una copia:
- Comprimir los datos seleccionados,
- Cifrar — con el cifrado de extremo a extremo en el cliente activado, de su sistema solo sale texto cifrado,
- Transferir a un Citadel disponible de la Storage Zone elegida.
Si durante la transferencia falla un endpoint, el cliente cambia automáticamente a otro Citadel disponible.
Plataformas
El cliente admite Linux, Windows y macOS (beta). Hay binarios precompilados disponibles para descarga; el código fuente es de acceso público.
Configuración
Para su funcionamiento guarda en la configuración local:
- el token de acceso vinculado al proyecto,
- con el cifrado en el cliente, el material de claves,
- las rutas o fuentes de datos a respaldar.
Al ser el cliente de código abierto, puede comprobarse cómo se realizan la compresión, el cifrado y la transferencia — una transparencia acorde con la orientación soberana de lionbackup.
Un recorrido completo desde el inicio de sesión hasta la primera copia está en Primeros pasos.
Varios trabajos de copia en un mismo equipo
Un proyecto puede tener varias configuraciones, por ejemplo una ejecución
diaria para documentos y otra semanal para la base de datos. Cada configuración
da nombre a su trabajo con name::
lionbackup:
name: daily-docs
El nombre aparece en la salida y en el nombre del archivo de registro
(lionbackup-<name>-YYYYMMDD.log). Así, varias configuraciones pueden
compartir un log_directory sin que sus líneas se mezclen en un mismo archivo.
Si falta name:, el cliente lo deriva del nombre del archivo de configuración
(daily-docs.yaml → daily-docs). Conviene mantener iguales el nombre del
archivo y name:.
Errores de lectura, carpetas especiales de Windows y transparencia
Desde el cliente v0.1.2:
- Las junctions heredadas de Windows (enlaces de compatibilidad ocultos como "Mis imágenes" en el perfil) se omiten siempre – son ilegibles por diseño y no contienen datos.
- Los errores de lectura bajo una fuente (acceso denegado, archivo eliminado durante la ejecución) producen por defecto un aviso + omisión; al final el cliente informa del total de elementos omitidos. Una fuente inexistente o ilegible sigue abortando.
- El comportamiento se configura con
on_read_errorenlionbackup.yaml:warn(por defecto) oabortpara fallar al primer error.
on_read_error: warn # o: abort
El cliente narra sus pasos ("Paso 1/3: comprobando fuentes …", progreso del escaneo cada segundo), de modo que incluso con directorios muy grandes se ve al instante qué está ocurriendo.
Windows: archivos abiertos mediante instantánea
En Windows, el cliente lee los archivos que un programa mantiene abiertos en
exclusiva desde una instantánea (VSS) de la unidad. Está activado por
defecto (use_vss: true) y requiere derechos de administrador. Sin ellos, el
cliente omite los archivos bloqueados, respalda el resto y los indica en el
registro. Para las copias mediante el Programador de tareas, elija por tanto
"Ejecutar con los privilegios más altos".
La instantánea lee los archivos de una base de datos en ejecución, pero sin
consultar a la base de datos. Lo fiable es una copia que escribe la propia base
de datos, por ejemplo mediante un comando pre_backup (ver más abajo) en una
carpeta que el cliente respalda.
VM de Hyper-V
A partir del cliente 0.2.0, en un Windows Server con el rol Hyper-V el
cliente respalda VM completas. En la configuración solo figuran sus nombres,
tal como los muestra Get-VM; en cada ejecución el cliente pregunta a Hyper-V
qué archivos les pertenecen.
lionbackup:
hyperv:
vms:
- FILESRV01
- DC01 # o "*" para todas las VM del host
files: # opcional, puede faltar
- D:\Compartidos
- Coherente con las aplicaciones, sin apagar. La instantánea se crea mediante DiskShadow con el writer de Hyper-V. Con el servicio de integración de copia de seguridad (instantánea de volumen) en el invitado es una copia en línea, en la que también aplicaciones como SQL Server quedan coherentes; sin él, Hyper-V pone la VM brevemente en estado guardado.
- Una copia por VM, estructurada como una exportación de Hyper-V. Tras la
restauración,
Import-VMla importa como copia con un nuevo ID. - Copia completa. Cada ejecución respalda la VM entera. El límite estándar de 100 GB por copia (ver Límites) lo ampliamos a petición.
- Requisitos. Windows Server 2025 o 2022, cliente ejecutado como
administrador, archivos de la VM en volúmenes locales de un host
independiente. El cliente rechaza con un mensaje las VM en Cluster Shared
Volumes o recursos compartidos SMB, los discos de paso y los VHD Sets. Sin
DiskShadow (Windows 10/11), o si falla el writer de Hyper-V, solo respalda
con coherencia ante fallos (crash-consistent) y avisa;
on_writer_error: abortcancela en su lugar. - Puntos de control antiguos tras la importación. Un punto de control que ya
existía antes de la copia solo arranca con Secure Boot en la VM importada si
antes se vuelve a establecer la plantilla de Secure Boot
(
Set-VMFirmware -VM $vm -EnableSecureBoot On -SecureBootTemplate MicrosoftWindows). Tras una importación desde la exportación propia de Hyper-V ocurre lo mismo.
Una guía paso a paso con prueba de restauración está en el blog: Copia de seguridad de VM Hyper-V sin apagarlas y Restaurar una VM Hyper-V desde la nube.
Comandos antes y después de la copia
A partir del cliente 0.2.0, el cliente ejecuta comandos propios indicados
en hooks:, por ejemplo un volcado de la base de datos antes de la copia:
lionbackup:
hooks:
pre_backup:
- 'C:\Scripts\copia-base-de-datos.cmd'
post_backup:
- 'C:\Scripts\tras-la-copia.cmd'
timeout_sec: 3600 # por comando, predeterminado 3600
| Etapa | Cuándo | Si el comando falla |
|---|---|---|
pre_backup | antes que nada, incluso antes de comprobar las fuentes | La ejecución no respalda nada. |
post_snapshot | en cuanto existe la instantánea; si no, tras la lectura | La copia continúa, pero termina con error. |
post_backup | siempre al final, también tras errores | La ejecución termina con error. |
Ponga los comandos entre comillas simples: de lo contrario, dos puntos seguidos
de un espacio o un # en el comando rompen el YAML. En Windows se ejecutan
mediante cmd.exe /C, en Linux y macOS mediante /bin/sh -c.
Quien pueda modificar la configuración puede ejecutar comandos con ella, en un
servidor a menudo como administrador. Guarde la configuración de modo que solo
los administradores puedan modificarla. En Linux y macOS, el cliente rechaza
hooks: en una configuración en la que pueden escribir el grupo u otros
usuarios.