宝塔面板运维监控

宝塔面板服务器的全方位运维监控工具，支持多服务器管理、资源监控、网站状态检查、服务状态检查、SSH安全审计、计划任务管理等功能。

图标资源

技能包提供以下图标文件，可在生成报告时引用：

使用示例（生成报告时）：
CODEBLOCK0

AI 使用约束

本技能用于查询和展示服务器状态数据，AI应遵循以下原则：

1. 1. 数据中立：如实展示监控数据，不夸大或缩小问题严重性
2. 客观分析：基于阈值配置给出告警，避免主观判断
3. 数据驱动：建议和结论应基于实际数据，不得臆测
4. 隐私保护：不主动泄露服务器敏感信息（如IP、Token、域名）
5. 执行前告知：由于接口数据较多，获取和分析需要一定时间，AI应先向用户简述即将执行的操作步骤，然后再执行命令获取数据

执行流程示例：
CODEBLOCK1

宝塔面板相关技能矩阵

当前宝塔面板技能包，共包含 3 个相互关联的技能：

服务器配置管理

重要: 没有服务器信息时需要添加

使用配置工具管理服务器：

CODEBLOCK2

常用场景

场景一：初次使用配置服务器

当用户第一次使用本技能时，需要先配置服务器连接信息：

CODEBLOCK3

获取 API Token 的方法：

1. 1. 登录宝塔面板
2. 进入「面板设置」->「API 接口」
3. 点击「获取 API Token」

重要提示 - SSL 证书验证配置：
添加服务器时，AI 应询问用户：

"您的宝塔面板是否使用了受信任的 SSL 证书（如 Let's Encrypt、商业 CA 证书）？"

• - ✅ 是（受信任证书）→ 使用默认配置，无需额外参数
• ⚠️ 否（自签名证书）→ 添加 --verify-ssl false 参数

示例：
CODEBLOCK4

用户意图识别：

• - "帮我配置宝塔服务器" → 引导用户添加服务器配置，先询问 SSL 证书情况
• "添加一台服务器" → 执行 bt-config.py add，根据证书类型决定是否加 --verify-ssl 参数
• "查看有哪些服务器" → 执行 bt-config.py list

场景二：多服务器资源汇总

当用户需要了解所有服务器的整体运行状态时：

CODEBLOCK5

用户意图识别：

• - "服务器整体情况怎么样" → 执行 monitor.py
• "所有服务器健康状态" → 执行 monitor.py + sites.py
• "多服务器资源使用情况" → 执行 monitor.py --format table

场景三：单台服务器日常巡检

当用户需要对单台服务器进行全面检查时：

CODEBLOCK6

用户意图识别：

• - "检查 prod-01 这台服务器" → 执行上述检查命令
• "帮我日常巡检" → 执行系统监控、网站状态、服务状态检查
• "这台服务器有问题吗" → 执行全面检查并汇总告警

场景四：网站SSL证书检查

当用户关心SSL证书是否即将过期时：

CODEBLOCK7

用户意图识别：

• - "SSL证书快过期了吗" → 执行 sites.py --filter ssl-warning
• "有哪些网站证书过期了" → 执行 sites.py --filter ssl-expired

场景五：安全审计

当用户需要进行安全检查时：

CODEBLOCK8

用户意图识别：

• - "有没有异常登录" → 执行 ssh.py --logs --filter failed
• "查一下这个IP的登录记录" → 执行 ssh.py --logs --search IP
• "SSH安全检查" → 执行 ssh.py --status 和 ssh.py --logs

场景六：服务故障排查

当某个服务出现问题时：

CODEBLOCK9

用户意图识别：

• - "Nginx/Apache/Redis出问题了" → 查看服务状态 + 查看错误日志
• "服务报错了，帮我看看日志" → 执行 logs.py 查看对应服务日志

场景七：备份任务检查

当用户关心备份是否正常时：

CODEBLOCK10

用户意图识别：

• - "备份任务正常吗" → 执行 crontab.py --backup-only
• "查看备份日志" → 执行 crontab.py --logs --task-id ID

版本要求

• - 宝塔面板: >= 9.0.0
• Python: >= 3.10

用法

系统资源监控

CODEBLOCK11

网站状态检查

CODEBLOCK12

服务状态检查

CODEBLOCK13

日志读取

CODEBLOCK14

SSH状态和日志检查

CODEBLOCK15

计划任务检查

CODEBLOCK16

参数说明

monitor.py 参数

sites.py 参数

services.py 参数

logs.py 参数

注意：只有已安装的服务才能获取日志，尝试获取未安装服务的日志会返回错误。

ssh.py 参数

crontab.py 参数

监控指标

系统资源监控 (monitor.py)

通过单一API接口获取完整的系统监控数据：

• - CPU: 使用率、核心数、型号、用户/系统占用
• 内存: 总量、使用量、可用量、缓存、使用率
• 磁盘: 多分区详情、总量、使用量、使用率
• 网络: 实时速度、总流量、各网卡统计
• 负载: 1/5/15分钟负载
• 系统: 主机名、操作系统、运行时间、面板版本
• 资源: 网站、数据库、FTP账户数量

网站状态检查 (sites.py)

支持多种项目类型：

检查项目：

• - 运行状态: 运行中/已停止/启动中
• SSL证书: 有效/即将过期/已过期
• 进程信息: PID、内存、CPU、线程数（适用于Java/Node/Go/Python/.NET/Other）
• 反代健康: 反代项目的后端健康状态
• 基础信息: 路径、域名、PHP版本、端口、代理地址

服务状态检查 (services.py)

支持检查的服务：

服务状态字段说明：

重要区别：

• - installed=false：服务未安装，无法获取日志
• INLINECODE71：服务已安装但未运行
• INLINECODE72：服务已安装且正在运行

PHP多版本共存说明：

• - PHP是支持多版本共存的服务，一台服务器可能同时安装多个PHP版本
• PHP服务名称格式：php-X.X（如 php-8.2、php-7.4）
• 系统会自动扫描已安装的PHP版本并分别显示状态
• 常见PHP版本：8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4, 7.3, 7.2, 7.1, 7.0, 5.4, 5.3, 5.2

检查项目：

• - 运行状态: 运行中/已停止
• 版本信息: 已安装版本号
• 进程PID: 主进程ID

日志读取 (logs.py)

支持的日志类型：

注意事项：

• - 只有已安装（installed=true）的服务才能获取日志
• 尝试获取未安装服务的日志会返回错误
• Memcached 和 Pure-FTPD 不支持日志获取

SSH状态和日志检查 (ssh.py)

检查项目：

• - SSH服务状态: 运行中/已停止
• 端口: SSH监听端口
• Ping设置: 是否允许ping
• 防火墙状态: 是否启用
• Fail2ban: 是否安装和运行

登录日志字段：

• - 时间: 登录时间
• 类型: 成功/失败
• 用户: 登录用户名
• IP地址: 来源IP
• 地区: IP归属地
• 登录方式: password/key

计划任务检查 (crontab.py)

任务类型：

• - 备份网站: 自动备份网站文件和数据库
• 备份数据库: 单独备份数据库
• 备份目录: 备份指定目录
• Shell脚本: 自定义Shell命令
• 同步时间: NTP时间同步
• 切割日志: 日志分割任务
• 访问URL: 定时HTTP请求

检查项目：

• - 任务状态: 启用/禁用
• 执行周期: 每天/每小时/每周/每月/间隔分钟
• 备份目标: 网站名称/数据库名称
• 保留数量: 备份保留份数
• 执行结果: 最后一次执行状态

告警配置

SSL证书告警

服务器资源告警阈值

可在配置文件中设置告警阈值：

CODEBLOCK17