在连接管理工具中,“保存一个远程地址”“确认端口可达”和“真正登录远程桌面”是三个不同层次的问题。本项目围绕前两个层次,使用 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
compatibleSdkVersion5.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:info1
目录范围dir:choose、dir:forget2
文件处理fs:scan、fs:stat、fs:readText、fs:writeText、files:choose、file:saveText6
系统交互clip:write、shell:reveal2
偏好prefs:get、prefs:set2
会话session:save、session:load2
样例samples:list1
网络net:probe、net:selfTest2
密码secret:seal、secret:unseal2

它们通过一个包装器注册,不是出现 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 / height1320 / 860固定初始窗口尺寸
minWidth / minHeight1024 / 680限制最小尺寸
backgroundColor#1e1e2e与业务主题一致
autoHideMenuBartrue配合移除默认菜单
nodeIntegrationtrue本地渲染层可使用 Node 能力
contextIsolationfalse不是隔离的 preload API 模型
spellcheckfalse关闭输入拼写检查
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.xml13 节点、9 连接、4 文件夹、3 个根节点,errors 为空
CSV 样例解析samples/connections.csv13 节点、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
缺端口 URIssh://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 构建入口。本文没有执行构建命令,因此不提供虚构的成功日志、产物路径或安装结论。

发布前建议分层检查:

  1. 工程身份:当前 bundleName 仍为 com.huawei.ohos_electron,vendor 为 example,AppScope 的 app_name 为 Electron;需核对应用名、Ability 标签与各语言资源是否一致。
  2. 权限与模板项:web_engine 声明网络、剪贴板及目录访问等权限,同时还存在位置、相机、麦克风等模板能力;electron 保留快捷方式 metadata。应结合实际业务、运行时要求和平台规则逐项核对,不因本文建议直接批量删除。
  3. 许可证:确认代码来源与授权关系后统一 package.json、关于弹层和对外材料。
  4. 配置交换:覆盖空容器、多层分组、缺失字段、编码和多行 CSV,并用目标客户端独立检验导出结果。
  5. 网络行为:先使用受控本机回环,再使用用户明确授权的测试端点;分别记录解析、握手、超时、横幅、停止与重试结果。
  6. 凭据生命周期:使用一次性测试数据,检查写盘失败、密钥损坏、显示计时、复制反馈、剪贴板残留和窗口切换。
  7. 设备交互:检查标题栏、最小窗口、表格滚动、下拉遮挡、文件对话框、重复操作与重启后的会话恢复。

只有完成对应验证,才能将“源码具备某条调用路径”升级为“在指定设备和条件下通过验收”。三张界面素材不能替代这些步骤。

六、常见问题与解决方案

以下问题来自源码核对和本次有限引擎验证。标为建议的措施尚未实施,不是已经完成的修复或上架排障记录。

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 与地址复制;不自动启动外部客户端
持久化目录范围、偏好、凭据和部分会话快照分别落盘
桌面界面五面板、响应式三列、日志与自定义浮层

本次最关键的三个经验:

  1. 把能力边界落实到调用链。 协议标签不是协议栈,端口可达不是认证成功,复制命令也不是启动客户端。
  2. 用独立案例检查格式对称性。 正常样例能解析之外,还要覆盖空容器、多行 CSV、继承和地址归一,不能只比较节点统计。
  3. 分开审视持久化与运行时安全。 密码密文落盘不能覆盖状态栏、剪贴板和异步回调中的明文风险,路径表也不能替代渲染隔离。

本文完成的是当前实现的技术梳理、有限引擎验证与素材归档。源码中尚存的边界均如实保留,未据此宣称完整移植、全功能验收或已完成鸿蒙上架。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