Skip to content

Latest commit

 

History

History
120 lines (62 loc) · 3.85 KB

README.md

File metadata and controls

120 lines (62 loc) · 3.85 KB

shakti

Bind the shell to any http port | Remote controller | Shell Attached Kindly To Internet

⮊ What?

This is a remote shell. It allow to send unix commands via the http protocol.

An interface will be accessible on the defined port, with some usefuls predefined commands. They are meant to be edited.

This interface allow to send shell commands and will echo the command result on the wanted ports.

Commands can be sent in loop. They can also be sent/called from a terminal with w3m

This program is a php shell script written in one file to keep it portable.

⮊ Why?

Allow to control devices in an easy way. Commands automation are then easy to manage.

As example, controls a raspberry pi directly via any browser on the local network.

There is no authentification. There is no keys to setup.

⮊ NEWS!

The last version does NOT need to be run as supersuser.

⮊ How?

Shell results are converted to html, then served with the php built-in server.

Commands are sent with ajax/javascript to the php file.

The system need aha and screen.

sudo apt install aha screen

The server act as a daemon, wait for commands, and can open ports on demand.

./shakti

Default port 707, or pass the port with the -p argument:

./shakti -p 8080

⮊ When?

Anytime when a remote controller with no security is desirable.

This tool won't replace ssh, but allow to remotly simulate his behavior, in an easier setup way

If you need security, use ssh.

But if you don't, here is a one liner pipe runner:

wget https://webdev23.github.io/shakti/shakti && chmod +x shakti && ./shakti -p 3838

⮊ Where?

Localhost, private networks, dev/hack environments, clusters.

Of course it can as well fully works on the public web, with just a little port forwarding.

The php built-in server can fall asleep after some times, to avoid wake up him in intervals with any command.

⮊ Usage?

Just open with a browser the link given on launch.

To run into termux android

We need to install some packages into termux. Mostly aha isn't available into termux apt, so we need to complile with make/clang. Here is adb commands to run from a computer, from a stock blank termux install to a full running shakti:

adb shell input keyevent KEYCODE_WAKEUP && adb shell input text apt%supdate%s&&%sapt%supgrade && adb shell input keyevent 160
adb shell input text apt%sinstall%swget%sgit%smake%sclang%sscreen%stermux-setup-storage%stermux-exec%stermux-api%s-y && adb shell input keyevent 160
adb shell input text git%sclone%shttps://github.com/theZiz/aha.git && adb shell input keyevent 160
adb shell input text cd%saha
adb shell input text make
adb shell input text make%sinstall
adb shell input keyevent KEYCODE_WAKEUP  && adb shell am force-stop com.termux && adb shell monkey -p com.termux 1 
adb shell input text wget%shttps://webdev23.github.io/shakti/shakti && adb shell input keyevent 160
adb shell input text chmod%s+x%sshakti && adb shell input keyevent 160
adb shell input text ./shakti%s-p%s8080 && adb shell input keyevent 160

⮊ Examples of uses?

From the default port 707, open the port 3838 to echo the command ls

http://localhost:707/?cmd=ls&port=3838

Then open http://localhost:3838

or http://localhost:3838/?cmd=ls&port=3838&live to see live refreshing results, every 1 seconds

The &live parameter, will refresh the page every second.

We can also use any browser tab reloader module.

From a terminal, using w3m

w3m 'http://localhost:707/?cmd=ls&port=3000'

Will show ls result every second on this link: http://localhost:3000/?cmd=ls&port=3000&live

⮊ Who?

Nico Krazhtest https://ponyhacks.com