Skip to content

1. Setup

Jump to bottom
seojungmin edited this page Dec 15, 2025 · 1 revision

이 문서는 CryptoScanner_GUI를 설치 → 설정(.env) → 실행/첫 스캔까지 한 번에 끝내는 통합 가이드입니다.

Configuration (.env)

레포 루트 디렉토리(= CryptoScanner_GUI/)에 .env 파일을 생성합니다.

OPENAI_API_KEY=YOUR_KEY_HERE
Google_API_KEY=YOUR_KEY_HERE
  • .env는 절대 커밋하지 마세요 (API 키 유출 위험)
  • 팀 작업 시 각자 로컬에만 설정하는 방식이 안전합니다.

Installation & Build

Linux (Debian/Ubuntu)

Dependencies

sudo apt update
sudo apt install build-essential qtbase5-dev libssl-dev pkg-config nodejs clang cmake   libnss3-dev libnspr4-dev libp11-kit-dev

Clone

git clone https://github.com/BOB14th-project/CryptoScanner_GUI.git
cd CryptoScanner_GUI

Build backend + integrated build

cd CryptoScanner
./mac_linux_amd_arm.sh

cd ..
./build_integrated.sh

Build GUI + copy backend

cd crypto-scanner-gui
npm install
npm run build
npm run copy-backend

Run (AMD)

npm run dist:linux-amd
cd ../linux-amd
./crypto-scanner-gui

Run (ARM)

npm run dist:linux-arm
cd ../linux-arm
./crypto-scanner-gui
Windows (AMD)

Dependencies (요약)

  • PowerShell 관리자 권한 권장
  • Chocolatey로 필수 패키지 설치
  • Qt 설치 (경로 예: C:\Qt)
  • (권장) Qt 설치 시 Qt 5 Compatibility module 포함

Chocolatey 설치/업데이트 + 필수 패키지

Set-ExecutionPolicy Bypass -Scope Process -Force; `
  [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; `
  iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

choco upgrade chocolatey
choco install nodejs git llvm -y

Clone

cd C:git clone https://github.com/BOB14th-project/CryptoScanner_GUI.git
cd CryptoScanner_GUI

Build backend + integrated build

cd CryptoScanner
.\windows_amd.bat

cd ..
.uild_integrated_windows.bat

Build GUI + copy backend + dist + run

cd crypto-scanner-gui
npm install
npm run build
npm run copy-backend
npm run dist:win-amd

cd ..\win-amd
.\CryptoScanner.exe
macOS (Apple Silicon)

Dependencies

# Homebrew 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 필요한 패키지 설치
brew install node qt@5 openssl llvm

# LLVM objdump 심볼릭 링크 생성
sudo ln -sf /opt/homebrew/bin/llvm-objdump /opt/homebrew/bin/objdump

Clone

git clone https://github.com/BOB14th-project/CryptoScanner_GUI.git
cd CryptoScanner_GUI

Build backend + integrated build

cd CryptoScanner
./mac_linux_amd_arm.sh

cd ..
./build_integrated.sh

Build GUI + copy backend + run

cd crypto-scanner-gui
npm install
npm run build
npm run copy-backend

cd ../mac-arm64
open CryptoScanner.app

Getting Started (첫 실행 / 첫 스캔)

앱 실행 확인

  • Linux: linux-amd/crypto-scanner-gui 또는 linux-arm/crypto-scanner-gui
  • Windows: win-amd/CryptoScanner.exe
  • macOS: mac-arm64/CryptoScanner.app

첫 스캔은 Quick Scan 추천

  1. Main Page에서 QUICK SCAN
  2. Folder Scan 또는 File Scan 선택
  3. 대상 선택 → Scan Start

Full Scan은 시간이 오래 걸릴 수 있고(수 시간 단위), 권한/보안 SW 영향도 받을 수 있어 환경이 안정화된 뒤 진행을 권장합니다.

결과 확인

  • RESULT 메뉴에서 날짜별 스캔 기록 확인
  • Result Page에서 상세 결과(View Detailed Results) 확인
  • 필요하면 CSV 다운로드

Clone this wiki locally