Laboratorio interactivo estilo HackTheBox para aprendizaje de Docker con validación automática de flags UUID personalizadas
Docker CTF Lab es un sistema de retos progresivos tipo "Capture The Flag" diseñado para aprender Docker de forma práctica e interactiva. Cada estudiante recibe flags UUID personalizadas basadas en su documento de identidad, lo que garantiza la integridad académica y facilita el seguimiento del progreso individual.
- ✅ 15 Retos Progresivos: Desde comandos básicos hasta arquitecturas complejas
- � Flags UUID Personalizadas: Únicas por estudiante usando UUID deterministico (uuid.uuid5)
- 🤖 Validación Automática: Verifica contenedores, redes, volúmenes mediante Docker API
- 🎨 Dashboard Hacker-Style: UI estilo HackTheBox con tema oscuro, efectos Matrix y glow verde neón
- 📡 Monitoreo MQTT en Tiempo Real: Tracking de progreso de estudiantes vía MQTT broker
- 🚀 Auto-configuración: Setup automático en GitHub Codespaces
- 🏆 Sistema de Puntos: 380 puntos totales distribuidos por dificultad
| # | Reto | Categoría | Dificultad | Puntos |
|---|---|---|---|---|
| 1 | 🐳 Primer Contenedor | Comandos Básicos | Principiante | 10 |
| 2 | 🔍 Inspector de Imágenes | Imágenes | Principiante | 10 |
| 3 | 🚀 Contenedor en Background | Ejecución | Principiante | 15 |
| 4 | 🔌 Mapeo de Puertos | Redes | Intermedio | 15 |
| 5 | 💾 Volúmenes Persistentes | Volúmenes | Intermedio | 20 |
| 6 | 🌐 Red Personalizada | Redes | Intermedio | 20 |
| 7 | 🔗 Conectando Contenedores | Redes | Avanzado | 25 |
| 8 | 🔐 SSH en Contenedor | Servicios | Avanzado | 30 |
| 9 | 📡 Telnet Antiguo | Servicios | Avanzado | 30 |
| 10 | 🏭 SCADA Industrial | Aplicaciones | Experto | 35 |
| 11 | 🖥️ Escritorio Remoto VNC | Aplicaciones | Experto | 35 |
| 12 | 🏗️ Dockerfile Personalizado | Construcción | Avanzado | 30 |
| 13 | 📦 Docker Compose Multi-Servicio | Orquestación | Experto | 40 |
| 14 | 🔍 Inspección Avanzada | Diagnóstico | Intermedio | 25 |
| 15 | 🧹 Limpieza Maestra | Mantenimiento | Intermedio | 20 |
Total: 380 puntos disponibles
- Fork este repositorio a tu cuenta de GitHub
- Abre Codespaces:
- Click en el botón verde "Code"
- Selecciona "Codespaces"
- Click en "Create codespace on main"
- Espera la configuración automática (1-2 minutos)
- Ejecuta el script de inicio:
./start.sh
- Configura tu documento cuando se solicite
- ¡Comienza a resolver retos!
- Python 3.8 o superior
- Docker instalado y corriendo
- Git
# 1. Clonar el repositorio
git clone https://github.com/edison-enriquez/ctf_docker_lab.git
cd ctf_docker_lab
# 2. Instalar dependencias
pip install -r requirements.txt
# 3. Dar permisos de ejecución
chmod +x start.sh verify_system.py
# 4. Verificar sistema
./verify_system.py
# 5. Configurar laboratorio
python3 docker_challenge.py setup
# 6. Iniciar dashboard
python3 web_dashboard.py./start.sh
# Selecciona opción 1: Iniciar Dashboard WebAccede en: http://localhost:5000
# Ver todos los retos
python3 docker_challenge.py start
# Ver tu progreso
python3 docker_challenge.py status
# Ver pista de un reto
python3 docker_challenge.py hint 1
# Enviar una flag
python3 docker_challenge.py submit FLAG{primer_contenedor_ABC12345}
# Limpiar contenedores de prueba
python3 docker_challenge.py cleanupCada estudiante recibe flags únicas basadas en su documento de identidad mediante hash SHA-256.
Ejemplo:
Documento: 1234567890
Reto: #1
Flag: FLAG{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
-
👨🎓 ESTUDIANTES: Usan el dashboard principal en
http://localhost:5000- Interface hacker-style para resolver retos
- Envían códigos UUID directamente (sin
FLAG{}) - Ven su propio progreso individual
-
👨🏫 PROFESORES: Usan el monitor MQTT en
http://localhost:5001- Dashboard de monitoreo centralizado
- Ven el progreso de TODOS los estudiantes
- Reciben notificaciones en tiempo real
- Consultan estadísticas globales
El sistema incluye capacidad de monitoreo en tiempo real a través de MQTT. Los estudiantes publican automáticamente eventos de progreso que pueden ser monitoreados centralmente por el profesor.
Consulta la carpeta mqtt_monitor/ que incluye:
- 📖 README completo con especificaciones técnicas
- 🚀 QUICKSTART.md para iniciar rápidamente
- 🖥️ app.py - Servidor de monitoreo con Flask + SocketIO
- 📊 dashboard.html - Plantilla para visualización en tiempo real
- 🧪 mqtt_test_publisher.py - Generador de datos de prueba
- ⚙️ .env.example - Configuración de variables de entorno
Eventos MQTT publicados automáticamente:
docker_ctf_lab/{documento}/heartbeat- Estado online cada 30 segundosdocker_ctf_lab/{documento}/progress- Reporte completo de progresodocker_ctf_lab/{documento}/flag_submit- Notificación de reto completado
- ✅ Vista en tiempo real de todos los estudiantes
- ✅ Estado online/offline automático
- ✅ Notificaciones cuando completan retos
- ✅ Estadísticas globales y rankings
- ✅ Historial de eventos
- ✅ Dashboard estilo hacker (consistente con el lab)
Más información: mqtt_monitor/README.md
El dashboard principal ha sido rediseñado con inspiración en HackTheBox:
- Tema oscuro con colores neón (#00ff41, #00d9ff)
- Fuentes monoespaciadas (Fira Code, Share Tech Mono)
- Efecto Matrix de fondo con lluvia de caracteres
- Glow effects en bordes y textos
- Animaciones de escaneo y shimmer
- Terminal-style con indicadores de estado tipo CLI
- Notificaciones toast con efectos de deslizamiento
Las flags ahora usan formato UUID completo y se envían SIN el prefijo FLAG{}:
Lo que ves en el reto:
12345678-1234-5678-1234-567890abcdef
Lo que copias y pegas:
12345678-1234-5678-1234-567890abcdef
- Generadas con
uuid.uuid5()para determinismo - Únicas por estudiante y por reto
- Imposibles de adivinar pero reproducibles
- NO necesitas escribir
FLAG{...}, solo pega el UUID directo
- TALLER.md - Write-ups y soluciones detalladas
- GUIA_PROFESOR.md - Guía para instructores
- INICIO_RAPIDO.md - Guía rápida para estudiantes
- mqtt_monitor/README.md - Sistema de monitoreo MQTT
- Documentación Docker
- Python 3.8+ - Core del sistema
- Flask - API REST y dashboard web
- Docker Python SDK - Verificación automática
- Paho-MQTT - Cliente MQTT para monitoreo
- HTML5/CSS3/JavaScript - Frontend con efectos avanzados
- WebSockets (SocketIO) - Actualizaciones en tiempo real
Edison Enríquez
- GitHub: @edison-enriquez
¿Listo para el desafío? 🐳 Hack the containers!