Cómo solucionar el error 'VM is locked (backup/snapshot)' en Proxmox VE

El error TASK ERROR: can't lock file '/var/lock/qemu-server/lock-XXX.conf' - got timeout o el mensaje persistente VM is locked (backup) / VM is locked (snapshot) en la interfaz web de Proxmox Virtual Environment (PVE) ocurre cuando una tarea de mantenimiento se interrumpe de forma abrupta antes de retirar el cerrojo de seguridad.

Proxmox bloquea preventivamente las máquinas virtuales (QEMU) y contenedores (LXC) durante tareas críticas como copias de seguridad con Proxmox Backup Server (PBS), instantáneas (snapshots) o migraciones en vivo para evitar escrituras simultáneas y corrupción de disco. Si el almacenamiento de destino sufre un corte de red o la tarea se cancela a la fuerza, el estado de bloqueo permanece activo indefinidamente impidiendo arrancar, apagar o modificar la máquina desde el panel web.

La Solución Paso a Paso

1. 1

   Paso 1: Verificar y cancelar tareas huérfanas en el nodo

   Antes de forzar el desbloqueo, asegúrate de que ningún proceso en segundo plano continúe escribiendo datos en el disco de la VM. Conéctate por SSH o abre la consola Shell del nodo de Proxmox y lista los procesos activos relacionados con el ID de tu máquina virtual:

   BASH Copiar

   # Reemplaza 105 por el VMID de tu máquina virtual
   ps aux | grep qm | grep 105
   ps aux | grep vzdump
   

   Si ves un proceso de vzdump colgado o sin actividad de entrada/salida (I/O), finalízalo limpiamente o fuerza su detención:

   BASH Copiar

   kill -9 <PID_DEL_PROCESO>
   

2. 2

   Paso 2: Desbloquear máquinas virtuales QEMU con qm unlock

   Si el recurso bloqueado es una máquina virtual KVM/QEMU, ejecuta el comando nativo qm unlock indicando el identificador numérico:

   BASH Copiar

   qm unlock 105
   

   Una vez ejecutado, actualiza la interfaz web de Proxmox. El icono de candado amarillo desaparecerá de inmediato y los botones de control (Start, Stop, Reboot) volverán a estar operativos.

3. 3

   Paso 3: Desbloquear contenedores LXC con pct unlock

   Si el problema ocurre dentro de un contenedor Linux (LXC), la herramienta de gestión correspondiente es pct:

   BASH Copiar

   pct unlock 200
   

   Comprueba el estado del contenedor con:

   BASH Copiar

   pct status 200
   

4. 4

   Paso 4: Eliminar manualmente el bloqueo persistente en la configuración

   En ocasiones excepcionales donde el comando unlock reporta que el cerrojo no existe pero la interfaz gráfica sigue mostrando el estado bloqueado, edita directamente el archivo de configuración de la máquina virtual:

   BASH Copiar

   # Para máquinas virtuales QEMU:
   nano /etc/pve/qemu-server/105.conf
   
   # Para contenedores LXC:
   nano /etc/pve/lxc/200.conf
   

   Busca la línea que comienza por lock: (por ejemplo, lock: backup o lock: snapshot), bórrala por completo, guarda los cambios con Ctrl + O y sal con Ctrl + X. La base de datos de clúster pmxcfs sincronizará el cambio en tiempo real.

Preguntas Frecuentes

¿Es seguro ejecutar qm unlock con la máquina virtual encendida?

Sí, qm unlock solo retira la bandera de bloqueo administrativo a nivel de metadatos de Proxmox. Sin embargo, debes cerciorarte previamente de que no haya un snapshot o backup escribiendo activamente para evitar inconsistencias en la copia de seguridad resultante.

¿Por qué Proxmox no incluye un botón de desbloqueo en la interfaz gráfica?

Por seguridad. El bloqueo previene que los administradores inicien o reinicien máquinas mientras el motor de instantáneas modifica los bloques de disco. La exigencia de usar la línea de comandos garantiza que el operador humano haya verificado el estado real de los procesos del sistema.