EyeWitness - 웹 스크린샷 도구

EyeWitness는 웹사이트의 스크린샷을 찍고, 서버 헤더 정보를 제공하며, 알려진 기본 자격 증명을 식별하도록 설계되었습니다. 이제 Chromium 브라우저를 기반으로 더 나은 안정성과 쉬운 설치를 지원합니다.

🚀 주요 기능

크로스 플랫폼 지원 - Windows, Linux, macOS
Chromium 기반 - Google Chrome/Chromium으로 안정적인 헤드리스 스크린샷
적응형 리소스 관리 - 시스템 성능에 따라 자동 조정
설정 파일 지원 - 선호하는 설정 저장
URL 검증 - 사전 검사를 통해 URL 유효성 확인
예상 완료 시간(ETA) 포함 진행 추적 - 스캔 완료 시간을 정확히 파악
향상된 오류 처리 - 구체적인 오류 유형과 실행 가능한 안내
다중 입력 형식 - 텍스트 파일, Nmap XML, Nessus XML
격리된 가상 환경 - 시스템 충돌 없음 및 PEP 668 우회

🔒 가상 환경 아키텍처

EyeWitness는 이제 모든 설치에 Python 가상 환경을 사용하여 다음을 제공합니다:

✅ 주요 이점

시스템 충돌 없음 - 모든 Python 패키지가 격리된 환경에 설치됨
PEP 668 문제 없음 - Kali/최신 Linux에서 "externally-managed-environment" 오류를 완전히 우회
크로스 플랫폼 일관성 - Windows, Linux, macOS에서 동일한 접근 방식
간편한 정리 - eyewitness-venv/ 디렉터리를 삭제하면 모든 것이 제거됨
프로덕션 준비 - 자동 오류 처리 및 실패 시 롤백

🚀 작동 방식

설치 시 가상 환경 생성 - 격리된 Python이 포함된 eyewitness-venv/ 디렉터리
가상 환경 활성화 - 격리된 환경에 진입하는 간단한 명령
모든 패키지가 격리되어 설치 - 시스템 Python에 전혀 영향을 주지 않음
EyeWitness 정상 실행 - 가상 환경 내에서 표준 Python 명령어 사용

📁 설치 후 파일 구조

EyeWitness/
├── eyewitness-venv/          # 🔒 Virtual environment (isolated Python packages)
│   ├── bin/activate          # Linux/macOS activation script
│   └── Scripts/activate.bat  # Windows activation script
├── Python/
│   └── EyeWitness.py         # 📜 Main script (runs in virtual environment)
└── setup/                    # Setup scripts and requirements

📦 설치 옵션

🔥 NEW: EyeWitness는 이제 Python 가상 환경을 사용하여 모든 플랫폼에서 충돌 없이 견고한 설치를 제공합니다!

참고: Docker 지원은 현재 개발 중입니다. 지금은 아래의 네이티브 설치 옵션을 사용하세요.

🪟 Windows 설치

Python 가상 환경을 사용한 자동 설정:

# 1. 관리자 권한으로 PowerShell 열기
# 2. EyeWitness 디렉터리로 이동
cd path\to\EyeWitness\setup

# 3. 설치 스크립트 실행 (가상 환경 생성)
.\setup.ps1

# 4. 가상 환경을 활성화하여 설치 테스트
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

설치되는 항목:

🔒 격리된 Python 가상 환경 (eyewitness-venv/)
가상 환경 내 Python 종속성 (selenium 등)
Google Chrome 브라우저 (없는 경우)
ChromeDriver (자동화용)

🐧 Linux 설치

Python 가상 환경을 사용한 프로덕션 준비 설치:

# 1. 설정 디렉터리로 이동
cd EyeWitness/setup

# 2. 설치 스크립트 실행 (가상 환경 생성)
sudo ./setup.sh

# 3. 가상 환경을 활성화하여 설치 테스트
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

설치되는 항목:

🔒 격리된 Python 가상 환경 (eyewitness-venv/)
가상 환경 내 모든 Python 패키지 (PEP 668 완전 우회)
시스템 패키지를 통한 Chromium 브라우저 및 ChromeDriver
가상 디스플레이 지원 (xvfb)

🎯 이점:

✅ PEP 668 충돌 없음 - 가상 환경이 모든 제한을 우회
✅ 시스템 패키지 문제 없음 - 모든 Python 종속성이 격리됨
✅ 간편한 정리 - eyewitness-venv/ 디렉터리만 삭제하면 됨
✅ 프로덕션 준비 - 설치 실패 시 자동 롤백

지원되는 Linux 배포판:

Ubuntu 20.04+ / Linux Mint
Debian 10+ / Kali Linux
CentOS 8+ / RHEL / Rocky Linux
Arch Linux / Manjaro
Alpine Linux

🍎 macOS 설치

Homebrew 기반 Python 가상 환경 설치:

# 1. Homebrew로 Chrome 설치
brew install --cask google-chrome

# 2. 설정 디렉터리로 이동하여 설치 실행
cd EyeWitness/setup
sudo ./setup.sh

# 3. 가상 환경을 활성화하여 설치 테스트
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

설치되는 항목:

🔒 격리된 Python 가상 환경 (eyewitness-venv/)
가상 환경 내 Python 종속성
Chrome 브라우저 (Homebrew를 통해)
ChromeDriver (자동화용)

🎯 사용 예제

🚀 EyeWitness 사용 방법

설치 스크립트 실행 후, 가상 환경을 활성화하고 EyeWitness를 실행하세요:

🐧 Linux/macOS:

# 1. 가상 환경 활성화
source eyewitness-venv/bin/activate

# 2. EyeWitness 실행 (현재 격리된 환경에 있음)
python Python/EyeWitness.py --single https://example.com
python Python/EyeWitness.py -f urls.txt
python Python/EyeWitness.py -x nmap_scan.xml
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# 3. 작업 완료 후 가상 환경 비활성화
deactivate

🪟 Windows:

# 1. 가상 환경 활성화
eyewitness-venv\Scripts\activate.bat

# 2. EyeWitness 실행 (현재 격리된 환경에 있음)
python Python\EyeWitness.py --single https://example.com
python Python\EyeWitness.py -f urls.txt
python Python\EyeWitness.py -x nmap_scan.xml
python Python\EyeWitness.py -f urls.txt -d C:\path\to\output

# 3. 작업 완료 후 가상 환경 비활성화
deactivate

📄 설정 파일

# 먼저 가상 환경 활성화
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# 샘플 설정 파일 생성
python Python/EyeWitness.py --create-config

# 설정 파일 사용
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 URL 검증

# 먼저 가상 환경 활성화
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# 스크린샷 없이 URL 유효성 검증
python Python/EyeWitness.py -f urls.txt --validate-urls

# 검증 건너뛰기 (주의하여 사용)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ 고급 옵션

# 먼저 가상 환경 활성화
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# 시스템에 맞게 스레드 조정 (기본: 자동 감지)
python Python/EyeWitness.py -f urls.txt --threads 5

# 느린 연결을 위한 타임아웃 증가
python Python/EyeWitness.py -f urls.txt --timeout 30

# 지연 및 지터 추가
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

# 프록시 사용
python Python/EyeWitness.py -f urls.txt --proxy-ip 127.0.0.1 --proxy-port 8080

# 사용자 지정 출력 디렉터리
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# 이전 스캔 재개
python Python/EyeWitness.py --resume /path/to/output/ew.db

성능 튜닝

EyeWitness는 시스템 리소스를 자동으로 감지하고 그에 따라 조정합니다:

CPU 코어 기반 스레드 수 (코어 × 2, 최대 20)
시스템 과부하 방지를 위한 메모리 모니터링
시작 전 디스크 공간 확인

설정 파일 형식

선호하는 설정을 저장하는 설정 파일을 생성하세요:

{
    "threads": 10,
    "timeout": 30,
    "delay": 0,
    "jitter": 0,
    "user_agent": "Custom User Agent",
    "proxy_ip": "127.0.0.1",
    "proxy_port": 8080,
    "output_dir": "./sessions",
    "prepend_https": false,
    "show_selenium": false,
    "resolve": false,
    "skip_validation": false,
    "results_per_page": 25,
    "max_retries": 2
}

문제 해결

일반적인 문제

Chromium/ChromeDriver를 찾을 수 없음:

모든 플랫폼: 설치 스크립트를 다시 실행하세요 - 브라우저를 자동으로 설치합니다
Linux: setup/ 디렉터리에서 sudo ./setup.sh
Windows: setup\ 디렉터리에서 관리자 권한으로 .\setup.ps1
macOS: (brew install --cask google-chrome 후) setup/ 디렉터리에서 sudo ./setup.sh

가상 환경 문제:

eyewitness-venv/ 디렉터리를 삭제하고 설치 스크립트를 다시 실행하세요
Python 3.7+가 venv 모듈과 함께 설치되어 있는지 확인하세요
적절한 관리자/root 권한으로 설치 스크립트를 실행했는지 확인하세요

연결 시간 초과:

타임아웃 증가: --timeout 60
방화벽 설정 확인
대상에 접근 가능한지 확인

높은 메모리 사용량:

스레드 수 줄이기: --threads 5
URL을 더 작은 배치로 처리
다른 애플리케이션 닫기

권한 오류:

Linux/macOS: 파일 권한 확인
Windows: 필요한 경우 관리자 권한으로 실행

오류 메시지

모든 오류에는 이제 구체적인 문제 해결 단계가 포함됩니다. 예:

시간 초과 오류는 프록시 설정 및 타임아웃 증가를 제안
연결 오류는 방화벽 및 네트워크 확인을 제공
리소스 오류는 메모리 사용량 및 권장 사항을 표시

출력

EyeWitness는 다음을 생성합니다:

report.html - 스크린샷이 포함된 기본 보고서
screens/ - 스크린샷 이미지
source/ - 페이지 소스 코드
ew.db - 재개 기능을 위한 SQLite 데이터베이스

보고서 기능

분류된 결과 (고가치, CMS, 네트워크 장치 등)
기본 자격 증명 감지
헤더 분석
검색 및 정렬 가능

요구 사항

Python 3.7+ (대부분의 Python 설치에 포함된 venv 모듈 지원 필요)
관리자/root 권한 (시스템 패키지 및 가상 환경 생성을 위해)
인터넷 연결 (패키지 다운로드용)
Chromium/Chrome 브라우저 (설치 스크립트가 자동으로 설치)
ChromeDriver (설치 스크립트가 자동으로 설치)

📝 참고: 설치 스크립트가 모든 종속성을 자동으로 처리합니다. Python 3.7+와 관리자 권한만 있으면 됩니다.

원본과의 차이점

이 포크는 다음과 같은 중요한 현대화를 포함합니다:

더 이상 사용되지 않는 Selenium API 수정
보관된 종속성 교체 (fuzzywuzzy → rapidfuzz)
포괄적인 오류 처리 추가
크로스 플랫폼 지원 개선
리소스 모니터링 추가
Docker 지원 개발 중
설정 파일 지원 추가
사용자 경험 향상

연락처

E-Mail: GetOffensive [@] redsiege [dot] com

라이선스

EyeWitness는 GNU General Public License v3.0에 따라 라이선스가 부여됩니다.

EyeWitness

인기

EyeWitness - 웹 스크린샷 도구

🚀 주요 기능

🔒 가상 환경 아키텍처

✅ 주요 이점

🚀 작동 방식

📁 설치 후 파일 구조

📦 설치 옵션

🪟 Windows 설치

🐧 Linux 설치

🍎 macOS 설치

🎯 사용 예제

🚀 EyeWitness 사용 방법

📄 설정 파일

🔍 URL 검증

⚙️ 고급 옵션

성능 튜닝

설정 파일 형식

문제 해결

일반적인 문제

오류 메시지

출력

보고서 기능

요구 사항

원본과의 차이점

연락처

라이선스