Repolode
beelzebub-labs

beelzebub-labs/beelzebub

Framework de engaño de código abierto en Go para desplegar servicios señuelo SSH, HTTP, TCP, TELNET y MCP, y capturar interacciones de atacantes como evidencia.

Estrellas
2,232
Forks
221
Issues abiertos
11
Último commit
hace 5 días

¿Qué es?

Beelzebub es un framework de engaño para equipos de seguridad que quieren estudiar la actividad dirigida a servicios señuelo. Los servicios, las rutas y las reglas de respuesta se definen en YAML, y cada respuesta puede ser estática o generada por un proveedor de LLM. Se pueden compilar plugins de Go de confianza para ampliar los servicios y las respuestas.

Cuando un atacante interactúa con un señuelo, el entorno de ejecución captura evidencia como comandos, detalles de solicitudes HTTP y el contexto de la sesión, según el protocolo. Los eventos pueden escribirse en logs locales, publicarse en RabbitMQ o enviarse a Beelzebub Platform; las métricas de Prometheus se pueden habilitar por separado.

El proyecto admite señuelos SSH, HTTP, TCP, TELNET y MCP, con 18 configuraciones de ejemplo que cubren servicios como MySQL, Redis, SMB y MQTT. Puede ejecutarse como binario de Go, mediante Docker Compose o en Kubernetes con Helm.

Funciones clave

  • 01Definir servicios señuelo, rutas y respuestas en YAML.
  • 02Generar respuestas adaptativas con proveedores de LLM o usar manejadores estáticos sin uno.
  • 03Capturar comandos, detalles de solicitudes HTTP y el contexto de la sesión a partir de las interacciones.
  • 04Enviar eventos a logs locales, RabbitMQ o Beelzebub Platform.
  • 05Exponer herramientas señuelo para que los señuelos MCP observen invocaciones sospechosas de agentes.

Casos de uso

  • Estudiar cómo los atacantes exploran servicios SSH, Telnet o similares a bases de datos en un laboratorio aislado.
  • Colocar señuelos HTTP o MCP para recopilar evidencia de solicitudes sospechosas o intentos de prompt injection.
  • Incorporar eventos de interacción con señuelos a una canalización existente de logs o alertas mediante RabbitMQ.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/beelzebub-labs/beelzebub.git
  2. 2

    Entra en el directorio del proyecto

    cd beelzebub
  3. 3

    Ejecuta el instalador en modo Docker

    ./install.sh --docker
  4. 4

    Prueba el señuelo HTTP predeterminado en el puerto 8080

    curl -i http://localhost:8080/

Antes de usarlo

  • Se distribuye bajo la licencia GPL-3.0, una licencia copyleft que exige distribuir las obras derivadas en las mismas condiciones.
  • El instalador inicia servicios de ejemplo en puertos privilegiados, así que solo debe ejecutarse en un host de laboratorio aislado que tengas autorización para usar.
  • Los señuelos basados en LLM requieren un proveedor configurado, y la configuración de Docker necesita Docker Engine con Compose v2.

En colecciones

Temas

Preguntas frecuentes

¿Qué es beelzebub?
Framework de engaño de código abierto en Go para desplegar servicios señuelo SSH, HTTP, TCP, TELNET y MCP, y capturar interacciones de atacantes como evidencia. Beelzebub es un framework de engaño para equipos de seguridad que quieren estudiar la actividad dirigida a servicios señuelo. Los servicios, las rutas y las reglas de respuesta se definen en YAML, y cada respuesta puede ser estática o generada por un proveedor de LLM. Se pueden compilar plugins de Go de confianza para ampliar los servicios y las respuestas.
¿beelzebub es gratuito? ¿Qué licencia tiene?
beelzebub es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿beelzebub sigue mantenido?
Mantenimiento activo. El último commit de beelzebub fue el 3 nov 2026.
¿Para qué puedo usar beelzebub?
Estudiar cómo los atacantes exploran servicios SSH, Telnet o similares a bases de datos en un laboratorio aislado. Colocar señuelos HTTP o MCP para recopilar evidencia de solicitudes sospechosas o intentos de prompt injection. Incorporar eventos de interacción con señuelos a una canalización existente de logs o alertas mediante RabbitMQ.
¿Cómo se instala beelzebub?
Clona el repositorio: git clone https://github.com/beelzebub-labs/beelzebub.git Entra en el directorio del proyecto: cd beelzebub Ejecuta el instalador en modo Docker: ./install.sh --docker Prueba el señuelo HTTP predeterminado en el puerto 8080: curl -i http://localhost:8080/
¿Dónde consigo beelzebub?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/beelzebub-labs/beelzebub

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados