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