{"repo":"shui1iao/GUKO","free":true,"listed":false,"github":"https://github.com/shui1iao/GUKO","clone":"git clone https://github.com/shui1iao/GUKO.git","description":"轻量 VPS / 服务器管理 Telegram Bot，支持 SSH 管理、批量导入、质量测试和安全白名单。","language":"Python","stars":23,"topics":["telegram-bot","vps","server-management","self-hosted","docker","nodequality","ssh"],"license":"MIT","category":"deployment-docker-iac","readme_excerpt":"GUKO 中文 English 轻量 VPS / 服务器管理 Telegram Bot：服务器状态面板、SSH 登录管理、常用测试脚本入口 私聊打开 Bot 就能查看服务器列表、状态详情、流量与资源占用；支持在 Telegram 内添加服务器、测试 SSH、运行 IP 质量 / NodeQuality / TCPQuality / 流媒体 / NextTrace / GB5 等常用检测。 默认白名单模式，适合自托管。 --- 🎯 核心特性 - 服务器状态面板 ：展示在线数量、CPU / 内存 / 硬盘、流量、实时网速、系统信息等。 - Telegram 内添加服务器 ：支持单台添加、批量导入、编辑、删除和 SSH 连通性测试。 - 灵活 SSH 鉴权 ：支持默认密钥继承、每台独立密钥、已有密钥路径、上传 / 粘贴私钥、密码登录。 - 常用测试与协议入口 ：支持 IP 质量、NodeQuality、TCPQuality、流媒体解锁、NextTrace、GB5、SS-Rust、AnyTLS、VLESS、Snell 等任务。 - IP / 域名工具 ：支持 IPPure 官方图片与 bgp.tools BGP 路由图。 - 适合 Docker 部署 ：提供 Docker Compose、Makefile 和初始化脚本。 --- 🚀 快速开始 先准备： 1. 到 @BotFather 创建 Bot，拿到 BOT TOKEN 。 2. 用 @userinfobot 或 @RawDataBot 获取你的 Telegram 数字用户 ID。 提供 2 种部署方式， 推荐 Docker Compose 。 方式一：Docker Compose（推荐，无需 git clone） docker-compose.yml 已显式设置 name: guko ，因此在 Docker / DockUP 等管理面板里会显示为 guko ，不会因为部署目录不同变成随机目录名。 最小配置里只需要先改： 启动后在 Bot 里发送 /addserver 添加第一台服务器。 方式二：源码构建（开发用） --- 💬 使用方式 打开面板 私聊 Bot 发送： Bot 会显示 GUKO 总览面板，可以点服务器查看详情。 添加服务器 点击 ➕ 添加服务器 ，或者发送： 单台添加 选择 添加单台 ，按提示发送： 示例： 然后 Bot 会询问登录方式，支持密钥路径、上传 / 粘贴私钥、密码或先保存后测试。 添加后可用按钮或命令测试： 服务器详情页也支持 编辑 和 删除 ；删除需要二次确认，只会删除本地配置，不会操作远端机器。 批量导入 选择 批量导入 后，Bot 会先问： 1. 是否全部使用同一个 SSH 端口，还是每台自己写端口。 2. 是否全部使用同一把密钥、同一个密码、每台自己写认证，还是先只导入不测试。 常用批量格式： 如果选择“每台自己写端口”： 如果选择“每台自己写认证”： Telegram 里发送密码 / 私钥会经过 Telegram 云端。建议使用私有 Bot，并限制 ALLOWED USERS 。 命令 - /start — 打开 GUKO 面板 - /list — 查看服务器列表 - /status — 查看总览状态 - /addserver — 添加 / 批量导入服务器 - /testssh — 测试单台服务器 SSH - /testall — 批量测试 SSH - /exportconfig — 导出脱敏配置 - /info — 查看单台详情 - /health — 只","default_branch":null,"files":null,"tree":[],"storefront":"/r/shui1iao","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/shui1iao/GUKO/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}