Binlex – Ein Lexer-Framework für binäre genetische Merkmale Wenn Maldevs denken, ihr Binary sei FUD, dann steht ihnen eine existenzielle Krise bevor.

Binlex extrahiert Anweisungen, Grundblöcke und Funktionen aus Binärdateien und erzeugt durchsuchbare JSON-Merkmale für Reverse Engineering, Jagd und Ähnlichkeits-Workflows. Es modelliert die Binärstruktur mit einer von der Genomik inspirierten Hierarchie: Genome (Anweisungen, Blöcke, Funktionen), Chromosomen (Muster mit Wildcards), Allelpaare (Bytes) und Gene (Nibbles). Diese Darstellung macht Malware-Analyse und binäre Ähnlichkeit systematischer, indem sie Mustervergleiche, Clustering und Signaturerstellung über große Probensammlungen ermöglicht.

Features

• 🧬 Schnelle Merkmalsextraktion für Anweisungen, Blöcke und Funktionen
• 🔐 Hashing und Merkmale: MinHash, TLSH, SHA256, Entropie und Wildcard-Muster
• 📈 Normalisierungs- und Feature-Pipelines für ML-orientierte Ähnlichkeits-Workflows
• 🧰 Schnittstellen: CLI, Rust-API, Python-API/Bindings und IDA-Plugin
• ⚙️ Processor-Framework in Rust mit schneller externer Ausführung über ipc und http
• 🧠 Baue deine eigenen Rust-Processor, um zusätzliche Analysen durchzuführen
• 🎯 Werkzeuge für YARA-Erzeugung, Symbol-Import und Batch-JSON-Workflows

Unterstützte Ziele 🌐

• Plattformen: Linux, macOS, Windows
• Formate: PE, ELF, Mach-O
• Architekturen: AMD64, I386, CIL

Enthaltene Befehlszeilen-Tool-Suite 🧰

• binlex: Haupt-CLI zur Extraktion binärer Merkmale
• binlex-mcp: Model-Context-Protocol-Server zur Bereitstellung von Binlex-Werkzeugen für MCP-Clients
• binlex-server: Processor-Transportserver für http-Workflows
• binlex-hash: Hash-Dienstprogramm
• binlex-image: Dienstprogramm für Bildoperationen
• binlex-symbols: Hilfsprogramm zum Import und zur Konvertierung von Symbolen
• binlex-yara: YARA-Regeln aus Binlex-artigen Mustern oder Streams erzeugen

Build & Installation 🛠️

Rust-API & Werkzeuge

cargo run --manifest-path xtask/Cargo.toml
cargo build --release --workspace

Python-Bindings 🐍

cd bindings/python/
virtualenv -p python3 venv/
source venv/bin/activate
pip install maturin[patchelf]
maturin develop

Paketierung 📦

make zst   # Arch Linux
make deb   # Debian-based
make wheel # Python Wheel

IDA-Plugin 🧠

cd plugins/ida/
pip install .
python -m binlex_ida install

Docker-Container

# Local Build and Start
docker compose -f compose.yml -f compose.local.yml up --build -d
# Start Using Docker Hub
docker compose -f compose.yml -f compose.remote.yml up -d

Dokumentation 📚

Anleitungen

• Befehlszeilen-Anleitung
• Benutzerdefinierte Processor

Beispiele 🧪

• Python-Beispiele
• Rust-Beispiele

Rust-API

cargo doc --open

Konfiguration 📁

Standard-Verzeichnisse für die Konfiguration:

• Linux: $XDG_CONFIG_HOME/binlex/binlex.toml oder $HOME/.config/binlex/
• macOS: $HOME/Library/Application Support/binlex/
• Windows: %APPDATA%\binlex\

Zitieren 📖

Wenn du Binlex in einer Zeitschriftenpublikation oder einem Open-Source-KI-Modell verwendest, zitiere:

@misc{binlex,
  author = {c3rb3ru5d3d53c},
  title = {binlex: A Binary Genetic Trait Lexer Framework},
  year = {2025},
  note = {Available at \url{https://github.com/c3rb3ru5d3d53c/binlex}}
}

Für jede andere geschäftliche/persönliche Nutzung oder generierte Ausgaben (zum Beispiel YARA-Regeln) ist keine Zitierung erforderlich.