dsh-node-monitor
Manifest validMulti-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
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)
四种典型拓扑:
- 单机 / 同局域网:插件自监听 45873,UDP 发现后自动互加,零配置。
- 跨网络 + 一台公网 DSH:公网 DSH 作 Hub,PC 出站
hub/push,无需端口映射。 - 无公网服务器:Tailscale / ZeroTier / IPv6 直连,用「接入码」一条链接添加节点。
- 反代/域名部署:配置
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:
- Windows 首次运行会弹防火墙,允许专用/公用网络(TCP 45873、UDP 45871)。
- 打开任意一台的「节点监控」→ 几秒后「局域网发现」出现对方。
- 点「接入」,粘贴对方「本机配对信息」里的 12 位令牌 → 保存。
- 也可以什么都不做: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
- 两台都装 v0.7.3 并重启。
- A:「本机配对信息」→「接入码」→ 选一个本机地址(局域网 IP / Tailscale 100.x / IPv6)。
- 复制接入链接(或让对方扫二维码)。
- 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 下的电脑 | 自动发现列表,点「自动接入」一台即可;没有发现时点「重新扫描」 |
| 主节点网络 | 多台电脑接同一台云服务器/常开 PC | A 卡:本机当主节点,复制加入地址+加入令牌;B 卡:填这两项点连接,之后自动出现该主节点下所有电脑 |
| 手动直连 | 已知地址(Tailscale/ZeroTier/IPv6/单台临时) | 粘贴连接码,或点「手动填写地址与连接令牌」 |
同一网络最简单:装好插件 → 连接设备 → 同一网络 → 自动接入,不需要令牌、不需要记 IP。
| 同一网络 | 主节点网络 | 手动直连 |
|---|---|---|
![]() | ![]() | ![]() |
设置页也保留「连接设备」入口;原「跨网络 / 发现」两个标签已合并进来。
加入地址为什么是 127.0.0.1?(v0.15.0)
127.0.0.1 是 DSH 默认的监听地址,只对本机有效,跨网络肯定访问不到。A 卡现在会:
- 检测到内网/回环地址时显示黄色提示;
- 提供「跨网访问地址」输入框,填这台机器在公网/反代上的地址,例如
https://dsh.hdtime.space,点「保存地址」; - 保存后「加入地址」「复制加入链接」「二维码」都会用这个地址,令牌不变。
填写要求:该地址必须能从子节点访问,且反向代理要把 /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 卡出现「—」、复制/重新生成按钮变灰,通常是宿主侧没有提供主节点信息,不是页面坏了:
- 宿主进程是旧版:插件文件已升级,但 DSH 宿主还没重启(界面会提示“宿主版本较旧”)。重启 DSH 后再打开面板。
- 主节点模式被关闭:设置了
hub: false或环境变量DSH_NODE_MONITOR_HUB=0。要当主节点就删掉它并重启 DSH;只当子节点可以忽略 A 卡,直接用 B 卡。 - 修复后 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.json0600,目录 0700;令牌不进 state、不进日志、不返回给非 owner。 - 自动配对只交换只读令牌;自动接入的节点是只读的,要远程运维需手动粘贴完整令牌。
配置
插件配置(profile patch 的 config,需重启 DSH):
| 键 | 环境变量 | 默认 | 说明 |
|---|---|---|---|
home | DSH_HOME | ~/.dsh | 状态与密钥目录 |
label | — | 主机名 | 局域网显示名 |
discovery | DSH_NODE_MONITOR_DISCOVERY=0 | true | 是否启用 UDP 发现 |
discoveryPort | DSH_NODE_MONITOR_DISCOVERY_PORT | 45871 | 发现端口 |
discoveryPeers | DSH_NODE_MONITOR_DISCOVERY_PEERS | — | 单播发现目标,host:port,host:port |
agentPort | DSH_NODE_MONITOR_AGENT_PORT | 45873 | agent 服务端口(双栈) |
publicListen | DSH_NODE_MONITOR_PUBLIC_LISTEN=0 | true | 是否监听 ::/0.0.0.0 |
autoPair | DSH_NODE_MONITOR_AUTO_PAIR=0 | true | 是否自动互加 |
allowControl | DSH_NODE_MONITOR_ALLOW_CONTROL=1 | false | 允许远程插件启停 |
allowRestart | DSH_NODE_MONITOR_ALLOW_RESTART=1 | false | 允许远程重启 DSH |
hub | DSH_NODE_MONITOR_HUB=0 | true | 是否接受远程节点上报 |
publicUrl | DSH_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/status | Bearer agentToken / statusToken | 状态快照;只读令牌返回精简版 |
POST /node-monitor/api/v1/control | Bearer agentToken | 运维动作(需 allowControl) |
POST /node-monitor/api/v1/pair | Bearer agentToken 或 auto | 双向登记(仅局域网来源) |
POST /node-monitor/api/v1/hub/push | Bearer hubToken | PC 上报 + 领取命令 |
POST /node-monitor/api/v1/hub/result | Bearer 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.md | English 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 看不到 PC | PC「远程主节点」是否已连接;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
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、插件市场全都能用。
★ 12
↓ 471/wk
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-vpsby 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
★ 8
↓ 1.9k/wk
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-plugin-meshby JUANWANG-BUAA
Auditable, token-gated DeepSeek Harness remote gateway: mobile QR access, per-device sessions, Host/Origin rewrite, settings/credentials/directory support.
★ 51
↓ 296/wk
MIT
TypeScript
Nov 7, 2026
dsh plugin --profile web add dsh-full-remoteby 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
★ 65
↓ 572/wk
MIT
JavaScript
Oct 31, 2026
dsh plugin --profile web add dsh-notifierby 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
★ 1
↓ 588/wk
MIT
TypeScript
Sep 12, 2026
dsh plugin --profile web add dsh-local-linkDSH 插件:通过 SSH 在本地 DSH 全局面板里整页使用远端 DSH(薄客户端)| DSH plugin: open a remote DSH in a full-page panel over SSH
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-remote-go














