Skip to content

Educational TCP reverse-shell demo. Local testing only.

License

volzyyy/reverse-shell-demo-using-TCP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

reverse-shell-demo-using-TCP

⚠️ IMPORTANT NOTICE

THIS IS A TEST/DEMO NOT THE FULL CODE. (FULL COMING LATER)
NEED SOME BACKROUND KNOWLEDGE

Educational TCP Reverse-Shell Demo (Safe Version)


Overview

This project is an educational demonstration of a reverse-shell style client/server architecture using Python TCP sockets. ⚠️ Important: This project is meant for learning purposes only. Run only on machines you own or in isolated lab environments (VMs, containers). Never attempt to access machines you do not own.


Features

  • Client

    • Connects back to a server (reverse connection)
    • Reports basic system information (IP, machine type, OS)
    • Sends output back to the server
  • Server

    • Listens for incoming client connections
    • Sends commands to connected clients
    • Receives and prints client responses
    • Supports interactive communication without blocking using threads

How to Run

  1. Set the IP Address

    • Edit both server.py and client.py.
    • Change the IP address to the machine you want the client to connect to.
  2. Start the Server

    • Open a command terminal on the machine running server.py.
    • Run:
      python server.py
    • You should see a message like:
      Server is running and waiting for a connection...
      
  3. Start the Client

    • On the same machine or another machine (your choice for testing), open a command terminal.
    • Run:
      python client.py
    • The client will connect to the server and send basic system info.
  4. Interact with the Server

    • On the server terminal, once the client connects, you should see:
      Run Commands:
      
    • You can now type (like IPCONFIG on Windows or PING) and see the output from the client.

About

Educational TCP reverse-shell demo. Local testing only.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages