{
  "meta": {
    "title": "Comandos de backup de Proxmox — vzdump, qmrestore, pct restore | ProxMenux",
    "description": "Referencia de comandos de backup y restauración de Proxmox VE: vzdump para VMs y contenedores LXC, qmrestore para VMs, pct restore para contenedores, backups programados en /etc/pve/jobs.cfg, hook scripts y rutas excluidas.",
    "ogTitle": "Comandos de backup de Proxmox — vzdump, qmrestore, pct restore",
    "ogDescription": "Referencia de comandos vzdump, qmrestore y pct restore para hacer y restaurar backups de VMs y contenedores LXC de Proxmox.",
    "twitterTitle": "Comandos de backup de Proxmox | ProxMenux",
    "twitterDescription": "Comandos vzdump, qmrestore y pct restore para hacer y restaurar backups de VMs y contenedores de Proxmox."
  },
  "header": {
    "title": "Backup y restauración",
    "description": "Selección de comandos vzdump, qmrestore y pct restore para backups en Proxmox. Incluye programación, opciones avanzadas como hooks, rutas excluidas y prioridad de E/S, y gestión de archivos de copia.",
    "section": "Ayuda e información"
  },
  "intro": {
    "title": "Tres modos de backup",
    "body": "En VM, <strong>snapshot</strong> realiza una copia en vivo y no necesita snapshots del almacenamiento. <strong>suspend</strong> pausa la VM antes de la copia y no mejora necesariamente la consistencia. <strong>stop</strong> la apaga primero; si estaba encendida, puede reanudarse una vez iniciada la copia. En LXC es distinto: snapshot requiere almacenamiento con snapshots, suspend usa dos pasadas de rsync y stop mantiene el contenedor parado durante toda la copia."
  },
  "commandGroups": [
    {
      "title": "Backup de VM",
      "commands": [
        {
          "command": "vzdump <vmid>",
          "description": "Crear un backup de una VM/CT concreta"
        },
        {
          "command": "vzdump <vmid> --storage <storage>",
          "description": "Backup de la VM a un almacenamiento concreto"
        },
        {
          "command": "vzdump <vmid> --mode snapshot",
          "description": "Crear backup por snapshot (para VMs)"
        },
        {
          "command": "vzdump <vmid> --mode suspend",
          "description": "Pausar la VM antes de la copia en vivo, modo suspend heredado"
        },
        {
          "command": "vzdump <vmid> --mode stop",
          "description": "Apagar la VM antes de iniciar la copia"
        },
        {
          "command": "vzdump --all",
          "description": "Backup de todas las VMs y contenedores"
        },
        {
          "command": "vzdump --all --exclude <vmid1>,<vmid2>",
          "description": "Backup de todas excepto las VMs especificadas"
        }
      ]
    },
    {
      "title": "Opciones de backup",
      "commands": [
        {
          "command": "vzdump <vmid> --compress zstd",
          "description": "Usar compresión zstd para el backup"
        },
        {
          "command": "vzdump <vmid> --compress gzip --pigz <threads>",
          "description": "Usar pigz con varios hilos"
        },
        {
          "command": "vzdump <vmid> --storage <storage> --notes-template <text>",
          "description": "Añadir notas al backup"
        },
        {
          "command": "vzdump <vmid> --mailto <email>",
          "description": "Enviar email de notificación"
        },
        {
          "command": "vzdump <vmid> --prune-backups keep-last=<n>",
          "description": "Conservar solo n backups por VM"
        },
        {
          "command": "vzdump <vmid> --stdexcludes 0",
          "description": "No excluir ficheros temporales"
        },
        {
          "command": "vzdump <vmid> --quiet 1",
          "description": "Silenciar mensajes de salida"
        }
      ]
    },
    {
      "title": "Restaurar backups",
      "commands": [
        {
          "command": "qmrestore <backup-file> <vmid>",
          "description": "Restaurar VM desde backup"
        },
        {
          "command": "qmrestore <backup-file> <vmid> --storage <storage>",
          "description": "Restaurar a un almacenamiento concreto"
        },
        {
          "command": "qmrestore <backup-file> <vmid> --unique",
          "description": "Restaurar la VM generando nuevas direcciones MAC aleatorias"
        },
        {
          "command": "pct restore <vmid> <backup-file>",
          "description": "Restaurar contenedor desde backup"
        },
        {
          "command": "pct restore <vmid> <backup-file> --storage <storage>",
          "description": "Restaurar contenedor a un almacenamiento concreto"
        },
        {
          "command": "pct restore <vmid> <backup-file> --rootfs <storage>:<size-GiB>",
          "description": "Restaurar asignando el disco raíz al almacenamiento y tamaño elegidos"
        },
        {
          "command": "pct restore <vmid> <backup-file> --unprivileged 1",
          "description": "Restaurar como CT no privilegiado"
        }
      ]
    },
    {
      "title": "Gestión de backups",
      "commands": [
        {
          "command": "ls -la /var/lib/vz/dump/",
          "description": "Listar backups en la ubicación por defecto"
        },
        {
          "command": "find /var/lib/vz/dump/ -name \"*.vma*\"",
          "description": "Buscar backups de VM"
        },
        {
          "command": "find /var/lib/vz/dump/ -name \"*.tar*\"",
          "description": "Buscar backups de contenedor"
        },
        {
          "command": "pvesm list <storage> --content backup",
          "description": "Listar backups en un almacenamiento concreto"
        },
        {
          "command": "rm /var/lib/vz/dump/<backup-file>",
          "description": "Borrar un fichero de backup"
        },
        {
          "command": "cat /etc/vzdump.conf",
          "description": "Mostrar la configuración de backup"
        }
      ]
    },
    {
      "title": "Backups programados",
      "commands": [
        {
          "command": "cat /etc/pve/jobs.cfg",
          "description": "Mostrar la programación de backups"
        },
        {
          "command": "nano /etc/vzdump.conf",
          "description": "Editar la configuración de backup"
        },
        {
          "command": "systemctl list-timers",
          "description": "Listar temporizadores de systemd"
        },
        {
          "command": "systemctl status cron",
          "description": "Comprobar el estado del servicio cron"
        },
        {
          "command": "pvenode task list --typefilter vzdump",
          "description": "Listar tareas de backup finalizadas"
        },
        {
          "command": "pvenode task log <upid>",
          "description": "Mostrar el registro de una tarea de copia mediante su UPID"
        }
      ]
    },
    {
      "title": "Operaciones avanzadas",
      "commands": [
        {
          "command": "qmrestore <backup> <vmid> --force",
          "description": "Forzar la restauración, sobrescribiendo la VM existente"
        },
        {
          "command": "vzdump <vmid> --dumpdir <directory>",
          "description": "Especificar un directorio personalizado para el backup"
        },
        {
          "command": "vzdump <vmid> --script <script>",
          "description": "Ejecutar un hook script durante el backup"
        },
        {
          "command": "vzdump <vmid> --exclude-path <path>",
          "description": "Excluir rutas concretas del backup"
        },
        {
          "command": "vzdump <vmid> --ionice <priority>",
          "description": "Fijar la prioridad de E/S del proceso de backup"
        },
        {
          "command": "vzdump <vmid> --lockwait <minutes>",
          "description": "Esperar al lock"
        },
        {
          "command": "qm importdisk <vmid> <disk-image> <storage>",
          "description": "Importar un archivo de imagen de disco (por ejemplo raw, qcow2 o vmdk) como disco sin usar, no un archivo de backup de vzdump"
        }
      ]
    }
  ],
  "testRestores": {
    "title": "Prueba tus restauraciones",
    "bodyRich": "Restaura periódicamente una copia en un VMID de prueba libre con <code>qmrestore --unique</code>, arranca la VM en una red aislada y comprueba su contenido. La opción unique genera nuevas direcciones MAC; no cambia las IP estáticas ni la configuración de las aplicaciones. Prueba igual los contenedores con <code>pct restore</code>."
  },
  "related": {
    "heading": "Relacionado",
    "items": [
      {
        "href": "/docs/help-info/vm-ct-commands",
        "label": "Gestión de VM y CT",
        "tail": " — comandos del ciclo de vida con qm y pct."
      },
      {
        "href": "/docs/help-info/storage-commands",
        "label": "Almacenamiento y discos",
        "tail": " — gestión de almacenamiento con pvesm."
      },
      {
        "href": "/docs/help-info",
        "label": "Resumen de Ayuda e información",
        "tail": "."
      }
    ]
  }
}