unraid

Unraid API Skill 是一款专为 Unraid NAS 系统设计的监控工具，通过 GraphQL 接口提供对服务器的全方位只读访问能力。该技能包含 27 个 API 端点，覆盖系统状态、硬件监控、存储管理、虚拟化环境等核心运维场景，适合家庭服务器管理员和小型企业运维人员使用。

核心用法方面，用户通过配置 UNRAID_URL 和 UNRAID_API_KEY 环境变量即可建立连接，利用提供的 Bash 辅助脚本执行 GraphQL 查询。工具支持多种输出格式（JSON、格式化、原始数据），并内置了磁盘健康检查、系统日志读取、阵列状态监控等现成示例脚本。对于多服务器环境，dashboard.sh 脚本可实现批量状态汇总，大幅提升多节点管理效率。

显著优点体现在其纯粹的只读设计上，从根本上杜绝了误操作导致系统损坏的风险。相比传统 SSH 监控方式，GraphQL 接口允许精确请求所需字段，减少带宽占用并提升查询效率。技能提供了完整的字段内省支持，用户可动态发现可用数据点。同时，环境变量管理凭证的方式避免了敏感信息硬编码，符合安全最佳实践。无需在服务器端安装代理，仅需 API 密钥即可工作，部署极为轻量。

潜在局限包括来源等级为 T3 社区项目，非 Unraid 官方维护，长期支持存在不确定性。功能上仅限于 Unraid 7.2 及以上版本，且无法获取 Docker 容器输出日志（需通过 SSH 使用 docker logs 命令）。此外，工具依赖系统预装的 curl 和 jq 命令，在精简环境中可能需要手动安装依赖。对于需要修改系统配置的写操作（如启停容器、修改阵列状态）则无能为力。

适用人群主要包括 Unraid NAS 用户、家庭实验室（Homelab）爱好者、以及需要监控私有云基础设施的运维人员。对于需要定期检查磁盘健康、监控阵列校验状态、或集中管理多台 Unraid 服务器的场景尤为适用。也适合作为自动化监控体系的数据采集端，与 Prometheus、Grafana 等工具配合使用。

使用风险方面，脚本默认使用 curl 的 -k 参数接受自签名证书，在内网环境虽便利但存在潜在中间人攻击风险，建议在生产环境中配置可信证书。频繁的 API 轮询（低于 5 秒间隔）可能对服务器造成不必要的负载。此外，作为社区项目，建议在使用前审查代码并在隔离环境中测试，确认符合自身安全策略后再部署到生产环境。