Cómo instalar Proxmox VE 8 sobre Debian 12 Bookworm

Proxmox VE es una plataforma de virtualización de código abierto que combina máquinas virtuales KVM y contenedores LXC con una interfaz web de gestión. Aunque existe una ISO propia, en un servidor dedicado remoto es más cómodo instalarlo sobre un Debian 12 ya instalado. En este tutorial convertirás un servidor dedicado con Debian 12 Bookworm en un nodo Proxmox VE 8, configurarás el bridge de red para las máquinas virtuales, prepararás el uso de IPs adicionales y añadirás el almacenamiento LVM para los discos de las VMs.

Importante

Proxmox VE 8 se basa en Debian 12 y está al final de su ciclo de soporte. Para un nodo nuevo que vaya a estar muchos años en producción, valora instalar Proxmox VE 9 sobre Debian 13 siguiendo la documentación oficial de Proxmox. Esta guía sigue siendo válida para nodos que deban quedarse en Debian 12.

Requisitos previos

Un servidor dedicado de CubePath con Debian 12 Bookworm instalado desde el panel de control (consulta la guía "Instalar el sistema operativo en un servidor dedicado"). Al instalarlo, deja espacio libre en el grupo de volúmenes LVM vg0, que usaremos para los discos de las máquinas virtuales.
Una CPU con virtualización por hardware (Intel VT-x o AMD-V), algo que tienen todos los servidores dedicados actuales.
Acceso SSH como root. Todos los comandos de esta guía se ejecutan como root; si entras con otro usuario, cambia con su -.
La IP principal del servidor, su máscara y su gateway, visibles en tu área de cliente.

Advertencia

en el paso 6 modificarás la configuración de red. Un error puede dejarte sin acceso SSH, así que revisa los datos dos veces antes de aplicar los cambios.

Paso 1: Comprobar el nombre de host

Proxmox necesita que el nombre del servidor resuelva a su IP pública, no a 127.0.1.1. Comprueba qué IP devuelve:

hostname --ip-address

Si la salida no es la IP pública del servidor, edita /etc/hosts:

nano /etc/hosts

Deja una línea con la IP pública, el nombre completo y el nombre corto, y elimina o comenta cualquier línea 127.0.1.1 con el mismo nombre. Sustituye your_server_ip y pve1.your_domain por tus valores:

127.0.0.1       localhost
your_server_ip  pve1.your_domain pve1

Vuelve a comprobarlo; ahora debe mostrar solo la IP pública:

hostname --ip-address

203.0.113.10

Paso 2: Añadir el repositorio de Proxmox VE

Descarga la clave con la que Proxmox firma sus paquetes para Bookworm en el directorio de claves de apt:

install -d -m 0755 /etc/apt/keyrings
wget -qO /etc/apt/keyrings/proxmox-release-bookworm.gpg https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg

Puedes verificar su huella con sha512sum /etc/apt/keyrings/proxmox-release-bookworm.gpg y compararla con la publicada en la página "Install Proxmox VE on Debian 12 Bookworm" del wiki de Proxmox.

Añade el repositorio pve-no-subscription, que no requiere suscripción de pago:

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/proxmox-release-bookworm.gpg] http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-install-repo.list

Actualiza el índice de paquetes y el sistema:

apt update
apt full-upgrade -y

apt update debe mostrar el repositorio de Proxmox sin errores:

Get:4 http://download.proxmox.com/debian/pve bookworm InRelease [2,771 B]
Get:5 http://download.proxmox.com/debian/pve bookworm/pve-no-subscription amd64 Packages [...]

Paso 3: Instalar el kernel de Proxmox

Proxmox VE usa su propio kernel. Instálalo y reinicia para arrancar con él antes de instalar el resto de paquetes:

apt install -y proxmox-default-kernel
systemctl reboot

Cuando vuelvas a conectarte, comprueba el kernel en uso. Debe terminar en -pve:

uname -r

6.8.12-15-pve

Paso 4: Instalar los paquetes de Proxmox VE

Instala Proxmox VE junto con Postfix (para que el nodo pueda enviar notificaciones), open-iscsi y chrony para la sincronización de hora:

apt install -y proxmox-ve postfix open-iscsi chrony

Durante la instalación aparecerá la configuración de Postfix. Si no tienes un servidor de correo propio, elige Local only; si vas a enviar correo a través de un relay, elige Satellite system. En el nombre de correo del sistema, deja el nombre del servidor.

Elimina ahora el kernel de Debian, que ya no se necesita, y regenera la configuración de GRUB:

apt remove -y linux-image-amd64 'linux-image-6.1*'
update-grub

Elimina también os-prober, que en un hipervisor puede detectar sistemas dentro de los discos de las VMs y añadirlos por error al menú de arranque:

apt remove -y os-prober

Si existe el archivo /etc/apt/sources.list.d/pve-enterprise.list, coméntalo o elimínalo: ese repositorio requiere suscripción y apt update devolverá un error 401 Unauthorized sin ella.

