Proxmox 9¶

En este artículo

• Funcionalidades de implementación
• Instalación de Proxmox 9
• Primer inicio de sesión y comprobación básica
• Red: Bridge vmbr0
• Discos y almacenamiento
• Carga de imágenes ISO
• Crear la primera VM (Ubuntu 25.10)
• Instalación de Windows (para nodos más potentes)
• Contenedores LXC: Inicio rápido
• Perfiles típicos de VM
• Conectar VMs y LXC en una misma red
• Copias de seguridad y plantillas
• Problemas comunes y soluciones
• Diagnósticos: Guía rápida
• Mini-FAQ
• Lista de verificación de preparación del sistema
• Pedir un servidor con Proxmox 9 mediante API

Funcionalidades de implementación¶

Instalación de Proxmox 9¶

Tras la instalación del servidor, en un plazo de 15-20 minutos se realizará la instalación del servicio Proxmox VE. Se enviará un correo electrónico a la dirección vinculada a la cuenta, notificándole sobre el servidor instalado y proporcionándole un enlace con el formato https://proxmox<ID_server>.hostkey.in, al cual debe acceder para entrar en la interfaz web de gestión de Proxmox VE:

• Login - root;
• Password - contraseña del sistema.

Primer inicio de sesión y comprobación básica¶

1. Abra su navegador > https://proxmox{Server_ID}.hostkey.in e introduzca las credenciales:

   

2. Navegue a: Datacenter > Node > Summary - compruebe CPU, RAM, discos y tiempo de actividad (uptime).

   

3. Desactive el repositorio enterprise si no tiene suscripción:

Node > Repositories > pve-enterprise > Disable. Mantenga pve-no-subscription:

Comandos de Terminal:

sed -i 's/^deb/#deb/g' /etc/apt/sources.list.d/pve-enterprise.list || true

apt update

Red: Bridge vmbr0¶

El bridge vmbr0 es un "switch" virtual al que se conectan las VMs. Está vinculado a una interfaz física (por ejemplo, ens18/eno1).

A través de la interfaz web¶

1. Node > System > Network.

   

2. Verifique que vmbr0 existe. Si no existe o no está configurado: Create > Linux Bridge:

   • Name: vmbr0
   • IPv4/CIDR: especifique su IP estática en el formato X.X.X.X/YY (deje en blanco si usa DHCP);
   • Gateway (IPv4): puerta de enlace predeterminada (normalmente X.X.X.1) (no introduzca nada si usa DHCP);
   • Bridge ports: su interfaz física, por ejemplo ens1;
   • Save > Apply configuration:

   

A través de CLI (si se pierde el acceso web)¶

Ejemplo de /etc/network/interfaces (ifupdown2):

auto lo
iface lo inet loopback
auto ens18
iface ens18 inet manual
auto vmbr0
iface vmbr0 inet static
    address 192.0.2.10/24
    gateway 192.0.2.1
    bridge-ports ens18
    bridge-stp off
    bridge-fd 0

ifreload -a

Errores comunes:

• bridge-ports especificado incorrectamente (interfaz física errónea) > la red "desaparece". Corrija la interfaz y ejecute ifreload -a.
• Gateway o subred incorrectos introducidos > existe conexión local pero no hay acceso a Internet.

Discos y almacenamiento¶

Añadir un segundo disco para el almacenamiento de VMs¶

1. Node > Disks: asegúrese de que el nuevo disco sea visible (por ejemplo, sdb).

   

2. Opción A - LVM-Thin (conveniente para snapshots):

   • Disks > LVM-Thin > Create: seleccione el disco > especifique el nombre del VG (por ejemplo, pve2) y el thin-pool (por ejemplo, data2).

   

   • El almacenamiento aparecerá en Datacenter > Storage.

   

3. Opción B - Directory:

   • Cree un sistema de archivos (Disks > ZFS o manualmente mkfs.ext4), móntelo en /mnt/...

   

   • Datacenter > Storage > Add > Directory > ruta /mnt/... > habilite Disk image, ISO image (según sea necesario).

Carga de imágenes ISO¶

Las imágenes ISO pueden cargarse de dos maneras.

A. A través de la interfaz web¶

