Tutorial 2: Crear una máquina virtual Debian para servicios Docker

En este tutorial vamos a crear una máquina virtual (VM) con Debian en Proxmox VE, desde cero y sin dar por hecho que tienes experiencia previa con la virtualización. El objetivo es disponer de un Linux ligero, estable y administrable desde la red, preparado para alojar servicios que más adelante podrás ejecutar con Docker.

Seguiremos el flujo completo: descargar la ISO oficial, cargarla en Proxmox, definir el hardware virtual, instalar Debian, actualizar el sistema y comprobar el acceso por SSH. No modificaremos la configuración de red del host Proxmox ni las máquinas virtuales que ya tengas.

Qué vamos a montar y qué necesitas

Proxmox VE es el servidor de virtualización; Debian será el sistema operativo invitado que se ejecutará dentro de una VM independiente. Más adelante, Docker podrá ejecutar aplicaciones dentro de Debian sin mezclar sus dependencias con el propio host Proxmox.

Un Proxmox VE instalado y accesible desde el navegador.
Acceso de administrador a la interfaz web.
Conexión a Internet desde el host y desde la futura VM.
Espacio libre en el almacenamiento donde se guardan los discos virtuales.
La ISO oficial de Debian para equipos de 64 bits (amd64).

Importante: una VM consume recursos del equipo físico. Si el host tiene 16 GB de RAM y también ejecuta una VM de Windows configurada con 12 GB, no conviene arrancar a la vez otra VM con mucha memoria asignada. En ese escenario empieza con 2 GB para Debian, limita los servicios que ejecutes simultáneamente y revisa el uso real antes de aumentar recursos.

1. Descargar la ISO oficial de Debian

Descarga Debian desde la web oficial. Para esta guía usaremos la imagen netinst de la versión estable para PC de 64 bits (amd64). Es una descarga pequeña; durante la instalación se descargan de Internet los paquetes que falten.

Descargar la ISO netinst desde Debian.org

Guarda el archivo ISO en tu ordenador. No necesitas crear un USB de arranque: Proxmox montará esa ISO como si fuera el DVD de instalación de la máquina virtual.

2. Subir la ISO a Proxmox

Abre la interfaz web de Proxmox e inicia sesión. En el árbol de la izquierda, selecciona el nodo físico donde crearás la VM y entra en el almacenamiento que tenga habilitado el tipo de contenido ISO image (a menudo se llama local).

Abre la pestaña ISO Images o Imágenes ISO.
Pulsa Upload / Subir.
Selecciona el archivo ISO de Debian que acabas de descargar.
Espera a que termine la transferencia y comprueba que aparece en la lista.

Si no aparece la opción para subir una ISO, comprueba que has seleccionado un almacenamiento que admita imágenes ISO. No cambies el contenido permitido ni borres archivos para resolverlo sin revisar antes la configuración del almacenamiento.

3. Crear la máquina virtual

Selecciona el nodo Proxmox y pulsa Create VM / Crear VM. El asistente divide la configuración en varias pestañas. Los nombres pueden variar ligeramente según la versión, pero las opciones principales son las mismas.

3.1. General

Node: el nodo físico donde quieres alojar Debian.
VM ID: deja el identificador que Proxmox proponga, salvo que tengas un esquema propio.
Name: utiliza un nombre claro, por ejemplo debian-docker-01.

El nombre sirve para identificar la VM en la interfaz; no tiene por qué coincidir con el nombre de equipo que configurarás dentro de Debian.

3.2. OS (sistema operativo)

Selecciona el almacenamiento donde subiste la ISO.
Escoge la imagen ISO de Debian.
Si aparece un selector de tipo o versión, elige Linux y la opción más cercana a la versión de Debian disponible.

3.3. System (sistema)

Para una instalación Linux estándar puedes mantener la mayoría de los valores predeterminados. Si el asistente ofrece QEMU Guest Agent, puedes marcarlo para preparar la integración con Proxmox; más adelante instalaremos el agente dentro de Debian. No cambies opciones de firmware o máquina avanzada sin una necesidad concreta.

3.4. Discos

El disco virtual es el espacio que verá Debian como su unidad interna. Para empezar, una configuración razonable para una VM ligera de servicios es:

Bus/Device: SCSI, si el asistente lo ofrece.
SCSI Controller: VirtIO SCSI single o la opción VirtIO SCSI recomendada por el asistente.
Storage: selecciona el almacenamiento destinado a discos de VM. En cada instalación puede ser distinto; no elijas el almacenamiento de ISO por costumbre.
Disk size: 32 GB para una base pequeña; 64 GB si prevés guardar imágenes Docker, bases de datos o datos de aplicaciones dentro de la VM.
Cache: conserva el valor predeterminado salvo que sepas por qué necesitas cambiarlo.

El tamaño configurado es la capacidad que tendrá el disco virtual. El espacio que ocupará físicamente depende también del tipo de almacenamiento y de cómo esté configurado.

