CaryvaneAyuda
/
ES

Copia de seguridad de un servidor Proxmox

Proxmox VE solo hace copias de seguridad incrementales y deduplicadas de una máquina virtual cuando la copia va a algo que habla el protocolo de Proxmox Backup. El agente de Caryvane en un nodo Proxmox lo habla: Proxmox ve un servidor de copias de seguridad en el propio nodo, y cada fragmento (chunk) que envía acaba en el almacenamiento que usted eligió, exactamente con la estructura que mantiene un Proxmox Backup Server. Las copias se programan, ejecutan, examinan y restauran desde la interfaz web de Proxmox, igual que con un Proxmox Backup Server; Caryvane aporta el almacenamiento, el catálogo, las alertas y una clave de recuperación.

Compatible con Proxmox Backup Server

Caryvane no es un producto de Proxmox y no contiene Proxmox Backup Server. Implementa el protocolo que usa Proxmox VE para comunicarse con uno, de modo que Proxmox trata al agente como un servidor de copias de seguridad. Proxmox y Proxmox Backup Server son marcas comerciales de Proxmox Server Solutions GmbH.

1. Instalar el agente en todos los nodos #

Proxmox ejecuta la copia de seguridad de una máquina virtual en el nodo donde está la máquina, y se comunica con el servidor de copias en 127.0.0.1. Por eso cada nodo del clúster necesita el agente de Caryvane para Linux, registrado para el cliente propietario del clúster. Es el agente de Linux normal; no hay un agente aparte para Proxmox. En un nodo Proxmox detecta Proxmox por sí mismo e informa de la versión, y así sabe Caryvane que el equipo puede servir copias de seguridad. Cree el clúster en Caryvane desde cualquier nodo. En cuanto el clúster tiene un área de almacenamiento, cada uno de los demás nodos con el agente instalado se une solo en pocos minutos: demuestra que pertenece al mismo clúster Proxmox con el token de almacenamiento que Proxmox comparte entre sus nodos. Añadir nodo, en la página del clúster, sigue sirviendo para un nodo que quiera incorporar de inmediato. Si elige una máquina que está en un nodo sin agente, el cuadro de diálogo de la tarea lo advierte, y sus copias aparecen como ejecuciones con error que nombran el nodo, no como completadas.

  1. En Caryvane, cree un token de registro para el cliente (Agentes → Registrar agente) y siga las instrucciones de Linux en cada nodo. El paquete es un .deb para Debian, que es lo que ejecuta un nodo Proxmox.
  2. Espere a que cada nodo aparezca en línea. Un nodo con Proxmox muestra su versión de Proxmox en la tarjeta del agente; así sabe el asistente que puede alojar el almacén de datos.

Cada nodo es un agente y se factura como un agente. No se cobra por máquina virtual.

2. El clúster, sus áreas de almacenamiento y qué copiar #

  1. Tareas → Nueva tarea → Hacer una copia de seguridad de un servidor Proxmox. La primera vez, ponga nombre al clúster y elija su primer nodo. Añada los demás nodos después desde la página de Proxmox; no necesitan nada más, porque todos los nodos sirven el mismo certificado.
  2. Hacer copia de seguridad de invitados: marque las máquinas virtuales y los contenedores (la lista llega en directo desde el clúster), o elija Todos los invitados, incluidos los que se creen más adelante o Todos los invitados de un pool de Proxmox. Elija el almacenamiento y una carpeta dentro de él, cuándo (a diario, ciertos días o cada pocas horas) y cuánto tiempo conservar: Una copia al día durante (días) y, opcionalmente, Y al menos las últimas N.

Por ejemplo: la VM 146 conservada 5 días en el almacenamiento M, carpeta proxmox/vm146, y la VM 170 conservada 30 días en el almacenamiento Y son dos tareas. Cada combinación de almacenamiento y carpeta se convierte en un almacenamiento propio en Proxmox, caryvane-nombre, con su propia clave de cifrado, que el agente registra en pocos minutos. La misma máquina puede estar en dos tareas hacia dos áreas de almacenamiento; por ejemplo, cada noche al Reino Unido durante un mes y cada semana a un almacenamiento económico durante un año.

