DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-node-monitor

q

dsh-node-monitor

Manifest valid

Multi-node DSH monitor and control hub: per-node status and read-only sessions, zero-config LAN networking via UDP discovery, one-click/embedded access to a real DSH UI, cross-network remote hub via o

UI (client)hasBundlePatch

dsh-node-monitor

English | 简体中文

多 DSH 节点监控与管控插件:把本机、局域网、跨公网的多台 DSH 收进同一个左侧栏面板,查看状态、会话概览,按需远程打开、配对和运维。

  • 左侧栏固定入口 节点监控(order 20),主面板同 id
  • 支持 Windows / macOS / Linux 的 DSH Web 与桌面端(浏览器内渲染,响应式)
  • 同一局域网内装完即用:自动发现、自动互加,无需 --host、无需手工配置
  • 没有公网 IP 也能连:接入码 + Tailscale / ZeroTier / IPv6 直连
  • 有一台公网可访问的 DSH 时,可把它当远程主节点(Hub),其余机器出站反连
  • 运维控制默认关闭;只读令牌、dry-run、二次确认、审计日志、限流

仓库:https://github.com/qingshuiliuyun/dsh-node-monitor
当前版本:v0.7.3(2026-11-15)
测试:npm test → 51/51(30 单测 + 20 集成)
安装包:dsh-node-monitor-dist/dsh-node-monitor-0.7.3.zip / .tgz 或 GitHub tag v0.7.3


功能总览

能力说明起始版本
状态总览节点卡片:在线状态、延迟、CPU/内存/磁盘、会话数、最近活动、告警v0.1
节点详情主机信息、运行时长、负载、协议、令牌状态、最近事件v0.1
只读会话概览仅展示会话 ID/状态/模型/工作目录/最近活动时间,不读取对话内容v0.3
任务与告警阈值告警、离线告警、告警确认、事件流v0.1
基础管理添加/编辑/删除节点、测试连接、启停探测、批量探测/启停v0.1 / v0.3.1
左侧栏入口固定图标 + 状态色(绿/黄/红/灰),点击进入主面板v0.1
一键打开真实 DSH用一次性票据 302 到目标节点登录页;同源时可内嵌v0.2 / v0.3
运维控制插件列表/启停、重启(可选);默认关闭,dry-run + confirm + 审计v0.3
局域网自动发现UDP 45871 广播公开身份,不广播令牌;令牌确认后接入v0.4
双向配对A 添加 B 后,B 自动登记 A,两侧都出现对方v0.4.1
零配置自动组网插件自监听 45873,发现后自动互加(只交换只读令牌)v0.5
远程主节点 Hub公网/常开 DSH 作 Hub,PC 每 3s 出站上报,跨 NAT 无需入站端口v0.6
加入链接 / 二维码Hub 一键分享加入信息,链接令牌只放 URL # 片段v0.6.1
无服务器接入码http://<LAN/Tailscale/IPv6>:45873 + 令牌,一条链接完成添加v0.6.2
安全加固只读令牌、Hub 命令过期、peer 上限、请求超时、审计轮转v0.6.3

术语与命名

同一个东西在界面上只用同一个名字。第一次用先看这张表:

名称是什么用在哪里在哪里拿/填
连接令牌插件之间互相访问的密码(宿主字段 agentToken)连接设备、状态/控制、配对对方「设置 → 连接 → 连接令牌」
加入令牌把本机接入主节点的密码(宿主字段 hubToken)「连接设备 → 主节点网络」主节点「连接设备 → 主节点网络」A 卡
连接码节点 ID + 连接令牌,一条码完成查找和添加「连接设备 → 手动直连」、设置里的本机连接码「设置 → 连接 → 连接码」
DSH 登录链接对方 DSH 网页的登录地址(启动 URL 的 ?token=…)打开/内嵌对方完整界面对方启动 DSH 时打印的 URL
接入码本机地址 + 连接令牌组成的一条链接/二维码让对方直接添加本机「设置 → 连接 → 接入码」

命名规则:

  • 「连接令牌」只用于插件与插件之间;「加入令牌」只用于PC → 主节点;
  • 「连接码」是给人抄的一条码,不是新的令牌类型;
  • 「DSH 登录链接」只用于打开对方网页界面,不参与节点连接;
  • 界面永远只显示掩码,完整值只在宿主侧 ~/.dsh/node-monitor/secrets.json(0600)。

