thisistfs/rogue-frameworkBanco de trabajo de escritorio para fuzzing con AFL++, emulación QEMU multiarquitectura, desarrollo de harnesses, análisis headless con Ghidra, mutadores personalizados y comparación de parches para el desarrollo de exploits.
Rogue Framework es un banco de trabajo de escritorio para AFL++, fuzzing QEMU multiplataforma, desarrollo de harnesses, análisis ligero de Ghidra headless, mutadores personalizados y comparación de parches. Es intencionalmente un banco de trabajo auditable en lugar de un envoltorio de solo botones: cada comando de AFL++ generado es visible antes de su ejecución, y los harnesses generados son archivos fuente ordinarios que el investigador puede editar. Se supone que es "El BurpSuite de los desarrolladores de exploits"
Rogue Framework actualmente está dirigido a Linux y Python 3.11+ con PyQt6.
En Kali Linux, el instalador configura el entorno de Python, clona la rama oficial
stable de AFL++ y compila su distribución completa y el backend QEMU
instrumentado, luego instala Ghidra headless, GDB nativo/multiarch, GDB server, emulación
de usuario/sistema QEMU, dependencias de compilación/construcción, un lanzador de usuario y
entradas persistentes en el PATH del shell. AFL++ se descarga en el directorio local ignorado
AFLplusplus/ y no se distribuye como parte de Rogue Framework:
chmod +x install.sh
./install.sh
rogue-framework
Instale también los compiladores cruzados comunes y sus sysroots de invitado (esta es una descarga mucho más grande) con:
./install.sh --with-cross-toolchains
El instalador es idempotente. Use ./install.sh --check para auditar una instalación existente o ./install.sh --rebuild-afl para forzar una recompilación de AFL++/QEMU. Use ./install.sh --update-afl para avanzar explícitamente el checkout descargado a la última revisión estable oficial. Ejecútelo como el usuario de escritorio; solo solicita sudo para los paquetes de apt. Un PATH recién escrito no puede alterar el shell padre que ya está en ejecución, así que abra una nueva terminal, ejecute source ~/.zshrc/~/.bashrc, o inicie Rogue a través de la ruta absoluta ~/.local/bin/rogue-framework que imprime el instalador.
El inicio manual desde el checkout sigue estando disponible:
python3 run.py
Para un entorno editable:
python3 -m pip install -e .
rogue-framework
Los binarios dinámicos de arquitectura cruzada necesitan un sysroot de invitado compatible seleccionado con QEMU_LD_PREFIX; esto es inherentemente específico del objetivo/distribución. La ruta de analyzeHeadless de Ghidra se puede sobrescribir en Tools → External tools.
Un proyecto .rgp es JSON legible y versionado que contiene la definición portátil del proyecto. Los artefactos grandes y mutables residen en su espacio de trabajo complementario gestionado:
example.rgp
example.rgp-work/
workspace.json
project.sqlite3
corpus/
output/
harnesses/
mutators/
analysis/
logs/
runs/
staging/
recovery/
backups/
objects/sha256/
Esta división mantiene los archivos del proyecto revisables y evita incrustar corpus de fallos, hallazgos, índices de análisis o el estado de Ghidra en JSON. workspace.json vincula el manifiesto con la identidad correcta del espacio de trabajo, mientras que project.sqlite3 almacena el estado operativo/indexado. Las referencias gestionadas usan workspace://; los recursos explícitamente externos usan external://. Las rutas de herramientas locales de la máquina y el estado de la interfaz se almacenan fuera del proyecto portátil.
Guardar como crea un clon independiente con nuevas identidades de proyecto y espacio de trabajo. Rogue prepara y valida el destino antes de cambiar el documento abierto, de modo que un clon fallido deja el proyecto de origen sin cambios. Los guardados canónicos usan un arrendamiento de escritor advisory más comprobaciones de conflictos por revisión/SHA-256, conservan los manifiestos previos válidos, publican archivos de forma atómica con fsync y mantienen instantáneas de recuperación ante fallos, incluidos los borradores activos del editor. Los arneses generados, los mutadores, el JSON de Ghidra, los resultados de patch-diff y los hallazgos minimizados también se publican de forma transaccional, de modo que un reemplazo fallido no elimina el artefacto válido anterior.
.fuzzRogue puede importar manifiestos .fuzz heredados de esquema 0–2 y sus compañeros .fuzz-work. El origen heredado nunca es el destino canónico: el primer guardado lo actualiza a un proyecto hermano .rgp y un espacio de trabajo .rgp-work, conservando los archivos heredados originales. Los proyectos nuevos y los destinos de Guardar como siempre usan .rgp.