Caryvane escribe cada tarea en el clúster como una tarea de copia de seguridad de Proxmox (Centro de datos → Respaldo; en la interfaz en inglés, Datacenter → Backup; marcada con caryvane-job en su comentario) y la mantiene sincronizada: si la cambia en Caryvane, cambia la tarea de Proxmox; si la elimina, la tarea de Proxmox desaparece. Proxmox se encarga de ejecutarla, así que sus copias incrementales, la congelación mediante el agente invitado y la migración en vivo funcionan con normalidad. No edite esas tareas en Proxmox; Caryvane las restablece. Las tareas de copia que cree usted mismo en Proxmox hacia un almacenamiento de Caryvane siguen funcionando y aparecen en la página de Proxmox como creada en Proxmox.

Ejecutar ahora en una tarea inicia sus copias de inmediato. Cada copia aparece como una ejecución de su tarea, con el tamaño, lo que se envió y lo que ya estaba guardado. Si ninguna copia llega a un área de almacenamiento dentro del intervalo que haya fijado, se marca como retrasada.

Para proveedores: copias en el almacenamiento propio de un cliente #

El servidor Proxmox de un proveedor puede copiar las máquinas virtuales de un cliente en el almacenamiento del cliente, por ejemplo en su propio bucket del Reino Unido. Primero el cliente debe permitirlo: en su destino de almacenamiento, Almacenamiento → … → Permitir los servidores Proxmox de mi proveedor. Solo puede elegirse el almacenamiento de clientes que dependen del proveedor, nunca el de otro proveedor ni el de un cliente del mismo nivel, y el almacenamiento propio del proveedor no necesita ninguna casilla.

3. La clave de cifrado: guarde una copia ahora #

El almacenamiento se crea con una clave de cifrado que Proxmox genera y guarda en /etc/pve/priv/storage/. Cada fragmento se cifra en el nodo antes de salir; Caryvane y el almacenamiento solo ven texto cifrado. Proxmox muestra la clave una sola vez y le pide que la guarde: hágalo, en un gestor de contraseñas o en una copia impresa guardada lejos del clúster. Si se pierde el clúster, la clave se pierde con él.

Hay una segunda vía de vuelta. La entrada del almacenamiento lleva también una clave maestra de Caryvane, y Proxmox cifra con ella una copia de la clave de datos dentro de cada copia de seguridad. Caryvane guarda la mitad privada, cifrada, y un responsable puede descargarla desde la página de la tarea como clave de recuperación. Con la clave de recuperación y las herramientas de Proxmox, cualquier copia vuelve a ser legible aunque el clúster y su clave hayan desaparecido. Descárguela una vez y guárdela junto con la primera; la descarga queda anotada en el registro de auditoría.

No ejecute nunca pvesm set … --encryption-key autogen en el almacenamiento de Caryvane: sustituye la clave sin avisar, y todas las copias anteriores pasan a necesitar la clave de recuperación.

4. Qué se copia y cómo #

Cada copia de Proxmox aparece en Caryvane como una ejecución de la tarea del almacén de datos, una por máquina, con el tamaño, los fragmentos enviados y los bytes reutilizados. La página de la tarea muestra todas las instantáneas de todas las máquinas.

5. Restaurar #

Las restauraciones se hacen en la interfaz web de Proxmox, exactamente igual que desde un Proxmox Backup Server. Caryvane sirve las copias a Proxmox; en Caryvane no hay botón de restaurar para máquinas Proxmox. La página del clúster en Caryvane repite estos pasos con los nombres de sus propios almacenamientos. Los nombres de menú siguientes son los de la interfaz de Proxmox en español; entre paréntesis, los de la interfaz en inglés.

