什么是Unraid
Unraid API Skill 是一个专为 Unraid 服务器设计的 GraphQL API 工具，旨在通过标准化的接口实现对 Unraid 系统的全面查询与监控。与传统的 RESTful API 不同，Unraid 7.2 及以上版本采用 GraphQL 架构，提供单一端点 `/graphql` 支持所有数据请求。该工具封装了 27 个只读接口，覆盖系统状态、磁盘健康、阵列信息、容器管理、虚拟机运行状况以及日志获取等关键运维场景。用户可通过命令行脚本或自定义查询快速提取所需信息，无需深入理解底层实现细节。其设计强调轻量化和灵活性，适合集成到自动化监控平台或家庭服务器管理系统中。通过使用环境变量配置服务器凭证和 API 密钥，开发者可以安全高效地与远程 Unraid 实例交互，构建统一的多服务器仪表盘或告警机制。
核心功能特点
- 基于 GraphQL 的单端点 API 架构，支持精准字段级数据查询
- 提供 27 个只读接口，涵盖系统监控、磁盘温度、阵列状态、容器与虚拟机管理
- 内置多格式输出支持（JSON/格式化/原始数据），便于脚本集成
- 支持多服务器并发查询，适用于集中化运维管理
- 提供完整的参考文档与示例脚本，降低上手门槛
适用场景
Unraid API Skill 特别适合需要远程监控和维护 Unraid 服务器的技术用户，尤其是那些使用 Unraid 作为家庭媒体中心、私有云存储或开发测试环境的个人或小型团队。在日常运维中，用户可以通过该工具定期检查 CPU 使用率、内存占用和磁盘温度，及时发现潜在硬件故障或性能瓶颈。例如，结合 cron 定时任务调用 `disk-health.sh` 脚本，可实现对硬盘健康状况的持续跟踪，并在温度异常时触发通知。对于部署了 Docker 容器或虚拟机的场景，API 提供了容器列表、运行状态及 VM 资源配置信息，方便进行资源审计或服务重启操作。此外，在构建统一监控面板时，`dashboard.sh` 脚本能够聚合多个 Unraid 服务器的核心指标，生成结构化报告，极大提升运维效率。无论是自动化备份验证、阵列奇偶校验进度追踪，还是网络共享目录的状态检查，该工具都能以简洁的方式满足复杂需求。