shuijiao1/guko

GUKO is a lightweight Telegram bot for managing VPS instances and servers, written in Python. Instead of logging into each server separately, you message the bot in Telegram to see a dashboard of every server you have added: how many are online, CPU, memory and disk usage, network traffic, real time speed, and basic system information. You add servers to the bot directly through Telegram chat, either one at a time or through a batch import that accepts a list of names and IP addresses in a single message. SSH access can be configured several ways: reuse a default key set for every server, give a server its own key, point to an existing key already on disk, upload or paste a private key directly into the chat, or use a password instead. Newly added servers can be tested immediately with a single-server or test-all command to confirm SSH connectivity works. Beyond monitoring, GUKO can run common diagnostic checks against a server over SSH, including IP quality testing, NodeQuality, streaming media unlock detection, NextTrace route tracing, and a GB5 benchmark. It can also generate IP and domain lookup images using IPPure and bgp.tools BGP routing data. Each of these checks can be turned on or off individually through environment variables. Deployment is designed around Docker: the recommended path pulls a prebuilt Docker Compose file and does not require cloning the repository at all, while a second path builds from source for development. Configuration lives in a .env file where you set your Telegram bot token, obtained from BotFather, and a list of allowed Telegram user IDs, obtained from a bot like userinfobot. By default the bot only responds to that allowlist, and administrator user IDs are configured separately with permission to add, remove, or run higher risk commands. The README states that the repository itself does not contain any bot tokens, real user IDs, server passwords, or private keys, and stresses keeping the real .env file out of version control. The project is released under the MIT license, and documentation is available in both Chinese and English.