Una máquina completa #

  1. En Proxmox, bajo cualquier nodo, haga clic en el almacenamiento de Caryvane. Su nombre empieza por caryvane- (por ejemplo, caryvane-test); la tarjeta del área de almacenamiento en Caryvane lo muestra.
  2. Abra Respaldos (Backups). Aparecen todas las copias de todas las máquinas de esa área de almacenamiento, de la más reciente a la más antigua.
  3. Elija la copia y haga clic en Restaurar (Restore).
  4. Elija el destino. Un ID de VM nuevo restaura junto al original, la opción segura cuando solo quiere echar un vistazo. El ID de VM propio de la máquina la sustituye; Proxmox le pide que detenga antes la máquina y sobrescribe sus discos.
  5. Elija el almacenamiento de destino para los discos (por ejemplo, su pool de Ceph) e inicie la restauración. El progreso aparece en el registro de tareas de Proxmox, en la parte inferior de la pantalla.

Desde la línea de comandos, qmrestore caryvane-test:backup/vm/153/2026-10-18T17:40:45Z 9153 hace lo mismo (pct restore para un contenedor). En nuestro propio clúster, una máquina de 50 GiB se restauró desde un bucket en la nube en aproximadamente medio minuto y arrancó con normalidad.

Archivos y carpetas sueltos #

  1. Abra el almacenamiento de Caryvane y Respaldos como antes, elija la copia y haga clic en Restauración de archivos (File Restore).
  2. Proxmox inicia una pequeña máquina auxiliar temporal para leer la copia. Abra el disco (por ejemplo, drive-scsi0) y después la partición que contiene los archivos; una partición de intercambio no se puede abrir.
  3. Vaya hasta el archivo o la carpeta y haga clic en Descargar (Download). Una carpeta se descarga como ZIP.

No se escribe nada en la máquina en ejecución; copie usted el archivo de vuelta. La primera vez que se examina una copia tarda un poco más, mientras arranca la máquina auxiliar.

Si se pierde el clúster #

Las copias están a salvo en el almacenamiento, pero cada una está cifrada en el nodo con una clave que Proxmox guardaba en el clúster (/etc/pve/priv/storage/caryvane-<name>.enc). Si guardó una copia de ese archivo cuando Proxmox se lo mostró, póngalo de nuevo en el clúster nuevo y restaure con normalidad. Si no, la clave de recuperación del cliente en Caryvane permite recuperarla:

  1. Instale el agente de Caryvane en un nodo Proxmox del clúster nuevo, añada el nodo a un clúster en Caryvane y añada el mismo almacenamiento, bucket y carpeta como área de almacenamiento. Las copias aparecen bajo el nuevo almacenamiento caryvane- en Proxmox.
  2. En la página del clúster en Caryvane, haga clic en Clave de recuperación junto al cliente y guarde la clave en el nodo como master.pem.
  3. Obtenga la clave cifrada que lleva cada copia y desbloquéela con la clave de recuperación:
    proxmox-backup-client restore vm/153/2026-10-18T17:40:45Z rsa-encrypted.key rsa-encrypted.key \
      --repository 'USER@127.0.0.1:8007:DATASTORE'
    proxmox-backup-client key import-with-master-key old.enc \
      --master-keyfile master.pem --encrypted-keyfile rsa-encrypted.key --kdf none
    USER y DATASTORE son las líneas username y datastore del almacenamiento en /etc/pve/storage.cfg; la contraseña está en /etc/pve/priv/storage/caryvane-<name>.pw (pásela como PBS_PASSWORD), y PBS_FINGERPRINT es la línea fingerprint del almacenamiento. --kdf none deja la clave recuperada sin contraseña, que es lo que admite un almacenamiento de Proxmox.
  4. En Proxmox, Centro de datos → Almacenamiento (Datacenter → Storage), edite el almacenamiento de Caryvane, abra Cifrado (Encryption) y suba old.enc como su clave. Las copias antiguas ya se restauran con normalidad.

Guarde la clave de recuperación de cada cliente en un lugar que sobreviva a la pérdida del clúster. Su descarga queda anotada en el registro de auditoría.

