Ir al contenido
Sistema

Docker en Debian: comprobaciones que se deben realizar antes de iniciar la instalación.

Avatar illustré de Julien Macé 2 min de lectura
Tux vérifie un serveur Debian avec Docker avant l’installation
Avant d’installer Docker sur Debian, vérifiez la version, le dépôt et les ports exposés.

Instalar Docker en Debian no es complicado. El verdadero problema radica en hacerlo demasiado rápido, con un paquete obsoleto. docker.ioun repositorio declarado incorrectamente o un servidor cuyo cortafuegos no ha sido revisado.

En mi caso, siempre prefiero comprobar lo básico antes de comenzar la instalación: versión de Debian, arquitectura, paquetes conflictivos, servicio Docker, grupo de usuarios y prueba. Hola MundoEsto evita que tengas una instalación parcialmente funcional o, peor aún, un contenedor que exponga un puerto cuando creías que aún estabas protegido por UFW.

Tux comprueba un servidor Debian con Docker antes de la instalación.
Antes de instalar Docker en Debian, compruebe la versión, el repositorio y los puertos expuestos.

Primero, compruebe la versión de Debian.

Docker Engine está documentado para Debian 13, Debian 12 y Debian 11. Antes de copiar un comando, asegúrese de identificar claramente la máquina. Esto es especialmente importante si administra un servidor antiguo, una máquina virtual clonada o una distribución derivada.

cat /etc/os-release
cat /etc/debian_version
nombre-m
dpkg --print-architecture

El repositorio de Docker utiliza el nombre en clave Debian, por ejemplo ratón de biblioteca O trixie. Si NOMBRE_EN_CÓDIGO_DE_VERSIÓN Si está vacío, o si está utilizando una distribución derivada, no proceda aleatoriamente. Reemplace manualmente el nombre en clave con el de la base Debian que esté utilizando.

Si tiene alguna duda al respecto, vuelva a leer la guía de LinuxEnCaja sobre el tema. Comandos fiables para comprobar la versión de DebianEste es precisamente el tipo de control que evita depósitos de APT inconsistentes.

Elimine cualquier paquete antiguo que pueda estar causando problemas.

En Debian, el paquete docker.io Puede que se encuentre en los repositorios de la distribución. No sigue el mismo ciclo de instalación que los paquetes oficiales de Docker. Si su objetivo es instalar Docker Engine desde el repositorio oficial, primero elimine cualquier paquete que pueda generar conflictos.

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc podman-docker containerd runc | cut -f1)

Este comando podría simplemente devolver que no hay nada instalado. Eso no es un problema. Sin embargo, no elimina sus contenedores, imágenes, volúmenes y redes antiguos almacenados en /var/lib/dockerNo toque esta carpeta sin una copia de seguridad si la máquina ya ha sido utilizada.

Agregue correctamente el repositorio oficial de Docker.

El método limpio implica un archivo fuente APT dedicado y una clave en /etc/apt/llaverosTe aconsejo que evites los tutoriales antiguos que añaden una clave con clave-aptaEste ya no es el método correcto.

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

A continuación, añade el repositorio de Docker con el nombre en clave de Debian detectado por el sistema:

sudo tee /etc/apt/sources.list.d/docker.sources <

La comprobación sencilla tras este paso:

política de caché de apt docker-ce
grep -R "descargar.docker.com" /etc/apt/sources.list.d/

Deberías ver el repositorio de Docker en las fuentes y un candidato. docker-ceSi APT no encuentra nada, no fuerce la instalación. Primero, corrija el archivo. docker.sources, el nombre en clave o la conectividad de red.

Instala Docker y luego controla el servicio.

La instalación básica incluye Docker Engine, el cliente, containerd, Buildx y el complemento Compose. Este es el paquete habitual para una instalación limpia de Debian en la actualidad.

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

No se detenga en el mensaje de finalización de APT. Verifique que el servicio se haya iniciado correctamente:

sudo systemctl status docker --no-pager
systemctl está activo docker
sudo journalctl -u docker -b --no-pager | size -n 40

Si el servicio no se inicia, comience por revisar los registros. A menudo son más informativos que los reinicios repetidos. Para revisar los servicios activos y las unidades que fallaron, consulte el artículo sobre systemctl y la lista de servicios de Linux Esta comprobación ha finalizado.

Prueba con hello-world, pero no trivialices el grupo de Docker.

La prueba oficial sigue siendo sencilla:

sudo docker run hello-world

Si la imagen se descarga, se ejecuta y muestra su mensaje de confirmación, el motor Docker está funcionando. También puede comprobar las versiones instaladas:

ventana acoplable --versión
versión de Docker Compose
sudo docker info

La tentación entonces es agregar a su usuario al grupo. estibador evitar sudoEs práctico, pero no está exento de riesgos: un usuario perteneciente a este grupo puede obtener privilegios muy elevados a través del demonio de Docker. En una máquina de prueba, ¿por qué no? En un servidor compartido, solo lo haría para una cuenta de administrador claramente identificada.

sudo groupadd docker
sudo usermod -aG docker $USER
Docker de nuevo grupo
Docker Run Hola Mundo

Si iniciaste Docker con sudo Antes de cambiar al grupo, también podría encontrarse con un problema de permisos en ~/.dockerEn este caso, corrija al propietario en lugar de ejecutar todos los comandos al azar:

sudo chown -R "$USER":"$USER" ~/.docker
chmod -R go-rwx ~/.docker

Revise la configuración del firewall antes de exponer un contenedor.

Este es el punto que yo revisaría antes de instalar Docker en un servidor accesible desde internet. Docker manipula las reglas de red, y los puertos publicados por los contenedores pueden eludir lo que crees haber bloqueado con UFW o firewalld.

sudo ss -ltnp
sudo docker ps
sudo docker ps --format "table {{.Names}} {{.Ports}}"
sudo ufw estado numerado

Si va a publicar un servicio, vuelva a leer el comando. -p 127.0.0.1:8080:80 no tiene el mismo impacto que -p 8080:80La primera opción limita la escucha en la máquina local, la segunda expone el puerto en las interfaces disponibles.

Para un servidor Debian expuesto, le aconsejo que también vuelva a leer el Reglas de UFW que se deben configurar antes de abrir un servidor.Docker y el cortafuegos deben considerarse conjuntamente, no por separado.

Las comprobaciones que realizo antes de validar

Antes de dar por finalizada la instalación, realizo esta breve serie de comprobaciones. Es concisa, pero detecta la mayoría de los fallos:

  • cat /etc/os-release confirma la base Debian correcta.
  • política de caché de apt docker-ce apunta al repositorio Docker esperado.
  • sudo systemctl status docker --no-pager No se ha detectado ningún error.
  • sudo docker run hello-world Funciona al menos una vez.
  • versión de Docker Compose Responda si planea usar Compose.
  • sudo ss -ltnp No muestra ningún puerto publicado inesperadamente.

Para ir más allá, mantén el Documentación de Docker para Debian, EL Pasos posteriores a la instalación de Linux y la pagina de Versiones de Debian mantenidasY si Docker se niega a iniciarse, no realice inmediatamente una reinstalación completa: comience por journalctl -u docker -bAhí es donde suele radicar el verdadero error.

Compartir Facebook X WhatsApp LinkedIn Pinterest Reddit Correo