Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fnzv/trsh
Telegram Remote-Shell
https://github.com/fnzv/trsh
linux shell sysadmin telegram telegram-api telepot
Last synced: 3 months ago
JSON representation
Telegram Remote-Shell
- Host: GitHub
- URL: https://github.com/fnzv/trsh
- Owner: fnzv
- License: mit
- Created: 2017-04-23T10:56:07.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-10-20T13:27:10.000Z (about 1 year ago)
- Last Synced: 2024-06-12T07:16:28.975Z (5 months ago)
- Topics: linux, shell, sysadmin, telegram, telegram-api, telepot
- Language: Python
- Size: 104 KB
- Stars: 68
- Watchers: 10
- Forks: 34
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - fnzv/trsh - Telegram Remote-Shell (Python)
README
## TRSH
Telegram Remote-Shell is a python script that allows to comunicate to your Linux server via Telegram API (with bots).
UPDATE:
Hey, there is a remake in go of the same Python script in Golang [here](https://github.com/fnzv/trsh-go)
-----------------
-------------------------------
## Requirements
- Linux System
- Bot created from @BotFather via Telegram
- Software Packages: python-pip (to install telepot) & basic linux tools like nmap,dig,mtr (optional)
## Installation
The setup is quite easy:
* Chat with BotFather to create a Bot ( https://telegram.me/botfather ), just launch the command /newbot to get your Telegram Token.
Open the bot chat and send some messages to activate the bot.
* Launch this command on your Linux system:
```
cd /home && git clone https://github.com/fnzv/trsh.git && cd trsh && bash install.sh
```
##### WARNING: this command will install the required/missing packages ( supervisor, dnsutils, python-pip, python, nmap, mtr, pip-telepot )
##### NOTES:
- You will be asked to insert your Telegram Bot Token aquired on the first step.
- The script will guess your Sender-id based on the messages you send on the first step.
- If you cannot figure out how to find your Sender-id manually launch the script get-sender-id.py from commandline and you will get a raw output containing chat_id,sender_id,username,type
After you finished the installation the python script will run as a system service with supervisor.
## Usage
- /ping - Tests connectivity
- /dig - Resolve the given domain, supports RR.. example /dig A google.com or /dig MX google.com
- /mtr - Execute a mtr with a following report
- /nmap - Execute a nmap -Pn -A
- /curl - Execute a curl request
- /whois - Whois lookup
- /sysinfo - Display generic system information (disk usage, network & memory)
- /sh - Execute a command with Bash.. example /sh cat namefile , /sh ps auxf | grep ssh
## Tests
The following scripts are being tested on Ubuntu 16.04 LTS, Raspian Jessie and marked as working.
## Contributors
Feel free to open issues or send me an email
## License
Code distributed under MIT licence.