Skip to content

4. Troubleshooting

seojungmin edited this page Dec 15, 2025 · 1 revision

CryptoScanner_GUI를 빌드 / 실행 / 스캔할 때 자주 막히는 지점만 정리했습니다.


1. Build 흐름 체크 (가장 흔함)

정상 흐름(요약)

  1. CryptoScanner/에서 백엔드 빌드
  2. 레포 루트에서 통합 빌드 스크립트 실행 (build_integrated.*)
  3. crypto-scanner-gui/에서 npm install → npm run build
  4. 반드시 npm run copy-backend (GUI에 백엔드 실행파일 복사)
  5. npm run dist:<platform> 후, 산출물 폴더에서 실행

“GUI는 뜨는데 스캔이 실패한다 / 결과가 비어있다”는 대부분 4번(copy-backend) 누락이 원인입니다.


2. .env 설정 체크

증상

  • LLM/리포트 관련 기능이 동작하지 않음
  • 키가 없다는 에러/로그가 뜸

체크

  • 위치: CryptoScanner_GUI/.env
  • 키 이름(대소문자 포함):
OPENAI_API_KEY=YOUR_KEY
Google_API_KEY=YOUR_KEY

주의

  • .env는 커밋 금지(키 유출)

3. OS별 자주 막히는 것

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

4. 스캔이 오래 걸리거나 실패할 때

  • 시간 감각(README 안내 기준)

    • Quick Scan: 파일/폴더 단위 (최대 5분)
    • Full Scan: 시스템 전체 (약 3시간)
  • 권장 흐름

    1. 처음엔 Quick Scan으로 정상 동작 확인
    2. 그 다음 스캔 대상을 단계적으로 확대
    3. Full Scan은 환경(권한/보안 제품/EDR)에 영향 받을 수 있음

5. RESULT / Analyze가 비어있을 때

체크리스트

  • npm run copy-backend를 했는지 확인
  • dist 후 생성된 폴더(linux-amd, linux-arm, win-amd, mac-arm64)에서 실행했는지 확인
  • Quick Scan으로 “파일 1개” 재현 테스트

Appendix. 빠른 진단 커맨드

node -v
npm -v
cmake --version

Clone this wiki locally