Proxmox 9¶

En este artículo

• Funcionalidades de implementación
• Instalación de Proxmox 9
• Primer inicio de sesión y verificación básica
• Red: Puente vmbr0
• Discos y almacenamiento
• Carga de imágenes ISO
• Crear 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óstico: Hoja de trucos
• Mini-FAQ
• Lista de verificación de preparación del sistema
• Solicitar un servidor con Proxmox 9 usando la API

En este artículo

• Funcionalidades de implementación
• Instalación de Proxmox 9
• Primer inicio de sesión y verificación básica
• Red: Puente vmbr0
• Discos y almacenamiento
• Carga de imágenes ISO
• Crear primera VM (Ubuntu 25.10)
• Instalación de Windows
• 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óstico: Hoja de trucos
• Mini-FAQ
• Lista de verificación de preparación del sistema
• Solicitar un servidor con Proxmox 9 usando la API

Funcionalidades de implementación¶

Instalación de Proxmox 9¶

Después de instalar el servidor, en un plazo de 15-20 minutos, se realiza la instalación del servicio Proxmox VE. Se enviará un correo electrónico al buzón vinculado a la cuenta, notificándole sobre el servidor instalado y proporcionando un enlace en 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 verificación básica¶

1. Abra su navegador > https://<server_IP>:8006 e introduzca las credenciales:

   

2. Navegue a: Datacenter > Node > Summary - verifique CPU, RAM, discos, tiempo de actividad.

   

3. Desactive el repositorio empresarial si no hay 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: Puente vmbr0¶

El puente vmbr0 es un "conmutador" 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 exista. 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: puerta de enlace predeterminada (generalmente X.X.X.1) (no introduzca si usa DHCP);
   • Bridge ports: su interfaz física, por ejemplo ens1;
   • Guardar > Apply configuration:

   

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

Ejemplo /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:

• Puertos de puente especificados incorrectamente (interfaz física incorrecta) > la red "desaparece". Corrija la interfaz y ejecute ifreload -a.
• Gateway o subred introducidos incorrectamente > existe conexión local pero no hay acceso a internet.

Discos y almacenamiento¶

Agregar un segundo disco para almacenamiento de VM¶

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

   

2. Opción A - LVM-Thin (conveniente para instantáneas):

   • 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), monte 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 se pueden cargar 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 ubuntu-25.10-live-server-amd64.iso local > espere a que finalice la carga.

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

Ejemplo de descarga de Ubuntu 25.10 ISO al almacenamiento local:

cd /var/lib/vz/template/iso

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

Crear 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 como predeterminado, Name - ubuntu2510 (o el suyo):

OS: seleccione 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 después de crear la VM (ver 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): habilite 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 se necesita VLAN: VLAN Tag:

Confirm: verifique 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:

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

3. Reinicie e inicie sesión a través de la 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 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 débiles, Windows puede funcionar de manera inestable.

1. ISO: Descargue las ISOs de Windows Server (2019/2022/2025) y virtio-win.iso (controladores) 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 agregar un segundo CD con controladores:

   

3. System: BIOS OVMF (UEFI);

   • Machine: q35;
   • Si es necesario, habilite Add EFI Disk y Add TPM (para nuevas versiones de Windows). Si no arranca, intente SeaBIOS y deshabilite 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. Confirm: 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). Después de la instalación, configure los controladores de red en el Administrador de dispositivos (NetKVM):

   

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

    

Solución de problemas de Windows:¶

• Pantalla negra/no arranca: Cambie OVMF > SeaBIOS, deshabilite EFI/TPM.
• Sin red: Asegúrese de que NIC = VirtIO y el controlador NetKVM esté instalado.
• Lentitud del disco: Asegúrese de que el disco = SCSI + controlador virtio.

Contenedores LXC: Inicio rápido¶

Las plantillas prefabricadas con software mínimo están 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 contraseña root o 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ático 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.
• Después de iniciar: inicie sesión a través de SSH e instale software desde la plantilla o paquetes:

  apt update && apt -y upgrade
  

  

En LXC, no se necesita Qemu Guest Agent. El montaje de directorios del host se realiza a través de MP (puntos de montaje).

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.
• Anfitriones de contenedores (Docker/Podman): 2–4 vCPUs, 4–8 GB RAM; disco/pool separado para datos.

Alternativa a ISO: Puede usar imágenes Cloud-Init de Ubuntu 25.10 para clonación rápida con red/SSH autoconfigurada. 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ático - especifique IPs en una subred (por ejemplo, 10.10.0.2/24, 10.10.0.3/24) y gateway común 10.10.0.1.
3. Opcionalmente. VLAN: Especifique VLAN Tag en la configuración de la tarjeta de red de las VMs/CT y asegúrese de que el uplink del conmutador permita esta VLAN.
4. Dentro del SO, verifique que el firewall local no bloquee ICMP/SSH/HTTP.
5. Prueba: Desde la VM Ubuntu ping <IP-LXC> y viceversa; ip route, traceroute ayudarán con los problemas.

Cuando hay diferentes subredes:¶

• Proxmox en sí no enruta entre puentes. Se necesita un enrutador (VM separada con Linux/pfSense) o NAT en el host.
• NAT simple en el host (ejemplo):

Habilitar reenvío:

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 el horario de vzdump (almacenamiento, hora, modo instantánea/parada):

  

• Plantilla de VM: Después de la configuración básica de la VM > Convert to Template. Crear nuevas VMs a través de Clone ahorra tiempo y elimina errores:

Problemas comunes y soluciones¶

"La interfaz web desapareció" (GUI no se abre)¶

Verifique si el nodo es accesible a través de SSH. En el nodo, ejecute:

systemctl status pveproxy pvedaemon pve-cluster

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

systemctl restart pveproxy pvedaemon

Red perdida después de editar el puente¶

Conéctese a través de la consola (a través del proveedor/VNC/IPMI). Verifique /etc/network/interfaces y aplique:

ifreload -a

ip a

ip r

La VM no se conecta a internet¶

• Asegúrese de que dentro de la VM se especifiquen IPs/máscara/gateway/DNS correctos.
• Verifique que el Bridge del adaptador de red de la VM sea - vmbr0 (o nat/vmbr1).
• Si se usa VLAN - especifique VLAN Tag en la configuración de la NIC de la VM (Hardware > Network Device > VLAN Tag), y en el uplink del conmutador permita esta VLAN.

La ISO no arranca / Instalador no visible¶

• Verifique el Boot Order (Options > Boot Order) y que la ISO correcta esté conectada.
• Para UEFI, verifique que Secure Boot en el SO invitado no esté habilitado si la ISO no lo admite.

Carga alta / Disco "atascado"¶

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

Webcam/dispositivo USB "desconectado" en VM¶

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

Actualizaciones y reinicio¶

apt update && apt full-upgrade -y

reboot

Diagnóstico: Hoja de trucos¶

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 agregar puentes adicionales (vmbr1) según sea necesario.

P: ¿Dónde están las ISOs por defecto? R: En el almacenamiento local: /var/lib/vz/template/iso.

P: ¿Qué distingue local de local-lvm? R: Local - un directorio regular para ISO, plantillas de contenedores, etc. local-lvm - LVM-Thin para discos de VM/contenedor con instantáneas.

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

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

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

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

Solicitar un servidor con Proxmox 9 usando la API¶

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

Algunos de los contenidos de esta página fueron creados o traducidos usando IA.