Shell remote control from telegram
Description of the ShellRemoteBot
Helps you work with your server (or remote computer) via telegram bot emulating terminal operations (sh for Linux and cmd for Windows) and a file manager functionality.
It is possible to work in the terminal from under any user in OS. You can configure access to several telegram users or only for You.
The program can run as a regular console program or run as a daemon/service.
Tested in Linux but You can try to use in other OS also. Developed with FreePascal. It depends on fp-telegram lib .
Script files (macros)
You can specify predefined shell scripts. Create script file with extention
.script in the same folder where INI file is located.
Get the script menu by command
/scripts. Click the selected script.
You can call the file manager by
/dir command then select directory inline button (select another folder) or file inline button (select the file to download).
You can set the default value in the configuration file (
- Create bot https://core.telegram.org/bots/#3-how-do-i-create-a-bot . You must select (keep default) longpolling method for getting updates.
- Create config ini file
tgshd.iniin app folder:
[API] ;; Specify Your token Token= ;; Actual if telegram server is blocked in server/computer region Endpoint=https://api.telegram.org/bot ;; Timeout for lognpolling requests while getting updates Timeout=20 [Users] ;; Specify all admin users (Telegram UserID [Integer]). For example: ;;123456789=a ;; where 'a' character is means administrator, 'b' - banned YOUR_User_ID=a [Proxy] ;; If You can want to use HTTP proxy please use tgsynapsehttpclientbroker Host= Port= Username= Password= [Scripts] ;; You can specify directory for script file folder. Default value equal configuration file directory Directory= [File] ;; You can specify default initial directory path for file manager called by /dir command DefaultDir=
- Run as a console program or daemon/service.
You can easily install using a .deb file on Debian/Ubuntu/etc. Download deb package from release section https://github.com/Al-Muhandis/ShellRemoteBot/releases Then install for example:
sudo dpkg --install tgsh_1.2-1_amd64.deb # After package installation set up at least token and admin user id in the INI file located at /etc/tgshd/tgshd.ini # for example with Nano editor sudo nano /etc/tgshd/tgshd.ini # Now You can run /usr/bin/tgshd -r # Or is better enable and run as a daemon (service file for systemd inlcluded in the DEB package) systemctl enable tgshd systemctl start tgshd
Users rights and telegram user ID
You can define user access in configuration file
tgshd.ini by adding string like
user_id=a where user_id is telegram user id of administrator.
You can add more than one administrator.
If any simple telegram user sends any message, command etc to the bot then the bot will reply
You cannot access to this bot!.
if You add a line
user_id=b then user will banned and the bot will not respond anything
There are some ways to determine your user_id but You can simply send
/myid to @HelloLazarusBot chat
Telegram bot commands
Reads messages from the shell console.
Sometimes the program does not wait for a response immediately after execution in the console, and in this case, you can read the newly appeared messages by the
/sig and /sigXXXX
It is worked under Unix systems. You can send POSIX signal to terminal.
/sig 9 where 9 is kill sig number or You can send commands
Calls the menu for executing the prepared script from the list of files. Scripts must located in the same folder where the INI file is located,
or you can set the folder in the settings in the the
[Scripts] section /
Calls the file Manager. You can set the default value in the configuration file
If you want to add HTTP proxy support, then:
laz_synapse.lpkdepending on the project
- set the proxy data in the
INIfile. Note: The native FPHTTPClient does not yet have full HTTPS proxy support. So in the case of synapse HTTP client, to make the HTTPs proxy work in Linux (laz_synapse.lpk v40.1), comment out the line in the blcksock.pas source unit of the synapse library.
// Port := IntToStr(ResolvePort(Port));