Nezha Telegram Bot - NextGen V1 是一个基于 Nezha 监控 API，用于监控服务器状态的 Telegram 机器人。通过简单的命令，您可以实时查看服务器的运行状态、资源使用情况、执行计划任务以及监控服务可用性。

📋 特性

• 账号绑定：安全绑定您的 Nezha 账户，确保数据隐私。
• 服务器概览：查看所有服务器的在线状态、内存使用、交换空间、磁盘使用、网络流量等统计信息。
• 单台服务器状态：获取单个服务器的详细状态信息，包括负载、CPU 使用率、内存、磁盘、网络流量等。
• 计划任务管理：查看并执行预设的计划任务，自动化管理服务器。
• 服务可用性监测：监控服务的可用性和平均延迟，确保服务稳定运行。
• 数据刷新：实时刷新数据，确保您获取到最新的服务器状态。

🚀 快速开始

📦 前提条件

在开始之前，请确保您已经具备以下条件：

• Python 3.7 或更高版本
• Telegram 账号
• 已安装哪吒监控 Dashboard 并完成配置
• Telegram 机器人 Token（通过 BotFather 获取）

🔧 安装步骤

1. 克隆仓库

   git clone https://github.com/yourusername/nezha-telegram-bot.git
   cd nezha-telegram-bot

2. 创建虚拟环境

   推荐使用 venv 创建虚拟环境：

   python3 -m venv venv
   source venv/bin/activate  # 对于 Windows 用户使用 venv\Scripts\activate

3. 安装依赖

   pip install -r requirements.txt

4. 配置环境变量

   为了安全起见，建议使用环境变量存储敏感信息。创建一个 .env 文件并添加以下内容：

   TELEGRAM_TOKEN=your_telegram_bot_token

5. 初始化数据库

   数据库会在首次运行时自动创建。

6. 运行机器人

   python bot.py

   您应该会看到类似以下的日志输出，表示机器人已成功启动：

   2024-12-08 17:50:39,139 - telegram.ext.Application - INFO - Application started
   

🛠️ 使用指南

📌 绑定账号

为了确保您的数据安全，绑定账号仅支持私聊中进行操作。如果在群组中尝试绑定，机器人会提示您需在私聊中执行。

1. 私聊中发送 /bind 命令。

2. 按照提示依次输入：

   • 用户名
   • 密码
   • Dashboard 地址（例如：https://dashboard.example.com）

3. 绑定成功后，您可以开始使用机器人的各项功能。

📜 可用命令

• /start - 启动机器人并显示欢迎信息。
• /help - 获取可用命令列表和简要说明。
• /bind - 绑定您的 Nezha 账户。
• /unbind - 解绑您的 Nezha 账户。
• /overview - 查看所有服务器的状态总览。
• /server - 查看单台服务器的详细状态。
• /cron - 执行计划任务。
• /services - 查看服务状态总览。

📊 服务器概览

使用 /overview 命令，可以查看所有绑定服务器的统计信息，包括在线状态、内存使用、交换空间、磁盘使用、网络流量等。您还可以通过点击“刷新”按钮实时更新数据。

🖥️ 单台服务器状态

使用 /server 命令，输入服务器名称进行搜索，并选择相应的服务器查看详细状态信息。包括负载、CPU 使用率、内存、磁盘、网络流量等数据。

⏰ 计划任务管理

使用 /cron 命令，可以查看并执行预设的计划任务。点击相应任务名称进行确认执行或取消操作。

🌐 服务可用性监测

使用 /services 命令，可以查看服务的可用性信息，包括可用率、当前状态、平均延迟和剩余流量等。

🙏 致谢

• python-telegram-bot - 用于 Telegram 机器人的开发。
• aiohttp - 异步 HTTP 客户端/服务器框架。
• aiosqlite - 异步 SQLite 连接库。
• 哪吒监控 - 哪吒服务器监控。
• ChatGPT - 本项目采用“面向 ChatGPT 编程”的理念，完成了包括本文档在内的 90% 的代码。

---

免责声明：使用本机器人时，请确保遵守相关法律法规。开发者不对因使用本机器人导致的任何损失承担责任。