How do I install the Btpanel skill?

Run npx skillmds@latest add dvcrn/btpanel in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Btpanel skill do?

宝塔面板(BT-Panel)运维监控技能，提供服务器资源监控、网站状态检查、服务状态检查、SSH安全审计、计划任务管理、日志读取等功能 It is listed under Coding & Dev Tools on SkillMD.

Is Btpanel safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Btpanel?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Btpanel free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Btpanel?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Btpanel by dvcrn — Agent Skill

Name: Btpanel
Rating: 4.2 (5 reviews)
Author: dvcrn

宝塔面板运维监控

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

图标资源

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

文件	格式	用途
`icon/bt-logo.svg`	SVG	矢量图标，适合缩放

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

# 服务器巡检报告

![宝塔面板](icon/bt-logo.svg)

## 概述
...

AI 使用约束

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

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

执行流程示例：

AI: 我将为您执行以下操作：
    1. 获取服务器系统资源状态（CPU、内存、磁盘）
    2. 检查网站运行状态
    3. 检查服务运行状态
    正在获取数据，请稍候...
    [执行命令]
    [展示结果和分析]

服务器配置管理

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

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

# 查看帮助
python3 {baseDir}/scripts/bt-config.py -h

# 添加服务器
python3 {baseDir}/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_TOKEN

# 列出服务器
python3 {baseDir}/scripts/bt-config.py list

# 设置阈值
python3 {baseDir}/scripts/bt-config.py threshold --cpu 75 --memory 80

常用场景

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

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

# 添加服务器（需要面板地址和API Token）
python3 {baseDir}/scripts/bt-config.py add -n prod-01 -H https://panel.example.com:8888 -t YOUR_API_TOKEN

# 查看已配置的服务器
python3 {baseDir}/scripts/bt-config.py list

获取API Token的方法：

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

用户意图识别：

"帮我配置宝塔服务器" → 引导用户添加服务器配置
"添加一台服务器" → 执行 bt-config.py add
"查看有哪些服务器" → 执行 bt-config.py list

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

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

# 查看所有服务器的资源使用情况
python3 {baseDir}/scripts/monitor.py --format table

# 查看所有服务器的网站状态汇总
python3 {baseDir}/scripts/sites.py

# 查看所有服务器的服务状态
python3 {baseDir}/scripts/services.py

用户意图识别：

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

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

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

# 指定服务器名称进行各项检查
python3 {baseDir}/scripts/monitor.py --server prod-01 --format table
python3 {baseDir}/scripts/sites.py --server prod-01
python3 {baseDir}/scripts/services.py --server prod-01
python3 {baseDir}/scripts/ssh.py --status --server prod-01
python3 {baseDir}/scripts/crontab.py --backup-only --server prod-01

用户意图识别：

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

场景四：网站SSL证书检查

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

# 查看SSL即将过期的网站
python3 {baseDir}/scripts/sites.py --filter ssl-warning

# 查看SSL已过期的网站
python3 {baseDir}/scripts/sites.py --filter ssl-expired

用户意图识别：

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

场景五：安全审计

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

# 查看SSH登录失败记录
python3 {baseDir}/scripts/ssh.py --logs --filter failed

# 搜索特定IP的登录记录
python3 {baseDir}/scripts/ssh.py --logs --search 192.168.1.100

# 查看SSH服务状态
python3 {baseDir}/scripts/ssh.py --status

用户意图识别：

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

场景六：服务故障排查

当某个服务出现问题时：

# 查看服务状态
python3 {baseDir}/scripts/services.py --server prod-01

# 查看服务错误日志
python3 {baseDir}/scripts/logs.py --server prod-01 --service nginx --lines 200
python3 {baseDir}/scripts/logs.py --server prod-01 --service redis

用户意图识别：

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

场景七：备份任务检查

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

# 查看所有备份任务
python3 {baseDir}/scripts/crontab.py --backup-only

# 查看特定备份任务的执行日志
python3 {baseDir}/scripts/crontab.py --logs --task-id 11

用户意图识别：

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

版本要求

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

用法

系统资源监控

# 查看帮助
python3 {baseDir}/scripts/monitor.py -h

# 监控所有服务器
python3 {baseDir}/scripts/monitor.py

# 监控指定服务器
python3 {baseDir}/scripts/monitor.py --server prod-01

# JSON格式输出
python3 {baseDir}/scripts/monitor.py --format json

# 表格格式输出
python3 {baseDir}/scripts/monitor.py --format table

# 输出到文件
python3 {baseDir}/scripts/monitor.py --output report.json

网站状态检查

# 查看帮助
python3 {baseDir}/scripts/sites.py -h

# 检查所有服务器的网站状态
python3 {baseDir}/scripts/sites.py

# 检查指定服务器
python3 {baseDir}/scripts/sites.py --server prod-01

