https://github.com/n4s1rl1/ng-shell

Ngrok Reverse Shell Tool
https://github.com/n4s1rl1/ng-shell

ngrok python3 reverse-shell tool

Last synced: about 1 year ago
JSON representation

Ngrok Reverse Shell Tool

• Host: GitHub
• URL: https://github.com/n4s1rl1/ng-shell
• Owner: N4s1rl1
• License: gpl-3.0
• Created: 2024-09-14T19:57:43.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-14T20:07:57.000Z (almost 2 years ago)
• Last Synced: 2024-10-18T13:14:12.476Z (over 1 year ago)
• Topics: ngrok, python3, reverse-shell, tool
• Language: Python
• Homepage:
• Size: 183 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Ngrok Reverse Shell Tool

## Description 

This Python tool allows you to create a reverse shell using Ngrok's public IP and port. It automates the process of starting Ngrok, fetching the tunnel's public URL, and generating various types of reverse shell commands. Once Ngrok is started, it gives you the ability to select from multiple reverse shell options, including `bash`, `netcat`, `php`, `python`, `ruby`, and `socat`. Additionally, it provides the necessary Netcat listener command and instructions to stop the Ngrok process.

## Features

* Automatically opens Ngrok in a new terminal.

* Fetches the public Ngrok URL and resolves the IP and port.

* Supports different reverse shell commands (bash, nc, php, python, ruby, socat).

* Provides a command to stop Ngrok when you're done.

## Installation & Usage

1. `git clone https://github.com/N4s1rl1/NG-SHELL.git`

2. `cd NG-SHELL`

3. `pip install -r requirements.txt`

4. `sudo python3 ng-shell.py`

## Screenshot

![ng-shell](./img/ng-shell.png)

## Language

[![Python](https://img.shields.io/badge/Python%203-blue.svg)](https://www.python.org)