PyGhidra란
PyGhidra는 네이티브 CPython 3에서 Ghidra API를 사용하는 공식 라이브러리입니다. 프로젝트, 프로그램, 심볼과 분석 기능을 재현 가능한 Python 작업에 연결합니다.
PyGhidra는 네이티브 CPython 3에서 Ghidra API를 사용하는 공식 라이브러리입니다. 프로젝트, 프로그램, 심볼과 분석 기능을 재현 가능한 Python 작업에 연결합니다.
요구 사항과 버전
현재 버전은 2026년 5월 14일 공개된 PyGhidra 3.1.0입니다. Python 3.9 이상, Ghidra 12.0 이상, JDK 21이 필요합니다.
현재 버전은 2026년 5월 14일 공개된 PyGhidra 3.1.0입니다. Python 3.9 이상, Ghidra 12.0 이상, JDK 21이 필요합니다.
설치 방법
전용 가상 환경을 만들고 PyPI 또는 공식 Ghidra 배포본의 오프라인 패키지로 설치합니다. 제3자 EXE는 필요하지 않습니다.
전용 가상 환경을 만들고 PyPI 또는 공식 Ghidra 배포본의 오프라인 패키지로 설치합니다. 제3자 EXE는 필요하지 않습니다.
- 1
Virtual environment
Isolate dependencies.
python -m venv .venv - 2
Install
Use the active interpreter.
python -m pip install --upgrade pyghidra==3.1.0 - 3
Offline option
Use the official bundled package.
python -m pip install --no-index -f <GhidraInstallDir>/Ghidra/Features/PyGhidra/pypkg/dist pyghidra
Ghidra 연결
GHIDRA_INSTALL_DIR를 압축 해제한 Ghidra 루트로 설정하거나 pyghidra.start()에 install_dir를 전달합니다.
GHIDRA_INSTALL_DIR를 압축 해제한 Ghidra 루트로 설정하거나 pyghidra.start()에 install_dir를 전달합니다.
GHIDRA_INSTALL_DIR=<path-to-ghidra-root>
첫 자동 분석
프로세스당 한 번 시작하고 분석 권한이 있는 샘플을 컨텍스트에서 열며 결과는 설치 폴더 밖에 저장합니다.
프로세스당 한 번 시작하고 분석 권한이 있는 샘플을 컨텍스트에서 열며 결과는 설치 폴더 밖에 저장합니다.
from pathlib import Path
import pyghidra
with pyghidra.open_program(Path('sample.exe')) as api:
print(api.getCurrentProgram().getName())
자주 발생하는 문제
Python 실행 파일, java -version, Ghidra 루트와 호환성을 확인합니다. 외부 바이너리와 스크립트는 신뢰하지 않는 입력으로 처리합니다.
Python 실행 파일, java -version, Ghidra 루트와 호환성을 확인합니다. 외부 바이너리와 스크립트는 신뢰하지 않는 입력으로 처리합니다.
| Symptom | Cause | Check |
|---|---|---|
| Import error | Wrong environment | python -m pip show pyghidra |
| Java error | Wrong JDK | java -version |
| Path error | Wrong root | GHIDRA_INSTALL_DIR |
| API mismatch | Version boundary | PyGhidra 3.x + Ghidra 12.0+ |
PyGhidra FAQ
Is PyGhidra included with Ghidra?
PyGhidra는 네이티브 CPython 3에서 Ghidra API를 사용하는 공식 라이브러리입니다. 프로젝트, 프로그램, 심볼과 분석 기능을 재현 가능한 Python 작업에 연결합니다.
Which Python version is required?
Python 3.9 or later.
Why can it not find Ghidra?
GHIDRA_INSTALL_DIR를 압축 해제한 Ghidra 루트로 설정하거나 pyghidra.start()에 install_dir를 전달합니다.
Does it replace analyzeHeadless?
No. Choose the workflow that fits the pipeline.
Is PyGhidra MCP the same project?
No. MCP tools are separate projects.