1. Datacenter > Storage > (seleccione storage con tipo ISO, por ejemplo, local) > Content.
2. Upload > seleccione la ISO local ubuntu-25.10-live-server-amd64.iso > espere a que termine la carga.

B. A través del Nodo (CLI)¶

Ejemplo de descarga de la ISO de Ubuntu 25.10 al almacenamiento local:

cd /var/lib/vz/template/iso

wget https://releases.ubuntu.com/25.10/ubuntu-25.10-live-server-amd64.iso

Crear la primera VM (Ubuntu 25.10)¶

Ejemplo: Ubuntu Server 25.10 (VPS con 2 vCPU)

Haga clic en Create VM (arriba a la derecha):

General: Deje el ID por defecto, Name - ubuntu2510 (o el suyo):

OS: seleccione la ISO ubuntu-25.10-live-server-amd64.iso, Type: Linux:

System:

• Graphics card: Default;
• BIOS: OVMF (UEFI);
• Machine: q35;
• SCSI Controller: VirtIO SCSI single;
• (Opcionalmente) habilite Qemu Agent en Options tras la creación de la VM (ver más abajo):

Disks:

• Bus/Device: SCSI;
• SCSI Controller: VirtIO SCSI single;
• Storage: su LVM-Thin/Directory;
• Size: 20–40 GB (mínimo 10-15 GB para pruebas);
• Discard (TRIM): habilitar en un thin-pool:

CPU:

• Sockets: 1;
• Cores: 2 (según su VPS);
• Type: host (mejor rendimiento):

Memory:

• 2048–4096 MB. Puede habilitar Ballooning (por ejemplo, Min 1024, Max 4096):

Network:

• Model: VirtIO (paravirtualizado);
• Bridge: vmbr0;
• Si necesita VLAN: VLAN Tag:

Confirmar: compruebe la configuración, marque Start after created y haga clic en Finish:

Instalación del SO:¶

1. Inicie la VM > Console (noVNC) > Try or Install Ubuntu:

   

2. Instalador:

   • DHCP/IP estática según sea necesario;
   • Disk: Use entire disk;
   • Profile: usuario/contraseña;
   • OpenSSH server: habilitar.

3. Reinicie e inicie sesión vía consola/SSH.

Post-instalación:¶

sudo apt update && sudo apt -y full-upgrade

sudo apt -y install qemu-guest-agent

sudo systemctl enable --now qemu-guest-agent

Boot Order: si arranca desde la ISO - Options > Boot Order > mueva scsi0 por encima de cdrom.

Instalación de Windows (para nodos más potentes)¶

Adecuado para nodos con ≥4 vCPU/8 GB RAM. En VPS con pocos recursos, Windows puede funcionar de forma inestable.

1. ISO: Descargue las ISOs de Windows Server (2019/2022/2025) y virtio-win.iso (drivers) en Storage > Content:

   

2. Create VM > OS: Microsoft Windows, seleccione la imagen ISO de instalación. La opción Add additional drive for VirtIO drivers le permite añadir un segundo CD con los drivers:

   

3. System: BIOS OVMF (UEFI);

   • Machine: q35;
   • Si es necesario, habilite Add EFI Disk y Add TPM (para versiones nuevas de Windows). Si no arranca, pruebe con SeaBIOS y desactive EFI/TPM:

   

4. Disks:

   • Bus: SCSI;
   • Controller: VirtIO SCSI;
   • Size: 40–80 GB;
   • Habilite IO Threads:

   

5. CPU: 2–4 vCPUs;

   • Type: host:

   

6. Memory: 4–8 GB:

   

7. Network: Model VirtIO (paravirtualizado), Bridge vmbr0:

   

8. Confirmar: Complete la creación de la VM haciendo clic en Create, luego en Hardware > CD/DVD Drive, adjunte una segunda ISO - virtio-win.iso:

   

9. Instalador de Windows: En el paso de selección de disco, haga clic en Load Driver > especifique el CD con VirtIO (vioscsi/viostor). Tras la instalación, configure los drivers de red en el Administrador de dispositivos (NetKVM):

   

10. Guest Agent (opcional): Instale Qemu Guest Agent para Windows usando la virtio-win ISO:

    