架构速览

┌────────────────────────── 浏览器(任意设备) ──────────────────────────┐
│  左侧栏「节点监控」→ main 面板                                          │
│    │ Connection RPC(DSH Cookie 认证,/node-monitor-rpc)               │
└────┼───────────────────────────────────────────────────────────────────┘
     ▼
┌────────────────────────── 宿主插件(Node 侧) ─────────────────────────┐
│  NodeMonitorHost                                                       │
│   ├─ 节点注册表 / 告警 / 事件 / 审计(~/.dsh/node-monitor)              │
│   ├─ 探测调度(HTTP,4s 超时,失败 2 次离线)                            │
│   ├─ agent HTTP 服务(45873,双栈)                                     │
│   ├─ UDP 发现(45871)+ 自动配对                                        │
│   └─ Hub 客户端(可选,3s 出站 POST)                                   │
└────┬───────────────────────────────┬───────────────────────────────────┘
     │ Bearer HTTP(agentPort)       │ Hub push/result
     ▼                               ▼
 其他 DSH 节点                   远程主节点(公网 DSH)

四种典型拓扑:

  1. 单机 / 同局域网:插件自监听 45873,UDP 发现后自动互加,零配置。
  2. 跨网络 + 一台公网 DSH:公网 DSH 作 Hub,PC 出站 hub/push,无需端口映射。
  3. 无公网服务器:Tailscale / ZeroTier / IPv6 直连,用「接入码」一条链接添加节点。
  4. 反代/域名部署:配置 publicUrl,面板生成正确的加入链接与二维码。

安装

方式 A:在 DSH 面板里安装(推荐)

DSH →「插件」→「添加插件」→ 粘贴以下任一地址 → 安装 → 重启 DSH:

https://codeload.github.com/qingshuiliuyun/dsh-node-monitor/tar.gz/refs/tags/v0.7.3

也支持直接填 GitHub 仓库地址 https://github.com/qingshuiliuyun/dsh-node-monitor(会拉默认分支)。

方式 B:本地目录(离线包)

解压 dsh-node-monitor-0.7.0.zip,在「添加插件」里填解压后的目录绝对路径,或在 profile 里用:

dsh plugin add /绝对路径/dsh-node-monitor

方式 C:手工挂载(不推荐)

在 profile 的 package.json 里加 "dsh-node-monitor": "link:/绝对路径/dsh-node-monitor",并把 dsh-node-monitor 加入 dsh.profile.bundles;不要改 cordis.patch.yml(bundle 自带的 patch 会在加载时合成)。

升级与回滚

  • 升级:重复「添加插件」并填新 tag 的 tarball 地址 → 重启 DSH。
  • 回滚:填旧 tag 地址重装 → 重启。
  • 升级 v0.6.3+ 后建议在面板里重新生成连接令牌,让旧版自动配对留下的完整令牌立即失效。

四种组网方式

1. 同一局域网:装完即用

两台机器都装插件并重启 DSH:

  1. Windows 首次运行会弹防火墙,允许专用/公用网络(TCP 45873、UDP 45871)。
  2. 打开任意一台的「节点监控」→ 几秒后「局域网发现」出现对方。
  3. 点「接入」,粘贴对方「本机配对信息」里的 12 位令牌 → 保存。
  4. 也可以什么都不做:v0.6 起会自动互加,双方都出现对方(只读状态)。

企业 WiFi 开了 AP 隔离、或跨 VLAN 时,广播到不了,用下面的方式手工加。

2. 跨公网:一台 DSH 当远程主节点(Hub)

适合有一台常开的旧电脑、NAS、云服务器。

Hub 侧:装插件并重启,打开「节点监控」→「远程主节点」,记下:

  • 加入地址:例如 http://192.168.1.10:45873、http://100.x.x.x:45873 或 https://dsh.example.com
  • 加入令牌:12 位,可显示/复制/重新生成

PC 侧:打开「节点监控」→「远程主节点」,地址填 Hub 的加入地址、令牌填 Hub 的加入令牌 → 连接。之后 Hub 面板会持续显示这些 PC(标签「远程」),状态/会话/插件启停可用。

