lizi600jin/dsh-ensp
开发工具面向华为 eNSP 实验的自动化工具,可生成拓扑、启动设备、逐条下发配置、验收结果并导出实验报告。
项目介绍
dsh-ensp 是华为 eNSP 的 Windows 自动化外壳。它能生成 eNSP 可直接打开的 .topo 文件,启动和停止模拟设备,逐条下发 VRP 配置并在每条命令后报告错误,轮询等待路由协议收敛,再按场景断言检查实验结果,最后把拓扑、设备实际生效配置、验证输出和结论导出成 Word 实验报告。
同一套核心提供 CLI、可 import 的 JavaScript 库、含 17 个工具的 MCP Server,以及 DeepSeek Harness 插件四种用法。内置场景覆盖 VLAN、STP、链路聚合、静态路由、RIP、OSPF、BGP、IS-IS、MPLS、组播、NAT、DHCP、ACL、QoS、端口安全、IPsec、IPv6、WLAN、防火墙和高可用等主题(场景说明)。
适合已经运行 eNSP、希望把网络实验做成可重复脚本的学员、教师和实验工程师。
快速使用
准备一台 Windows 机器,eNSP 与 VirtualBox 已安装且可正常运行,Node.js 18 或更高版本,并以管理员身份运行本工具和 eNSP。先全局安装:
npm install -g dsh-ensp
然后在管理员身份的交互式桌面会话中按推荐顺序执行:
ensp doctor # 检查环境
ensp preset ospf-single --topo lab.topo # 生成拓扑
ensp up lab.topo # 打开、启动并确认设备就绪
ensp apply ./configs --topology lab.topo --save
ensp verify ospf-single --topology lab.topo
ensp report ospf-single --topology lab.topo --out ospf-single.docx
ensp stop
apply 读取每台设备一个的 .cfg 文件,可用 ensp preset ospf-single --config ./configs 生成。verify 默认对断言重试最多 60 秒,因为路由协议在命令返回后才收敛,可用 --wait 调整。report 只在明确调用时生成六章文档。
MCP 客户端可以这样接入:
{
"mcpServers": {
"ensp": {
"command": "npx",
"args": ["-y", "dsh-ensp", "mcp"]
}
}
}
DSH 用户也可以执行 dsh plugin --profile desktop add dsh-ensp 安装。
使用约束
- 仅支持 Windows;eNSP 没有其他平台版本,包也只声明
win32。 - 需要已安装并可正常运行的 eNSP 和 VirtualBox。安装位置会从命令行参数、环境变量、注册表和常见路径自动探测。
- 必须在管理员身份的交互式桌面会话中运行。UIPI 会丢弃低完整性进程的模拟输入,服务、计划任务和 SSH 会话即使提权也无法驱动图形界面;
ensp doctor会报告输入注入是否可用。 - eNSP 窗口必须保持可见且不被遮挡,工具无法强制把窗口提到前台;点击前会检查落点归属,被其他窗口覆盖时拒绝点击。
- 部分机型需要 eNSP 安装时未附带的镜像,典型是 USG6000V。
ensp images可以检查,ensp images <机型> --install <文件>可放入你已有的镜像;工具不会自动下载镜像。 - eNSP 只允许单实例,工具启动前会清理持有单实例锁的僵尸进程。
- 场景没有断言时,
verify返回unverified且退出码为 3,不冒充通过;少数场景只有冒烟检查。 - 采用 GPL-3.0-or-later,修改后对外分发须保留声明并以同一协议开源(许可证)。
HotRepo 点评
在 2026-11-16 的 JavaScript 新项目榜中,dsh-ensp 记录到 103 星,约一小时的统计窗口内净增 3 星;目前没有记录到 GitHub 全语言日榜名次,所以没有更广的排名信号可解读。技术层面更值得关注的是它对 eNSP 各种边界情况的处理:按机型检查镜像、检测窗口遮挡、识别 UIPI 对输入注入的影响,以及带重试的断言式验收。这些都是具体且可核查的工程取舍,使它不只是对界面点击的简单封装。
相关文档
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。