# 只显示停止的网站
python3 {baseDir}/scripts/sites.py --filter stopped

# 只显示SSL即将过期的网站（30天内）
python3 {baseDir}/scripts/sites.py --filter ssl-warning

# 只显示SSL已过期的网站
python3 {baseDir}/scripts/sites.py --filter ssl-expired

# JSON格式输出
python3 {baseDir}/scripts/sites.py --format json

# 输出到文件
python3 {baseDir}/scripts/sites.py --output sites.json

服务状态检查

# 查看帮助
python3 {baseDir}/scripts/services.py -h

# 检查所有服务器的服务状态
python3 {baseDir}/scripts/services.py

# 检查指定服务器
python3 {baseDir}/scripts/services.py --server prod-01

# 只检查特定服务
python3 {baseDir}/scripts/services.py --service nginx --service redis

# JSON格式输出
python3 {baseDir}/scripts/services.py --format json

# 输出到文件
python3 {baseDir}/scripts/services.py --output services.json

日志读取

# 查看帮助
python3 {baseDir}/scripts/logs.py -h

# 查看Nginx错误日志
python3 {baseDir}/scripts/logs.py --service nginx

# 查看Redis日志
python3 {baseDir}/scripts/logs.py --service redis

# 查看Apache错误日志
python3 {baseDir}/scripts/logs.py --service apache

# 查看MySQL错误日志
python3 {baseDir}/scripts/logs.py --service mysql

# 查看MySQL慢查询日志
python3 {baseDir}/scripts/logs.py --service mysql --log-type slow

# 查看PostgreSQL日志（需要插件）
python3 {baseDir}/scripts/logs.py --service pgsql

# 查看PostgreSQL慢日志
python3 {baseDir}/scripts/logs.py --service pgsql --log-type slow

# 指定服务器和行数
python3 {baseDir}/scripts/logs.py --server prod-01 --service nginx --lines 200

# JSON格式输出
python3 {baseDir}/scripts/logs.py --service nginx --format json

SSH状态和日志检查

# 查看帮助
python3 {baseDir}/scripts/ssh.py -h

# 查看SSH服务状态
python3 {baseDir}/scripts/ssh.py --status

# 查看SSH登录日志
python3 {baseDir}/scripts/ssh.py --logs

# 只查看失败的登录日志
python3 {baseDir}/scripts/ssh.py --logs --filter failed

# 只查看成功的登录日志
python3 {baseDir}/scripts/ssh.py --logs --filter success

# 搜索特定IP的登录记录
python3 {baseDir}/scripts/ssh.py --logs --search 192.168.1.1

# 指定服务器
python3 {baseDir}/scripts/ssh.py --status --server prod-01

# JSON格式输出
python3 {baseDir}/scripts/ssh.py --logs --format json

计划任务检查

# 查看帮助
python3 {baseDir}/scripts/crontab.py -h

# 查看所有计划任务
python3 {baseDir}/scripts/crontab.py

# 只查看备份任务
python3 {baseDir}/scripts/crontab.py --backup-only

# 查看指定服务器
python3 {baseDir}/scripts/crontab.py --server prod-01

# 查看备份任务日志
python3 {baseDir}/scripts/crontab.py --logs --task-id 11

# JSON格式输出
python3 {baseDir}/scripts/crontab.py --format json

参数说明

monitor.py 参数

参数	说明	默认值
`--server`, `-s`	指定服务器名称	所有服务器
`--format`, `-f`	输出格式 (json/table)	json
`--output`, `-o`	输出文件路径	标准输出
`--config`, `-c`	配置文件路径	自动查找

sites.py 参数

参数	说明	默认值
`--server`, `-s`	指定服务器名称	所有服务器
`--format`, `-f`	输出格式 (json/table)	table
`--output`, `-o`	输出文件路径	标准输出
`--filter`	过滤条件 (stopped/ssl-warning/ssl-expired)	无
`--config`, `-c`	配置文件路径	自动查找

services.py 参数

参数	说明	默认值
`--server`, `-s`	指定服务器名称	所有服务器
`--format`, `-f`	输出格式 (json/table)	table
`--output`, `-o`	输出文件路径	标准输出
`--service`	指定要检查的服务（可多次指定）	默认服务列表
`--config`, `-c`	配置文件路径	自动查找

logs.py 参数

参数	说明	默认值
`--server`, `-s`	指定服务器名称	所有服务器
`--service`	服务名称 (nginx/apache/redis/mysql/pgsql)	必填
`--log-type`	日志类型 (error/slow)	error
`--lines`, `-n`	返回最后N行日志	100
`--format`, `-f`	输出格式 (json/table)	table
`--output`, `-o`	输出文件路径	标准输出
`--config`, `-c`	配置文件路径	自动查找

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

ssh.py 参数

