RevShell v1.0 🚀

Advanced PHP Reverse Shell for Ethical Hacking & Penetration Testing

Developed by s0obee

---

⚠️ DISCLAIMER

This tool is developed EXCLUSIVELY for:

• ✅ Educational purposes
• ✅ Authorized penetration testing
• ✅ Security research
• ✅ Ethical hacking with proper authorization

🚫 UNAUTHORIZED USE IS STRICTLY PROHIBITED AND ILLEGAL

The developer is NOT RESPONSIBLE for any misuse of this tool. Users must ensure they have explicit permission before using this tool on any system.

---

🎯 Features

🖥️ Interactive Terminal

• Full command execution with working directory support
• Command history (up/down arrow keys)
• Dynamic prompt display (user@hostname:directory$)
• Built-in commands: cd, pwd, ls, clear, history
• Cross-platform support (Windows/Linux/Unix)

📁 Advanced File Manager

• Visual file browser with grid layout
• Directory navigation (click to enter, double-click to edit)
• File type icons and size display
• Upload, download, edit, and delete operations
• Real-time directory synchronization

🔓 Privilege Escalation Tools

• System information gathering
• SUID binary detection (Linux/Unix)
• Unquoted service paths (Windows)
• Process and network enumeration
• Scheduled tasks and cron jobs analysis

🌐 Network Tools

• Reverse shell generator
• Multiple payload options
• Cross-platform shell commands
• Automatic listener detection

🔒 Security Features

• Password authentication
• Session management
• Secure logout with self-destruction
• File trace cleanup
• Browser cache clearing

---

🚀 Installation

Prerequisites

• Web server (Apache, Nginx, etc.)
• PHP 7.0 or higher
• Write permissions on target directory

Quick Setup

# Clone the repository
git clone https://github.s0obee/revshell.git

# Navigate to directory
cd revshell

# Set permissions (Linux/Unix)
chmod 644 revShell.php

# Upload to web server
# Access via browser: http://target-server/revShell.php

Configuration

// Edit these settings in revShell.php
$password = 'your_secure_password';  // Change default password
$shell_name = 'RevShell v1.0';       // Customize shell name

---

📖 Usage

1. Authentication

• Access the shell via web browser
• Enter the configured password
• Gain access to the control panel

2. Terminal Operations

# Navigate directories
cd /path/to/directory

# List files
ls -la

# Execute commands
whoami
id
uname -a

# View command history
history

3. File Management

• Click File Manager tab
• Navigate directories by double-clicking folders
• Select files with single click
• Use Up button to go to parent directory
• Upload, edit, download, or delete files

4. Privilege Escalation

• Click Privilege Escalation tab
• Run Scan System for automated checks
• Review SUID binaries, services, and permissions
• Analyze results for potential escalation vectors

5. Reverse Shell

• Click Network Tools tab
• Enter your IP address and port
• Click Connect to establish reverse shell
• Ensure your listener is running: nc -lvp 4444

---

🛡️ Security Considerations

For Penetration Testers

• Always obtain written authorization before deployment
• Use strong, unique passwords
• Remove shell after testing completion
• Document all activities for reporting

For System Administrators

• Monitor web server logs for suspicious PHP files
• Implement file upload restrictions
• Use Web Application Firewalls (WAF)
• Regular security audits and file integrity monitoring

---

🔧 Technical Details

System Requirements

• PHP: 7.0+
• Extensions: Standard PHP functions
• Permissions: File read/write access
• Memory: Minimal requirements

Supported Platforms

• ✅ Linux (Ubuntu, CentOS, Debian, etc.)
• ✅ Windows (Server 2016+, Windows 10+)
• ✅ Unix variants (FreeBSD, OpenBSD, etc.)
• ✅ macOS (with PHP support)

Browser Compatibility

• ✅ Chrome/Chromium
• ✅ Firefox
• ✅ Safari
• ✅ Edge
• ✅ Opera

---

📸 Screenshots

🖥️ Main Interface (Terminal)

Interactive terminal with command execution and directory navigation

📁 File Manager

Modern file browser with grid layout and file type icons

Directory navigation and file operations interface

🔓 Privilege Escalation Tools

System enumeration and privilege escalation detection tools

🌐 Network Tools

Reverse shell generator and network utilities

🔒 Secure Logout

Secure logout process with self-destruction countdown

---

🤝 Contributing

Contributions are welcome for educational improvements only:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/improvement)
3. Commit changes (git commit -am 'Add educational feature')
4. Push to branch (git push origin feature/improvement)
5. Create Pull Request

Contribution Guidelines

• Focus on educational value
• Maintain security best practices
• Add proper documentation
• Test across multiple platforms

---

📝 Changelog

v1.0.0 (Current)

• ✅ Initial release
• ✅ Interactive terminal with command history
• ✅ Advanced file manager with directory navigation
• ✅ Privilege escalation tools
• ✅ Network tools and reverse shell generator
• ✅ Secure authentication and logout
• ✅ Cross-platform compatibility

---

📄 License

This project is licensed under the Educational Use License.

Educational Use License

Permission is granted to use this software solely for:
- Educational purposes
- Authorized security testing
- Research activities

Commercial use, unauthorized deployment, or malicious activities
are strictly prohibited.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

---

🔗 Resources

Educational Materials

• OWASP Web Security Testing Guide
• Penetration Testing Execution Standard
• Ethical Hacking Courses

Security Tools

• Metasploit Framework
• Burp Suite
• OWASP ZAP

---

📞 Contact

Developer: s0obee
Purpose: Educational & Ethical Hacking
Version: 1.0

For educational inquiries or security research collaboration:

• Create an issue in this repository
• Ensure all communications are for legitimate educational purposes

---

⚠️ Remember: With great power comes great responsibility ⚠️

Use this tool ethically and responsibly