Este es un texto traducido por máquina que puede contener errores.
Instalar Docker Engine
Aquí instales Docker Engine y el plugin de Compose en un servidor Linux. Estará completado cuando hello-world responda y Compare muestre un número de versión. Trabaje en la terminal del equipo virtual (VM), una comando a la vez.
Si ya tiene una instalación funcional, vaya a [[Containerbruk Level 1 - Kjor og undersog en container|Ejecutar e inspeccionar un contenedor]].
¿Qué es Docker? explica imagen, contenedor y registro. Contenedores y máquinas virtuales muestra la relación con la VM de Linux.
Requisitos previos
Necesitas un servidor Debian o Ubuntu en Proxmox y permisos de administrador. Abre la Consola de tu propia máquina virtual e inicia sesión. Docker se instala y usa dentro de la máquina virtual, no en el Shell del host de Proxmox. Toda la instalación puede realizarse desde la consola. Iniciar sesión desde tu propio equipo mediante 🔐 SSH es un tema aparte que puedes abordar más adelante.
Debes saber cómo mostrar el directorio actual con pwd, ver su contenido con ls y cambiar de directorio con cd. El ejercicio de CLI en CLI-øvelsen ofrece apoyo para trabajar en la terminal. Usuari y permisos en Linux explica los usuarios y grupos; la configuración específica de root/sudo está detallada en las instrucciones de instalación a continuación.
¿Nuevo en Proxmox o los fundamentos de redes?
[[Instalación del servidor Nivel 2 - VM en Proxmox|🖥️ Instalación del servidor - VM en Proxmox]] muestra cómo crear una VM e instalar Ubuntu o Debian, paso a paso. Si no tienes acceso a Proxmox, [[Instalación del servidor Nivel 1 - Hardware físico|🖥️ Instalación del servidor - Hardware físico]] muestra lo mismo directamente en hardware físico. [[Virtualización Nivel 1 - Tutorial de VMs|🖥️ Virtualización]] es la tarea de evaluación donde más tarde documentarás que dominas esto de forma independiente. [[Protocolos Nivel 1 - Protocolos de red|🌐 Protocolos de red]] cubre direcciones IP y puertos.
Instalar Docker Engine
Sigue la guía de instalación oficial para Docker Engine en Debian o Docker Engine en Ubuntu.
Lee los prerrequisitos y usa Instalación mediante el repositorio apt para tu sistema operativo. Primero configura la fuente del paquete de Docker y luego instala Docker Engine y el complemento Compose como se muestra allí.
Comandos largos sin copiar y pegar
Copiar y pegar a menudo no funciona en la consola de Proxmox, y varias líneas de la guía de instalación son largas. Escribe una línea a la vez y compara carácter por carácter antes de presionar Enter. Si apt update falla después, suele deberse a un error tipográfico en el repositorio del paquete o a un problema de red; consulte “Si algo sale mal”.
¿Debian sin sudo?
Sigue la receta para root y sudo antes de comenzar. Puedes instalar sudo para el usuario normal o ejecutar los comandos de administración como root en la consola de la máquina virtual. Como root, omites sudo delante de los comandos.
La instalación en Debian
Los siguientes comandos se han obtenido de la guía de Docker para el 14 de octubre de 2026. Si no funcionan, es posible que Docker los haya modificado; compárelos entonces con la página oficial. Si utiliza Ubuntu, siga la guía para Ubuntu en su lugar, ya que las direcciones son diferentes.
Algunas palabras en la salida de apt están en sueco o danés, por ejemplo «Sammanfattning» y «Fortsätta?». Esto proviene de la traducción noruega de Debian y no tiene ninguna relevancia para la instalación.
1. Obtenga la clave de Docker. Esta clave permite a apt verificar que los paquetes provienen realmente de Docker.
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
2. Añade la fuente del paquete de Docker. Escribe la primera línea y presiona Enter. La terminal muestra un > antes de cada nueva línea hasta que escribas EOF. Después, tee imprime el contenido del archivo. Allí, Suites debe mostrar el nombre de tu versión de Debian, por ejemplo, trixie.
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
Después de sudo apt update, debe ver líneas de download.docker.com. Si faltan, hay un error tipográfico en el archivo. Consulte “Si algo sale mal”.
3. Instale Docker. Responda S cuando apt pregunte si desea continuar.
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
La animación también muestra sudo docker run hello-world desde la consola inferior.
Verifica la instalación:
docker --version
docker compose version
sudo systemctl status docker
sudo docker run hello-world
hello-world descarga una imagen pequeña, inicia un contenedor de prueba y escribe un mensaje. Presiona q si systemctl status docker muestra el resultado en un paginador y deseas volver a la terminal.
Usa sudo antes de los comandos de Docker más adelante si el usuario habitual no tiene permisos. Si decides otorgar al usuario habitual acceso mediante el grupo docker, ejecuta lo siguiente desde la sesión del usuario habitual. El grupo concede privilegios equivalentes a raíz; hazlo solo para un usuario que vaya a administrar el servidor de práctica:
sudo usermod -aG docker $USER
Si ejecuta esto desde una sesión raíz sin usar sudo, use usermod -aG docker su_usuario y reemplace su_usuario con el usuario normal. $USER en una sesión raíz se refiere a root, no a su usuario normal.
Cierre la sesión y vuelva a iniciarla (o ejecute newgrp docker) para que los cambios surtan efecto. Hasta entonces, puede usar sudo antes de las comandos en los próximos ejercicios.
Punto de control: Docker está instalado
hello-world debe haber mostrado Hello from Docker!, y docker compose version debe mostrar una versión. Si falta uno de los resultados, corrige la instalación antes de iniciar el servidor web. Siempre que sea posible, muestra el comando y la respuesta cuando pidas ayuda.
Si la instalación falla
| Síntoma | Verificación |
|---|---|
No se encuentra docker o docker compose | Que tanto el Engine como el complemento de Compose estén instalados según la guía para tu sistema operativo. |
permission denied en el comando de Docker | Prueba con sudo. Los cambios de grupo requieren un nuevo inicio de sesión. |
| El servicio de Docker no está funcionando | Lee sudo systemctl status docker y el mensaje de error antes de volver a intentarlo. |
apt update muestra Malformed o Unsupported file | Compara el archivo de origen del paquete con la guía de Docker carácter por carácter. |
NO_PUBKEY o is not signed | Asegúrate de que la clave esté descargada en la ruta correcta y sea legible por apt. |
Could not resolve, Failed to fetch, timeout o dial tcp | La máquina virtual no puede alcanzar el repositorio de paquetes ni el registro. Usa [[Método de depuración Nivel 1 - Depuración sistemática |
Siguiente paso
Cuando hello-world haya mostrado Hello from Docker! y Compose muestre una versión, continúas con Ejecutar e inspeccionar un contenedor. Allí obtienes Nginx y verificas qué contenedor responde.
El ejercicio de contenedores se encuentra actualmente en Ejecutar e inspeccionar un contenedor.
Los ejercicios de almacenamiento se encuentran actualmente en Preservar datos fuera del contenedor.