{"id":19839912,"url":"https://github.com/fnzv/trsh-go","last_synced_at":"2025-10-07T02:37:44.070Z","repository":{"id":57712764,"uuid":"299054131","full_name":"fnzv/trsh-go","owner":"fnzv","description":"Telegram Remote-Shell is a Golang script that let you comunicate with your server using a Telegram Bot","archived":false,"fork":false,"pushed_at":"2020-09-27T15:15:12.000Z","size":3864,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-06T17:05:57.113Z","etag":null,"topics":["bot","golang","linux","telegram"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fnzv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-09-27T14:51:11.000Z","updated_at":"2024-08-17T07:18:16.000Z","dependencies_parsed_at":"2022-09-26T21:30:47.894Z","dependency_job_id":null,"html_url":"https://github.com/fnzv/trsh-go","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnzv%2Ftrsh-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fnzv","download_url":"https://codeload.github.com/fnzv/trsh-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251932536,"owners_count":21667161,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","golang","linux","telegram"],"created_at":"2024-11-12T12:24:47.785Z","updated_at":"2025-10-07T02:37:39.047Z","avatar_url":"https://github.com/fnzv.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"## trsh-go\n\nTelegram Remote-Shell is a Golang script that let you comunicate with your Linux server using a Telegram Bot  \u003cbr\u003e\nThis repo is a re-make of my original Python script created a few years ago [here](https://github.com/fnzv/trsh)\n\n-----------------\n![](img/bot.png?raw=true)\n \u003cbr\u003e\n\n -------------------------------\n## Requirements\n- Linux OS (tested on Ubuntu 20.04 and Centos 7)\n- Telegram Bot created using @BotFather\n- Packages required: jq\n- (Optional packages used):  nmap, dig, mtr, net-tools (netstat)\n\n## Quick setup\n\nBefore setup: \u003cbr\u003e\n\n* Chat with BotFather in order to create a Bot ( https://telegram.me/botfather ), just launch the command /newbot and get your Telegram Token. \u003cbr\u003e\n Open the bot chat and send some messages to activate the bot. \u003cbr\u003e\n\n* Launch this oneliner+script on your Linux system (where the bot will be running as a service): \u003cbr\u003e\n\n```\ngit clone https://github.com/fnzv/trsh-go /home/trsh/ \u0026\u0026 cd /home/trsh/ \u0026\u0026 bash install.sh\n```\n\n##### WARNING: this command will install the required/missing packages ( dnsutils, nmap, mtr, net-tools )\n\n##### NOTES:\n\n- You will be asked to insert your Telegram Bot Token acquired on the first step and then follow the quick installation wizard. \u003cbr\u003e\n\n- The script will gather your chat-id based on the last unread message you send to the bot on the first step. \u003cbr\u003e\n\nAfter you finished the installation the Golang script binary will run as a system service with systemd (trsh.service).\n\n## Usage\n\n- /dig - Resolve the given domain, supports RR.. example /dig A google.com or /dig MX google.com\n- /mtr - Execute a mtr with a following report\n- /nmap - Execute a nmap -Pn -A\n- /curl - Execute a curl request\n- /whois - Whois lookup\n- /sysinfo - Display generic system information (disk usage, network \u0026 memory)\n- /sh - Execute a command with Bash.. example /sh cat namefile , /sh ps auxf | grep ssh\n\n## Tests\n\nThe following scripts are tested on Ubuntu 20.04 LTS, Centos 7 and marked as working.\n\n\n## Run using docker\n\nInside this repo you will find a prepared Docker image  to build and use in order to run trsh-go:\n\n1) Build the image:\n\n```\ndocker build -t trsh .\n```\n\n2) Run the docker image and specify your ENV vars (below an example):\n\n```\ndocker run -d -e TGBOT_TOKEN=\"123456789:qwertyuiopasdfghjklzxcb\" -e TGBOT_CHATID=\"12345678\" trsh-go\n```\n\n3) Chat with your Bot\n\n\n## Contributors\n\nFeel free to open issues or contact me directly\n\n## License\n\nCode distributed under MIT licence.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffnzv%2Ftrsh-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffnzv%2Ftrsh-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffnzv%2Ftrsh-go/lists"}