Unraid服务器监控

技能简介

通过GraphQL API连接Unraid服务器，获取27个只读端点的数据，覆盖系统运行状态、磁盘温度与健康、存储阵列、网络共享、Docker容器、虚拟机和系统日志等信息。

能做什么

• 检测服务器在线状态与CPU/内存实时使用率
• 查看磁盘温度、SMART健康度和阵列校验进度
• 列出网络共享文件夹及其配置
• 获取Docker容器和虚拟机的运行状态
• 读取系统日志文件内容
• 汇总未读通知数量（信息/警告/警报）

使用说明

1. 安装与配置

# 克隆技能仓库
git clone https://github.com/openclaw/skills.git
cd skills/jmagar/unraid

# 设置环境变量
export UNRAID_URL="https://your-unraid-server/graphql"
export UNRAID_API_KEY="your-api-key"

获取API密钥路径：Unraid Web界面 → Settings → Management Access → API Keys → Create（选择”Viewer”只读角色）。

2. 基础查询

# 检查服务器是否在线
./scripts/unraid-query.sh -q "{ online }"

# 获取CPU和内存使用率
./scripts/unraid-query.sh -q "{ metrics { cpu { percentTotal } memory { used total percentTotal } } }"

# 完整系统仪表盘
./scripts/dashboard.sh

3. 常用场景

# 磁盘健康与温度
./examples/disk-health.sh

# 阵列状态与校验进度
./scripts/unraid-query.sh -q "{ array { state parityCheckStatus { status progress errors } } }"

# 读取最近20条系统日志
./examples/read-logs.sh syslog 20

# 列出所有Docker容器
./scripts/unraid-query.sh -q "{ docker { containers { names image state status } } }"

# 列出所有虚拟机
./scripts/unraid-query.sh -q "{ vms { name state cpus memory } }"

4. 输出格式控制

-f json    # 原始JSON（默认）
-f pretty  # 格式化JSON
-f raw     # 仅返回数据，无包装层

输入与输出

见下方输入与输出表格。

风险提示

• API密钥需妥善保管，避免泄露导致未授权访问
• 该技能仅支持只读操作，无法修改服务器配置
• Docker容器输出日志无法通过API获取，需SSH登录后执行docker logs
• 依赖Unraid 7.2+版本，旧版本可能不兼容GraphQL端点
• 网络不稳定时可能导致查询超时或连接失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jmagar/unraid/SKILL.md
来源类型：GitHub开源项目