Binlex — фреймворк-лексер бинарных генетических признаков Если малдевы считают, что их бинарник FUD, их ждёт экзистенциальный кризис.

Binlex извлекает инструкции, базовые блоки и функции из бинарных файлов и генерирует доступные для поиска JSON-признаки для рабочих процессов реверс-инжиниринга, поиска угроз и анализа сходства. Он моделирует структуру бинарных файлов с помощью иерархии, вдохновлённой геномикой: геномы (инструкции, блоки, функции), хромосомы (паттерны с подстановочными символами), аллельные пары (байты) и гены (нибблы). Такое представление делает анализ вредоносных программ и определение сходства бинарных файлов более систематичными, позволяя сравнивать на уровне паттернов, выполнять кластеризацию и генерировать сигнатуры на больших наборах образцов.

Возможности

• 🧬 Быстрое извлечение признаков для инструкций, блоков и функций
• 🔐 Хеширование и признаки: MinHash, TLSH, SHA256, энтропия и паттерны с подстановочными символами
• 📈 Нормализация и конвейеры признаков для ML-ориентированных рабочих процессов анализа сходства
• 🧰 Интерфейсы: CLI, Rust API, привязки Python и плагин для IDA
• ⚙️ Фреймворк процессоров на Rust с быстрым внешним выполнением через ipc и http
• 🧠 Создавайте собственные процессоры на Rust для выполнения дополнительного анализа
• 🎯 Инструменты для генерации YARA, загрузки символов и пакетной обработки JSON

Поддерживаемые целевые платформы 🌐

• Платформы: Linux, macOS, Windows
• Форматы: PE, ELF, Mach-O
• Архитектуры: AMD64, I386, CIL

Комплект инструментов командной строки 🧰

• binlex: основной CLI для извлечения признаков из бинарных файлов
• binlex-mcp: сервер Model Context Protocol для предоставления инструментов Binlex MCP-клиентам
• binlex-server: транспортный сервер процессоров для рабочих процессов http
• binlex-hash: утилита хеширования
• binlex-image: утилита для работы с изображениями
• binlex-symbols: помощник по загрузке и преобразованию символов
• binlex-yara: генерация YARA-правил из паттернов или потоков в стиле Binlex

Сборка и установка 🛠️

Rust API и инструменты

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

Привязки Python 🐍

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

Упаковка 📦

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

Плагин для IDA 🧠

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

Docker-контейнеры

# 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

Документация 📚

Руководства

• Руководство по командной строке
• Пользовательские процессоры

Примеры 🧪

• Примеры на Python
• Примеры на Rust

Rust API

cargo doc --open

Конфигурация 📁

Каталоги конфигурации по умолчанию:

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

Цитирование 📖

Если вы используете Binlex в журнальной публикации или в модели ИИ с открытым исходным кодом, процитируйте:

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

Для любых других корпоративных или личных целей использования или сгенерированных результатов (например, YARA-правил) цитирование не требуется.