Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

16 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐳 Docker CTF Lab - Sistema de Retos Capture The Flag

Laboratorio interactivo estilo HackTheBox para aprendizaje de Docker con validación automática de flags UUID personalizadas

Docker Python Flask MQTT License

📋 Descripción

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.

🎯 Características Principales

  • ✅ 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

🎓 Retos Incluidos

# 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

🚀 Inicio Rápido en GitHub Codespaces

Opción 1: Fork y Codespaces (Recomendado para estudiantes)

  1. Fork este repositorio a tu cuenta de GitHub
  2. Abre Codespaces:
    • Click en el botón verde "Code"
    • Selecciona "Codespaces"
    • Click en "Create codespace on main"
  3. Espera la configuración automática (1-2 minutos)
  4. Ejecuta el script de inicio:
    ./start.sh
  5. Configura tu documento cuando se solicite
  6. ¡Comienza a resolver retos!

Opción 2: Instalación Local

Prerequisitos

  • Python 3.8 o superior
  • Docker instalado y corriendo
  • Git

Pasos

# 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

💻 Uso del Sistema

🌐 Dashboard Web (Recomendado)

./start.sh
# Selecciona opción 1: Iniciar Dashboard Web

Accede en: http://localhost:5000

💻 Línea de Comandos (CLI)

# 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 cleanup

🔒 Sistema de Flags Personalizadas

Cada 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}

📡 Monitoreo MQTT (Solo Profesores)

⚠️ IMPORTANTE: Separación de Roles

  • 👨‍🎓 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.

Para Profesores/Administradores

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 segundos
  • docker_ctf_lab/{documento}/progress - Reporte completo de progreso
  • docker_ctf_lab/{documento}/flag_submit - Notificación de reto completado

Características del Monitor

  • ✅ 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


🎨 Características de la UI

Diseño Hacker-Style

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

Flags UUID

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

📚 Recursos

�️ Tecnologías

  • 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

�👨‍💻 Autor

Edison Enríquez


¿Listo para el desafío? 🐳 Hack the containers!

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages