Ghidra 설치 전에 확인할 사항
Ghidra는 MSI, EXE, DMG를 사용하는 일반 설치형 앱이 아닙니다. 공식 실행 배포본은 ghidra_12.1.2_PUBLIC_20260605.zip이며 하나의 압축 파일에 세 플랫폼 실행 스크립트가 들어 있습니다. Source code 압축 파일은 일반 Ghidra 설치용이 아닙니다.
공식 최소 기준은 Windows 10 build 1809 이상, Linux 또는 macOS 10.13 이상, 4 GB RAM, 설치 바이너리 1 GB입니다. 큰 바이너리와 여러 프로젝트에는 8 GB 이상 RAM과 ZIP, 캐시, 프로젝트를 위한 추가 저장 공간이 실용적입니다.
기존 Ghidra 폴더 위에 새 버전을 풀지 마세요. 버전별 폴더를 유지하면 비교와 되돌리기가 쉽습니다. 새 버전으로 중요한 프로젝트를 열기 전에 .gpr 파일과 연결된 .rep 디렉터리를 함께 백업합니다.
실행 파일과 펌웨어를 분석할 권한은 소유권, 계약, 조직 정책과 법률에 따라 달라집니다. 명확한 허가가 있는 대상에만 Ghidra를 사용하세요.
Ghidra 설치용 JDK 21 준비
Ghidra 12.1에는 64비트 Java 21 Runtime and Development Kit가 필요합니다. JRE가 아니라 javac를 포함한 전체 JDK를 설치합니다. Adoptium Temurin, Amazon Corretto 또는 호환 OpenJDK 21 LTS를 선택할 수 있습니다.
설치 뒤 새 터미널에서 java -version과 javac -version을 실행합니다. 둘 다 21과 64비트 런타임을 보여야 합니다. 런처는 JAVA_HOME 또는 PATH에서 Java를 찾습니다.
여러 Java 버전은 함께 사용할 수 있습니다. 다른 앱 때문에 오래된 Java를 제거하지 않아도 되며 Ghidra에 올바른 JDK 홈을 지정할 수 있습니다. JDK 홈은 bin 폴더의 상위 경로이지 java 실행 파일 자체가 아닙니다.
java -versionjavac -version공식 파일로 Ghidra 설치 시작
공식 Ghidra 12.1.2 릴리스의 Assets에서 ghidra_12.1.2_PUBLIC_20260605.zip을 선택합니다. 이 사이트의 버튼도 15초 후 같은 github.com 파일을 직접 엽니다.
ZIP은 572,803,866바이트, 약 546.3 MiB입니다. 아주 작은 파일, HTML 문서 또는 예상하지 않은 EXE가 저장되면 실행하지 말고 공식 릴리스로 돌아갑니다. 파일 이름과 게시 도메인을 함께 확인합니다.
Source code zip과 tar.gz는 개발자가 별도 빌드 과정을 수행할 때 사용합니다. 일반 Ghidra 설치에서는 이름에 PUBLIC과 날짜가 들어간 미리 빌드된 압축 파일이 맞습니다.
| GitHub 자산 | 일반 설치 | 용도 |
|---|---|---|
| ghidra_12.1.2_PUBLIC_20260605.zip | 사용 | 공식 멀티플랫폼 실행 배포본 |
| Source code (zip) | 사용 안 함 | 개발자용 소스 스냅샷 |
| Source code (tar.gz) | 사용 안 함 | tar.gz 소스 스냅샷 |
Ghidra 설치 전 SHA-256 검증
공식 SHA-256은 b62e81a0390618466c019c60d8c2f796ced2509c4c1aea4a37644a77272cf99d입니다. 로컬에서 계산한 결과가 한 글자까지 같아야 합니다. 다르면 파일을 삭제하고 공식 URL에서 다시 받습니다.
Windows는 Get-FileHash, macOS는 shasum, Linux는 sha256sum을 제공합니다. 체크섬은 게시자에 대한 판단을 대신하지 않지만 전송 손상과 예상하지 못한 파일 변경을 찾는 핵심 Ghidra 설치 단계입니다.
Get-FileHash .\ghidra_12.1.2_PUBLIC_20260605.zip -Algorithm SHA256shasum -a 256 ghidra_12.1.2_PUBLIC_20260605.zipsha256sum ghidra_12.1.2_PUBLIC_20260605.zip압축을 풀고 Ghidra 설치 완료
ZIP 전체를 새 쓰기 가능 폴더에 압축 해제합니다. 압축 파일 안에서 스크립트를 실행하면 상대 경로와 모듈을 찾지 못합니다. 모든 플랫폼에서 경로의 느낌표를 피하고 Windows에서는 캐럿도 피합니다.
ghidra_12.1.2_PUBLIC 폴더에서 Windows는 ghidraRun.bat, macOS와 Linux는 ./ghidraRun을 실행합니다. 첫 시작은 모듈과 사용자 설정을 만들기 때문에 조금 오래 걸릴 수 있습니다.
프로젝트 창이 열리면 Ghidra 설치가 완료된 것입니다. Non-Shared Project를 만들고 백업 가능한 위치를 선택합니다. 시작 메뉴나 바탕 화면 바로 가기는 자동 생성되지 않으며 필요하면 실행 확인 후 직접 만듭니다.
- 1
전체 압축 해제
버전마다 새 폴더를 사용합니다.
ghidra_12.1.2_PUBLIC/ - 2
설치 폴더 열기
Ghidra, Extensions, support, docs를 확인합니다.
cd ghidra_12.1.2_PUBLIC - 3
플랫폼 스크립트 실행
Windows와 Unix 계열의 실행 파일이 다릅니다.
ghidraRun.bat | ./ghidraRun - 4
로컬 프로젝트 만들기
쓰기 가능하고 백업하기 쉬운 위치를 선택합니다.
File > New Project
일반적인 Ghidra 설치 오류
java command not found는 JDK 21을 설치하고 터미널을 다시 열어 해결합니다. 지원되는 JDK를 찾지 못하면 java와 javac를 모두 확인하고 실행 파일이 아닌 JDK 홈을 지정합니다.
압축 해제 파일이 빠지면 SHA-256과 여유 공간을 확인하고 최신 압축 도구로 새 폴더에 다시 풉니다. macOS에서 Gatekeeper가 네이티브 파일을 막으면 공식 xattr 지침을 따르고 시스템 보호 전체를 끄지 않습니다.
즉시 종료되면 터미널 또는 support의 디버그 런처로 실행해 오류를 읽습니다. 경로, Java, 권한과 다운로드 무결성을 한 항목씩 바꾸면 원인을 정확히 구분할 수 있습니다.
| 증상 | 가능한 원인 | 첫 조치 |
|---|---|---|
| java 없음 | PATH 또는 JAVA_HOME | JDK 21 설치 후 터미널 재시작 |
| 지원 JDK 없음 | 잘못된 버전 또는 JRE | java와 javac 확인 |
| 즉시 종료 | 오류가 숨겨짐 | 터미널이나 디버그 런처 사용 |
| 파일 누락 | 불완전한 다운로드 | 해시 검증 후 다시 압축 해제 |
| macOS 차단 | quarantine | 공식 xattr 안내 확인 |
Ghidra 설치 자주 묻는 질문
관리자 권한이 필요한가요?
보통 필요하지 않습니다. 사용자에게 쓰기 권한이 있는 폴더에 압축을 풉니다.
Java 없이 설치할 수 있나요?
아니요. Ghidra 12.1에는 64비트 JDK 21이 필요합니다.
어디에 설치하나요?
짧고 쓰기 가능한 새 경로를 사용하고 버전별로 분리합니다.
Source code ZIP을 받나요?
일반 설치에는 PUBLIC 릴리스 ZIP을 받습니다.
제거 방법은 무엇인가요?
Ghidra를 닫고 프로젝트를 보관한 다음 압축을 푼 설치 폴더를 삭제합니다.
검증된 릴리스로 Ghidra 설치
12.1.2 PUBLIC ZIP을 받고 체크섬을 확인한 뒤 새 폴더에 압축을 푸세요.