RevShell is a bash-based tool designed to simplify the process of setting up reverse shells using various tunneling services. It automates the creation of a secure tunnel and provides an easy-to-use interface for generating and listening to reverse shell connections.
- Support for multiple tunneling services (ngrok, Cloudflare, localtunnel)
- Automatic tunnel setup
- Reverse shell command generation
- Integrated listener with
nc
- Easy-to-use command-line interface
- Bash
- netcat (
nc
) - One or more of the following tunneling services:
- ngrok (installed and configured with an authtoken)
- Cloudflare (cloudflared installed)
- localtunnel (installed via npm)
-
Clone this repository:
git clone https://github.com/HomeDev68/RevShell.git
-
Navigate to the cloned directory:
cd RevShell
-
Run the installation script:
sudo ./install.sh
This will install the RevShell scripts in your ~/.local/bin
directory.
To start a reverse shell session:
revshell <tunneling-service> <port>
Replace <tunneling-service>
with one of: ngrok
, cloudflare
, or localtunnel
.
Replace <port>
with the desired port number for your reverse shell connection.
Example:
revshell ngrok 8080
This command will:
- Start the specified tunneling service
- Display the public URL and IP
- Generate reverse shell commands for the target system
- Start a listener on the specified port
Follow the on-screen instructions to establish the reverse shell connection from the target system.
To uninstall RevShell, run:
sudo ./uninstall.sh
This tool is designed for educational and authorized testing purposes only. Misuse of this tool on systems you do not own or have explicit permission to test is illegal and unethical.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.