Los comandos Docker más importantes

Qué cubre este artículo sobre comandos Docker

• Los comandos Docker esenciales para el día a día.
• Gestión de contenedores, imágenes, volúmenes y redes.
• Docker Compose para configuraciones multicontenedor.
• Secuencias de comandos útiles para servicios de IA locales.
• Obstáculos comunes y consejos prácticos.

Introducción: Los comandos Docker más importantes

Docker es la herramienta estándar para ejecutar aplicaciones en contenedores. Para servicios de IA local como Ollama, Open WebUI, OpenClaw, OpenHands o bases de datos, Docker juega un papel central. Quien domina los comandos esenciales puede iniciar servicios rápidamente, supervisar contenedores, gestionar imágenes y acotarproblemas.

Este artículo resume los comandos Docker y Docker Compose más importantes que se usan regularmente en el hogar y en el trabajo con IA.

Conceptos clave

• Image: Plantilla para un contenedor.
• Container: Instancia en ejecución de una imagen.
• Volume: Almacenamiento persistente para contenedores.
• Network: Red virtual para contenedores.
• Registry: Ubicación de almacenamiento para imágenes, por ejemplo Docker Hub.
• Compose: Herramienta para aplicaciones multicontenedor.
• Dockerfile: Instrucciones de construcción para una imagen.

Gestión de contenedores

Comando	Propósito
docker ps	Mostrar contenedores en ejecución.
docker ps -a	Mostrar todos los contenedores, incluso los detenidos.
docker run <image>	Iniciar un contenedor.
docker run -d --name mein-container <image>	Iniciar contenedor en modo desconectado.
docker start <container>	Iniciar un contenedor.
docker stop <container>	Detener un contenedor.
docker restart <container>	Reiniciar un contenedor.
docker rm <container>	Eliminar un contenedor.
docker exec -it <container> /bin/bash	Acceder a un contenedor en ejecución.
docker logs <container>	Ver registros.
docker logs -f <container>	Seguir registros en tiempo real.

Ejemplos:

docker run -d --name ollama -p 11434:11434 ollama/ollama
docker exec -it ollama /bin/bash
docker logs -f ollama

Gestión de imágenes

Comando	Propósito
docker images	Mostrar imágenes locales.
docker pull <image>	Descargar una imagen.
docker rmi <image>	Eliminar una imagen.
docker build -t <name> .	Construir imagen desde Dockerfile.
docker tag <quelle> <ziel>	Etiquetar una imagen.
docker push <image>	Subir imagen a registry.

Ejemplos:

docker pull ollama/ollama:latest
docker rmi ollama/ollama:latest

Gestión de volúmenes

Comando	Propósito
docker volume ls	Listar volúmenes.
docker volume create <name>	Crear un volumen.
docker volume rm <name>	Eliminar un volumen.
docker volume inspect <name>	Mostrar detalles.

Ejemplo:

docker volume create ollama-data
docker run -d --name ollama -v ollama-data:/root/.ollama -p 11434:11434 ollama/ollama

Gestión de redes

Comando	Propósito
docker network ls	Listar redes.
docker network create <name>	Crear una red.
docker network inspect <name>	Mostrar detalles.
docker network rm <name>	Eliminar una red.

Docker Compose

Comando	Propósito
docker compose up	Iniciar servicios desde compose.yaml.
docker compose up -d	Iniciar en segundo plano.
docker compose down	Detener y eliminar servicios.
docker compose down -v	Eliminar incluyendo volúmenes.
docker compose ps	Mostrar estado.
docker compose logs	Mostrar registros.
docker compose logs -f	Seguir registros en tiempo real.
docker compose pull	Descargar imágenes actuales.
docker compose build	Reconstruir imágenes.
docker compose restart	Reiniciar servicios.

Ejemplo:

docker compose up -d
docker compose logs -f
docker compose down

Sistema y recursos

Comando	Propósito
docker system df	Mostrar uso de almacenamiento.
docker system prune	Eliminar datos no utilizados.
docker system prune -a	Eliminar todas las imágenes y contenedores no utilizados.
docker stats	Mostrar uso de recursos en tiempo real.
docker top <container>	Mostrar procesos en el contenedor.

Secuencias de comandos útiles

Iniciar Ollama con Docker

docker run -d \
  --name ollama \
  --gpus all \
  -v ollama-data:/root/.ollama \
  -p 127.0.0.1:11434:11434 \
  ollama/ollama

Conectar Open WebUI con Ollama

docker run -d \
  --name open-webui \
  -p 8080:8080 \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

Limpiar contenedores

docker stop $(docker ps -q)
docker rm $(docker ps -aq)
docker system prune -f

Precaución: docker system prune -a también elimina imágenes no utilizadas.

Consejos

• Asigna nombres a los contenedores para no trabajar con IDs.
• Utiliza volúmenes para datos persistentes.
• Usa docker compose en lugar de comandos docker run largos.
• Ejecuta docker system prune regularmente para mantener limpio el sistema.
• docker logs -f ayuda a depurar problemas.

Obstáculos comunes

• Puerto ya en uso: Detén otro contenedor o elige un puerto host diferente.
• Faltan datos de volumen: El volumen no se montó al iniciar.
• GPU no reconocida: Olvidaste --gpus all o faltan drivers.
• El contenedor no puede alcanzar el host: Utiliza host.docker.internal.
• Imagen no encontrada: Verificatypo en el nombre de la imagen o no hay conexión a internet.

Enlaces y recursos adicionales

• BotServ.de Docker Fundamentos
• BotServ.de Funciones de Ollama
• BotServ.de Administración de Open WebUI
• BotServ.de Proxmox LXC vs. VM

FAQ: Comandos Docker

¿Cómo veo todos los contenedores en ejecución? Con docker ps.

¿Cómo detengo todos los contenedores? docker stop $(docker ps -q).

¿Cómo elimino todos los contenedores? docker rm $(docker ps -aq).

¿Cuál es la diferencia entre docker y docker compose? Docker gestiona contenedores individuales, Compose gestiona varios contenedores juntos.

¿Cómo accedo a un contenedor por su nombre? En la misma red Docker, por nombre de contenedor, por ejemplo http://ollama:11434.

Fuentes y lectura adicional

• Docker Docs: https://docs.docker.com/
• Docker Compose: https://docs.docker.com/compose/
• Docker Hub: https://hub.docker.com/

Resumen: Los comandos Docker más importantes

Docker es imprescindible para servicios de IA locales. Los comandos esenciales son run, ps, start, stop, logs, exec, images, volume y compose up/down. Con solo algunos comandos puedes iniciar, supervisar y gestionar Ollama, Open WebUI, bases de datos y agentes. Utilizar archivos Compose hace que tus configuraciones sean reproducibles y más fáciles de mantener.