优先填 45873 的 agent 地址:它是插件自己的服务,绕过 DSH 登录与 Host 校验。
跨网络时建议 Hub 与 PC 都在 Tailscale 里,或给 Hub 套 cloudflared 隧道。

3. 没有服务器:接入码 + 虚拟局域网 / IPv6

  1. 两台都装 v0.7.3 并重启。
  2. A:「本机配对信息」→「接入码」→ 选一个本机地址(局域网 IP / Tailscale 100.x / IPv6)。
  3. 复制接入链接(或让对方扫二维码)。
  4. B:「连接设备 → 手动直连」→「手动填写地址与连接令牌」→ 把链接粘贴到节点地址输入框 → 地址和令牌自动填好 → 保存。

底层网络任选:Tailscale(免费额度够家庭,不支持广播 → 用接入码)、ZeroTier(二层,可能直接广播发现)、公网 IPv6(curl -6 ifconfig.co 确认)、cloudflared 隧道。

4. 域名 / 反向代理

如果面板通过域名访问(HTTPS 反代),配置:

- id: node-monitor
  name: 'dsh-node-monitor'
  config:
    publicUrl: 'https://dsh.example.com'   # 或环境变量 DSH_NODE_MONITOR_PUBLIC_URL

否则生成的加入链接/二维码会指向 127.0.0.1。反代只需把 / 转发到 DSH 端口;45873 是可选直连端口。

插件内升级(v0.7.1)

「本机配对信息 → 插件版本」提供 检查更新 与 一键升级:

  • 检查:读 GitHub tags,与当前版本比较;有新版显示「升级到 vX」。
  • 升级:两步确认后调用宿主插件管理器安装新版本 tarball;完成后提示重启 DSH。
  • 本地 link: 安装(开发模式)会拒绝自升级,避免覆盖开发目录;关闭开关:selfUpgrade: false 或 DSH_NODE_MONITOR_SELF_UPGRADE=0。
  • 离线环境检查会失败并给出 GitHub Releases 链接,可手动下载。

连接拓扑(v0.13.0)

第一个标签「节点监控」顶部新增连接拓扑:中间是主节点(或本机),周围是它连接的所有 DSH;点任意节点直接进入该节点详情。

  • 中心:连了远程主节点时是「云服务器 · Hub」,否则是本机;中心下方标注「主节点 / 本机」。
  • 叶子:主节点下的其他电脑(实线)、本机同一局域网直连的电脑(虚线),线型即连接方式。
  • 状态点:绿=在线、黄=不稳定、红=离线、灰=未知,与节点卡片一致;鼠标悬停显示名称/延迟。
  • 规模:按节点数自动调整高度,最多展示 64 个节点;节点多时自动缩排,标签重名会补端口或短 ID。
  • 移动端:拓扑可横向滑动,打开时自动把主节点居中;标题和说明自动堆叠。
  • 与卡片的关系:拓扑只做“看关系”,卡片仍是操作入口;两者使用同一份状态,3 秒同步。

连接拓扑

统一主节点:全网互联(v0.8.0)

统一入口与标签页(v0.10.0)

  • 侧栏只有一个入口 「DSH 节点」:顶部标题栏集中了刷新/添加/设置、汇总指标(节点/在线/异常/离线/告警)、搜索和状态筛选;下方是标签页。
  • 第一个标签 「节点监控」 只显示告警与节点卡片,列表区域不再放全局动态;点卡片进入详情后才显示该节点自己的「最近活动」。
  • 第二个标签起是其它 DSH 节点的界面(本机除外):在卡片上点「打开」新增标签,直接在应用内显示该节点的 DSH 界面,可随时切回监控。
  • 标签可移除(×),也可以「新标签打开」到浏览器;同一 Wi-Fi 下节点仍会自动出现。
  • 升级检查在打开设置时自动进行,发现新版后按钮直接显示「升级到 vX」,一次点击即可(升级后需重启 DSH)。

