Admin-Sistemas ·

Implementación de backups incrementales de LXC en Proxmox con vzdump y ZFS

Introducción

Los contenedores LXC son la solución ligera y flexible que muchos administradores eligen para alojar aplicaciones dentro de Proxmox VE. Sin embargo, la falta de una estrategia de backup adecuada puede poner en riesgo la disponibilidad de los servicios. En este artículo veremos cómo combinar vzdump (la herramienta nativa de Proxmox) con snapshots ZFS para obtener backups incrementales y una política de retención totalmente automatizada.

Al final del tutorial tendrás:

  • Un script que genera backups incrementales diarios.
  • Snapshots ZFS que sirven como base para los incrementos.
  • Rotación de backups basada en una política de retención (7 d, 4 w, 12 m).
  • Procedimientos de verificación y recuperación.

Requisitos previos

Entorno de Proxmox VE

Se asume que ya dispones de un nodo Proxmox 7.x o superior con almacenamiento ZFS configurado. Verifica que el pool ZFS esté activo:

# zpool status
pool "rpool" is ONLINE
  ...

Contenedores LXC a respaldar

Identifica los IDs de los contenedores que deseas incluir en la estrategia de backup:

# pveam available
...
# pct list
   VMID   Status   Lock   Name
   101    running          web01
   102    stopped          db01

Permisos

Ejecuta los siguientes comandos como root o con sudo. El script de backup necesita acceso a:

  • El binario vzdump.
  • El comando zfs para crear y destruir snapshots.
  • El directorio de backup (/backup/lxc en este ejemplo).

Configuración de snapshots ZFS

Creación del dataset dedicado

Para mantener los snapshots separados de los datos de los contenedores, crearemos un dataset exclusivo para los backups:

# zfs create -o compression=lz4 rpool/backup/lxc

Este dataset heredará la compresión LZ4, lo que reduce significativamente el espacio ocupado por los backups incrementales.

Política de snapshots

Los snapshots ZFS son instantáneos y de solo lectura. Usaremos el nombre backup-YYYYMMDD para identificar la fecha:

# zfs snapshot -r rpool/subvol-101@backup-$(date +%F)

El flag -r garantiza que se snapshoteen también los subvolumenes asociados al contenedor LXC.

Uso de vzdump para backups incrementales

¿Por qué vzdump?

vzdump es la herramienta oficial de Proxmox para respaldar contenedores y máquinas virtuales. Soporta:

  • Backups en modo stop (contenedor detenido).
  • Backups en modo snapshot (utilizando la capa de almacenamiento).
  • Compresión y cifrado.

Cuando el almacenamiento es ZFS, vzdump puede aprovechar los snapshots ZFS para crear backups incrementales sin copiar datos que no hayan cambiado.

Comando base

Ejemplo de backup de un contenedor LXC (ID 101) usando modo snapshot y compresión gzip:

# vzdump 101 --mode snapshot --compress gzip \
    --storage local-zfs --dumpdir /backup/lxc \
    --tmpdir /tmp/vzdump --mailnotification always

Explicación de los parámetros:

  • --mode snapshot: Usa snapshots del backend (ZFS) para crear el backup sin detener el contenedor.
  • --compress gzip: Reduce el tamaño del archivo .tar.gz resultante.
  • --storage local-zfs: Define el storage ZFS configurado en Proxmox.
  • --dumpdir: Ruta donde se guardará el archivo final.
  • --tmpdir: Directorio temporal para la creación del snapshot.
  • --mailnotification always: Notifica por correo el éxito o error.

Implementación de incrementales

Para que vzdump genere un backup incremental, debemos indicarle el snapshot base mediante la opción --snapshotname. El script que sigue automatiza este proceso.

Script de backup automático con retención

Diseño del script

El script realizará los siguientes pasos:

  1. Crear un snapshot ZFS con la fecha actual.
  2. Ejecutar vzdump apuntando al snapshot recién creado.
  3. Mover el archivo resultante a una estructura de carpetas por periodo (daily, weekly, monthly).
  4. Aplicar la política de retención borrando backups antiguos.
  5. Eliminar el snapshot ZFS usado.

Implementación

#!/bin/bash
# backup_lxc_zfs.sh
# -------------------------------------------------
# Variables de configuración
POOL="rpool"
DATASET="${POOL}/backup/lxc"
CONTAINERS=("101" "102")          # IDs de los LXC a respaldar
RETENTION_DAILY=7
RETENTION_WEEKLY=4
RETENTION_MONTHLY=12
MAIL_TO="admin@example.com"
LOGFILE="/var/log/lxc_backup.log"

Función para escribir en log

log(){ echo ”$(date +‘%Y-%m-%d %H:%M:%S’) $1” | tee -a “$LOGFILE”; }

-------------------------------------------------

log ”