Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
vt-py-scanner — VirusTotal API를 사용하여 폴더를 재귀적으로 스캔하여 악성코드를 탐지합니다. 주요 기능으로 해시 조회, CSV 내보내기, 실시간 진행률 및 자동화된 파일 분석을 위한 속도 제한 처리가 포함됩니다. | Kitploit
도구/GitHubGitHub/neorai/vt-py-scanner
Vulnerability AnalysisHash AnalysisForensicsInformation GatheringMalware AnalysisThreat Intelligence
GitHubneorai/vt-py-scanner

vt-py-scanner

VirusTotal API를 사용하여 폴더를 재귀적으로 스캔하여 악성코드를 탐지합니다. 주요 기능으로 해시 조회, CSV 내보내기, 실시간 진행률 및 자동화된 파일 분석을 위한 속도 제한 처리가 포함됩니다.

저장소 보기
53411개월 전아직 검토되지 않음
공유

VirusTotal 스캐너

VirusTotal API를 사용하여 모든 파일을 분석하는 Python 스크립트로, 폴더와 하위 폴더를 재귀적으로 스캔합니다. Windows에 최적화되었습니다.

기능

  • 폴더와 하위 폴더의 모든 파일을 스캔합니다.
  • .env 파일을 통한 구성 - API 키와 설정을 저장합니다.
  • 대화형 모드 - .env 파일 없이도 작동합니다.
  • Windows에 최적화 - 올바른 경로 처리 및 UTF-8 인코딩
  • 완전한 로깅 - 모든 이벤트와 오류를 .log 파일에 기록
  • CSV 내보내기 - 결과를 CSV 파일로 저장 (세미콜론으로 구분)
  • 시간 예측 - 남은 시간과 경과 시간을 실시간으로 표시
  • 무료 API의 분당 4개 파일 제한을 준수
  • 각 파일에 대한 VirusTotal 분석 URL 표시
  • X/Y 형식으로 결과 표시 (예: 0/70 = 70개의 안티바이러스 엔진 중 0개 양성)
  • 강력한 오류 처리 (잠긴 파일, 권한 없음 등)
  • 백분율을 포함한 실시간 진행 카운터
  • 완료 시 통계 및 총 시간이 포함된 상세 요약
  • 건너뛴 파일 목록과 이유
  • 업로드 전 해시 조회 - 파일이 이미 VirusTotal에 있는지 확인하여 시간과 대역폭 절약

요구 사항

  • Python 3.6 이상
  • VirusTotal API 키 (무료)
  • Windows (최적화되었지만 다른 시스템에서도 작동)

설치

  1. 파일을 컴퓨터에 다운로드하세요.

  2. 종속성 설치:

pip install -r requirements.txt
  1. VirusTotal API 키 받기:
    • https://www.virustotal.com/gui/my-apikey 로 이동
    • 등록 또는 로그인 (무료)
    • API 키 복사

사용법

옵션 1: .env 파일 사용 (권장)

  1. .env.example 파일을 .env로 복사:

    cp .env.example .env
    
  2. .env 파일을 편집하고 구성을 추가하세요:

    VIRUSTOTAL_API_KEY=your_actual_api_key_here
    SCAN_FOLDER=C:\Users\username\Desktop\my_files
    
  3. 스크립트 실행:

    python virustotal_scanner.py
    

스크립트가 자동으로 .env 파일에서 구성을 로드합니다.

옵션 2: 대화형 모드 (.env 없이)

.env 파일을 사용하지 않으려면 스크립트가 정보를 요청합니다.

python virustotal_scanner.py

스크립트가 다음을 요청합니다:

  1. VirusTotal API 키
  2. 스캔할 폴더 경로

사용 예시:

Enter your VirusTotal API key: a1b2c3d4e5f6...

Enter the folder path to scan: C:\Users\username\Desktop\my_files

Do you want to continue? (y/n): y

Windows에서 유효한 경로 예시:

  • C:\Users\username\Documents\my_files
  • C:\Users\username\Desktop\folder
  • . (점 = 현재 폴더)
  • 폴더를 터미널로 끌어다 놓을 수 있습니다.

생성되는 파일

스크립트 실행 후 다음 파일이 자동으로 생성됩니다.

virustotal_scan.log

모든 이벤트가 포함된 로그 파일:

  • 스캔 시작 및 종료
  • 처리된 각 파일
  • 오류 및 경고
  • 최종 통계

virustotal_results.csv

결과가 포함된 CSV 파일 (세미콜론으로 구분):

  • 분석 날짜 및 시간
  • 파일 이름
  • 전체 경로
  • 바이트 단위 크기
  • SHA256 해시
  • 양성 탐지
  • 전체 안티바이러스 엔진
  • 탐지 백분율
  • 상태 (CLEAN/DETECTED)
  • VirusTotal URL