连接码(v0.11.0)

  • 每台节点在「设置 → 连接」里显示自己的连接码:8位节点ID-连接令牌,例如 684EA926-CR75-MHN9-252D。
  • 另一台在「连接设备 → 手动直连」粘贴连接码,点「用连接码连接」即可:插件会在局域网内按节点 ID 查找对端地址、自动填入令牌并添加。
  • 连接码等同于密码,只发自己的设备;不在同一网络时对方不在同一广播域,请改用「连接设备 → 主节点网络」或接入链接。
  • 连接码中的令牌与「连接令牌」相同,重新生成令牌后旧连接码立即失效。
  • 主节点网络下:如果两台电脑都连了同一个主节点,输入连接码时本机找不到会再向主节点查询;命中后对方会以「已连接 / 经主节点」出现在列表里,状态与插件操作经主节点转发(对方的局域网地址无需暴露,令牌不参与跨网鉴权)。

局域网桥接与远程界面(v0.9.0)

  • 一次连接,带动同网络:同一局域网里,只要有一台电脑连上了主节点(Hub),其他电脑即使没有 Hub 令牌,也会通过这台电脑获得全网视图(面板出现「经主节点」「主节点」节点),插件列表/启停操作经这台电脑转发到 Hub 再转发到目标节点。
  • 桥接令牌:配对时由连上 Hub 的电脑下发,随 secrets 保存(0600),只用于桥接上报与控制转发;关闭桥接用 DSH_NODE_MONITOR_BRIDGE=0。
  • 远程界面入口:在「DSH 节点」面板顶部标签页里打开远端 DSH 页面(第一个标签是监控,其余是已配置登录链接的节点);同站(同域名/同 host,例如同域反代)可直接内嵌,跨站浏览器会拦 Cookie,需要在新标签打开或配置子域名反代。
  • 登录材料若是对方机器上的 127.0.0.1 链接,打开时会自动把主机名换成节点地址;仍提示拒绝连接时,请在对方机器复制局域网地址的带 token 链接重新保存。

DSH 侧栏的「工作区」区域由宿主 UI 独占,插件不能往里插入条目,因此做成并列的一级入口。

当所有电脑都连到同一个主节点后,每台电脑的面板会自动出现两类卡片:

  • 主节点(主节点 标签):提供网络中继的那台机器;
  • 经主节点(经主节点 标签):其他所有在线电脑,显示它们上报的 CPU/内存/磁盘/会话数。

所以「大家连同一个远程」之后,每台电脑都能看到全部节点,不需要两两配对。操作(加载插件列表、启用/停用插件)会经主节点转发到目标电脑执行,结果回传到你的面板。数据每 3 秒同步一次;主节点断线时这些卡片会保留并显示最近一次数据。

限制:经主节点转发的卡片是状态与插件管理,不是完整 DSH 界面(打开对方 DSH 仍需登录材料,见上文);中继操作仅限 plugins.list / plugins.setEnabled。

全自动与本机节点(v0.7.2)

  • 本机节点自动出现:插件启动后自动创建/修复「本机自检节点」;DSH 端口变化时自动更新地址;误删后下个采集周期自动恢复,也可在「设置 → 连接 → 添加/修复本机节点」手动触发。
  • 同一局域网全自动:装好插件即可。插件通过 UDP 广播发现彼此,自动交换只读令牌并双向接入(标签「自动」「双向」),不需要填地址、端口或令牌。
  • 远程电脑只需一次粘贴:在「设置 → 连接 → 接入码」生成一条链接/二维码,对方粘贴即可;或用「连接设备 → 主节点网络」接入一台常开设备。
  • 手动添加已简化:表单默认只显示 名称(可留空)、地址、令牌;适配器、健康路径、网络、备注、标签收进「高级选项」,一般保持默认。
  • 发现不到怎么办:确认两台在同一网段;Windows 防火墙允许 UDP 45871(发现)与 TCP 45873(探测/配对);路由器未开启 AP/访客隔离。仍不行可手动添加 http://对方IP:45873 + 对方「连接令牌」。

