不只DGX Spark:如何将Linux工作站、Windows PC与Mac主机一键接入sparkDash监控

原创2026-11-01 12:30:291,725 阅读

不只DGX Spark:如何将Linux工作站、Windows PC与Mac主机一键接入sparkDash监控

sparkDash ⚡ 是一个多设备实时监控面板(Dashboard),默认面向 NVIDIA DGX Spark 集群设计,但同样支持把任意 Linux GPU 工作站、Windows PC 和 Mac 主机作为一台“设备(unit)”通过 SSH 接入,统一查看 GPU、CPU、内存、网络、存储和 LLM 指标。本文面向新手,带你用最少的步骤,把这三类机器一键纳入同一个浏览器窗口里监控。

支持的设备类型一览

sparkDash 的核心理念是「一个 Spark 模型,N 个实例」:每台设备都是配置文件里的一条记录,新增设备只是改配置,不改代码。在 Add Spark 向导里,设备类型(Unit type)直接决定采集方式:

你的设备 选择的 Unit type 采集方式 面板特点
NVIDIA DGX Spark NVIDIA DGX Spark 本地 / SSH + nvidia-smi 统一内存(VRAM)视图
带独立 NVIDIA 显卡的 Linux 工作站 Dedicated GPU host (Linux, nvidia-smi) SSH + nvidia-smi 分离 RAM 与 VRAM 两个面板
Windows PC(NVIDIA 显卡 / AMD Strix Halo) Windows PC (NVIDIA GPU or AMD Strix Halo) 内置 OpenSSH + PowerShell 从系统性能计数器读取 GPU 占用
Mac 主机 设为 GPU host 并指定 platform: "darwin" SSH + macmon CPU / GPU / RAM / 温度

提示:面板本身可以跑在任意一台 Linux 上(x86 迷你主机、NAS、虚拟机都行),然后把所有 Spark、工作站、Windows、Mac 作为远程设备通过 SSH 接入,面板主机本身甚至不需要 GPU。

sparkDash监控面板总览:Linux工作站、Windows PC与Mac主机的GPU指标统一展示

部署 sparkDash 监控面板(Docker 一键启动)

先用 Docker 把面板拉起来(默认只监听本机回环地址,安全省心):

git clone https://gitcode.com/gh_mirrors/spa/sparkDash
cd sparkDash
docker compose up --build -d

启动后在面板主机上打开 http://127.0.0.1:5555 即可访问。想在自己电脑上查看,用一条 SSH 隧道转发端口:

ssh -N -L 5555:127.0.0.1:5555 user@sparkdash-host

更多远程访问与认证方案可参考 docs/REMOTE-ACCESS.md。

接入通用流程:Add Spark 向导

三类设备的接入步骤几乎一致,差异只在设备类型与采集前提。入口都在侧边栏 Sparks 旁的 + 按钮(手机端为 Add Spark / GPU host):

  1. 选择 Unit type:从下拉里挑选上面表格中对应的设备类型。
  2. 填写 Name 与连接信息:本机可勾选 “This host(local collectors, no SSH)”,远程设备填 LAN IP / 主机名、SSH 用户、端口(默认 22)以及认证方式(Key 或 Password)。
  3. 点击 Test:向导会对主机采集器 / SSH 和每个启用的服务(LLM、ComfyUI、Hermes、Tailnet)做通过 / 失败 / 跳过校验,全部通过后再保存。
  4. 保存:新标签页立刻出现,指标开始实时推送,无需重启。

向导源码可参考 src/components/AddSparkDialog.tsx,设备类型的判断逻辑在 src/shared/deviceKind.ts。

接入 Linux GPU 工作站(Dedicated GPU host)

带独立 NVIDIA 显卡的 Linux 机器是「一等公民」,监控方式与 Spark 完全相同(SSH + nvidia-smi),但不会把它误报成 DGX Spark:

  • 页头显示检测到的硬件摘要(GPU 型号、CPU、内存);
  • 页面把 VRAM(来自 nvidia-smi)和系统 RAM(来自 /proc/meminfo)分成两个面板;
  • 多卡主机无需额外配置:nvidia-smi 列出的每张卡都会采集,GPU 面板按卡分块展示。

只需在向导里选 Dedicated GPU host,填好 LAN IP 与 SSH 凭据即可。SSH 采集器的 Linux / macOS / Windows 分支都封装在 server/collectors/SystemCollector.js。

