Repository navigation
4. Troubleshooting
seojungmin edited this page Dec 15, 2025
·
1 revision
CryptoScanner_GUI를 빌드 / 실행 / 스캔할 때 자주 막히는 지점만 정리했습니다.
정상 흐름(요약)
-
CryptoScanner/에서 백엔드 빌드 - 레포 루트에서 통합 빌드 스크립트 실행 (
build_integrated.*) -
crypto-scanner-gui/에서npm install→npm run build -
반드시
npm run copy-backend(GUI에 백엔드 실행파일 복사) -
npm run dist:<platform>후, 산출물 폴더에서 실행
“GUI는 뜨는데 스캔이 실패한다 / 결과가 비어있다”는 대부분 4번(copy-backend) 누락이 원인입니다.
증상
- LLM/리포트 관련 기능이 동작하지 않음
- 키가 없다는 에러/로그가 뜸
체크
- 위치:
CryptoScanner_GUI/.env - 키 이름(대소문자 포함):
OPENAI_API_KEY=YOUR_KEY
Google_API_KEY=YOUR_KEY주의
-
.env는 커밋 금지(키 유출)
Linux (Debian/Ubuntu)
-
의존성 누락
cmake: command not found- Qt/OpenSSL include/link 에러
- Electron 실행 시 NSS/NSPR 관련 라이브러리 에러
해결(README 기준):
sudo apt update sudo apt install build-essential qtbase5-dev libssl-dev pkg-config nodejs clang cmake libnss3-dev libnspr4-dev libp11-kit-dev
-
실행 권한 문제 (
Permission denied)chmod +x ./crypto-scanner-gui
Windows (AMD)
-
Qt 설치/구성 문제
- 빌드 단계에서 Qt 관련 에러
- 실행 시 DLL 누락/앱이 안 뜸
- (포인트) Qt 설치 시 Qt 5 Compatibility module 포함 필요할 수 있음
- PowerShell은 관리자 권한 권장
-
경로 복붙 시 이상한 공백이 섞임
- 예:
CryptoScanner_GUI\C ryptoScanner처럼 공백이 들어가 실패
해결(정상 경로로 다시 입력):
cd CryptoScanner_GUI\CryptoScanner .\windows_amd.bat cd .. .\build_integrated_windows.bat
- 예:
macOS (Apple Silicon)
-
objdump 관련 오류
- 분석 단계에서
objdump가 없거나 동작이 다르게 나옴
해결(README 기준):
brew install node qt@5 openssl llvm sudo ln -sf /opt/homebrew/bin/llvm-objdump /opt/homebrew/bin/objdump
- 분석 단계에서
-
시간 감각(README 안내 기준)
- Quick Scan: 파일/폴더 단위 (최대 5분)
- Full Scan: 시스템 전체 (약 3시간)
-
권장 흐름
- 처음엔 Quick Scan으로 정상 동작 확인
- 그 다음 스캔 대상을 단계적으로 확대
- Full Scan은 환경(권한/보안 제품/EDR)에 영향 받을 수 있음
체크리스트
-
npm run copy-backend를 했는지 확인 -
dist후 생성된 폴더(linux-amd,linux-arm,win-amd,mac-arm64)에서 실행했는지 확인 - Quick Scan으로 “파일 1개” 재현 테스트
node -v
npm -v
cmake --version