Paso 5: Acceder a la interfaz web

Comprueba que el servicio de la interfaz web está activo:

systemctl status pveproxy --no-pager

● pveproxy.service - PVE API Proxy Server
     Loaded: loaded (/lib/systemd/system/pveproxy.service; enabled; preset: enabled)
     Active: active (running) since ...

Abre en el navegador:

https://your_server_ip:8006

Acepta el aviso del certificado autofirmado e inicia sesión con el usuario root, la contraseña de root del sistema y el realm Linux PAM standard authentication. Aparecerá un aviso de que no tienes suscripción válida; puedes cerrarlo, no impide usar Proxmox.

Paso 6: Configurar el bridge de red vmbr0

Las máquinas virtuales se conectan a la red a través de un bridge. Vas a crear vmbr0, moverle la IP principal del servidor y asociarle la interfaz física.

Primero identifica el nombre de la interfaz principal y los datos de red actuales:

ip -br addr
ip route show default

lo               UNKNOWN        127.0.0.1/8 ::1/128
eno1             UP             203.0.113.10/24 fe80::...
default via 203.0.113.1 dev eno1 onlink

En este ejemplo la interfaz es eno1, la IP 203.0.113.10/24 y el gateway 203.0.113.1. Haz una copia de la configuración actual:

cp /etc/network/interfaces /etc/network/interfaces.bak

Edita el archivo:

nano /etc/network/interfaces

Sustituye su contenido por lo siguiente, cambiando eno1, la IP y el gateway por los de tu servidor:

auto lo
iface lo inet loopback

iface eno1 inet manual

auto vmbr0
iface vmbr0 inet static
        address 203.0.113.10/24
        gateway 203.0.113.1
        bridge-ports eno1
        bridge-stp off
        bridge-fd 0

Si el archivo original contenía una sección IPv6 o líneas dns-nameservers, trasládalas al bloque de vmbr0. Aplica la nueva configuración (Proxmox instala ifupdown2, que permite recargar la red sin reiniciar):

ifreload -a

Comprueba que la IP está ahora en el bridge y que hay salida a internet:

ip -br addr show vmbr0
ping -c 3 1.1.1.1

vmbr0            UP             203.0.113.10/24 fe80::...

Si pierdes la conexión, entra por una consola remota (KVM o IPMI) si la tienes disponible, o contacta con soporte; desde la consola, restaura la copia con cp /etc/network/interfaces.bak /etc/network/interfaces y ejecuta ifreload -a.

Paso 7: Preparar el uso de IPs adicionales en las VMs

Si tienes IPs adicionales y quieres asignarlas a máquinas virtuales, activa el reenvío de paquetes IPv4 en el nodo con un archivo propio en /etc/sysctl.d/:

echo "net.ipv4.ip_forward=1" > /etc/sysctl.d/99-ip-forward.conf
sysctl --system

Verifica que está activo:

sysctl net.ipv4.ip_forward

net.ipv4.ip_forward = 1

Al configurar la red dentro de cada VM (conectada a vmbr0), usa estos valores:

Parámetro	Valor
Dirección IP	La IP adicional con máscara `/24`, por ejemplo `198.51.100.25/24`
Gateway	La IP principal del nodo, por ejemplo `203.0.113.10`

Paso 8: Añadir el almacenamiento LVM para las VMs

Los discos de las máquinas virtuales se crearán como volúmenes lógicos dentro del grupo de volúmenes vg0. Comprueba que existe y cuánto espacio libre tiene:

vgs

  VG  #PV #LV #SN Attr   VSize   VFree
  vg0   1   3   0 wz--n- 893.00g 800.00g

En la interfaz web, ve a Datacenter > Storage, pulsa Add y elige LVM. Rellena el formulario así:

ID: local-lvm
Volume group: vg0
Content: Disk image, Container

Añadir almacenamiento LVM en Datacenter > Storage

Formulario de almacenamiento LVM con el grupo de volúmenes vg0

Pulsa Add y comprueba desde la terminal que el almacenamiento está activo:

pvesm status

Name             Type     Status           Total            Used       Available        %
local             dir     active        30832548         3528572        25714730   11.44%
local-lvm         lvm     active       936378368        94371840       842006528   10.08%

A partir de ahora, crea todas las VMs en el almacenamiento local-lvm. Proxmox creará un volumen lógico en vg0 para cada disco de cada máquina virtual.

Conclusión

Tu servidor dedicado funciona ya como nodo Proxmox VE 8, con la red en bridge, reenvío activado para IPs adicionales y almacenamiento LVM listo para las máquinas virtuales. Como siguientes pasos, sube una ISO a local > ISO Images y crea tu primera VM, configura la autenticación en dos pasos para root en Datacenter > Permissions > Two Factor, y planifica copias de seguridad de las VMs en Datacenter > Backup.

On this page