Java

Manual de instalación de Dionaea en Ubuntu 18.04

Manual de instalación de Dionaea en Ubuntu 18.04
Guía técnica · Honeypot · Dionaea

Manual de instalación de Dionaea en Ubuntu 18.04 desde código fuente

Página preparada como manual técnico, con estructura clara, bloques de comandos y una explicación ordenada del proceso completo: dependencias, compilación con cmake, instalación en /opt/dionaea, verificación del binario, configuración, resolución de errores frecuentes y, al final del documento, un enlace para descargar una imagen de Ubuntu con Dionaea ya instalado.

SEO: Dionaea, Ubuntu 18.04, honeypot
Formato: HTML + CSS
Sin JavaScript

1. Visión general

Dionaea se utiliza en entornos de ciberseguridad y análisis para exponer servicios vulnerables controlados, registrar actividad maliciosa y capturar muestras. El procedimiento de este manual sigue un enfoque tradicional: descargar el código fuente, instalar las dependencias necesarias, generar la compilación con cmake, compilar con make e instalar el software bajo /opt/dionaea.

Importante: esta guía está centrada en Ubuntu 18.04. En entornos más modernos pueden cambiar paquetes, nombres de dependencias o compatibilidades, especialmente en torno a libemu.

2. Requisitos previos

  • Un sistema Ubuntu 18.04 con acceso a Internet.
  • Permisos para usar sudo.
  • Espacio suficiente para compilar el proyecto.
  • Acceso a la terminal.
Recomendación de laboratorio
Instala Dionaea en una máquina de pruebas o máquina virtual. En un honeypot conviene trabajar siempre en un entorno aislado y controlado.
Evita producción
No conviene montar un honeypot directamente en un servidor de producción ni mezclarlo con servicios críticos de la empresa.

3. Descargar el código fuente

El primer paso es clonar el repositorio oficial y entrar en el directorio del proyecto. 

git clone https://github.com/DinoTools/dionaea.git
cd dionaea

Una vez dentro del directorio dionaea, ya podrás preparar el entorno de compilación.

4. Instalar las dependencias necesarias

Antes de compilar Dionaea hay que instalar las librerías y herramientas requeridas. Este bloque instala compiladores, cabeceras de desarrollo, librerías de red, componentes Python y tipografías necesarias para algunas utilidades. 

sudo apt-get install \
    build-essential \
    cmake \
    check \
    cython3 \
    libcurl4-openssl-dev \
    libemu-dev \
    libev-dev \
    libglib2.0-dev \
    libloudmouth1-dev \
    libnetfilter-queue-dev \
    libnl-3-dev \
    libpcap-dev \
    libssl-dev \
    libtool \
    libudns-dev \
    python3 \
    python3-dev \
    python3-bson \
    python3-yaml \
    python3-boto3 \
    fonts-liberation

Qué hace este bloque

Grupo Función
build-essential, cmake, libtool, check Herramientas de compilación, configuración y validación.
cython3, python3-dev, python3-yaml, python3-bson, python3-boto3 Soporte Python y módulos auxiliares utilizados por componentes del proyecto.
libev-dev, libpcap-dev, libnetfilter-queue-dev, libnl-3-dev, libudns-dev Captura, eventos de red, colas del kernel y resolución DNS.
libssl-dev, libcurl4-openssl-dev Soporte TLS/SSL y comunicaciones seguras.
libemu-dev Emulación y análisis de shellcode.
fonts-liberation Fuente necesaria para utilidades como util/gnuplotsql.py.

5. Crear el directorio de compilación, compilar e instalar

Lo habitual es no compilar directamente en la raíz del proyecto, sino crear una carpeta build y trabajar desde allí. Esto mantiene el árbol de fuentes limpio.

Crear el directorio de compilación y preparar cmake

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX:PATH=/opt/dionaea ..

El parámetro -DCMAKE_INSTALL_PREFIX:PATH=/opt/dionaea indica a cmake dónde se instalará Dionaea una vez finalice el proceso.

Compilar e instalar

make
sudo make install
Resultado esperado: al terminar, el honeypot quedará instalado en /opt/dionaea.

6. Verificar que la instalación ha quedado correcta

Una vez instalado, el binario principal suele quedar bajo /opt/dionaea/bin/dionaea. La comprobación más rápida consiste en mostrar la ayuda del ejecutable. 

