GitHub all releases

Binlex - 바이너리 유전 형질 렉서 프레임워크

악성코드 개발자들이 자신의 바이너리가 FUD라고 생각한다면, 곧 실존적 위기를 맞게 될 것입니다.

Binlex는 바이너리에서 명령어, 기본 블록, 함수를 추출하고 리버스 엔지니어링, 헌팅, 유사성 워크플로를 위한 검색 가능한 JSON 특질을 생성합니다. 유전체학에서 영감을 받은 계층 구조로 바이너리 구조를 모델링합니다: 게놈(명령어, 블록, 함수), 염색체(와일드카드 패턴), 대립유전자 쌍(바이트), 유전자(니블). 이러한 표현은 대규모 샘플 집합에 걸쳐 패턴 수준 비교, 클러스터링, 시그니처 생성을 가능하게 하여 악성코드 분석과 바이너리 유사성 분석을 더 체계적으로 만듭니다.

Features

🧬 명령어, 블록, 함수에 대한 빠른 특질 추출
🔐 해싱 및 특질: MinHash, TLSH, SHA256, 엔트로피, 와일드카드 패턴
📈 ML 지향 유사성 워크플로를 위한 정규화 및 피처 파이프라인
🧰 인터페이스: CLI, Rust API, Python API/바인딩, IDA 플러그인
⚙️ ipc 및 http를 통한 빠른 외부 실행을 지원하는 Rust 프로세서 프레임워크
🧠 추가 분석을 수행할 나만의 Rust 프로세서 구축
🎯 YARA 생성, 심볼 수집, 배치 JSON 워크플로를 위한 도구

지원 대상 🌐

플랫폼: Linux, macOS, Windows
형식: PE, ELF, Mach-O
아키텍처: AMD64, I386, CIL

포함된 명령줄 도구 모음 🧰

binlex: 바이너리 특질 추출용 메인 CLI
binlex-mcp: Binlex 도구를 MCP 클라이언트에 노출하는 Model Context Protocol 서버
binlex-server: http 워크플로용 프로세서 전송 서버
binlex-hash: 해싱 유틸리티
binlex-image: 이미지 관련 유틸리티
binlex-symbols: 심볼 수집 및 변환 도우미
binlex-yara: Binlex 스타일 패턴 또는 스트림에서 YARA 규칙 생성

빌드 및 설치 🛠️

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

문서 📚

가이드

예제 🧪

Rust API

cargo doc --open

구성 📁

기본 구성 디렉터리:

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

인용 📖

저널 출판물이나 오픈소스 AI 모델에서 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 규칙)의 경우 인용은 필요하지 않습니다.

binlex

인기