# Linux 및 Windows용 바이너리 빌드
cd docker
make build-binaries

# 바이너리는 ./bin/에 생성됩니다
# - fastfinder-linux-amd64
# - fastfinder-windows-amd64.exe

# 런타임 이미지 빌드 (FastFinder + YARA + 편집기 포함)
.\docker-helper.ps1 build-runtime

# 구성 디렉토리를 지정하여 스캔 실행
.\docker-helper.ps1 run-runtime -ConfigPath "C:\path\to\config_folder" -ScanPath "C:\data\to\scan"

# 대화형 셸 모드 (스캔 없이 셸 접근만)
.\docker-helper.ps1 run-runtime -Interactive

fastfinder [옵션]

# 구성 파일을 사용한 기본 스캔
./fastfinder -c config.yaml

# 지속적인 모니터링 모드
./fastfinder -c config.yaml -t

# 독립 실행형 실행 파일 생성 (x64 아키텍처만)
./fastfinder -c config.yaml -b standalone_scanner.exe

input:
    path: [] # 단순 문자열 기반 파일 경로 및/또는 파일 이름 매칭
    content:
        grep: [] # 파일 내용 내 리터럴 문자열 값 매칭
        yara: [] # 복잡한 패턴 검색을 위해 YARA 규칙 사용 및 규칙 경로 지정 (와일드카드/정규식/조건)
        checksum: [] # 파일 내용에서 md5/sha1/sha256 해시 파싱
options:
    contentMatchDependsOnPathMatch: true # true인 경우, 경로는 grep(문자열) 검색의 사전 필터 역할만 합니다. YARA 및 체크섬은 항상 평가됩니다.
    findInHardDrives: true	# 하드 드라이브 내용 열거
    findInRemovableDrives: true # 이동식 드라이브 내용 열거
    findInNetworkDrives: true # 네트워크 드라이브 내용 열거
    findInCDRomDrives: true # 물리적 CD-ROM 및 마운트된 iso/vhd 등 열거
    findInMemory: true # 프로세스 메모리에서 결과 확인
output:
    copyMatchingFiles: true # 모든 일치 파일의 복사본 생성
    base64Files: true # 복사 전 일치 콘텐츠를 base64로 인코딩
    filesCopyPath: '' # 빈 값은 일치 파일을 fastfinder.exe 폴더에 복사
advancedparameters:
    yaraRC4Key: ''    # YARA 규칙은 지정된 RC4 키를 사용하여 암호화/복호화 가능
    maxScanFilesize: 2048 # maxScanFileSize MB까지 파일 무시 (기본값: 2048)               
    cleanMemoryIfFileGreaterThanSize: 512 # 무거운 파일 스캔 후 FastFinder 내부 메모리 정리 (기본값: 512MB)
eventforwarding:
  enabled: true
  buffer_size: 5
  flush_time_seconds: 10
  file: # 애플리케이션 활동을 jsonl 파일로 저장
    enabled: true
    directory_path: "./event_logs"
    rotate_minutes: 1    # 테스트용으로 1분마다 로테이션
    max_file_size_mb: 1  # 테스트용으로 1MB에서 로테이션
    retain_files: 5      # 이전 파일 5개 유지
  http: # 애플리케이션 활동을 HTTP POST JSON 데이터로 전달
    enabled: false
    url: "https://your-forwarder-url.com/api/events"
    ssl_verify: false
    timeout_seconds: 10
    headers:
      Authorization: "Bearer YOUR_API_KEY"
      MY-CUSTOM-HEADER: "My-Header-Value"
    retry_count: 3
  filters:
    event_types:
      - "error"
      - "warning"
      - "alert" 
      - "info"

input:
  content:
    yara:
      - "./example_rule_linux.yar"           # config.yaml과 동일한 폴더에서 검색
      - "./subfolder/custom_rules.yar"       # config 기준 하위 폴더에서 검색
      - "/absolute/path/to/rule.yar"         # 절대 경로는 그대로 작동
      - "https://example.com/rules.yar"      # URL도 지원됨

project/
├── config.yaml
├── example_rule_linux.yar          # ✅ "./example_rule_linux.yar"로 찾음
└── rules/
    └── custom.yar                  # ✅ "./rules/custom.yar"로 찾음

# 저장소 클론
git clone https://github.com/codeyourweb/fastfinder.git
cd fastfinder

# 종속성 설치 (컴파일 가이드 참조)
# 소스에서 빌드
go build -tags yara_static,gio -a -ldflags '-s -w' .

# 테스트 실행
go test ./...