Cómo instalar Docker en un VPS Ubuntu
La aplicación funciona en el portátil, pero al servidor le faltan las bibliotecas necesarias. Docker ayuda a describir el entorno de un contenedor y repetir el arranque sin configurar a mano cada componente.
Mostraremos cómo instalar Docker en Ubuntu 24.04 LTS, añadir Docker Compose y comprobar que los datos se conservan. La guía está pensada para un VPS nuevo con sudo y SSH; los ejemplos deben probarse en tu configuración.
Qué preparar para Docker en un VPS
Comprueba el sistema con cat /etc/os-release y la arquitectura con dpkg --print-architecture. La documentación oficial de Docker enumera las versiones y arquitecturas compatibles. No uses el repositorio de otra distribución solo porque el nombre se parezca.
Los recursos los determina la aplicación: Docker por sí mismo no fija un mínimo universal para una web, una base de datos o una cola. Para un contenedor de prueba, deja espacio para imágenes, registros y volúmenes. Revisa df -h antes de instalar.
Si el sistema ya tiene docker.io, el antiguo docker-compose o un containerd aparte, revisa primero los posibles conflictos. No elimines paquetes de un servidor en producción sin un plan para trasladar los contenedores y sin copia de los datos.
«Un resultado repetible empieza con una descripción clara».
El ejemplo siguiente usa docker-ce del repositorio APT oficial. Los comandos se ejecutan en el servidor; no hace falta copiar el signo $ de los ejemplos de la documentación.
Añade el repositorio oficial de Docker
Actualiza la lista de paquetes y prepara el directorio de claves:
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/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.ascEste archivo permite a APT verificar la firma de los paquetes del repositorio. Se descarga del dominio oficial de Docker, no de un espejo cualquiera. A continuación, crea el archivo de origen.
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt updateRevisa los mensajes de apt update. Si el repositorio no es compatible con tu versión o la clave no se puede leer, corrígelo antes de instalar. No desactives la verificación de firmas para ocultar un error.
Instala Engine y el plugin de Compose
Instala los paquetes y comprueba el servicio:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl status docker --no-pager
sudo docker version
sudo docker compose version
sudo docker run --rm hello-worldhello-world debe descargar una imagen de prueba, mostrar una confirmación y terminar. Es una comprobación del motor, no de que tu futura aplicación esté lista. Si el daemon no funciona, revisa journalctl -u docker.
Docker Compose se ejecuta como docker compose, con un espacio. En esta guía no hace falta el antiguo comando separado docker-compose. Anota las versiones del cliente, el daemon y el plugin para poder repetir el resultado.
Trabajaremos con sudo. En la configuración estándar, el acceso al daemon de Docker otorga amplios derechos sobre el host, así que añadir a una persona al grupo docker es una decisión de acceso, no una simple comodidad.
Ejecuta una aplicación sencilla con Compose
Crea un directorio de trabajo con mkdir -p ~/fotbo-demo y entra en él con cd ~/fotbo-demo. Guarda la configuración en el archivo compose.yaml:
services:
web:
image: nginx:stable-alpine
ports:
- "127.0.0.1:8080:80"
volumes:
- site_data:/usr/share/nginx/html
restart: unless-stopped
volumes:
site_data:La etiqueta de la imagen en este ejemplo de aprendizaje puede cambiar con el tiempo. Para un despliegue repetible en producción, anota la versión probada o el digest de la imagen. No des por hecho que una etiqueta nueva es automáticamente compatible con tu aplicación.
El puerto está vinculado a 127.0.0.1, así que la página está disponible en el propio VPS, pero no públicamente en todas las interfaces. Es práctico para una primera comprobación antes de configurar el dominio y HTTPS.
sudo docker compose config
sudo docker compose up -d
sudo docker compose ps
curl http://127.0.0.1:8080/El primer comando comprueba la estructura de la configuración y el último debe devolver HTML. Para abrir la página en tu navegador, crea un túnel SSH desde tu ordenador: ssh -L 8080:127.0.0.1:8080 admin@TU_IP, y después abre localhost:8080.
Comprueba que los datos se conservan en el volumen
El volumen con nombre site_data guarda el contenido por separado del sistema de archivos del contenedor. Si la imagen contiene archivos en el punto de montaje, Docker los copia por defecto a un volumen nuevo y vacío.
Cambia la página de prueba y vuelve a crear el contenedor:
sudo docker compose exec web sh -c 'printf "Fotbo demo\n" > /usr/share/nginx/html/index.html'
sudo docker compose up -d --force-recreate
curl http://127.0.0.1:8080/El texto esperado es Fotbo demo. Si se mantiene tras recrear el contenedor, la comprobación de separación de datos ha funcionado. Esto no es una copia de seguridad: perder el disco del VPS puede destruir el volumen junto con otros archivos.
Los datos importantes necesitan una estrategia de copias aparte. Sobre todo las bases de datos: copiar sin más el directorio de una base en ejecución no siempre produce un estado coherente. Comprueba el método en la documentación de tu SGBD.
Controla el acceso y los puertos abiertos
Publicar un puerto de Docker puede saltarse las reglas habituales de UFW. No supongas que ufw deny cerrará automáticamente cualquier puerto de un contenedor: Docker gestiona sus propias reglas de red.
En nuestro ejemplo, mantén la vinculación a loopback. Para una web pública, configura un proxy inverso, un dominio, TLS y una comprobación desde fuera. No publiques el puerto de una base de datos solo porque aparezca en un ejemplo de Compose.
«La comodidad debe dejar espacio al control».
No montes docker.sock en contenedores cualesquiera ni los ejecutes como privileged sin una necesidad justificada. Revisa el origen de la imagen, los permisos y los secretos. No guardes contraseñas en un repositorio público.
Comandos útiles para el diagnóstico son docker compose logs --tail=50 y docker system df. El primero muestra los registros y el segundo, el uso del disco. No borres todos los volúmenes como forma habitual de liberar espacio.
Actualiza la aplicación conservando los datos
Antes de actualizar, guarda la configuración y una copia de los datos, y lee los cambios de la imagen. Para la versión compatible elegida, ejecuta sudo docker compose pull, después sudo docker compose up -d y repite la comprobación de la página.
El comando docker compose down elimina los contenedores y la red del proyecto, pero por defecto conserva los volúmenes con nombre. La opción down -v elimina los volúmenes del proyecto: no la uses con datos que quieras conservar.
Tras una prueba correcta, anota los comandos de arranque y el procedimiento de recuperación. Para tu próximo proyecto, elige un VPS para Docker y empieza con una configuración probada.
Ahora ya sabes cómo instalar Docker en Ubuntu, ejecutar un contenedor y comprobar los datos tras sustituirlo. Para que Docker sea útil en tu proyecto, aplica esta secuencia de comprobaciones a tu propia aplicación.

ARTÍCULOS SIMILARES




