REA의 Rust 포팅으로, CLI/MCP 워크플로와 네이티브 Ghidra 워커를 갖춘 로컬 전용 리버스 엔지니어링 도구
터미널 또는 MCP 클라이언트에서 로컬 리버스 엔지니어링을 수행하기 위한 REA의 Rust 포팅 버전입니다.
바이너리를 검사하고, 함수를 디컴파일하며, JavaScript 및 Electron 앱을 분석하고, 관리형 및 모바일 아티팩트를 읽고, 프로세스 및 브라우저 캡처를 다룰 수 있습니다. CLI와 MCP 서버는 동일한 도구 구현을 사용합니다. 런타임에는 Node.js가 필요하지 않습니다.
사전 빌드된 릴리스에는 macOS, Linux, Windows의 ARM64 및 x86-64용 rea, MCP 서버, Ghidra 워커가 포함되어 있습니다. Node.js, Rust 툴체인 또는 관리자 계정이 필요하지 않습니다.
curl -fsSL https://github.com/nanashili/rea-rust/releases/latest/download/install.sh -o install-rea.sh
sh install-rea.sh
export PATH="$HOME/.local/bin:$PATH"
rea --version
Windows에서는 PowerShell 프롬프트에서 PowerShell 설치 프로그램을 실행하세요:
irm https://github.com/nanashili/rea-rust/releases/latest/download/install.ps1 -OutFile install-rea.ps1
powershell -ExecutionPolicy Bypass -File .\install-rea.ps1
설치 프로그램은 릴리스 체크섬을 검증하고 버전이 지정된 파일을 사용자별 디렉터리에 저장합니다. 셸 프로필, PATH, MCP 설정은 편집하지 않습니다. 업데이트하려면 설치 프로그램을 다시 실행하거나 REA_VERSION을 설정하여 릴리스를 선택하세요. 경로, 사용자 지정 위치, 제거 방법은 설치 세부 정보를 참조하세요.
고정된 Rust 툴체인(1.93.1), 릴리스 스크립트용 Python 3.11+, C/C++20 컴파일러(Linux에서는 GCC 12+)가 필요합니다. 이 저장소에는 모든 내장 헬퍼 소스가 포함되어 있습니다.
git clone https://github.com/nanashili/rea-rust.git
cd rea-rust
cargo build --locked --release -p rea
target/release/rea --help
macOS, Linux 또는 Windows에서 Ghidra 워커를 별도로 빌드하여 rea 옆에 배치합니다:
cargo build --manifest-path ghidra-rust-worker/Cargo.toml --locked --release
cp ghidra-rust-worker/target/release/rea-ghidra-rust-worker target/release/
PowerShell에서는 복사 단계에 Copy-Item ghidra-rust-worker/target/release/rea-ghidra-rust-worker.exe target/release/를 사용하세요.
이 워커는 네이티브 Ghidra 디컴파일러를 사용하며 JVM이 필요하지 않습니다. 다른 위치에 두려면 REA_GHIDRA_RUST_WORKER를 해당 파일의 절대 경로로 설정하세요.
Frida는 선택적 빌드 기능입니다. Frida 설정을 참고하세요. 다른 분석 제공자와 외부 도구는 각자의 설치가 필요합니다.
rea inspect /path/to/program
rea decompile /path/to/program main --provider ghidra-rust
rea inspect-go-binary /path/to/go-program --format json
rea doctor
인수와 옵션을 확인하려면 모든 명령에서 --help를 사용하세요.
실행 파일 경로를 바꿔서 클라이언트의 MCP 구성에 다음을 추가하세요:
{
"mcpServers": {
"rea": {
"command": "/absolute/path/to/rea",
"args": ["mcp"]
}
}
}
rea mcp는 stdio 서버를 시작합니다. 설치된 실행 파일의 절대 경로를 사용하세요. MCP 클라이언트는 셸과 다른 PATH를 가질 수 있습니다. rea setup은 클라이언트 등록과 스킬 설치를 미리 보여준 뒤, 변경 사항을 적용하기 전에 확인을 요청합니다. 릴리스 설치에는 Ghidra 워커가 이미 포함되어 있습니다.
GitHub Actions는 태그가 지정된 릴리스를 게시하기 전에 두 아키텍처의 macOS 및 Linux 아카이브와 Windows ARM64 및 x64 아카이브를 빌드하고 스모크 테스트합니다. Musl Linux 및 Frida 지원 바이너리는 제공되지 않습니다. 다른 분석 제공자와 외부 도구는 별도로 설치해야 합니다.
알려진 동작 차이와 테스트 범위는 마이그레이션 검증 보고서에 기록되어 있습니다.
로컬 애플리케이션 벤치마크는 설치된 macOS 애플리케이션 11개와 Go를 대상으로 하며, 25개 워크플로에 걸친 125개 샘플에 대해 경과 시간, CPU, 메모리, 호출별 결과 및 문서화된 실패를 다룹니다. 실패 검증 재실행은 수정 사항, 반복 측정 및 남은 실패를 기록합니다.
별도의 TypeScript/네이티브 비교는 고정된 빌드를 사용했으며, 2026년 10월 24일 Apple M1 Pro에서 파일 시스템 캐시가 워밍된 상태로 측정했습니다. 버전당 7개 세션이며, 반복 요청 행은 버전당 56회 호출을 사용합니다:
| 작업 | TypeScript | Rust |
|---|---|---|
| Go 빌드 메타데이터 시작 및 검사 | 570 ms | 64 ms |
| 실행 중인 세션에서 Go 메타데이터 요청 반복 | 7.3 ms | 16.2 ms |
| 작은 C 프로그램의 첫 번째 함수 시작 및 디컴파일 | 9.43 s | 0.39 s |
| 해당 디컴파일 세션 중 샘플링된 프로세스 패밀리 최대 메모리 | 1,022 MiB | 214 MiB |
디컴파일 비교는 TypeScript에 Java Ghidra를, 네이티브 빌드에 Rust Ghidra를 사용했습니다. Rust는 임포트 이름 충돌로 인해 더 큰 Go 테스트에서 실패했습니다. Java는 요청된 세 함수를 모두 반환했습니다.
입력, 원시 측정값, 출력 차이 및 재현 단계는 런타임 비교와 Ghidra 결과를 참조하세요. 성능 감사는 이후의 Rust 최적화를 다룹니다.
cargo fmt --all -- --check
cargo clippy --workspace --locked
cargo test --locked -p rea-core -p rea-rust-analysis -p rea-mcp
개발 가이드에서는 소스 레이아웃, 전체 워크스페이스 테스트 요구 사항, Ghidra 워커, 그리고 실험적 C API를 다룹니다. 도구 동작을 변경할 때는 MIGRATION_GUIDE.md를 참고하고, 크레이트 소유권에 대해서는 아키텍처 노트를 참고하세요.