DSH Plugins
返回列表
dsh-truenas

dsh-truenas

联网工具 更新于 2026.11.11

在终端中运行以下命令:

dsh plugin install Taoidle/dsh-truenas

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 会话中执行 dsh plugin install Taoidle/dsh-truenas 即可从 https://github.com/Taoidle/dsh-truenas 安装该插件。

插件介绍

TrueNAS 在较新版本里逐步弃用并移除了 REST API,若仍想让智能体在对话中直接操作存储、快照、应用与系统服务,就需要一套面向当前 WebSocket 接口的桥接层。dsh-truenas 是 DeepSeek Harness 上的联网工具插件:用版本化的 JSON-RPC 2.0 WebSocket(/api/current)连接一台或多台 NAS,不依赖额外服务,也不把运维能力拆成一堆 REST 封装。

配置侧强调「先验后存」:在设置页为每个实例填写地址、用户、API 密钥与 TLS 选项,密钥会在写入 Harness 凭据库之前向 NAS 试连;API 密钥不进配置文件,而是按实例名映射到凭据名。连接必须是 TLS——插件会拒绝 http/ws,避免密钥在明文链路上被 TrueNAS 当场作废。多台 NAS 可并存,省略 instance 时默认使用列表首项。

对智能体而言,插件提供从实例管理、存储池与数据集、ZFS 快照、SMB/NFS 共享、TrueNAS Apps/Docker、作业与复制/云同步,到告警、证书、磁盘 SMART、虚拟机、iSCSI/NVMe-oF 等一整套策展工具;遗漏的 JSON-RPC 仍可通过 truenas_call 调用,破坏性操作统一要求 confirm。若还安装了 Better Sidebar,可获得不经过浏览器的同源侧栏概览:指标、池健康、一键快照、服务与应用控制、任务进度等,并以 SSE 或轮询刷新。

适合已经在用 DSH、并希望把 homelab 或机房里的 TrueNAS 纳入 agent 工具链的运维者与进阶用户;也适合需要在 25.04 之后长期依赖 WebSocket API、又不想为每个场景手写 RPC 脚本的人。

截图预览

使用场景

  • 在对话里查看存储池健康、创建快照或回滚数据集,而无需打开 TrueNAS Web UI。
  • 同时维护多台 NAS 的共享、应用、复制与云同步任务,并用 confirm 约束破坏性操作。
  • 在 DSH 侧栏快速浏览 CPU/内存/磁盘温度,启停 SMB 等服务并跟进运行中的作业。

适合人员

  • 已在用 DeepSeek Harness、并把 TrueNAS 当作核心存储的 homelab 用户。
  • 需要在弃用 REST 后仍能通过 WebSocket 做自动化运维的 NAS 管理员。
  • 希望把 ZFS、Apps、告警与备份任务纳入 agent 工具链的进阶用户。