Saltar al contenido principal

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:

  1. Comprimir los datos seleccionados,
  2. Cifrar — con el cifrado de extremo a extremo en el cliente activado, de su sistema solo sale texto cifrado,
  3. 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.
Código abierto

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_error en lionbackup.yaml: warn (por defecto) o abort para 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-VM la 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: abort cancela 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
EtapaCuándoSi el comando falla
pre_backupantes que nada, incluso antes de comprobar las fuentesLa ejecución no respalda nada.
post_snapshoten cuanto existe la instantánea; si no, tras la lecturaLa copia continúa, pero termina con error.
post_backupsiempre al final, también tras erroresLa 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.

Los comandos se ejecutan con los derechos del cliente

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.