核心用法
本技能通过 TrueNAS API 和 Dockge Socket.IO 提供完整的 NAS 管理能力，涵盖以下场景：
存储管理：检查存储池健康状态、创建/删除数据集、管理 ZFS 快照与复制任务；应用编排：部署和更新 TrueNAS 官方应用（Apps）、通过 Dockge 管理自定义 Docker Compose 堆栈；服务监控：获取系统告警、查看运行中服务、检查应用更新可用性；扩展集成：支持 Sonarr、Radarr、Plex、Overseerr 等 15+ 种常见家庭实验室服务的 API 调用。
显著优点
- 双 API 支持：同时兼容 REST API（24.x/25.x）和 WebSocket API（25.10+ 推荐，26.x 必需），保障版本兼容性
- 容器生态整合：原生支持 TrueNAS Apps 市场应用 + Dockge 自定义堆栈，覆盖官方与非官方部署场景
- 丰富的生态对接：内置媒体管理（*arr 系列）、下载工具、书签服务、游戏服务器等参考配置
- 安全传输：强制 HTTPS，API 密钥认证，支持自签名证书（
-k参数）
潜在局限与风险
| 局限项 | 说明 |
|--------|------|
| 版本碎片化 | REST API 将于 26.04 彻底移除，需关注升级路径 |
| 破坏性操作 | 数据集删除、快照回滚等操作不可逆，需用户二次确认 |
| 网络依赖 | 需稳定内网连接至 TrueNAS 实例，VPN/复杂拓扑可能增加延迟 |
| 权限配置 | 应用存储需正确设置 ACL，否则易出现权限拒绝 |
| 依赖管理 | Dockge 功能需 Node.js 18+ 及 npm 依赖安装 |
适合人群
家庭实验室（Homelab）爱好者、NAS 管理员、需要自动化媒体库与备份策略的技术用户。特别适合已部署 TrueNAS SCALE 并希望用自然语言替代命令行/SSH 管理的场景。
常规风险提示
- API 密钥泄露：
TRUENAS_API_KEY及各类服务密钥需妥善保管，避免提交至版本控制 - 证书警告：生产环境建议配置受信 SSL 证书，而非长期依赖
-k跳过验证 - 快照空间膨胀：自动快照策略需配合保留规则，防止存储池耗尽
- Dockge 更新冲突：
ix-前缀堆栈为 TrueNAS 管理，手动更新可能导致状态不一致