/opt/dionaea/bin/dionaea -H
/opt/dionaea/bin/dionaea -V

Si los comandos devuelven la ayuda o la versión sin errores, la instalación binaria suele estar correcta. Si aparece algún fallo en bibliotecas o rutas, conviene revisar la salida de cmake y los paquetes instalados.

7. Configuración base

El fichero principal de configuración se ubica normalmente en esta ruta: 

/opt/dionaea/etc/dionaea/dionaea.cfg

Desde ese fichero principal se controlan servicios, controladores y módulos complementarios. En una instalación estándar también resultan clave las carpetas: 

/opt/dionaea/etc/dionaea/services-enabled/
/opt/dionaea/etc/dionaea/ihandlers-enabled/
Consejo: antes de tocar configuraciones avanzadas, guarda una copia del archivo original para poder revertir cambios rápidamente.

8. Ejecución manual de Dionaea

Para una primera prueba en consola puedes lanzar Dionaea indicando el fichero de configuración y un nivel de log amplio. 

sudo /opt/dionaea/bin/dionaea \
  -c /opt/dionaea/etc/dionaea/dionaea.cfg \
  -l all,-debug \
  -L '*'

Si prefieres ejecutarlo como demonio y generar un archivo PID: 

sudo /opt/dionaea/bin/dionaea \
  -D \
  -c /opt/dionaea/etc/dionaea/dionaea.cfg \
  -p /opt/dionaea/var/run/dionaea.pid

9. Errores frecuentes y cómo resolverlos

Error: gcc: command not found Faltan herramientas básicas de compilación. Reinstala build-essential.
Error con binding.pyx o Cython Suele indicar versión antigua de Cython o problema al generar bindings.
Error: Python.h not found Faltan cabeceras de desarrollo de Python. Revisa python3-dev.
Error de paquete libemu-dev En sistemas modernos ese paquete puede no estar presente o cambiar de disponibilidad.

Comprobaciones útiles

which gcc
python3 --version
cython3 --version
ls -la /opt/dionaea/bin/
cat /etc/os-release

Si el fallo aparece durante cmake, conviene revisar toda la salida del comando porque suele indicar exactamente qué dependencia no encuentra.

10. Desinstalar Dionaea

Si solo quieres eliminar una instalación realizada bajo la ruta indicada en este manual, el método más directo es borrar la carpeta de instalación. 

sudo rm -rf /opt/dionaea
Atención: revisa la ruta antes de ejecutar este comando. Un rm -rf mal escrito puede eliminar contenido no deseado.

11. Instalación rápida, lista para copiar y pegar

Este bloque reúne todo el flujo principal del manual en orden, útil para una instalación directa. 

git clone https://github.com/DinoTools/dionaea.git
cd dionaea

sudo apt-get install \
    build-essential \
    cmake \
    check \
    cython3 \
    libcurl4-openssl-dev \
    libemu-dev \
    libev-dev \
    libglib2.0-dev \
    libloudmouth1-dev \
    libnetfilter-queue-dev \
    libnl-3-dev \
    libpcap-dev \
    libssl-dev \
    libtool \
    libudns-dev \
    python3 \
    python3-dev \
    python3-bson \
    python3-yaml \
    python3-boto3 \
    fonts-liberation

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX:PATH=/opt/dionaea ..
make
sudo make install

/opt/dionaea/bin/dionaea -H

12. Fuentes oficiales y referencia

13. Descargar Ubuntu con Dionaea ya instalado

Si prefieres ahorrar tiempo y partir de una base ya preparada, al final de este manual dispones de un enlace de descarga para obtener una imagen de Ubuntu con Dionaea ya instalado.

Enlace de descarga:
Descargar Ubuntu con Dionaea instalado

Antes de usar la imagen, conviene revisar la configuración de red, las rutas de logs y los servicios habilitados para adaptarlos a tu laboratorio de ciberseguridad.

Esta versión ya lleva el contenido en la primera columna, como en la maqueta que has enviado: cabecera superior a todo lo ancho y, debajo, una columna izquierda para el índice y una columna derecha para el contenido principal del manual. Además, al final del documento se incluye un enlace para descargar una imagen de Ubuntu con Dionaea ya instalado.

Entradas relacionadas

Publicar comentario

Puede que te hayas perdido