Cómo hacer backups y snapshots en Proxmox VE: vzdump y qmrestore

Si ejecuta máquinas virtuales o vende VPS en un servidor dedicado, las copias de seguridad y los snapshots de Proxmox VE deben planificarse antes de que algo salga mal: los archivos borrados, las actualizaciones fallidas y las intrusiones se recuperan a partir de ellos. Esta guía explica los tres modos de copia de vzdump, las tareas de copia programadas, la restauración con qmrestore y pct restore, la diferencia entre snapshots y copias de seguridad, lo que aporta Proxmox Backup Server y cómo planificar el espacio de almacenamiento. Se aplica a Proxmox VE 7.x/8.x; ejecute los comandos como root en el host.

Paso 1: Compruebe el almacenamiento de Proxmox y el espacio para copias

El almacenamiento local predeterminado (/var/lib/vz) puede contener archivos de copia de seguridad; local-lvm almacena discos de VM, pero no copias. Compruebe primero el espacio libre y los invitados existentes:

pvesm status
df -h /var/lib/vz
qm list
pct list
ls -lh /var/lib/vz/dump/

Paso 2: Copias manuales con vzdump (modos snapshot, suspend y stop)

vzdump es la herramienta de copia de seguridad integrada. Los modos se diferencian así:

• snapshot: copia en vivo sin tiempo de inactividad; la opción más habitual. Con QEMU Guest Agent activado, el sistema de archivos se congela brevemente para mejorar la coherencia.
• suspend: principalmente para contenedores; primero se sincronizan los datos y luego el invitado se suspende brevemente.
• stop: el invitado se apaga, se copia y se vuelve a iniciar; es el más coherente, pero provoca tiempo de inactividad.

# one VM, live, zstd compressed, to storage "local"
vzdump 100 --mode snapshot --storage local --compress zstd

# one container, suspend mode
vzdump 101 --mode suspend --storage local --compress zstd

# stop mode: most consistent, guest is shut down during backup
vzdump 102 --mode stop --storage local --compress zstd

# all guests on this node, with a note
vzdump --all --mode snapshot --storage local --compress zstd --notes-template '{{guestname}} manual'

La compresión zstd es rápida y compacta. Los archivos se guardan en /var/lib/vz/dump/ como .vma.zst para las VMs y .tar.zst para los contenedores.

Paso 3: Cree una tarea de copia programada con política de retención

En la interfaz web, vaya a Datacenter → Backup → Add, elija nodo, almacenamiento, programación, modo y compresión, y defina cuántas copias conservar en la pestaña Retention. La misma tarea desde la línea de comandos:

# every day 02:30, all guests, keep 7 daily + 4 weekly
pvesh create /cluster/backup --schedule '02:30' --all 1 \
  --storage local --mode snapshot --compress zstd \
  --prune-backups keep-daily=7,keep-weekly=4 --enabled 1

pvesh get /cluster/backup
# preview when a schedule will run
systemd-analyze calendar '02:30'

prune-backups controla la limpieza automática; keep-daily=7,keep-weekly=4 conserva una copia diaria durante 7 días y una semanal durante 4 semanas. Sin una política de retención, las copias se acumulan hasta llenar el disco.

Paso 4: Restaure copias con qmrestore y pct restore

Restaure primero en un nuevo ID de VM, verifique los datos y luego haga el cambio, para no sobrescribir el original. Para sobrescribir a propósito, detenga el invitado y añada --force 1:

# list backup files on a storage
pvesm list local --content backup

# restore a VM backup to a NEW id 120 on local-lvm
qmrestore /var/lib/vz/dump/vzdump-qemu-100-2026_10_01-02_30_00.vma.zst 120 --storage local-lvm

# overwrite the existing VM 100 (VM must be stopped)
qm stop 100
qmrestore /var/lib/vz/dump/vzdump-qemu-100-2026_10_01-02_30_00.vma.zst 100 --force 1

# restore a container backup
pct restore 121 /var/lib/vz/dump/vzdump-lxc-101-2026_10_01-02_30_00.tar.zst --storage local-lvm

Paso 5: Cree y revierta snapshots en Proxmox (snapshots frente a copias de seguridad)

Un snapshot registra el estado del disco (y, opcionalmente, de la RAM) en un momento dado; crearlo y revertirlo lleva segundos, lo que es ideal antes de actualizar el sistema operativo o cambiar la configuración. Pero los snapshots residen en el mismo almacenamiento que el disco, desaparecen con él si la unidad falla, y crecen y ralentizan el disco si se conservan mucho tiempo. En resumen: los snapshots sirven para revertir cambios a corto plazo; las copias de seguridad, para la protección real de los datos.

# take a snapshot before an upgrade (add --vmstate 1 to include RAM)
qm snapshot 100 before_upgrade --description "before apt full-upgrade"
qm listsnapshot 100

# roll back if something breaks
qm rollback 100 before_upgrade

# delete it when no longer needed
qm delsnapshot 100 before_upgrade

# containers use pct
pct snapshot 101 before_upgrade
pct rollback 101 before_upgrade

Los snapshots requieren un almacenamiento compatible, como LVM-thin, ZFS, Ceph o qcow2 en almacenamiento de directorio; LVM normal y las imágenes raw no los admiten.

Paso 6: Proxmox Backup Server y planificación del espacio de almacenamiento

Proxmox Backup Server (PBS) es el servidor de copias de seguridad dedicado de Proxmox. Ofrece copias incrementales, deduplicación, cifrado y verificación; una copia diaria solo transfiere los bloques modificados, por lo que el espacio y el tiempo son muy inferiores a los de los archivos completos de vzdump. Normalmente PBS se ejecuta en otro servidor o en otro centro de datos, y se añade en Datacenter → Storage → Add → Proxmox Backup Server indicando su dirección, datastore, usuario y huella digital (fingerprint).

# after adding the PBS storage in Datacenter -> Storage, check it
pvesm status
# back up to it like any other storage (named "pbs1" here)
vzdump 100 --mode snapshot --storage pbs1

Cálculo aproximado para vzdump: datos usados por invitado × ratio de compresión (zstd suele estar entre 0,4 y 0,7) × número de copias conservadas, más un 20 % de margen. Diez invitados con 20 GB usados, conservando 7 copias, necesitan unos 10 × 20 × 0,6 × 7 ≈ 840 GB. Con la deduplicación de PBS suele ser mucho menos.

Preguntas frecuentes

La copia en modo snapshot indica «guest-agent not running»

La opción QEMU Guest Agent está activada en la VM, pero el agente no se está ejecutando dentro de ella. Instale e inicie qemu-guest-agent (apt en Debian/Ubuntu, dnf en CentOS/Rocky/AlmaLinux) o desactive la opción en Proxmox.

Las copias de seguridad llenaron el almacenamiento local

Defina una política de retención razonable en la tarea, elimine de /var/lib/vz/dump/ los archivos antiguos que ya no necesite (compruébelo bien antes de borrar) o traslade el destino de las copias a un disco independiente o a PBS.

¿Bastan los snapshots por sí solos?

No. Los snapshots dependen del almacenamiento original y desaparecen con él si el disco falla, se corrompe o se elimina la VM. Conserve al menos una copia de seguridad en otro disco o servidor.

¿Sigue con problemas? Abra un ticket con el soporte técnico 24/7 de IMIDC: https://www.imidc.com/submitticket.php