Admin-Sistemas ·

BorgBackup con cifrado y pruning automático en Proxmox: deduplicación y restauración rápida

Introducción: ¿Por qué BorgBackup en un hypervisor?

En entornos de virtualización, la protección de datos es un pilar crítico. Proxmox VE ofrece sus propias herramientas de backup (vzdump) que funcionan bien, pero en escenarios con múltiples VMs, alojamientos remotos o requisitos de retención agresivos, aparecen limitaciones: falta de deduplicación global y un consumo de espacio elevado. Aquí entra BorgBackup, una herramienta de backup de código abierto que combina deduplicación a nivel de bloque, compresión multicapa y cifrado autenticado (AES-256 en modo CTR + HMAC-SHA256). Su capacidad para integrarse en scripts de shell lo convierte en un compañero ideal para tareas programadas de Proxmox.

Este artículo no es un tutorial paso a paso de instalación básica; asume que ya tienes Borg instalado en tu host Proxmox (o en un contenedor LXC dedicado). Nos centraremos en la arquitectura de un script de backup robusto, la configuración del pruning automático y la restauración rápida con verificación de consistencia.

Arquitectura del flujo de backup

La idea central es no respaldar el almacenamiento completo de Proxmox (que incluye ISOs, plantillas y discos de VMs en uso), sino generar un dump previo con vzdump y luego enviar ese archivo a un repositorio Borg. Esto nos da dos capas: estructura de Proxmox y deduplicación de Borg sobre los dumps. Sin embargo, un enfoque más eficiente es usar Borg directamente sobre los discos virtuales (formato raw o qcow2), pero para este artículo usaremos el método estándar con vzdump, por su compatibilidad con snapshots en caliente.

Estructura del script principal

Crearemos un script en /usr/local/bin/backup-borg.sh con las siguientes secciones:

#!/bin/bash
# Variables
export BORG_REPO="/mnt/borg-repo"
export BORG_PASSPHRASE="tu-frase-secreta-muy-larga"
LOG="/var/log/borg-backup.log"
FECHA=$(date +%Y%m%d_%H%M%S)

El uso de export es crucial para que los comandos de Borg hereden las variables. La passphrase puede obtenerse desde un archivo protegido o un gestor de secretos, pero para este ejemplo la definimos directamente.

Función de backup de VMs

backup_vms() {
    for VMID in $(qm list | awk 'NR>1 {print $1}'); do
        vzdump $VMID --mode snapshot --compress zstd --dumpdir /tmp/dumps/ >/dev/null 2>&1
        if [ $? -eq 0 ]; then
            echo "VM $VMID respaldada correctamente" >> $LOG
        fi
    done
}

Aquí, qm list lista las VMs, y vzdump genera un snapshot. El parámetro --mode snapshot permite hacer backup sin detener la VM. La compresión zstd es rápida y con buena tasa.

Cifrado y deduplicación en Borg

Inicialización del repositorio

Si el repositorio no existe, lo inicializamos con cifrado repokey-blake2, que es más rápido que el SHA256 estándar:

if [ ! -d "$BORG_REPO" ]; then
    borg init --encryption=repokey-blake2 $BORG_REPO
fi

La opción repokey guarda la clave cifrada dentro del propio repositorio, pero requiere la passphrase para acceder. La deduplicación es automática: Borg divide los datos en bloques de 2MB y calcula su hash, evitando almacenar bloques repetidos entre dumps de diferentes fechas.

Comando de creación con compresión y filtros

borg create --verbose --filter AME --list --stats \
    --show-rc --compression zstd,6 --exclude-caches \
    ::'backup-{now:%Y%m%d_%H%M%S}' /tmp/dumps/ 2>> $LOG

Desglose de opciones:

  • --filter AME: muestra en logs los archivos Añadidos, Modificados y sin cambios (E = unchanged).
  • --compression zstd,6: nivel de compresión 6 (equilibrio entre velocidad y ratio).
  • --exclude-caches: excluye directorios con la marca CACHEDIR.TAG, útil para no duplicar cachés.
  • ::'backup-{now:%Y%m%d_%H%M%S}': nombre del archivo de backup con timestamp automático.

El directorio /tmp/dumps/ se limpia tras cada ejecución para no acumular archivos sin deduplicar en el sistema local.

Pruning automático: retención por política

El pruning es el proceso de eliminar backups antiguos según una política. Borg permite retener un número determinado de backups por intervalos de tiempo. La directiva más común es mantener: 7 diarios, 4 semanales, 6 mensuales y 2 anuales.

borg prune --list --show-rc \
    --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --keep-yearly 2 \
    $BORG_REPO 2>> $LOG

Esta ejecución elimina todos los backups que no coincidan con esos criterios. Es importante destacar que Borg no elimina bloques físicamente al hacer prune; esos bloques quedan marcados como no referenciados. Para liberar espacio real, se debe ejecutar borg compact (en versiones modernas, el prune ya incluye compactación automática si usas --compact).

borg compact $BORG_REPO 2>> $LOG

Sin la compactación, la deduplicación perdería su ventaja a largo plazo, ya que el repositorio crecería con datos huérfanos.

Automatización con systemd (no cron)

Para un entorno Proxmox, es recomendable usar un temporizador de systemd en lugar de cron, ya que ofrece mejor control de dependencias y logs. Creamos dos archivos:

Servicio de backup

[Unit]
Description=Backup Borg de VMs Proxmox
After=network-online.target

[Service] Type=oneshot ExecStart=/usr/local/bin/backup-borg.sh StandardOutput=journal

Temporizador

[Unit]
Description=Ejecutar backup Borg diario a las 02:30

[Timer] OnCalendar=--* 02:30:00 Persistent=true

[Install] WantedBy=timers.target

Habilitamos con systemctl enable backup-borg.timer --now. La opción Persistent=true ejecuta el backup si el sistema estaba apagado en el momento programado.

Restauración rápida y verificación

Listado de backups disponibles

borg list $BORG_REPO

Para extraer un backup completo, usamos el nombre que aparece en la lista, por ejemplo backup-20250215_023000.

Extracción de un directorio o archivo específico

borg extract $BORG_REPO::backup-20250215_023000 \
    --path dump/  # o un .vma específico

En el caso de un backup de VM, el archivo extraído será un .vma (Virtual Machine Archive). Para restaurarlo en Proxmox:

qmrestore /ruta/al/archivo.vma $VMID --storage local-lvm

Este comando recrea la VM con su configuración original. La rapidez de esta restauración es notable: al extraer solo el archivo necesario y no todo el repositorio, el tiempo de recuperación se reduce drásticamente.

Verificación de integridad

borg check --verify-data $BORG_REPO

Este comando valida la consistencia de los metadatos y, con --verify-data, el contenido de los bloques. Es recomendable ejecutarlo mensualmente para detectar corrupción silenciosa de datos.

Optimizaciones avanzadas: exclude y atime

Para evitar duplicar datos temporales de las VMs, añadimos exclusiones en el comando create:

--exclude '/tmp/dumps/*.tmp' --exclude '/tmp/dumps/iso/'

También podemos des