3.5. CPU

Sockets: 1.
Cores: 2 para empezar.
Type: puedes dejar el valor predeterminado si no necesitas una configuración específica de compatibilidad.

Dos núcleos virtuales son suficientes para aprender, administrar Debian y ejecutar algunos servicios ligeros. Si más adelante una aplicación necesita más CPU, podrás apagar la VM y ajustar la asignación.

3.6. Memoria

Usa como punto de partida 2048 MB (2 GB) si tu equipo tiene memoria limitada o ejecuta otras VMs. Si dispones de margen y vas a ejecutar varios contenedores, 4096 MB (4 GB) ofrece más holgura.

No asignes toda la RAM física a las máquinas virtuales: Proxmox y sus servicios también necesitan memoria. En equipos con 16 GB, una VM Windows configurada con 12 GB deja poco margen para mantener varias cargas activas al mismo tiempo.

3.7. Red

Bridge: normalmente vmbr0, si es el puente que ya utiliza tu LAN.
Model: VirtIO (paravirtualized).
VLAN Tag: déjalo en no VLAN si tu red no requiere etiquetar esta VM de forma explícita.
Firewall: puedes mantener habilitada la opción de firewall si ya gestionas sus reglas en Proxmox; recuerda que después tendrás que permitir el tráfico necesario.

Usar vmbr0 suele conectar la VM a la misma red de la interfaz física enlazada al puente. No selecciones otra VLAN ni cambies la configuración del puente del host como parte de este tutorial. La segmentación de Proxmox en VLAN se tratará en el Tutorial 3.

3.8. Confirmar

Revisa el resumen y pulsa Finish / Finalizar. Si aparece una opción para iniciar la VM después de crearla, puedes dejarla marcada. En el árbol de la izquierda debería aparecer la nueva máquina virtual.

4. Instalar Debian en la VM

Selecciona la VM y pulsa Start / Iniciar. Después abre Console / Consola. La máquina debería arrancar desde la ISO que has asociado.

En el menú inicial, selecciona Graphical install o Install. Ambas opciones permiten instalar Debian; la primera usa un asistente gráfico.
Elige idioma, ubicación y distribución del teclado.
Cuando solicite el nombre del equipo, utiliza algo sencillo como debian-docker-01.
Si pregunta por un dominio, puedes dejarlo vacío si no tienes uno configurado en tu red.
Define una contraseña segura para la cuenta administrativa que configure el instalador y crea un usuario normal para el uso diario.
En el particionado, selecciona la opción guiada para utilizar el disco virtual completo. Asegúrate de que se trata del disco de esta VM, no de un disco físico del host.
Confirma los cambios de particionado para escribirlos en el disco virtual.
Selecciona una réplica de Debian cuando te la solicite y deja que el instalador descargue los paquetes necesarios.

Cuando aparezca la selección de software, para un servidor que administrarás por red puedes instalar las utilidades estándar del sistema y el servidor SSH. Si no necesitas escritorio gráfico, desmarca el entorno de escritorio y sus paquetes asociados: consumirán recursos que puedes reservar para los servicios.

Finaliza la instalación y reinicia la VM cuando el instalador lo indique.

5. Desconectar la ISO y arrancar desde el disco

Después de instalar Debian, la VM podría volver a arrancar desde el instalador si la ISO sigue conectada y tiene prioridad de arranque. En Proxmox, abre Hardware, selecciona la unidad de CD/DVD y expulsa la ISO o cambia el orden de arranque para que el disco virtual sea el primero. Reinicia la VM si hace falta.

Si vuelve al menú de instalación, no reinstales Debian de inmediato: comprueba primero que la ISO se ha desconectado y que el disco virtual aparece en el orden de arranque.

6. Actualizar Debian e instalar herramientas básicas

Inicia sesión en la consola con tu usuario. Actualiza el índice de paquetes y aplica las actualizaciones disponibles:

su -
apt update
apt full-upgrade -y
apt install sudo curl ca-certificates gnupg qemu-guest-agent -y

Si has iniciado sesión como el usuario administrador y no como root, el primer comando solicitará la contraseña de root configurada durante la instalación. Si elegiste no definir una contraseña de root y el instalador configuró sudo para tu usuario, ejecuta los comandos administrativos con sudo en lugar de usar su -.

Si el usuario normal no tiene permiso para usar sudo, inicia sesión como root y añádelo al grupo sudo sustituyendo USUARIO por el nombre real de tu cuenta:

usermod -aG sudo USUARIO

Cierra la sesión y vuelve a entrar para que se apliquen los permisos del grupo. No compartas la contraseña de root ni reutilices contraseñas débiles.

7. Activar el QEMU Guest Agent

El agente invitado permite que Proxmox obtenga información adicional de la VM y realice algunas operaciones de forma más integrada. Como lo hemos instalado en el paso anterior, actívalo:

systemctl enable --now qemu-guest-agent
systemctl status qemu-guest-agent --no-pager