接入 Windows PC(OpenSSH Server + NVIDIA 驱动)

Windows 机器无需安装任何 agent,靠系统自带的 OpenSSH Server 就能被监控:

  1. 在 PC 上安装 OpenSSH Server(设置 → 应用 → 可选功能),然后以管理员 PowerShell 启动并设为自动:

    Start-Service sshd
    Set-Service sshd -StartupType Automatic
    
  2. 确认已装 NVIDIA 驱动(终端里能跑 nvidia-smi)。

  3. 回到 sparkDash,选 Add Spark / GPU host,Unit type 选 Windows PC with an NVIDIA GPU,填 PC 的 LAN IP 和 Windows 用户(支持密码登录)。

sparkDash 每轮轮询通过 SSH 下发两段短 PowerShell 脚本:一段从 nvidia-smi 读 GPU 温度、占用、功耗、VRAM 和进程;另一段从 Windows CIM 类读内存、CPU 负载、磁盘和网络。

两个常见坑:

  • 管理员账户的密钥登录:Windows 管理员组读取的是 C:\ProgramData\ssh\administrators_authorized_keys(而非 ~\.ssh\authorized_keys),且要求只有 Administrators 和 SYSTEM 可写。
  • AMD Strix Halo(iGPU):没装 nvidia-smi 时,会自动回退到 Windows 的 GPU Engine / Adapter Memory 性能计数器,占用读取效果类似任务管理器;AMD 不向 Windows 暴露温度与功耗,这两项会读 0。

接入 Mac 主机(macmon 采集)

Mac 通过 SSH 接入,指标来自轻量工具 macmon(无需 sudo),一次采样即可拿到 Apple Silicon 的 CPU / GPU 占用、温度、内存与系统功耗,因此一台 Mac 每个周期只产生一次 SSH 调用。

接入要点:

  • 在 Mac 上安装 macmon,并确保它位于 /opt/homebrew/bin、/usr/local/bin、~/.cargo/bin 或 SSH PATH 内;如果位置特殊,可在面板服务器端用环境变量 MACMON_PATH 指定路径。
  • 在 Add 向导里把该设备设为 GPU host,并在配置中把 platform 指定为 darwin(向导会保留已设置的 macOS 平台)。

采集实现与 Mac 分支逻辑在 server/collectors/SystemCollector.js 中;macmon 的候选路径与采样见 MACMON_PATH 相关说明。

接入后的进阶能力

设备接入后,除了实时曲线,还能直接使用面板内置的能力,例如对任意支持 LLM 的端口发起解码基准测试(Decode benchmark),选择并发等级与最大 token 数后一键运行,直观对比不同设备 / 不同模型的生成速度:

sparkDash监控面板的解码基准测试对话框:可设置并发数与最大token数

远程访问与安全小贴士

  • SSH 密钥(Docker 部署):SSH 在容器内执行,OpenSSH 只找容器里的 /root/.ssh。在 docker-compose.yml 中挂载一把私钥(如 - ${HOME}/.ssh/id_ed25519:/root/.ssh/id_ed25519:ro),文件权限保持 600。
  • 面板主机自身:用 “This host(local collectors — no SSH)” 添加,跳过 SSH。
  • 共享访问:保持回环绑定,通过 SSH 隧道、带认证的 TLS 反向代理或 Tailscale Serve 暴露;不要裸绑定 0.0.0.0。若必须远程绑定,请设置 SPARKDASH_TOKEN。
  • 密钥优先于密码:SSH 密码会用 AES-256-GCM 加密存储,但密钥更安全,推荐优先使用。

小结

sparkDash 不只服务于 DGX Spark——通过统一的 Add Spark 向导 + SSH 采集,你可以把 Linux GPU 工作站、Windows PC、Mac 主机一键纳入同一个监控窗口:Linux 用 nvidia-smi 分列 RAM/VRAM,Windows 靠 OpenSSH + PowerShell 读性能计数器,Mac 靠 macmon 一次采样拿到全套指标。部署一条 Docker 命令、接入几步向导,就能获得覆盖多操作系统的实时 GPU 监控面板。

更多能力(LLM 引擎探测、ComfyUI / Hermes 监控、告警通知、Prometheus 导出等)详见 README.md。

登录后查看全文
sparkDash