Guía de Configuración de vzdump

El archivo /etc/vzdump.conf reune las opciones de configuración de vzdump, la utilidad de Proxmox VE para realizar copias de seguridad de máquinas virtuales (QEMU/KVM) y contenedores (LXC). Allí se definen los comportamientos predeterminados para todas las copias de seguridad, a menos que se sobrescriban con opciones de línea de comandos o ajustes por trabajo en la interfaz gráfica de usuario de Proxmox.

Opciones de Respaldo Principales

dumpdir

Es el directorio local donde se almacenan los respaldos si no se especifica un almacenamiento (storage).

    dumpdir: /var/lib/vz/dump

storage

Backend de almacenamiento de Proxmox utilizado para respaldos (recomendado).

    storage: backup-nfs

Debe hacer referencia a un almacenamiento configurado en Datacenter → Storage que soporte contenido de respaldo.

mode

Método de respaldo para VMs de QEMU. Valores: snapshot | suspend | stop

    mode: snapshot

• snapshot – Respaldo en línea utilizando instantáneas de QEMU (predeterminado y recomendado)

• suspend – La VM se pausa durante el respaldo

• stop – La VM se apaga durante el respaldo

Nota: Los contenedores LXC siempre utilizan el modo de instantánea donde sea compatible.

compress

Algoritmo de compresión. Valores: 0 | 1 | gzip | lzo | zstd

    compress: zstd

• zstd es recomendado para PVE 8+ debido a su rendimiento y relación de compresión.

• 0 o none desactiva la compresión.

bwlimit

Valor entero (KiB/s) que define el límite de ancho de banda para el tráfico de respaldo.

    bwlimit: 51200

Útil para prevenir que los trabajos de respaldo saturen el almacenamiento o los enlaces de red.

Retención y Rotación

prune-backups

Política de eliminación de respaldos.

    prune-backups: keep-daily=7,keep-weekly=4,keep-monthly=6

Evaluada del lado del servidor en almacenamientos compatibles (por ejemplo, PBS, NFS).

maxfiles (Legado)

Número máximo de respaldos a mantener por VM.

    maxfiles: 5

Obsoleto a favor de prune-backups.

Rendimiento y Control de Recursos

ionice

Prioridad de I/O para procesos de respaldo. Valores: Entero (0–7)

    ionice: 7

Valores más altos reducen el impacto en las cargas de trabajo de producción.

nice

Prioridad de programación de CPU. Valores: Entero (-20 a 19)

    nice: 19

pigz

Número de hilos para compresión gzip paralela.

    pigz: 4

Ignorado al usar zstd.

Agente Invitado y Consistencia

agent

Habilita la congelación/descongelación del sistema de archivos del Agente Invitado de QEMU. Valores: 1 | 0

    agent: 1

Requiere que el agente invitado esté instalado y en funcionamiento en la VM.

quiesce

Solicita la inactividad del sistema de archivos a través del agente invitado. Valor: 1 | 0

    quiesce: 1

Mejora la consistencia de las aplicaciones para bases de datos y cargas de trabajo transaccionales.

Registro y Notificación

mailto

Dirección de correo electrónico del destinatario de los informes de trabajos de respaldo.

    mailto: jefe-estacion@unau.edu.ar

mailnotification

Política de notificación por correo electrónico. Valores: always | failure | never

    mailnotification: failure

stdout

Registrar salida en la salida estándar (uso de CLI). Valores: 1 | 0

    stdout: 0

Opciones Temporales y Avanzadas

tmpdir

Directorio de trabajo temporal durante el respaldo.

    tmpdir: /var/tmp

Configure tmpdir en un sistema de archivos local con E/S rápida y suficiente espacio libre.

Por qué tmpdir es especialmente importante para las copias de seguridad remotas

No especificar un directorio temporal puede provocar:

• Una grave degradación del rendimiento.

• Fallos en las copias de seguridad debido a tiempos de espera agotados o conexiones de red interrumpidas.

• Bloqueos de instantáneas de máquinas virtuales durante más tiempo, lo que aumenta el impacto de la E/S de los invitados.

• Copias de seguridad dañadas o incompletas.

• Exceso de idas y venidas de la red durante la compresión y las actualizaciones de metadatos.

• En el peor de los casos, vzdump puede fallar después de horas porque el área de almacenamiento temporal se llena o la red falla durante la escritura.

lockwait

Tiempo de espera (segundos) para la adquisición del bloqueo de la VM.

    lockwait: 600

script

Script de enlace ejecutado en diferentes etapas del respaldo.

    script: /usr/local/bin/vzdump-enlace.sh

Soporta fases como job-start, backup-start, backup-end y job-end.

Ejemplo de Configuración Mínima

    storage: pbs-backup
    mode: snapshot
    compress: zstd
    prune-backups: keep-daily=7,keep-weekly=4
    ionice: 7
    nice: 19
    mailnotification: failure

Consideraciones

• zstd es el algoritmo de compresión preferido.

• prune-backups reemplaza a maxfiles para la mayoría de los casos de uso.

• Se recomienda el uso Proxmox Backup Server (PBS) para entornos de producción.