Las instantáneas se pueden proteger y anotar en Proxmox. La retención de cada tarea depura las copias de sus propias máquinas; No conservar nunca más de de un área de almacenamiento, si está definido, elimina además las más antiguas, pero nunca la más reciente de una máquina ni una protegida. Las herramientas propias de Proxmox también funcionan: proxmox-backup-client apuntando a 127.0.0.1:8007 en cualquier nodo, con el token del almacenamiento.

Pruebas de arranque: comprobar que las copias se restauran #

Una copia que nunca se ha restaurado es una esperanza. Una prueba de arranque restaura la copia más reciente de una máquina en el clúster como copia desechable, la arranca, le pregunta quién es, hace una captura de su pantalla y la vuelve a eliminar, según una programación y sin que nadie tenga que vigilar. La página de Proxmox muestra entonces una insignia junto a cada máquina: Arrancó hace 2 días (verde), Arrancó, sin agente invitado (ámbar), Prueba de arranque fallida (rojo) o Sin comprobar. Haga clic en una insignia para ver la captura, el nombre de host y el sistema operativo que indicó la máquina, qué copia se probó y el registro de la ejecución.

Una insignia verde significa que la copia arrancó y respondió a través del agente invitado de QEMU. No prueba las aplicaciones de dentro ni garantiza que todos los archivos estén intactos; es una prueba sólida de que la copia es una máquina que funciona.

Configuración #

  1. En la página del clúster en Caryvane, Pruebas de arranque → Configurar pruebas de arranque.
  2. Marque las máquinas que quiere comprobar. No se comprueba nada que no marque. Las máquinas se comprueban de una en una, empezando por la más pequeña.
  3. Indique el almacenamiento de Proxmox en el que se restauran las copias, por ejemplo local-lvm o un pool de Ceph. Debe existir en el nodo que ejecuta las pruebas (se muestra en la tarjeta; es el nodo que escribe las tareas de copia del clúster).
  4. Fije el tamaño máximo (200 GB si no lo cambia), cuánto tiempo tiene una máquina para arrancar (10 minutos) y los días y la hora. Por defecto, los sábados a las 12:00 UTC, lejos de las copias nocturnas; si hay copias en curso cuando empieza, espera a que terminen.

Comprobar ahora la ejecuta de inmediato. Cada prueba es también una ejecución de la tarea de pruebas de arranque, con su registro, en la lista de tareas.

Qué hace una prueba en el clúster #

Sin el agente invitado de QEMU dentro de la máquina, la insignia solo puede decir que arrancó, por eso es ámbar: abra la captura para ver hasta dónde llegó. Instalar el agente invitado en cada máquina hace además que sus copias sean coherentes con las aplicaciones.

El clúster también puede hacer pruebas de arranque de equipos Windows físicos: una copia de equipo completo puede restaurarse según una programación en una VM desechable de un nodo, con el mismo aislamiento, el mismo rango de ID de VM y la misma limpieza, y un punto de restauración de equipo completo puede restaurarse como una VM de Proxmox permanente.

La captura completa se guarda en el almacenamiento del propio cliente, junto a las copias (verify/VMID/ en la carpeta del área de almacenamiento); Caryvane solo conserva una miniatura. Las pruebas fallidas se envían por correo electrónico a las direcciones de Configuración → Notificaciones; desactive ahí Prueba de arranque fallida si no quiere recibirlas.

6. Qué almacenamiento y qué esperar #

Sirve cualquier destino de almacenamiento de Caryvane. La diferencia está en la velocidad:

Si todavía no puede modificar el clúster #

Hay dos vías que ya funcionan sin instalar nada en los nodos Proxmox. Instale el agente de Caryvane dentro de cada máquina virtual, lo que da copias de archivos y aplicaciones (incluidos Hyper-V, SQL Server y Active Directory en invitados Windows), pero no la restauración de la máquina completa. O programe vzdump en un nodo hacia un directorio local y haga una copia de ese directorio con una tarea de archivos de Caryvane normal; cada volcado nocturno es completo, así que esto conviene para máquinas pequeñas.