Resolución de problemas de Windows:¶

• Pantalla negra/no arranca: Cambie OVMF > SeaBIOS, desactive EFI/TPM.
• Sin red: Asegúrese de que la NIC sea VirtIO y que el driver NetKVM esté instalado.
• Lentitud en disco: Asegúrese de que el disco sea SCSI + driver virtio.

Contenedores LXC: Inicio rápido¶

Hay plantillas preconfiguradas con software mínimo disponibles en el almacenamiento de plantillas.

1. Datacenter > Storage > (seleccione storage con tipo Templates) > Content > Templates. Descargue, por ejemplo: ubuntu-25.04-standard_*.tar.zst u otra plantilla necesaria:

   

2. Haga clic en Create CT:

   • General: Especifique ID/Name, Unprivileged container = Enabled (más seguro por defecto). Establezca la contraseña root o la clave SSH.

   

   • Template: Seleccione la plantilla descargada.

   

   • Disks: Storage/Size (por ejemplo, 8–20 GB).

   

   • CPU/RAM: Según la tarea (por ejemplo, 1 vCPU, 1–2 GB RAM).

   

   • Network: Bridge vmbr0, IPv4 = DHCP (o estática si es necesario). VLAN Tag según sea necesario.

   

Consejo para Red: Si está usando NAT en vmbr1, entonces configúrelo y especifique la IP estática.

- **DNS**: Predeterminado del host o el suyo propio.

- **Features**: Opcionalmente habilite `nesting`, `fuse`, `keyctl` (depende de las aplicaciones en el contenedor).

• Start at boot/Start after created: según desee.
• Tras el inicio: inicie sesión vía SSH e instale el software desde la plantilla o paquetes:

  apt update && apt -y upgrade
  

  

En LXC, no es necesario el Qemu Guest Agent. El montaje de directorios del host se realiza mediante MP (Mount points).

Perfiles típicos de VM¶

• Ubuntu/Debian (Web/DB/Utilidad): SCSI + VirtIO, UEFI (OVMF), 1–2 vCPUs, 2–4 GB RAM, disco 20–60 GB; habilite Qemu Guest Agent.
• Servicios ligeros (DNS/DHCP/Proxy): 1 vCPU, 1–2 GB RAM, disco 8–20 GB.
• Hosts de contenedores (Docker/Podman): 2–4 vCPUs, 4–8 GB RAM; disco/pool separado para datos.

Alternativa a ISO: Puede utilizar imágenes Ubuntu 25.10 Cloud-Init para un clonado rápido con red/SSH autoconfigurados. Adecuado si planea tener muchas VMs similares.

Conectar VMs y LXC en una misma red¶

Variante básica (Una subred):¶

1. Asegúrese de que todas las VMs/contenedores tengan Bridge = vmbr0 (o vmbr1).
2. Si usa una red DHCP, las direcciones se asignan automáticamente; si es estática, especifique las IPs en una misma subred (por ejemplo, 10.10.0.2/24, 10.10.0.3/24) y una puerta de enlace común 10.10.0.1.
3. Opcionalmente, VLAN: Especifique el VLAN Tag en la configuración de la tarjeta de red de las VMs/CT y asegúrese de que el uplink del switch permita esta VLAN.
4. Dentro del SO, compruebe que el firewall local no bloquee ICMP/SSH/HTTP.
5. Prueba: Desde una VM Ubuntu haga ping <IP-LXC> y viceversa; ip route y traceroute ayudarán con los problemas.

Cuando hay diferentes subredes:¶

• Proxmox por sí mismo no enruta entre bridges. Se necesita un router (una VM separada con Linux/pfSense) o NAT en el host.
• NAT simple en el host (ejemplo):

Habilite el reenvío (forwarding):

sysctl -w net.ipv4.ip_forward=1

iptables -t nat -A POSTROUTING -o vmbr0 -j MASQUERADE

EXT_IF=vmbr0

iptables -t nat -C POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE 2>/dev/null || \
iptables -t nat -A POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE

iptables -C FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT

iptables -C FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT

Copias de seguridad y plantillas¶

