连接配置树与网络探测的分层实现——mRemoteNG 鸿蒙PC版的 XML 解析、TCP 连通性检测与本地凭据加密
在连接管理工具中,“保存一个远程地址”“确认端口可达”和“真正登录远程桌面”是三个不同层次的问题。本项目围绕前两个层次,使用 Electron 壳与纯 JavaScript 实现 confCons.xml 配置树、CSV 清单导入导出、TCP 连通性探测、SSH/HTTP 文本横幅识别、AES-256-GCM 本地密码封装,以及会话和偏好持久化。本文参照实际业务源码、当前鸿蒙工程配置和三张应用截图,梳理连接数据如何从文件进入界面、探测结果如何回到节点,以及凭据落盘与显示之间需要注意的边界。
这是一套独立编写的 JavaScript 壳应用,不是将上游 mRemoteNG 原生客户端及其全部协议栈移植到鸿蒙。本文执行了 JavaScript 语法检查、样例解析和少量纯函数验证,没有运行远程登录、网络扫描、Electron 界面、本机回环自检、HAP 构建或真机安装;涉及这些环节的内容均为源码说明或后续验收建议。
欢迎加入开源鸿蒙 PC 社区:https://harmonypc.csdn.net/
欢迎在 PC 社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
AtomGit 仓库地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_mRemoteNG
说明:文中代码包含源码节选;未展示完整函数、对象或条件分支的片段需要结合原始上下文阅读,不能独立运行。
一、技术架构分析
1.1 整体架构
项目由鸿蒙工程、Electron 主进程、渲染层与三个业务引擎组成:
- 鸿蒙工程:electron 是 entry 模块,依赖 web_engine HAR;业务资源位于 web_engine 的 resources/app 目录。
- 主进程:负责窗口、文件对话框、文件读写、DNS/TCP、密码加解封、剪贴板与用户数据持久化。
- 渲染层:维护连接节点、选中项、展开状态、探测记录、凭据列表与五个工作面板。
- 纯函数引擎:ConnEngine 处理配置与树结构,NetEngine 处理网络输入和结果文本,CredEngine 处理凭据校验与连接串。
主要数据链路如下:
confCons.xml / CSV
↓ files:choose → fs:readText
ConnEngine → 扁平节点列表 → 连接树 / 配置明细
↓ 用户触发探测
renderer 串行队列 → net:probe → DNS / TCP / 文本横幅
↓
按节点 ID 保存结果 → 树徽标 / 详情 / 信息坞 / 输出区
凭据表单 → 校验 → secret:seal → passwordToken → 凭据 JSON
会话快照 → session:save → 用户目录 → 下次启动恢复
网络操作与文件操作实际由主进程中的 Node 模块承担;页面本身不实现远程桌面画面、SSH 交互终端或远端命令执行。界面里的“探测终端”是日志输出区,不是远程 Shell。
1.2 技术方案
| 需求 | 当前实现 | 能力边界 |
|---|---|---|
| 连接分组 | 解析 Container / Connection,保留 parentId 与 depth | 不包含通用树节点编辑、拖拽或重命名工具 |
| 配置交换 | confCons.xml 常用字段子集与七列 CSV | 不是上游所有属性、加密文件与继承规则的完整兼容实现 |
| 网络预检 | DNS 查询、TCP 握手、有限文本横幅 | 不执行用户认证、TLS 验证或远程桌面协商 |
| 连接交接 | 生成并复制命令、URI、访问地址 | 不自动启动终端、远程桌面客户端或浏览器 |
| 凭据保存 | AES-256-GCM 封装密码,JSON 保存元数据 | 本地可逆加密,不是硬件密钥库 |
| 桌面交互 | HTML、CSS Grid、原生 DOM 与自定义浮层 | Electron 与鸿蒙壳仍是必需运行环境 |
| 分发形态 | electron entry + web_engine HAR 工程 | 当前配置存在模板标识,不能等同已满足发布条件 |
这条路线把可移植的文本处理逻辑独立出来,使配置解析和结果分类能够在 Node 中直接验证;涉及窗口、系统权限和设备网络的部分,则保留给对应运行环境验收。
1.3 核心功能清单
| 模块 | 已接入的功能 |
|---|---|
| 连接面板 | 树展开折叠、关键词过滤、节点详情、选中连接测试 |
| 批量探测 | 全部连接或当前可见筛选结果串行测试、请求停止、输出清空 |
| 快速连接 | URI 拆分、主机与端口填写、连通性测试、追加根级连接、复制报告 |
| 配置面板 | XML / CSV 导入导出、协议统计、节点明细、目录扫描 |
| 凭据面板 | 新建、编辑、删除、名称去重、密码封装、解封显示与复制 |
| 设置面板 | 目录范围管理、超时与横幅偏好、内置样例、本机回环自检入口 |
| 持久化 | 偏好、会话、凭据 JSON,以及独立的目录范围文件 |
| 辅助交互 | 文件管理器定位、Ctrl+F、Ctrl+O、Ctrl+S、F5、关于弹层 |
协议表有 13 个条目,包括 RDP、SSH2、SSH1、Telnet、Rlogin、VNC、ICA、RAW、HTTP、HTTPS、Serial、PowerShell 和 ExternalApp。快速连接下拉排除了两个 kind 为 local 的条目,因此显示 11 种选择;这些数量表示配置分类,不表示内置了同等数量的远程客户端。
二、环境准备
2.1 开发环境要求
| 项目 | 当前工程或本次核对结果 |
|---|---|
| 本次源码检查环境 | Windows,Node.js v22.20.0 |
| 业务技术栈 | HTML、CSS、Vanilla JavaScript、Node 内置模块 |
| 业务包版本 | 1.0.0,入口 main.js |
| 鸿蒙开发工具 | 使用与工程 SDK 匹配的 DevEco Studio |
| 产品配置 | default,runtimeOS 为 HarmonyOS |
| compatibleSdkVersion | 5.0.5(17),release 阶段 |
| 模块结构 | electron 为 entry,web_engine 为 har |
| 设备声明 | 2in1、tablet |
| 本地原生库目录 | electron/libs/arm64-v8a |
原生库目录中可见 libadapter.so、libc++_shared.so、libelectron.so 与 libffmpeg.so。这里只确认文件存在,不代表验证了其加载结果或 ABI 兼容性。
业务包没有锁定 Electron 版本。截图状态栏的“mRemoteNG · Electron 1.0.0”来自应用版本字段 r.version,不能把它当作 Electron 引擎版本;真正的引擎版本由 app:info 返回的 electron 字段提供。
2.2 项目结构
当前业务代码已经位于鸿蒙工程的资源目录,不需要假设另有一份 electron-apps 开发副本。
ohos_mRemoteNG_electron-main/
└── ohos_hap/
├── AppScope/
│ ├── app.json5
│ └── resources/base/element/string.json
├── electron/
│ ├── oh-package.json5
│ ├── libs/arm64-v8a/
│ └── src/main/module.json5
├── web_engine/
│ └── src/main/
│ ├── module.json5
│ └── resources/resfile/resources/app/
│ ├── package.json
│ ├── main.js
│ ├── renderer.js
│ ├── index.html
│ ├── engines/
│ │ ├── conn-engine.js
│ │ ├── cred-engine.js
│ │ └── net-engine.js
│ ├── styles/mremoteng.css
│ └── samples/
│ ├── confCons.xml
│ └── connections.csv
└── build-profile.json5
下文 main.js、renderer.js 和 engines 路径均相对于上述 app 目录。本文只新增文章并归档截图,不调整这些业务文件和工程配置。
2.3 依赖说明
业务 package.json 全文如下:
{
"name": "mremoteng",
"version": "1.0.0",
"description": "mRemoteNG 连接管理器 · 鸿蒙 PC 的 Electron 壳实现",
"main": "main.js",
"license": "GPL-2.0",
"private": true
}
没有 npm dependencies、devDependencies 或 scripts。所谓“纯 JavaScript 引擎”是指业务算法没有额外的 npm 解析库,不是应用不依赖 Electron 或原生运行时。
| 依赖 | 用途 |
|---|---|
| electron | 窗口、IPC、文件选择、剪贴板、文件管理器定位 |
| fs / path | 配置、凭据与会话文件处理,目录范围判定 |
| dns / net | 地址解析、TCP 连接与回环监听 |
| crypto | 随机密钥、随机 nonce、AES-256-GCM |
| 三个本地引擎 | 配置模型、凭据纯函数、网络结果处理 |
三个引擎既向全局对象挂载接口,也支持 CommonJS 导出,因此可以脱离 DOM 验证。注意 package.json 声明 GPL-2.0,而关于弹层声明 Apache-2.0;本文保留现状,不代替项目维护者作许可证归属判断。
三、核心适配流程
3.1 主进程实现:窗口、目录范围与 20 条 IPC
窗口入口使用固定初始尺寸加载本地页面。main.js 中的完整窗口函数如下:
function createWindow() {
mainWindow = new BrowserWindow({
width: 1320,
height: 860,
minWidth: 1024,
minHeight: 680,
title: APP_TITLE,
backgroundColor: '#1e1e2e',
autoHideMenuBar: true,
webPreferences: {
nodeIntegration: true,
contextIsolation: false,
spellcheck: false
}
});
mainWindow.loadFile(path.join(__dirname, 'index.html'));
mainWindow.on('closed', () => {
mainWindow = null;
});
}
启动时,程序先登记 userData 与应用目录,再恢复持久化目录范围、注册 IPC,最后创建窗口。它没有使用屏幕工作区百分比计算尺寸,也没有在此处禁用硬件加速。
20 条 IPC 按职责分组如下:
| 分组 | 通道 | 数量 |
|---|---|---|
| 环境信息 | app:info | 1 |
| 目录范围 | dir:choose、dir:forget | 2 |
| 文件处理 | fs:scan、fs:stat、fs:readText、fs:writeText、files:choose、file:saveText | 6 |
| 系统交互 | clip:write、shell:reveal | 2 |
| 偏好 | prefs:get、prefs:set | 2 |
| 会话 | session:save、session:load | 2 |
| 样例 | samples:list | 1 |
| 网络 | net:probe、net:selfTest | 2 |
| 密码 | secret:seal、secret:unseal | 2 |
它们通过一个包装器注册,不是出现 20 次 ipcMain.handle。main.js 的完整包装函数如下:
function handle(channel, fn) {
ipcMain.handle(channel, async (event, req) => {
try {
return await fn(req || {});
} catch (e) {
return { success: false, error: errText(e), code: e && e.code };
}
});
}
读写文本、扫描、文件状态和文件管理器定位等入口使用 guard 检查目录范围。该函数的核心判定节选如下,依赖外层 allowedRoots 与 norm:
const full = path.resolve(String(target || ''));
const probe = norm(full) + '/';
const hit = allowedRoots.some((r) => {
const base = norm(r);
return norm(full) === base || probe.indexOf(base + '/') === 0;
});
if (!hit) {
const err = new Error('该位置未授权。请先用「选择目录」添加访问范围。');
err.code = 'EGUARD';
throw err;
}
return full;
选择文件或另存文件也会登记父目录;另存为直接使用系统对话框返回的路径,不是先要求目标已经在范围内。这里的“授权”是应用自身维护的路径表,不等同鸿蒙系统权限或强隔离沙箱:norm 会统一转小写,且未使用 realpath 检查符号链接,大小写敏感文件系统和链接路径都需要进一步验证。
常用限制也应对应实际调用路径:文本读取上限为 8 MiB,文件状态最多取前 500 项,目录扫描最多返回 4000 项、深度上限为 6;配置页实际传入深度 3,且只扫描 XML、CSV。源码虽然声明 maxProbeBatch 和 MAX_BATCH 为 50,但当前串行队列未使用它们截断数量,不能写成“已实施每批 50 条限制”。
3.2 五面板布局与连接树状态
index.html 将界面分为导航、业务内容与右侧信息坞,业务面板包括连接、快速连接、凭据、配置和设置。切换只改变 active 类,不重新创建窗口。
renderer.js 中的完整切换函数如下:
function showPanel(name) {
['conn', 'quick', 'cred', 'config', 'settings'].forEach(function (k) {
var panel = $('panel-' + k);
if (panel) panel.classList.toggle('active', k === name);
var nav = $('nav' + k.charAt(0).toUpperCase() + k.slice(1));
if (nav) nav.classList.toggle('active', k === name);
});
}
连接树没有直接保存嵌套 DOM 数据,而是使用扁平的 S.nodes。每个节点携带 id、parentId 和 depth,展开状态保存在 S.expanded,最近探测结果保存在 S.results[node.id]。
引擎搜索会保留命中节点及其祖先;渲染层再根据祖先展开状态决定是否显示:
function visibleNodes() {
var list = ConnE.filterNodes(S.nodes, S.filter);
var map = nodeIndex();
return list.filter(function (n) {
var p = n.parentId ? map[n.parentId] : null;
while (p) {
if (S.expanded[p.id] === false) return false;
p = p.parentId ? map[p.parentId] : null;
}
return true;
});
}
因此,“只测筛选结果”实际上测试当前可见的连接;如果祖先已经折叠,匹配的子连接仍可能被隐藏。程序载入配置时会把 S.expanded 清空,而显示逻辑将未设置项视为展开,并未直接沿用 XML 中每个节点的 Expanded 属性。
页面中的连接详情是只读展示。当前增加连接的路径是快速连接表单,它把新条目追加为根级节点;没有通用的连接修改、删除、移动文件夹或拖拽排序操作。新增后只是改变内存,必须导出配置或保存会话才能持久化。
启动顺序是环境信息、偏好、样例清单、凭据、会话恢复;没有可恢复会话时静默载入内置 XML。静默载入不会触发自动探测,默认 autoTest 也为 false。用户主动载入或导入配置时,开启的自动探测偏好才会参与判断。
3.3 配置引擎:XML 子集、继承与 CSV 交换
confCons.xml 的核心是 Connections 根元素和 Node 层级。ConnEngine 使用轻量标签扫描器处理所需子集,跳过注释、CDATA、处理指令和声明,并提取带单引号或双引号的属性。
其中,寻找标签结束位置时不能直接取第一个大于号,因为它可能位于属性值内部。conn-engine.js 的完整实现如下:
function tagEnd(text, from) {
var quote = '';
for (var i = from; i < text.length; i++) {
var c = text.charAt(i);
if (quote) {
if (c === quote) quote = '';
} else if (c === '"' || c === "'") {
quote = c;
} else if (c === '>') {
return i;
}
}
return text.length;
}
解析器去掉标签的命名空间前缀,但不验证命名空间 URI,也不是严格 XML 校验器。结束标签采用栈回溯匹配,一些不完整结构不会产生明确错误;不能用“返回 ok”证明文件符合全部 XML 规范。
常用节点字段包括名称、类型、协议、主机、端口、用户名、域、备注、面板、图标和层级。旧版 SSH 标签归一到 SSH2;上游 Password 属性没有被提取到节点模型。
parseConfCons 中的继承段如下,前文已经建立 nodes 与 byId:
nodes.forEach(function (n) {
if (n.type !== 'connection') return;
if (!n.host) {
var p = byId[n.parentId];
while (p) {
if (p.host) { n.host = p.host; n.inheritedHost = true; break; }
p = byId[p.parentId];
}
}
if (!n.port) {
var d = defaultPort(n.proto);
if (d) { n.port = d; n.inheritedPort = true; }
}
});
这段逻辑只让空主机从祖先取值,空端口按协议默认值补齐,并不是从父节点继承端口,更不是完整实现上游所有 Inherit 属性。缺主机提示在继承前生成,继承成功后没有撤回;Protected 则以字符串是否非空转换为布尔值,字符串 false 也会被视为 true。节点 ID 唯一性和循环父链也没有完整防护,因此输入仍应来自可信配置。
导出时先根据 parentId 重建树。conn-engine.js 的完整转换函数如下:
function toTree(nodes) {
var list = (nodes || []).map(function (n) {
var copy = {};
Object.keys(n).forEach(function (k) { copy[k] = n[k]; });
copy.children = [];
return copy;
});
var map = {};
list.forEach(function (n) { map[n.id] = n; });
var roots = [];
list.forEach(function (n) {
var p = n.parentId ? map[n.parentId] : null;
if (p) p.children.push(n);
else roots.push(n);
});
return roots;
}
随后 toConfCons 生成 XML。输出头部中的 EncryptionEngine、BlockCipherMode 和 KdfIterations 是字面属性,函数并未执行整份配置加密,不能与凭据库的 AES-GCM 封装混为一谈。
CSV 输出使用七列:Name、Hostname、Port、Protocol、Username、Domain、Description。以下是完整序列化函数:
function toCsv(nodes) {
var head = ['Name', 'Hostname', 'Port', 'Protocol', 'Username', 'Domain', 'Description'];
var rows = [head.join(',')];
(nodes || []).forEach(function (n) {
rows.push([
n.type === 'container' ? n.name + '/' : n.name,
n.host || '', n.port || '', n.proto || '', n.user || '', n.domain || '', n.descr || ''
].map(csvCell).join(','));
});
return rows.join('\r\n') + '\r\n';
}
csvCell 会为逗号、双引号和换行加引号,但 parseCsv 先按物理行拆分,不能正确恢复含换行的字段。CSV 也没有父节点列,导入后全部成为根级节点。
本次验证得到两个很具体的兼容边界:单个空文件夹导出时缺少闭合 Node 标签;带换行的 CSV 备注会被拆成额外节点。尤其是内置 CSV 含有文件夹标记,导入后这些文件夹都没有子节点,再导出 XML 就会遇到空容器问题。不能仅凭正常样例的统计往返一致,宣称所有配置可无损互转。
此外,当前 readAndApply 只区分 CSV 与 XML,其他扩展名会进入 XML 解析路径;JSON 虽然出现在部分文件筛选常量中,却不是已实现的第三种连接配置导入格式。
3.4 网络探测:DNS、TCP、横幅与串行队列
主进程 probe 从请求中取 host、port、proto、timeout 与 banner。端口必须是 1~65535 的整数,超时参数钳制在 500~10000 ms,并发计数达到 4 时返回 EBUSY。渲染层另外调用 NetEngine.isValidHost 做输入检查,但该函数的 IPv6 校验仍是宽松正则,不等同严格地址解析。
probe 中 DNS 与 socket 创建的连续节选如下,依赖外层 host、port、started、done 和 sock:
dns.lookup(host, { all: true }, (err, list) => {
if (err) {
return done({
success: false, host: host, port: port, ms: Date.now() - started,
code: err.code || 'ENOTFOUND', error: NetE.errorText(err.code, host)
});
}
const address = list && list[0] ? list[0].address : host;
const family = list && list[0] ? list[0].family : 0;
sock = net.connect({ host: address, port: port });
sock.setTimeout(timeout);
这是回调内部流程的开头,并非可独立运行的完整函数。当前只使用 DNS 返回的第一条地址,没有失败后尝试第二个地址,也没有覆盖 DNS 阶段的总截止计时器。socket timeout 不能简单解释成“从点击到返回必定不超过 10 秒”。
TCP 连接建立后的处理按协议分流:
| 请求类型 | 连接建立后的操作 | 能证明什么 |
|---|---|---|
| banner 为 false | 立即返回 | 本次 TCP 握手成功 |
| HTTPS、RDP、VNC | 立即返回,不读取明文横幅 | 目标端口可建立 TCP 连接 |
| HTTP | 发送 HEAD / HTTP/1.0 | 若收到响应,可提取状态行与部分头字段 |
| SSH 等其他类型 | 等待文本,最多等待 min(1500, timeout) | 若收到可识别横幅,可展示协议与软件字段 |
横幅最多保留 512 个 JavaScript 字符,收到换行就结束本次采集。HTTP 的 Server 头如果出现在后续数据包中,可能来不及收集;这不是完整 HTTP 客户端。SSH 横幅中的软件与尾部文本也是对端自报信息,不能作为认证结果。
NetEngine.parseBanner 中的 SSH 分支节选如下,依赖已构造的 line 与 out:
var ssh = line.match(/^SSH-([0-9.]+)-(\S+)(?:\s+(.+))?$/);
if (ssh) {
out.protocol = 'SSH-' + ssh[1];
out.software = ssh[2];
out.os = (ssh[3] || '').trim();
return out;
}
输出的 ms 从 DNS 查询之前开始计算,有些分支在连接时记录,有些在收到首行时记录。因此文章称其为“探测耗时”,不把界面“往返”文案解释为纯网络 RTT。
批量操作由 renderer.js 的 runTests 串行调度。下面是其内部 step 函数,依赖 queue、i、S 和 probeNode 等上下文:
function step() {
if (S.stopFlag) {
termLine('已停止:剩余 ' + (queue.length - i) + ' 个未测', 'warn');
return finishTests(false);
}
if (i >= queue.length) return finishTests(true);
var node = queue[i];
i += 1;
setText('probeStat', i + ' / ' + queue.length);
renderTree();
return probeNode(node).then(function () {
renderTree();
renderDock();
return step();
});
}
停止按钮只设置 stopFlag,要等当前请求返回后才停止调度后续节点,不会取消已经创建的 socket。开始一轮测试也不会清空全部历史结果,信息坞统计的是 S.results 中保留的各节点最近记录,不是严格的本批独立报告;快速测试结果则保存在 S.quick,不会自动并入这个统计。
本机回环自检是另一条独立入口:在 127.0.0.1 上监听系统分配的临时端口,写出测试横幅,再调用同一 probe。main.js 中创建服务端的连续节选如下:
const banner = 'SSH-2.0-mRemoteNG-selfcheck\r\n';
const server = net.createServer((sock) => {
try { sock.write(banner); } catch (e) { /* 对端已断开 */ }
setTimeout(() => { try { sock.destroy(); } catch (e) { /* 已关闭 */ } }, 400);
});
该自检设置了 8 秒外层计时器,可用于后续区分本地探测链路与外部网络问题。不过它不是 SSH 服务端,也不能验证外部 DNS 服务器、远程认证或公网可达性。本文没有执行自检,也没有向样例中的公网或内网地址发起请求。
3.5 凭据封装、命令生成与会话持久化
凭据保存分成两个步骤:先将密码交给 secret:seal,得到 passwordToken;再把名称、用户名、域、备注、更新时间与密文一起写入 MRemoteNGCreds.json。当前正常表单保存路径不会把新输入的密码直接作为 password 字段写入 JSON。
主进程的完整封装函数如下:
function sealText(plain) {
const iv = crypto.randomBytes(12);
const cipher = crypto.createCipheriv('aes-256-gcm', localKey(), iv);
const body = Buffer.concat([cipher.update(String(plain), 'utf8'), cipher.final()]);
return ['v1', iv.toString('base64'), cipher.getAuthTag().toString('base64'), body.toString('base64')].join('.');
}
localKey 生成 32 字节随机密钥,保存到 userData 下的 MRemoteNGKey.bin;nonce 为 12 字节,密文序列化为版本、nonce、认证标签与密文体四段。chmod 0o600 只是尽力设置权限,失败会被忽略。
密钥和密文都保存在本地应用用户目录,因此不能宣称“离开本机必定无法解密”或“硬件级保护”。密钥文件丢失、损坏或读取失败时,当前逻辑可能生成新密钥,从而无法解开旧密文;需要额外的密钥备份、迁移和损坏处理设计。
渲染层的完整凭据持久化函数如下:
function persistCreds() {
var file = S.info && S.info.credsFile;
if (!file) {
warn('缺少凭据文件路径');
return Promise.resolve(false);
}
var text = JSON.stringify({ version: 1, items: S.creds }, null, 2);
return ipcCall('fs:writeText', { path: file, text: text }).then(function (r) {
if (!r.success) {
fail(r.error || '凭据写入失败');
return false;
}
return true;
});
}
编辑时密码留空表示保留旧密文,不是清除密码;列表中显示“已加密”也只是检查 passwordToken 是否存在,并未尝试验证它能否解开。当前修改内存后再写盘,写盘失败没有事务回滚或原子替换保障。
尤其需要注意:secret:unseal 会把明文返回渲染层。显示密码会把明文放进输入框,再用计时器清空;复制密码复用了通用 copyText,成功后还会把明文前 90 个字符写入状态栏中部。当前也没有剪贴板自动清理。AES-GCM 保护的是落盘形式,不代表界面与剪贴板没有明文暴露风险,第六章将列出后续改进方向。
连接命令的选择逻辑如下:
function commandFor(node) {
if (!isConn(node) || !node.host) return '';
if (node.proto === 'SSH2' || node.proto === 'SSH1') return CredE.sshCommand(node);
if (node.proto === 'RDP') return CredE.rdpCommand(node);
if (node.proto === 'HTTP' || node.proto === 'HTTPS') return CredE.webUrl(node);
if (node.proto === 'Telnet') return 'telnet ' + node.host + ' ' + (node.port || 23);
if (node.proto === 'VNC') return 'vncviewer ' + node.host + '::' + (node.port || 5900);
return CredE.buildUri(node);
}
这些函数生成字符串,后续通过 clip:write 复制,没有执行它们。SSH 命令不包含密码;RDP 返回 mstsc 形式的文本,不意味着鸿蒙系统已经存在该程序。用户名和主机没有完整的 Shell 参数引用处理,来自不可信配置的命令不能直接当作安全可执行输入。
详情中的“匹配凭据”也只是按连接用户名寻找同名账号的第一条凭据,不是绑定凭据 ID,更没有用它执行登录。关于 Web 管理页会打开浏览器的提示文案与当前代码不一致,实际按钮仅复制地址。
会话保存使用下列数据对象,节选自 saveSession:
var data = {
nodes: S.nodes,
meta: S.meta,
confPath: S.confPath,
selected: S.selected,
prefs: S.prefs
};
会话不包含探测历史、日志、快速测试结果和展开状态。恢复时读取节点、配置元数据、来源路径与选中项,但没有应用会话里的 prefs,实际偏好来自此前的 prefs:get。保存会话依赖按钮或 Ctrl+S,没有关闭窗口时自动保存的实现。
3.6 Catppuccin Mocha 深色主题
主题使用 Catppuccin Mocha 色系:base 为 #1e1e2e,mantle 为 #181825,正文为 #cdd6f4,操作强调色为 #89b4fa。成功、警告和错误分别使用绿色、黄色和红色,同时保留文字说明,不单靠颜色表达状态。
主体三列布局的完整规则如下:
#mainArea {
display: grid;
grid-template-columns: var(--side-w) minmax(0, 1fr) var(--dock-w);
min-height: 0;
overflow: hidden;
}
默认导航宽 186px,信息坞宽 268px;中央区域、表格和输出区各自处理滚动。窗口变窄时,先收缩两侧,再隐藏信息坞并将连接树与详情改为单列:
@media (max-width: 1120px) {
:root { --dock-w: 0px; }
#dock { display: none; }
.cols2 { grid-template-columns: 1fr; }
.conn-grid { grid-template-columns: 1fr; }
}
这类布局适合同时观察节点与诊断信息,但 CSS 的滚动高度限制并不限制日志节点数量。termLine 持续追加 DOM,只有用户清空输出才会移除历史行;大量、长时间探测仍需要日志容量和渲染节流方面的后续验证。
四、鸿蒙稳定性适配
4.1 禁用默认菜单栏
问题现象: 自定义工具栏与 Electron 默认菜单并存时,可能出现重复入口。这里讨论的是现有设计针对的问题,不是本文复现出的设备故障。
根因分析: 主页面已经提供导入、保存、搜索等操作,默认 File/Edit/View 菜单并非该业务界面的组成部分。
解决方案: 当前 main.js 在模块初始化时移除应用菜单,同时窗口设置 autoHideMenuBar。源码中的调用为:
Menu.setApplicationMenu(null);
快捷操作则由 renderer.js 的键盘事件提供。文件选择仍使用 Electron 原生文件对话框,不能据此说项目已经移除了所有原生交互窗口。
4.2 自定义下拉、确认框与关于弹层
问题现象: 密码删除、目录撤销、新增连接命名和关于说明需要不同交互形式;不能仅凭一个弹层截图推断所有模态行为都通过设备验收。
根因分析: 当前项目有两套 DOM 浮层实现。普通确认框位于 appFrame 内,以绝对定位覆盖工作区;关于弹层位于 appFrame 之外,使用 fixed 定位覆盖视口。样式文件开头“不使用固定定位”的注释并不适用于后面追加的关于规则。
解决方案: 现有确认框通过 Promise 返回用户选择,下拉通过自定义按钮和选项列表实现。关于窗口通过增删 hidden 类控制,完整函数如下:
function openAboutDialog() {
var l = document.getElementById('aboutDialogLayer');
if (l) l.classList.remove('hidden');
}
function closeAboutDialog() {
var l = document.getElementById('aboutDialogLayer');
if (l) l.classList.add('hidden');
}
关于弹层的实际定位规则如下:
#aboutDialogLayer.about-layer {
position: fixed;
top: 0; left: 0; right: 0; bottom: 0;
background: rgba(17, 17, 27, 0.72);
display: flex;
align-items: center;
justify-content: center;
z-index: 9999;
}
截图可以证明素材中存在关于弹层的显示状态,不能证明它曾修复某个 XComponent 崩溃。当前 Escape 处理覆盖普通确认框和下拉,并没有接入关于弹层关闭;焦点管理、键盘可达性与不同缩放比例的命中区域仍需设备验证。
4.3 窗口配置与运行边界
当前窗口代码应按实际值解释,不套用其他项目的“三防配置”结论。
| 配置项 | 当前源码 | 本文结论 |
|---|---|---|
| width / height | 1320 / 860 | 固定初始窗口尺寸 |
| minWidth / minHeight | 1024 / 680 | 限制最小尺寸 |
| backgroundColor | #1e1e2e | 与业务主题一致 |
| autoHideMenuBar | true | 配合移除默认菜单 |
| nodeIntegration | true | 本地渲染层可使用 Node 能力 |
| contextIsolation | false | 不是隔离的 preload API 模型 |
| spellcheck | false | 关闭输入拼写检查 |
| frame / transparent / resizable | 未显式设置 | 不能描述为已配置三项防护 |
| disableHardwareAcceleration | 没有调用 | 未实施禁用硬件加速 |
| 窗口创建 try/catch | 没有包裹 | 未实现该级别的错误兜底 |
当前安全模型适用于受信任的本地页面。它不应直接承载不可信远程内容,也不应把应用路径表当作阻止已获得 Node 权限代码访问文件的安全边界。若以后增加外部网页、插件或在线配置来源,应重新设计渲染隔离、输入校验与最小权限接口。
4.4 IPC 错误反馈与异步状态归属
问题现象: 文件读取失败、网络请求失败、旧请求晚返回和界面切换可能同时发生。只有错误提示而没有请求归属管理,仍可能让用户看到过时结果。
根因分析: 当前渲染层统一捕获 invoke 拒绝,但没有总超时或批次标识。探测期间重新载入配置会重置节点和结果,旧 probeNode 回调仍可能向新的 S.results 写入旧节点结果;快速测试也没有最新请求归属校验。启动链的后续“就绪”提示还可能覆盖前面已经显示的错误。
解决方案: 现有 ipcCall 负责把传输失败转换为可展示对象,完整代码如下:
function ipcCall(channel, payload) {
return ipc.invoke(channel, payload || {}).then(function (r) {
return r || { success: false, error: '主进程没有返回结果' };
}).catch(function (e) {
return { success: false, error: '调用失败:' + String((e && e.message) || e) };
});
}
这解决的是拒绝结果的统一处理,不会让永不结算的 Promise 自动返回。后续建议为配置版本、探测批次与密码显示请求附加标识,丢弃过时回调,并为网络操作建立覆盖 DNS 和连接阶段的总截止时间。本文没有修改这部分源码,也没有将其改写为渲染层 fs 直读直写的 IPC 旁路方案。
五、构建与部署
以下三张图片来自项目对应的上架素材目录,原图保留,副本归档到本文同级 assets。它们是既有界面素材,不是本文重新构建或操作设备产生的测试截图。