连接细节(v0.7.3)

  • 令牌可见:所有令牌输入框右侧有「显示/隐藏」,连接令牌的 - 可带可不带、大小写与空格都不敏感。
  • 在哪里连接:总览右上「+ 连接设备」;空列表中央也有按钮;「设置 → 连接」里是「添加/修复本机节点」和「接入码」。
  • 怎么填:添加弹窗默认展开「怎么填?看这里(含示例)」,地址示例 http://192.168.1.23:45873,令牌在对方「设置 → 连接 → 连接令牌」。
  • 「主节点网络」是什么:不在同一 Wi-Fi 时用。选一台常开/公网 DSH 当主节点(Hub),或给对方粘贴接入码;同一网络则用第一个标签自动接入,不需要令牌。
  • 为什么不能直接看到对方 DSH:连接设备只建立监控/管理通道;打开对方完整界面还需要它的 DSH 登录地址(带 ?token= 的启动链接)。节点详情新增「远程 DSH 界面」说明:未配置时按钮为「填写登录材料」,配置后才是「打开」。
  • 打开被拦截时:会弹出「打开链接」对话框,提供「打开新标签 / 复制链接」,不再没有任何反应。

三个标签怎么选(v0.14.0)

  • 同一网络:自动发现 + 一键「自动接入」,同 Wi-Fi 首选,不需要令牌。
  • 主节点网络:多台电脑接同一台主节点;B 卡填地址+加入令牌,连上后自动出现该主节点下的所有电脑,不用逐台添加。
  • 手动直连:已知地址(Tailscale/ZeroTier/IPv6)或粘贴连接码/接入链接时用。

原「添加节点」弹窗仍保留,作为「手动直连」里的高级表单(名称、适配器、网络、备注、标签)。

一个入口连接设备(v0.14.0)

右上角只有一个 「+ 连接设备」,点开后在同一个弹窗里按场景切换:

标签页用来做什么操作
同一网络同一 Wi-Fi 下的电脑自动发现列表,点「自动接入」一台即可;没有发现时点「重新扫描」
主节点网络多台电脑接同一台云服务器/常开 PCA 卡:本机当主节点,复制加入地址+加入令牌;B 卡:填这两项点连接,之后自动出现该主节点下所有电脑
手动直连已知地址(Tailscale/ZeroTier/IPv6/单台临时)粘贴连接码,或点「手动填写地址与连接令牌」

同一网络最简单:装好插件 → 连接设备 → 同一网络 → 自动接入,不需要令牌、不需要记 IP。

同一网络主节点网络手动直连

设置页也保留「连接设备」入口;原「跨网络 / 发现」两个标签已合并进来。

加入地址为什么是 127.0.0.1?(v0.15.0)

127.0.0.1 是 DSH 默认的监听地址,只对本机有效,跨网络肯定访问不到。A 卡现在会:

  1. 检测到内网/回环地址时显示黄色提示;
  2. 提供「跨网访问地址」输入框,填这台机器在公网/反代上的地址,例如 https://dsh.hdtime.space,点「保存地址」;
  3. 保存后「加入地址」「复制加入链接」「二维码」都会用这个地址,令牌不变。