参数	说明	默认值
`--server`, `-s`	指定服务器名称	所有服务器
`--status`	查看SSH服务状态	否
`--logs`	查看SSH登录日志	否
`--filter`	日志过滤 (ALL/success/failed)	ALL
`--search`	搜索关键字（IP或用户名）	无
`--limit`, `-n`	返回日志条数	50
`--format`, `-f`	输出格式 (json/table)	table
`--output`, `-o`	输出文件路径	标准输出
`--config`, `-c`	配置文件路径	自动查找

crontab.py 参数

参数	说明	默认值
`--server`, `-s`	指定服务器名称	所有服务器
`--backup-only`	只显示备份任务	否
`--logs`	查看任务日志	否
`--task-id`	任务ID（配合--logs使用）	无
`--days`	日志查询天数	7
`--format`, `-f`	输出格式 (json/table)	table
`--output`, `-o`	输出文件路径	标准输出
`--config`, `-c`	配置文件路径	自动查找

监控指标

系统资源监控 (monitor.py)

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

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

网站状态检查 (sites.py)

支持多种项目类型：

类型	进程信息	运行状态判断
PHP	无	status==1 && stop为空
Java	pid_info	pid > 0
Node	load_info	run==true
Go	load_info	run==true
Python	pids	run==true
.NET	load_info	run==true
Proxy(反代)	无	status==1
HTML(静态)	无	status==1
Other(其他)	load_info	run==true

检查项目：

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

服务状态检查 (services.py)

支持检查的服务：

服务	状态检查	日志支持
Nginx	✓	✓ 错误日志
Apache	✓	✓ 错误日志
MySQL	✓	✓ 错误日志/慢日志
Redis	✓	✓ 日志文件
Memcached	✓	✗
Pure-FTPD	✓	✗
PHP (多版本)	✓	✗
PostgreSQL	✓	✓ 错误日志/慢日志

服务状态字段说明：

字段	说明
`installed` (setup)	服务是否已安装
`status`	服务是否正在运行
`version`	已安装的版本号
`pid`	主进程ID（运行中时）

重要区别：

installed=false：服务未安装，无法获取日志
installed=true, status=false：服务已安装但未运行
installed=true, status=true：服务已安装且正在运行

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)

支持的日志类型：

日志类型	服务	获取方式
错误日志	nginx	文件: /www/server/nginx/logs/error.log
错误日志	apache	文件: /www/wwwlogs/error_log
日志文件	redis	文件: /www/server/redis/redis.log
错误日志	mysql	接口: /database?action=GetErrorLog
慢日志	mysql	接口: /database?action=GetSlowLogs
错误日志	pgsql	插件接口: pgsql_manager
慢日志	pgsql	插件接口: pgsql_manager

注意事项：

只有已安装（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证书告警

剩余天数	告警级别
已过期	critical
≤ 7 天	critical
≤ 30 天	warning

服务器资源告警阈值

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

global:
  thresholds:
    cpu: 80      # CPU使用率告警阈值(%)
    memory: 85   # 内存使用率告警阈值(%)
    disk: 90     # 磁盘使用率告警阈值(%)

Btpanel

File contents

宝塔面板运维监控

图标资源

AI 使用约束

服务器配置管理

常用场景

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

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

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

场景四：网站SSL证书检查

场景五：安全审计

场景六：服务故障排查

场景七：备份任务检查

版本要求

用法

系统资源监控

网站状态检查

服务状态检查

日志读取

SSH状态和日志检查

计划任务检查

参数说明

monitor.py 参数

sites.py 参数

services.py 参数

logs.py 参数

ssh.py 参数

crontab.py 参数

监控指标

系统资源监控 (monitor.py)

网站状态检查 (sites.py)

服务状态检查 (services.py)

日志读取 (logs.py)

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

计划任务检查 (crontab.py)

告警配置

SSL证书告警

服务器资源告警阈值

Frequently asked questions

Btpanel

File contents

宝塔面板运维监控

图标资源

AI 使用约束

服务器配置管理

常用场景

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

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

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

场景四：网站SSL证书检查

场景五：安全审计

场景六：服务故障排查

场景七：备份任务检查

版本要求

用法

系统资源监控

网站状态检查

服务状态检查

日志读取

SSH状态和日志检查

计划任务检查

参数说明

monitor.py 参数

sites.py 参数

services.py 参数

logs.py 参数

ssh.py 参数

crontab.py 参数

监控指标

系统资源监控 (monitor.py)

网站状态检查 (sites.py)

服务状态检查 (services.py)

日志读取 (logs.py)

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

计划任务检查 (crontab.py)

告警配置

SSL证书告警

服务器资源告警阈值

Related skills

Frequently asked questions

How do I install the Btpanel skill?

What does the Btpanel skill do?

Is Btpanel safe to use?

Which AI agents work with Btpanel?

Is Btpanel free to use?

Who published Btpanel?