图 1:连接面板已载入内置 confCons.xml,显示 13 个节点,其中 9 个连接、4 个文件夹;右侧没有选中连接,探测统计为 0,输出区只有配置载入记录。截图支持“样例树已展示”的说明,不支持“远程目标全部可达”的结论。

图 2:快速连接面板展示 SSH2、端口 22、超时 4000 ms,以及地址解析、测试、保存和复制报告入口。结果区域明确为“尚未测试”;地址与用户名的浅色提示对应表单示例,不能当作已经成功连接的主机或登录账号。

图 3:关于弹层覆盖快速连接面板,文字说明这是独立 JavaScript 壳应用,并显示 Apache-2.0 声明。该声明与 package.json 的 GPL-2.0 尚不一致,需要发布前核实。
5.1 本地调试与本文验证结果
业务 package.json 没有 start 或 test 脚本,不能直接写成执行 npm start 即可运行。若本机已经准备好匹配的 Electron 可执行程序,可在业务 app 目录手动执行以下调试命令;本文未执行该启动操作:
electron .
本次实际使用 Node.js v22.20.0,对 main.js、renderer.js 和三个引擎执行 node --check,五个文件均通过语法检查。随后直接 require 引擎,读取工程自带样例或构造内存输入,没有创建 DOM 仿真、临时测试脚本或测试包。
| 实际检查 | 输入 | 观察结果 |
|---|---|---|
| XML 样例解析 | samples/confCons.xml | 13 节点、9 连接、4 文件夹、3 个根节点,errors 为空 |
| CSV 样例解析 | samples/connections.csv | 13 节点、9 连接、4 文件夹,但全部为根节点 |
| 协议统计 | 两份内置样例 | SSH2 2、RDP 1、HTTP 2、Telnet 1、VNC 1、HTTPS 2;继承计数 0 |
| XML 常用字段生成再解析 | 内置 XML 的解析节点 | 节点数与协议统计保持一致;不代表所有属性无损 |
| 关键词搜索 | Grafana | 保留生产环境、监控面板和 Grafana 三个节点 |
| 空文件夹导出 | 一个 container 节点 | 输出缺少 Node 闭合标签 |
| CSV 逗号备注 | a,b | 一个节点,备注正确恢复 |
| CSV 换行备注 | a 与 b 之间含换行 | 被解析为 demo 和 b 两个节点,且 errors 为空 |
| SSH 横幅纯函数 | SSH-2.0-OpenSSH_9.0 test | 识别 SSH-2.0、OpenSSH_9.0 和尾部文本 test |
| HTTP 横幅纯函数 | 200 OK 与 Server: demo | 识别 HTTP/1.1、200 OK、demo |
| 结果汇总 | 成功耗时 10、30,失败耗时 100 | 总计 3,成功 2,失败 1,成功项平均 20 ms |
| 端口与 IPv4 校验 | 0、22、65536;999.1.1.1 | 端口仅 22 通过,非法 IPv4 不通过 |
| IPv6 主机归一 | 2001:db8::1 | 返回 2001:db8:,表明尾段被端口剥离规则误处理 |
| URI 解析 | ssh://demo@localhost:2222 | 识别 SSH2、demo、localhost、2222 |
| 缺端口 URI | ssh://demo@localhost | 引擎返回端口 0,默认端口由调用方补齐 |
| 命令与凭据纯函数 | 虚构 demo 账号 | 生成 ssh -p 2222 demo@localhost,同名生成 demo (2) |
| 凭据字段校验 | 空名称、257 字符测试串 | 两个用例均被拒绝 |
这些结果包括正常行为与已观察到的边界,不能合并成“全部功能通过”。本次没有执行 net:probe、net:selfTest、secret:seal 或 secret:unseal,没有访问真实凭据文件,也没有验证密码落盘、剪贴板操作、系统对话框或上游客户端导入。
5.2 业务资源与鸿蒙模块的衔接
electron/oh-package.json5 的依赖节选如下:
"dependencies": {
"web_engine": 'file:../web_engine',
}
业务入口是 web_engine/src/main/resources/resfile/resources/app/package.json 中声明的 main.js,再由主进程加载 index.html。页面先载入三个引擎脚本,最后执行 renderer.js。
本项目资源已经平铺在 app 目录;不要为了套用其他项目的部署步骤而清空该目录,或从不存在的开发副本进行覆盖。后续若维护者修改业务,应确认进入构建的资源就是上述目录,并在构建后核对产物中的业务文件版本。
配置、凭据与偏好写入运行环境的 userData,而不是回写安装资源。主要文件包括 MRemoteNGPrefs.json、MRemoteNGSession.json、MRemoteNGCreds.json、MRemoteNGRoots.json 和 MRemoteNGKey.bin。文章归档和图片复制不会触碰这些运行时用户数据。
5.3 HAP 构建与部署检查点
在 DevEco Studio 中打开 ohos_hap,确认 SDK、产品、签名和模块依赖后,再使用 IDE 对应的 HAP 构建入口。本文没有执行构建命令,因此不提供虚构的成功日志、产物路径或安装结论。
发布前建议分层检查:
- 工程身份:当前 bundleName 仍为 com.huawei.ohos_electron,vendor 为 example,AppScope 的 app_name 为 Electron;需核对应用名、Ability 标签与各语言资源是否一致。
- 权限与模板项:web_engine 声明网络、剪贴板及目录访问等权限,同时还存在位置、相机、麦克风等模板能力;electron 保留快捷方式 metadata。应结合实际业务、运行时要求和平台规则逐项核对,不因本文建议直接批量删除。
- 许可证:确认代码来源与授权关系后统一 package.json、关于弹层和对外材料。
- 配置交换:覆盖空容器、多层分组、缺失字段、编码和多行 CSV,并用目标客户端独立检验导出结果。
- 网络行为:先使用受控本机回环,再使用用户明确授权的测试端点;分别记录解析、握手、超时、横幅、停止与重试结果。
- 凭据生命周期:使用一次性测试数据,检查写盘失败、密钥损坏、显示计时、复制反馈、剪贴板残留和窗口切换。
- 设备交互:检查标题栏、最小窗口、表格滚动、下拉遮挡、文件对话框、重复操作与重启后的会话恢复。
只有完成对应验证,才能将“源码具备某条调用路径”升级为“在指定设备和条件下通过验收”。三张界面素材不能替代这些步骤。
六、常见问题与解决方案
以下问题来自源码核对和本次有限引擎验证。标为建议的措施尚未实施,不是已经完成的修复或上架排障记录。
Q1:为什么快速连接没有打开远程桌面,复制访问地址也没有启动浏览器?
问题现象: 按钮名称和协议提示容易让人理解为完整的连接客户端,但当前交互主要返回探测结果或复制文本。
根因分析: commandFor、copyCommand、copyUri 和 copyAddr 只生成字符串并调用 clip:write,没有外部程序执行或浏览器打开链路。CredEngine 的部分提示文案超出了当前实际实现;协议表只是元数据。
解决: 使用者应在具备对应客户端的环境中检查并手动使用命令。后续若要增加程序启动,应分别设计平台能力探测、参数传递、用户确认和权限控制,而不是直接执行配置字符串。当前命令参数没有完整 Shell 引用处理,不应执行来自不可信配置的内容。
教训: 配置管理、端口预检和远程登录必须分别描述,按钮标签与说明文案不能代替实现证据。
Q2:TCP 可达、SSH 横幅和“全部失败”的提示分别说明什么?
问题现象: 用户可能把可达当作登录成功,也可能把全部失败提示中的“网段不同”视为唯一原因。
根因分析: TCP 成功只说明本次握手完成;SSH 横幅没有验证账号,HTTPS 没有验证证书,RDP/VNC 没有会话协商。失败可能来自 DNS、目标未监听、防火墙、权限或链路状态。当前 explainAllFailed 的部分固定文案过于确定,并不能据此排除应用自身问题。
解决: 按错误码、目标地址、解析结果和探测阶段逐项判断。后续可先运行回环自检确认本地路径,再对授权目标检查网络;若回环成功,也不能推导所有外部连接必然成功。文章中的横幅案例只测试文本解析,没有访问对应服务。
教训: 网络诊断应报告已观察事实与可能原因,避免把单次失败推导为唯一根因。
Q3:设置了超时,为什么停止仍要等待,统计还包含以前的结果?
问题现象: 停止按钮提示等待当前连接返回;后续测试完成时,信息坞可能包含之前节点的结果。
根因分析: 队列只检查 stopFlag,不取消在途 socket;socket timeout 在 DNS 查询之后设置,不覆盖全过程。S.results 按节点保存最近结果,runTests 开始时未清空,且声明的 50 条批量常量没有接入调度。
解决: 当前使用时区分“停止后续任务”与“立即取消请求”,区分“节点最近记录”与“本轮报告”。后续建议增加批次 ID、总截止时间、主动取消、明确批量上限和独立批次统计;载入新配置时应处理旧任务的结果归属。
教训: 超时、取消、并发和结果生命周期是不同机制,不能由一个停止按钮或一个常量代替全部控制。
Q4:XML 导出和 CSV 往返为什么不能认为完全兼容?
问题现象: 本次空文件夹导出缺少闭合标签,CSV 的换行备注被拆成额外节点,而正常样例仍可得到相同统计。
根因分析: nodeXml 在空 children 时直接返回起始标签;parseCsv 先按物理行拆分,不具备跨行引号状态。CSV 未保存树关系,XML 解析也只覆盖常用字段,不读取上游 Password,未完整实现继承和加密配置语义。
解决: 在修复前不要把这条路径用于需要无损保存的配置。后续应补齐空容器闭合、跨行 CSV 解析、层级交换规则和字段兼容测试,再用独立 XML 解析器及目标客户端核验。URI 也需要单独加强:本次未加方括号的 IPv6 地址被 normalizeHost 误处理,不能宣称所有 IPv6 输入已经支持。
教训: 用同一个宽松解析器验证自己的输出,容易掩盖格式问题;统计一致不代表结构和全部属性一致。
Q5:已经使用 AES-256-GCM,为什么仍需处理明文泄露风险?
问题现象: 静态调用链显示,复制密码成功后会把内容前 90 个字符写入状态栏;显示密码时明文也会进入输入框。本文没有用真实密码运行这些操作。
根因分析: credCopy 解封后调用通用 copyText,而 copyText 的成功反馈包含 text.slice(0, 90)。该反馈适合地址或报告,不适合秘密数据;密码显示计时器只清理输入框,不负责状态栏或剪贴板。密钥与密文同处 userData,也不是硬件隔离。
解决: 后续应为秘密复制建立不回显内容的专用反馈,清理可能残留的界面内容;剪贴板延迟清理应仅在内容仍是本次复制值时执行,避免覆盖用户后续复制的数据。显示与解封应校验凭据 ID 和请求归属,密钥异常应显式报错,写盘需要原子性设计。在完成这些改进前,不应将当前版本作为生产凭据保险库。
教训: 静态存储加密只是秘密数据生命周期的一环,输入、解封、显示、复制、日志和备份都需要单独保护。
Q6:目录已撤销或会话已保存,为什么仍不能推导出完整隔离与完整恢复?
问题现象: 撤销子目录后,其父目录若仍在范围中,访问可能仍被允许;保存会话也不代表保存了探测历史、界面状态与所有偏好。
根因分析: 路径表支持父目录覆盖子路径,且采用字符串归一而非真实路径隔离。会话仅保存部分字段,恢复未应用其中 prefs,结果会清空;普通读写也不是事务式保存。渲染层开启 Node 能力,本身不受这张范围表强制隔离。
解决: 当前应检查全部重叠目录范围,并通过专门的偏好保存入口保存设置;重启验证时逐项核对节点、选择状态和偏好来源。后续建议补充真实路径与大小写策略、持久化结构校验、原子写入和明确的恢复清单。
教训: 应用级路径限制不是系统沙箱,局部快照也不是完整运行现场备份。
Q7:为什么有界面截图,仍要核对应用名、权限和许可证?
问题现象: 页面标题显示 mRemoteNG,但当前 AppScope 使用模板包名和 Electron 标签,关于弹层与 package.json 的许可证声明也不一致。
根因分析: HTML 标题、BrowserWindow 标题、AppScope 标签、Ability 标签和商店材料属于不同层次。截图只能显示其中一部分;模板权限和快捷方式还需要结合最终应用核对。
解决: 发布前统一身份资源与许可证说明,审查权限用途和快捷方式入口,核对签名与目标产品,再执行构建、安装及设备回归。本文没有读取或公开签名秘密,也没有自行修改包名、权限、许可证或原生库。
教训: 页面已经展示与工程已经具备发布条件不是同一个结论,应分别提供证据。
七、总结
mRemoteNG 壳应用把连接清单、网络预检和本地凭据管理组合为一个桌面工作区。值得复用的是职责分层:纯 JavaScript 引擎负责可测试的数据处理,主进程提供系统能力,渲染层组织交互和结果展示。
| 特性 | 当前实现与需要保留的边界 |
|---|---|
| 配置树 | confCons.xml 常用字段解析、parentId 建树、祖先保留搜索 |
| CSV 交换 | 七列清单与基础转义;层级、多行字段及空容器导出仍有限制 |
| 网络预检 | DNS + TCP + 有限横幅;不是登录、证书或远程会话验收 |
| 队列控制 | 渲染层串行、主进程并发上限 4;停止不取消在途请求 |
| 凭据封装 | AES-256-GCM 与本地密钥;明文反馈和密钥生命周期仍需改进 |
| 连接交接 | 命令、URI 与地址复制;不自动启动外部客户端 |
| 持久化 | 目录范围、偏好、凭据和部分会话快照分别落盘 |
| 桌面界面 | 五面板、响应式三列、日志与自定义浮层 |
本次最关键的三个经验:
- 把能力边界落实到调用链。 协议标签不是协议栈,端口可达不是认证成功,复制命令也不是启动客户端。
- 用独立案例检查格式对称性。 正常样例能解析之外,还要覆盖空容器、多行 CSV、继承和地址归一,不能只比较节点统计。
- 分开审视持久化与运行时安全。 密码密文落盘不能覆盖状态栏、剪贴板和异步回调中的明文风险,路径表也不能替代渲染隔离。
本文完成的是当前实现的技术梳理、有限引擎验证与素材归档。源码中尚存的边界均如实保留,未据此宣称完整移植、全功能验收或已完成鸿蒙上架。
更多推荐




所有评论(0)