EyeWitness - Инструмент для создания скриншотов веб-сайтов

EyeWitness предназначен для создания скриншотов веб-сайтов, предоставления информации о заголовках сервера и определения учётных данных по умолчанию, если они известны. Теперь работает на движке Chromium для повышения надёжности и упрощения установки.

🚀 Ключевые возможности

• Кроссплатформенная поддержка - Windows, Linux и macOS
• На базе Chromium - Надёжные безголовые скриншоты с Google Chrome/Chromium
• Адаптивное управление ресурсами - Автоматически подстраивается под возможности системы
• Поддержка файлов конфигурации - Сохраняйте свои предпочтения
• Проверка URL - Предварительная проверка корректности URL
• Отслеживание прогресса с расчётным временем - Точное знание времени завершения сканирования
• Улучшенная обработка ошибок - Конкретные типы ошибок с практическими рекомендациями
• Множество форматов ввода - Текстовые файлы, Nmap XML, Nessus XML
• Изолированная виртуальная среда - Полное отсутствие конфликтов с системой и обход PEP 668

🔒 Архитектура виртуальной среды

Теперь EyeWitness использует виртуальные среды Python для всех установок, что обеспечивает:

✅ Ключевые преимущества

• Отсутствие конфликтов с системой - Все пакеты Python устанавливаются в изолированной среде
• Отсутствие проблем с PEP 668 - Полный обход ошибок "externally-managed-environment" на Kali/современных Linux
• Кроссплатформенная согласованность - Одинаковый подход на Windows, Linux и macOS
• Простая очистка - Удалите каталог eyewitness-venv/, чтобы убрать всё
• Готовность к эксплуатации - Автоматическая обработка ошибок и откат при сбоях

🚀 Как это работает

1. Установка создаёт виртуальную среду - каталог eyewitness-venv/ с изолированным Python
2. Активация виртуальной среды - Простая команда для входа в изолированную среду
3. Все пакеты устанавливаются изолированно - Нулевое влияние на системный Python
4. Запуск EyeWitness обычным образом - Стандартные команды Python работают в виртуальной среде

📁 Структура файлов после установки

EyeWitness/
├── eyewitness-venv/          # 🔒 Виртуальная среда (изолированные пакеты Python)
│   ├── bin/activate          # Скрипт активации для Linux/macOS
│   └── Scripts/activate.bat  # Скрипт активации для Windows
├── Python/
│   └── EyeWitness.py         # 📜 Основной скрипт (запускается в виртуальной среде)
└── setup/                    # Скрипты установки и зависимости

📦 Варианты установки

🔥 НОВИНКА: EyeWitness теперь использует виртуальные среды Python для полного отсутствия конфликтов и надёжной установки на всех платформах!

Примечание: Поддержка Docker в настоящее время разрабатывается. Пожалуйста, пока используйте варианты нативной установки, приведённые ниже.

🪟 Установка на Windows

Автоматизированная установка с виртуальной средой Python:

# 1. Open PowerShell as Administrator
# 2. Navigate to EyeWitness directory
cd path\to\EyeWitness\setup

# 3. Run the setup script (creates virtual environment)
.\setup.ps1

# 4. Test installation by activating virtual environment
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. Navigate to setup directory
cd EyeWitness/setup

# 2. Run the setup script (creates virtual environment)
sudo ./setup.sh

# 3. Test installation by activating virtual environment
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. Install Chrome via Homebrew
brew install --cask google-chrome

# 2. Navigate to setup directory and run setup
cd EyeWitness/setup
sudo ./setup.sh

# 3. Test installation by activating virtual environment
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. Activate the virtual environment
source eyewitness-venv/bin/activate

# 2. Run EyeWitness (you're now in the isolated environment)
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. When finished, deactivate the virtual environment
deactivate

🪟 Windows:

# 1. Activate the virtual environment
eyewitness-venv\Scripts\activate.bat

# 2. Run EyeWitness (you're now in the isolated environment)
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. When finished, deactivate the virtual environment
deactivate

📄 Файлы конфигурации

# Activate virtual environment first
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Create a sample config file
python Python/EyeWitness.py --create-config

# Use a config file
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 Проверка URL

# Activate virtual environment first
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Validate URLs without taking screenshots
python Python/EyeWitness.py -f urls.txt --validate-urls

# Skip validation (use with caution)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ Расширенные параметры

# Activate virtual environment first
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Adjust threads based on your system (default: auto-detected)
python Python/EyeWitness.py -f urls.txt --threads 5

# Increase timeout for slow connections
python Python/EyeWitness.py -f urls.txt --timeout 30

# Add delays and jitter
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

# Use proxy
python Python/EyeWitness.py -f urls.txt --proxy-ip 127.0.0.1 --proxy-port 8080

# Custom output directory
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# Resume a previous scan
python Python/EyeWitness.py --resume /path/to/output/ew.db