• Backup: Datacenter > Backup o Node > Backup - configure la programación de vzdump (almacenamiento, hora, modo snapshot/stop):

  

• Plantilla de VM: Tras la configuración básica de la VM > Convert to Template. Crear nuevas VMs mediante Clone ahorra tiempo y elimina errores:

Problemas comunes y soluciones¶

"La interfaz web ha desaparecido" (La GUI no abre)¶

Compruebe si el nodo es accesible vía SSH. En el nodo, ejecute:

systemctl status pveproxy pvedaemon pve-cluster

journalctl -u pveproxy --no-pager -n 100

systemctl restart pveproxy pvedaemon

Pérdida de red tras editar el Bridge¶

Conéctese vía consola (a través del proveedor/VNC/IPMI). Compruebe /etc/network/interfaces y aplique:

ifreload -a

ip a

ip r

La VM no se conecta a Internet¶

• Asegúrese de que en la VM se hayan especificado las IPs/máscara/gateway/DNS correctos.
• Compruebe que el Bridge del adaptador de red de la VM sea vmbr0 (o nat/vmbr1).
• Si se usa VLAN, especifique el VLAN Tag en los ajustes de la NIC de la VM (Hardware > Network Device > VLAN Tag), y asegúrese de que el uplink del switch permita esta VLAN.

La ISO no arranca / El instalador no es visible¶

• Compruebe el Orden de arranque (Options > Boot Order) y que la ISO correcta esté conectada.
• Para UEFI, compruebe si el Secure Boot en el SO invitado no está habilitado si la ISO no lo soporta.

Alta carga / "Atascamiento" de disco¶

• Utilice VirtIO SCSI y habilite IO Threads para un uso intensivo de disco.
• No almacene copias de seguridad en el mismo thin-pool que contiene los discos operativos; es mejor tener un almacenamiento separado.

Webcam/Dispositivo USB "desconectado" en la VM¶

• Para el traspaso de USB (passthrough), utilice Hardware > USB Device. Si el dispositivo deja de responder, realice un Stop/Start de la VM o reconecte el USB en el host. A veces, deshabilitar Use USB3 ayuda con la compatibilidad.

Actualizaciones y reinicio¶

apt update && apt full-upgrade -y

reboot

Diagnósticos: Guía rápida¶

Red del nodo:

ip a; ip r; ping -c3 1.1.1.1; ping -c3 google.com

systemctl status pveproxy pvedaemon pvestatd pve-cluster

journalctl -u pveproxy -n 200 --no-pager

df -h | sort -k5 -h
lvs; vgs; pvs

cat /etc/pve/storage.cfg

qm list; qm config <VMID>; qm status <VMID>

qm stop <VMID> --skiplock; sleep 2; qm start <VMID>

Mini-FAQ¶

P: ¿Se puede renombrar vmbr0? R: Sí, pero no se recomienda en un nodo de producción; es más fácil dejar vmbr0 y añadir bridges adicionales (vmbr1) según sea necesario.

P: ¿Dónde se encuentran las ISO por defecto? R: En el almacenamiento local: /var/lib/vz/template/iso.

P: ¿Qué diferencia hay entre local y local-lvm? R: local: un directorio regular para ISO, plantillas de contenedores, etc. local-lvm: LVM-Thin para discos de VM/contenedores con snapshots.

P: ¿Cómo clonar rápidamente una VM? R: Convierta una VM ejemplar en una Plantilla (Template), luego haga Clone > Full/Linked.

P: ¿Cómo escalar de forma segura la CPU/RAM de una VM? R: Apague la VM y cambie los recursos; para Linux, algunos parámetros pueden cambiarse "en caliente", pero es mejor hacerlo con la máquina apagada.

Lista de verificación de preparación del sistema¶

• Existe acceso a https://<server_IP>:8006;
• vmbr0 está configurado y hay internet desde el nodo;
• Las ISO están cargadas en el almacenamiento;
• La primera VM está creada e instalada;
• Qemu Guest Agent está habilitado;
• La copia de seguridad está configurada (vzdump schedule);
• Las actualizaciones han sido verificadas.

Pedir un servidor con Proxmox 9 mediante API¶

Para instalar este software utilizando la API, siga estas instrucciones.