El estado debe indicar que el servicio está activo. Después, apaga la VM si es necesario y comprueba en Options / Opciones de Proxmox que QEMU Guest Agent está habilitado. Según la versión y el estado de la VM, puede ser necesario apagarla y volverla a iniciar para que Proxmox empiece a utilizarlo.

8. Comprobar la red y encontrar la IP

Dentro de Debian, ejecuta:

ip -br a
ip route

Busca una interfaz de red con una dirección IP de tu LAN y una ruta por defecto. Si la interfaz no tiene IP, revisa que el adaptador de red virtual esté conectado, que hayas seleccionado el puente correcto y que el servidor DHCP de tu red esté funcionando.

También puedes ver la IP en el resumen de Proxmox cuando el QEMU Guest Agent está activo y puede comunicarla. No supongas que la IP será siempre la misma: si quieres una dirección estable, reserva una IP para la VM en el DHCP de tu router/firewall o configura una IP fija que encaje con tu esquema de red, evitando duplicados.

9. Conectarte por SSH desde tu ordenador

Si durante la instalación habilitaste el servidor SSH, podrás administrar Debian sin depender de la consola web. Desde Windows abre PowerShell o Terminal y ejecuta el siguiente comando, sustituyendo la IP y el usuario por los de tu VM:

ssh usuario@192.168.1.50

La primera conexión puede pedirte confirmar la huella de la máquina; comprueba que estás conectándote a la IP correcta antes de aceptarla. Después introduce la contraseña de tu usuario. Si la conexión falla, confirma la IP con ip -br a y revisa el estado del servicio:

systemctl status ssh --no-pager

Si el servidor SSH no está instalado, puedes hacerlo desde la consola de Proxmox con apt install openssh-server -y y activarlo con systemctl enable --now ssh. Para un homelab, evita exponer SSH directamente a Internet; accede desde la LAN o mediante una VPN y mantén las actualizaciones al día.

10. Dejar Debian preparado para Docker

En este punto ya tienes una VM Debian funcional, actualizada y administrable por SSH. Antes de instalar aplicaciones, comprueba que el sistema tiene espacio disponible y que puede salir a Internet:

df -h
free -h
ping -c 3 deb.debian.org

Si las comprobaciones son correctas, la VM está preparada para el siguiente paso: instalar Docker Engine y desplegar servicios de forma aislada. Conviene instalar Docker desde la documentación oficial y elegir el método adecuado para la versión de Debian instalada, en lugar de ejecutar scripts desconocidos copiados de Internet.

Documentación oficial: instalar Docker Engine en Debian

No hace falta instalar Docker en el host Proxmox para seguir esta arquitectura: Docker irá dentro de Debian, que a su vez es una VM. Así mantienes separada la capa de virtualización de las aplicaciones y puedes hacer copias de seguridad de la VM desde Proxmox.

11. Errores habituales y cómo resolverlos

La VM no arranca desde la ISO

Comprueba que la ISO se ha subido correctamente, que está seleccionada en el CD/DVD virtual y que el orden de arranque permite iniciar desde ese dispositivo.

La VM no obtiene dirección IP

Comprueba que la tarjeta virtual está conectada, que el puente seleccionado es el adecuado y que el DHCP de la red está disponible. No cambies la configuración de red del host Proxmox para solucionar un problema que puede estar limitado a la VM.

La consola muestra una pantalla negra o no responde

Espera unos instantes y revisa la pestaña Summary / Resumen y las tareas recientes de Proxmox. Si la VM no tiene recursos suficientes, apágala y revisa CPU y memoria antes de volver a arrancarla.

Debian se instala, pero vuelve al instalador al reiniciar

Expulsa la ISO del CD/DVD virtual y comprueba que el disco virtual está seleccionado como dispositivo de arranque.

La VM funciona, pero Proxmox no muestra su IP

Instala y activa qemu-guest-agent dentro de Debian y habilita la opción correspondiente en Proxmox. Mientras tanto, puedes consultar la dirección con ip -br a desde la consola.

12. Comprobación final

Antes de dar por terminado el tutorial, revisa esta lista:

La VM aparece en Proxmox y arranca sin errores.
Debian inicia desde su disco virtual y no desde la ISO.
El sistema está actualizado.
La VM obtiene una IP válida y tiene conectividad.
El acceso por SSH funciona desde tu red local.
El servicio QEMU Guest Agent está activo, si has decidido habilitarlo.
La RAM y la CPU asignadas dejan recursos suficientes para el host y las demás VMs.

Qué viene después

Ya tienes la base Linux sobre la que desplegar servicios. En el siguiente tutorial de la serie abordaremos cómo conectar Proxmox a una red VLAN de forma segura, revisando los conceptos de puente, VLAN y conectividad antes de cambiar la configuración. Haz primero una copia de seguridad de cualquier VM importante y no modifiques el puente de gestión si no tienes una vía alternativa de acceso al host.

CLHOME — Tu homelab, bajo control.