填写要求:该地址必须能从子节点访问,且反向代理要把 /node-monitor/api/v1/* 原样转发到 DSH 的 3081(HTTPS 更好)。可以在子节点上先验证:

curl -s -o /dev/null -w '%{http_code}\n' https://你的域名/node-monitor/api/v1/health

返回 200 即可;填错或代理没转,子节点会显示连接失败。该地址保存在宿主 secrets.json 的 publicUrl(0600),也可用 DSH_NODE_MONITOR_PUBLIC_URL 环境变量预设。

加入地址/加入令牌显示「—」怎么办(v0.14.2)

A 卡出现「—」、复制/重新生成按钮变灰,通常是宿主侧没有提供主节点信息,不是页面坏了:

  1. 宿主进程是旧版:插件文件已升级,但 DSH 宿主还没重启(界面会提示“宿主版本较旧”)。重启 DSH 后再打开面板。
  2. 主节点模式被关闭:设置了 hub: false 或环境变量 DSH_NODE_MONITOR_HUB=0。要当主节点就删掉它并重启 DSH;只当子节点可以忽略 A 卡,直接用 B 卡。
  3. 修复后 A 卡会显示加入地址和加入令牌;信息缺失时按钮会禁用,不再弹“复制失败/生成失败”。

术语审核(v0.14.1)

  • 全站不再出现「设置 → 跨网络 / 发现」这两个已删除的入口;面板顶部按钮统一为「+ 连接设备」。
  • 手动表单、空状态、登录引导里的“添加节点”全部改为「连接设备 → 手动直连」。
  • 「同一网络」列表会按地址识别已接入的节点,显示「已接入」而不是再给一个「自动接入」。
  • 主节点网络 A 卡的加入令牌说明改为「连接设备 → 主节点网络」A 卡,不再指向旧设置页。

主节点网络面板怎么填

「连接设备 → 主节点网络」里是两张卡,按机器角色二选一:

  • A · 本机当主节点:只在主节点机器(云服务器/常开 PC)上用。复制这里的加入地址和加入令牌,发到子节点。
  • B · 本机当子节点:在要接入的电脑上,把 A 的两项分别填进「主节点地址」「加入令牌」,点「连接」。连接后这里显示「已连接 + 地址 + 断开」。

令牌不再默认隐藏:

  • 连接令牌 / 连接码默认明文显示,旁边有「隐藏 / 复制」;需要发给别的电脑时直接复制,不用重新生成。
  • 加入令牌默认明文,可「隐藏 / 复制 / 重新生成」;重新生成会让已接入的电脑全部掉线,只在令牌泄漏时使用。
  • 术语固定:连接令牌=插件间连接;加入令牌=子节点接主节点;连接码=节点ID+连接令牌。

界面说明

  • 左侧栏:图标颜色=汇总状态(红:严重告警/有节点离线;黄:有告警/异常;绿:全部在线;灰:未知)。
  • 总览:汇总 chips、告警列表(确认/全部确认/打开节点)、节点卡片(CPU/内存/磁盘、会话、延迟)、筛选(关键字/状态/分组)、批量栏(探测/启用/停用)、事件流。
  • 节点详情:状态、探测/编辑/删除、指标、主机信息、会话概览(只读)、运维控制(默认关闭)、告警、节点事件、协议与主机信息。
  • 设置抽屉:连接(令牌/本机节点/连接设备入口/版本升级/接入码)、通用(刷新/告警/文档)。
  • 本机配对信息:节点 ID、显示名(可改)、连接令牌(显示/复制/重新生成)、接入码(多地址 + 二维码)。
  • 同一网络:自动发现列表、已接入/自动接入(在「连接设备」弹窗内)。
  • 主节点网络:A 卡(本机当主节点)显示加入地址/令牌/加入链接/二维码;B 卡(本机当子节点)填主节点地址+加入令牌;令牌默认可见,可复制/隐藏。
  • 添加/编辑节点:名称可留空(自动取远端 hostname)、地址、适配器(DSH/通用 HTTP)、网络、备注、令牌、标签、启用探测;粘贴加入链接/接入码会自动解析。
  • 移动端:≤760px 单列,批量栏与筛选自动换行,内嵌视图全屏。

安全模型

插件同时使用几种令牌,权限严格区分(详见 docs/SECURITY.md):

令牌权限使用场景
agentToken(连接令牌)完整:状态、会话元数据、控制手动添加节点、接入码
statusToken(只读令牌)只读:计数/指标,无会话明细、无最近事件、不能控制局域网自动发现/自动配对
hubToken(加入令牌)只允许 Hub 上报/领命令PC 连接远程主节点
nodeTokens.*对应节点的令牌Hub 访问已添加节点
  • 运维控制默认关闭:allowControl: true / DSH_NODE_MONITOR_ALLOW_CONTROL=1 才可用;重启默认也关。
  • 控制请求默认 dry-run,真实执行需 confirm: true;每次调用写 audit.jsonl(0600)。
  • 加入链接/接入码令牌只放在 URL # 片段,不发给服务器;二维码本地生成。
  • 令牌文件 ~/.dsh/node-monitor/secrets.json 0600,目录 0700;令牌不进 state、不进日志、不返回给非 owner。
  • 自动配对只交换只读令牌;自动接入的节点是只读的,要远程运维需手动粘贴完整令牌。

配置

插件配置(profile patch 的 config,需重启 DSH):

键环境变量默认说明
homeDSH_HOME~/.dsh状态与密钥目录
label—主机名局域网显示名
discoveryDSH_NODE_MONITOR_DISCOVERY=0true是否启用 UDP 发现
discoveryPortDSH_NODE_MONITOR_DISCOVERY_PORT45871发现端口
discoveryPeersDSH_NODE_MONITOR_DISCOVERY_PEERS—单播发现目标,host:port,host:port
agentPortDSH_NODE_MONITOR_AGENT_PORT45873agent 服务端口(双栈)
publicListenDSH_NODE_MONITOR_PUBLIC_LISTEN=0true是否监听 ::/0.0.0.0
autoPairDSH_NODE_MONITOR_AUTO_PAIR=0true是否自动互加
allowControlDSH_NODE_MONITOR_ALLOW_CONTROL=1false允许远程插件启停
allowRestartDSH_NODE_MONITOR_ALLOW_RESTART=1false允许远程重启 DSH
hubDSH_NODE_MONITOR_HUB=0true是否接受远程节点上报
publicUrlDSH_NODE_MONITOR_PUBLIC_URL—对外 origin,用于链接/二维码

运行时设置(面板「设置」):refreshMs 5000、timeoutMs 4000、offlineAfterFailures 2、latencyWarnMs 1500、cpuWarnPct 85、memWarnPct 90、diskWarnFreePct 10、eventsLimit 40。

接口速查

面板 ↔ 宿主:Connection RPC 通道 /node-monitor-rpc,全部 owner-only(除只读状态),动作: state、refresh、addNode、updateNode、removeNode、ackAlert、ackAll、batchNodes、settings、testNode、setLogin、clearLogin、openTicket、control、hubJoin、nodeInvite、hubInfo、hubConnect、hubDisconnect、hubRotateToken、discoveryProbe、selfToken、rotateToken、updateLabel。

Agent HTTP(45873 / DSH 端口):

端点认证说明
GET /node-monitor/api/v1/health无存活探测
GET /node-monitor/api/v1/statusBearer agentToken / statusToken状态快照;只读令牌返回精简版
POST /node-monitor/api/v1/controlBearer agentToken运维动作(需 allowControl)
POST /node-monitor/api/v1/pairBearer agentToken 或 auto双向登记(仅局域网来源)
POST /node-monitor/api/v1/hub/pushBearer hubTokenPC 上报 + 领取命令
POST /node-monitor/api/v1/hub/resultBearer hubToken命令执行结果
GET /node-monitor/open一次性票据302 到节点登录页

UDP 发现:45871,组播 239.255.43.21,30s 一次,TTL 5 分钟,字段见 DESIGN.md §7.3。协议细节见 DESIGN。

文档

文档内容
DESIGN.md总体架构、数据模型、协议规格、安全模型、部署与测试
docs/INSTALL.md分场景安装、端口/防火墙、升级回滚、排障
docs/SECURITY.md威胁模型、令牌矩阵、数据暴露面、加固清单
docs/ARCHITECTURE-DECISIONS.md架构决策记录(ADR):取舍与备选方案
docs/CHANGELOG.md版本历史
README.en.mdEnglish README
docs/screenshots/界面截图(v0.6.x)
market/PUBLISH.md插件市场提交说明

界面截图

总览多节点
节点详情接入码
远程主节点加入二维码
全自动与本机节点简化的添加表单
统一主节点全网互联连接拓扑(主节点视角)
连接拓扑(PC 视角)移动端拓扑
填写示例与令牌显示远程界面说明

开发与测试

npm test                 # 64/64
node --test --test-force-exit test/core.test.js
node --test --test-force-exit test/host.test.js
  • 无运行时依赖;二维码使用内置 lib/qrcode.js(qrcode-generator 2.0.4,MIT)。
  • 目录:lib/core.js(纯逻辑/协议)、lib/index.js(宿主)、lib/client.js(浏览器 bundle)、lib/qrcode.js。
  • 测试:test/core.test.js(33)、test/host.test.js(24,含真实 node:http 往返与主节点中继)。

故障排查

现象排查
面板显示「未配对」编辑节点粘贴对方完整令牌;或重新用接入码添加
节点离线curl http://<对端>:45873/node-monitor/api/v1/health;Windows 防火墙放行 TCP 45873
局域网发现为空同一广播域?AP 隔离?UDP 45871 放行?企业 WiFi 改用手工添加/接入码
加入链接打开是 127.0.0.1反代部署需配置 publicUrl / DSH_NODE_MONITOR_PUBLIC_URL
打开节点 401目标 DSH 的启动令牌已轮换,重新配对登录材料
控制返回 403目标节点未开 allowControl;自动接入节点只读,需完整令牌
批量/控制 unknown-endpoint宿主仍是旧代码,重启 DSH
Hub 看不到 PCPC「远程主节点」是否已连接;Hub 的 45873 是否可达;令牌是否正确

目录结构

dsh-node-monitor/
├─ lib/            # core.js / index.js / client.js / qrcode.js
├─ locale/         # zh.json / en.json
├─ test/           # core.test.js / host.test.js
├─ docs/           # INSTALL.md / SECURITY.md / CHANGELOG.md / screenshots/
├─ market/         # 插件市场提交材料
├─ assets/         # 市场图标
├─ cordis.patch.yml
├─ package.json
├─ README.md
└─ DESIGN.md

路线图

  • 接入码有效期(默认 10 分钟,可续期)
  • Hub peer 列表持久化,重启立即恢复
  • 通知通道(Webhook/邮件/IM)与静默时段
  • 会话时间线(只读)与任务进度细分
  • 多用户/RBAC 与操作审批
  • npm 发布与市场收录后的自动更新提示

License

MIT

界面与交互(v0.7.1 重设计)

  • 顶部固定标题栏:⟳ 刷新、+ 连接设备、⚙ 设置,同栏还有汇总指标、搜索、状态筛选与标签页;所有配置类操作收进设置抽屉,主体只留告警与节点卡片(节点动态在详情页)。
  • 设置抽屉两个分区:连接(令牌状态、本机配对信息、接入码、连接设备入口、版本升级)、通用(刷新/告警参数、版本、文档与停用提示)。
  • 节点卡改为三列紧凑指标(CPU / 内存 / 磁盘可用),状态、网络、延迟、最近在线一眼可见;移动端自动单列、隐藏次要按钮、抽屉全屏。
  • 面板内「插件版本」行支持检查更新与一键升级(v0.7.1 起);link: 安装的开发目录不提供自升级,请用面板重新安装。
  • 截图:docs/screenshots/ui-overview-v2.png、ui-settings-connect.png、ui-settings-general.png、ui-mobile-v2.png、ui-mobile-settings.png、connect-lan.png、connect-hub.png。

Comments

Loading…

Similar plugins

dsh-vps

by AIcivilization

One-command DeepSeek Harness on your VPS: a zero-dependency login gateway puts the stock DSH web UI - settings, API keys, plugin market - behind HTTPS and a password, reachable from anywhere. · 一条命令把 DeepSeek Harness 装进 VPS:零依赖登录网关 + 自动 HTTPS,公网可达,设置、API Key、插件市场全都能用。

Development & InfrastructureTerminal & ClientsManifest valid

★ 12

↓ 471/wk

MIT

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-vps

by peng456

Discovers other DSH instances on the local network by UDP multicast or port scan, lists them in a sidebar panel together with the capabilities each one reports, and dispatches tasks between machines i

Tools & CapabilitiesManifest valid

★ 8

↓ 1.9k/wk

MIT

JavaScript

Nov 9, 2026

dsh plugin --profile web add dsh-plugin-mesh

by JUANWANG-BUAA

Auditable, token-gated DeepSeek Harness remote gateway: mobile QR access, per-device sessions, Host/Origin rewrite, settings/credentials/directory support.

Security & AuditManifest valid

★ 51

↓ 296/wk

MIT

TypeScript

Nov 7, 2026

dsh plugin --profile web add dsh-full-remote

by THEWOLFWALKER

Unified notification and remote-control plugin for DeepSeek Harness (DSH): one zero-dependency notify() API across 27 channels, with phone-friendly approvals/questions, six inbound control channels, a

Notifications & IntegrationsManifest valid

★ 65

↓ 572/wk

MIT

JavaScript

Oct 31, 2026

dsh plugin --profile web add dsh-notifier

by donoteatme

Browser-first, LAN-only access to the current DeepSeek Harness Web UI with one-time QR pairing, revocable devices, event-driven diagnostics, and a slot-preserving mobile layout; no companion app, clou

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 1

↓ 588/wk

MIT

TypeScript

Sep 12, 2026

dsh plugin --profile web add dsh-local-link

DSH 插件:通过 SSH 在本地 DSH 全局面板里整页使用远端 DSH(薄客户端)| DSH plugin: open a remote DSH in a full-page panel over SSH

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-remote-go