CSV는 Excel, Google Sheets 또는 모든 스프레드시트 프로그램에서 열 수 있습니다.

출력 예시

================================================================================
  VIRUSTOTAL SCANNER - COMPLETE FOLDER SCAN
================================================================================
Folder: C:\Users\username\Desktop\my_files
API limit: 4 files per minute
Maximum file size: 32 MB
================================================================================

Counting files...
Total files found: 15

Starting analysis...

================================================================================
Progress: [1/15]
================================================================================

[*] Analyzing: document.pdf
    Path: C:\Users\username\Desktop\my_files\document.pdf
  Uploading file...
  Waiting for analysis results...
  Analysis in progress... (attempt 1/30)

  >> URL: https://www.virustotal.com/gui/file/abc123...
  >> Detections: 0/70

================================================================================
Progress: [2/15]
================================================================================

[*] Analyzing: program.exe
    Path: C:\Users\username\Desktop\my_files\program.exe
  Uploading file...
  Waiting for analysis results...

  >> URL: https://www.virustotal.com/gui/file/def456...
  >> Detections: 2/70

[!] Rate limit reached: Waiting 15 seconds...

================================================================================
  FINAL SCAN SUMMARY
================================================================================

ANALYZED FILES:
--------------------------------------------------------------------------------

1. [CLEAN] 0/70
   File: C:\Users\username\Desktop\my_files\document.pdf
   URL: https://www.virustotal.com/gui/file/abc123...

2. [DETECTED] 2/70
   File: C:\Users\username\Desktop\my_files\program.exe
   URL: https://www.virustotal.com/gui/file/def456...

================================================================================
SKIPPED FILES:
--------------------------------------------------------------------------------

1. C:\Users\username\Desktop\my_files\large_file.iso
   Reason: File too large (650.50 MB)

2. C:\Users\username\Desktop\my_files\system.dll
   Reason: No read permissions

================================================================================
  STATISTICS
================================================================================
Total files found: 15
Files analyzed: 13
Files skipped: 2
  - Clean files (0 detections): 12
  - Files with detections: 1
================================================================================

제한 사항 및 고려 사항

무료 API 제한:

  • 분당 4개 파일 (스크립트가 자동으로 대기)
  • 최대 크기: 파일당 32MB
  • 더 큰 파일은 자동으로 건너뜁니다.

건너뛰는 파일:

  • 32MB보다 큰 파일
  • 빈 파일 (0바이트)
  • 읽기 권한이 없는 파일
  • 시스템에 의해 잠긴 파일

중요한 보안 참고 사항

  • API 키를 비공개로 유지하세요 - 공유하지 마십시오.
  • 파일은 공개적으로 분석됩니다 - 기밀 파일을 업로드하지 마십시오.
  • 파일은 보안 커뮤니티와 공유됩니다 - 업로드되면 공개됩니다.
  • VirusTotal은 보안 분석을 위한 것입니다 - 책임감 있게 사용하세요.
  • 개인 또는 민감한 회사 데이터를 업로드하지 마십시오.

스크립트가 하는 일

  1. 폴더와 하위 폴더의 모든 파일을 찾습니다.
  2. 각 파일이 분석에 유효한지 확인합니다.
  3. 파일 해시가 VirusTotal에 이미 있는지 확인합니다 (시간과 대역폭 절약)
  4. 찾을 수 없는 경우 각 파일을 VirusTotal에 업로드합니다 (분당 4개 제한 준수)
  5. 분석 결과를 기다립니다.
  6. URL 및 탐지 결과를 표시합니다 (예: 0/70, 5/70)
  7. 마지막에 완전한 요약을 생성합니다.

문제 해결

오류: "잘못된 API 키"

  • API 키를 올바르게 복사했는지 확인하세요.
  • https://www.virustotal.com/gui/my-apikey 에서 새 키를 받으세요.

오류: "파일에 대한 액세스 거부"

  • 일부 시스템 파일은 보호됩니다.
  • 시스템 파일을 분석해야 하는 경우 관리자로 실행하세요.

스크립트가 매우 느립니다.

  • 정상입니다: 무료 API는 분당 4개 파일로 제한됩니다.
  • 100개의 파일이 있으면 약 25분이 소요됩니다.

건너뛴 파일

  • 건너뛴 이유를 확인하려면 최종 요약을 확인하세요.
  • 32MB보다 큰 파일은 무료 API로 분석할 수 없습니다.

라이선스

MIT 라이선스 - Copyright (c) 2025 neorai

이 프로젝트는 자유롭고 오픈소스입니다. 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →