GUKO：一个轻量的 VPS Telegram 管理 Bot
GUKO 是一个轻量自托管 Telegram Bot，用来在 Telegram 里管理常用 VPS、查看服务器状态，并快速运行 IP 质量、NodeQuality、流媒体解锁、NextTrace、GB5 等常见测试。
我平时会管理几台 VPS，也经常需要跑一些重复性很强的测试：看机器状态、测 SSH、跑 IP 质量、NodeQuality、流媒体解锁、NextTrace、GB5，或者临时查一下某个 IP 的 BGP 路由图。
这些事情如果每次都手动 SSH 上去执行命令，倒也不是不能用，但很容易变成：命令散落在聊天记录、笔记、终端历史和各种脚本里。GUKO 就是为了解决这个问题做的一个轻量 Telegram Bot。
项目地址：https://github.com/shuijiao1/GUKO
它解决什么问题
GUKO 的定位不是完整监控面板，也不是复杂运维平台。
它更像一个放在 Telegram 里的 VPS 小工具箱：
- 想看服务器列表和状态时，打开 Bot；
- 想添加一台新机器时，在 Telegram 里按提示填；
- 想跑常见测试时，点按钮触发；
- 想回看最近一次测试结果时，直接从 Bot 里查看。
也就是说，它适合个人自用、小规模服务器管理，以及那些「懒得每次 SSH 上去手敲命令」的场景。
主要功能
服务器状态面板
GUKO 可以展示服务器的基础状态，例如：
- 在线 / 离线；
- CPU、内存、硬盘占用；
- 流量与实时网速；
- 系统信息；
- SSH 连通性。
它不是为了替代 Nezha、Prometheus、Grafana 这类完整监控系统，而是提供一个更轻的入口：打开 Telegram 就能快速看一眼。
在 Telegram 里添加服务器
添加服务器不需要手动改 JSON，也不需要登录后台页面。
Bot 支持：
- 单台添加；
- 批量导入；
- 编辑服务器信息；
- 删除服务器配置；
- SSH 连通性测试。
SSH 鉴权方式也尽量覆盖常见情况：
- 默认密钥；
- 每台独立密钥；
- 已有密钥路径；
- 上传 / 粘贴私钥；
- 密码登录；
- 先导入，后续再补认证。
对于经常买小鸡、迁移机器、临时测试服务器的人来说，这比反复手改配置舒服很多。
常用 VPS 测试入口
GUKO 里集成了一些常见测试入口，例如：
- IP 质量；
- NodeQuality；
- 流媒体解锁；
- NextTrace；
- GB5；
- IPPure；
- bgp.tools BGP 路由图。
这些测试本质上还是调用对应的脚本或服务，但 GUKO 把入口统一到了 Telegram 里，减少了记命令和切终端的成本。
我个人比较看重的是：测试历史可以留存，并且能用接近测试完成时的形式重新查看。比如 BGP / IPPure 这类结果是图片，就重新发图；NodeQuality 这类结果则保留报告链接和完整输出。
为什么默认白名单
GUKO 涉及服务器信息、SSH 配置和测试任务，所以默认不应该做成公开 Bot。
项目采用白名单模式，部署时需要配置允许使用的 Telegram 用户 ID。这样即使 Bot Token 泄露风险降低一些，也不会变成谁都能操作的入口。
当然，白名单不是万能安全措施。真正部署时仍然建议：
- 使用自己创建的私有 Bot；
- 不要把真实
.env、私钥、服务器清单提交到仓库； - 尽量使用专门的低权限密钥；
- 删除服务器、重装系统、防火墙修改这类高风险动作必须谨慎。
GUKO 更适合做「自用管理入口」，而不是暴露给陌生用户的公共服务。
部署方式
推荐使用 Docker Compose。
最小流程大概是：
mkdir -p guko/keys guko/media guko/tmp
cd guko
curl -Lo docker-compose.yml https://github.com/shuijiao1/GUKO/releases/latest/download/docker-compose.yml
然后准备 .env，至少填写：
BOT_TOKEN=replace-me
ALLOWED_USERS=123456789
ADMIN_USERS=123456789
再启动：
docker compose pull
docker compose up -d
docker compose logs -f
启动后，在 Bot 里发送：
/start
然后就可以添加第一台服务器。
完整部署说明以 GitHub README 为准：https://github.com/shuijiao1/GUKO
适合谁用
GUKO 比较适合这些场景：
- 手里有几台 VPS，经常需要看状态；
- 经常跑 IP 质量、NodeQuality、流媒体解锁；
- 想把常见 VPS 测试集中在 Telegram 里；
- 不想维护复杂监控面板；
- 希望自托管，不想把服务器列表交给第三方平台。
如果你只管理一台机器，可能直接 SSH 就够了。如果你需要完整监控、告警、图表和长期指标，专业监控系统会更合适。
GUKO 的核心价值是：轻量、直接、方便跑测试。
小结
GUKO 不是一个大而全的运维平台，而是一个围绕 Telegram 使用习惯做的小型服务器管理工具。
它把「看服务器状态」「添加机器」「跑常见测试」「查看历史结果」这些高频动作整合到一个 Bot 里，适合个人或小圈子自托管使用。