一款基于 Electron + C++ DLL 架构的跨平台网络调试工具,支持 TCP、UDP、组播多协议,内置数据包模板与丰富变量宏,助力嵌入式开发、IoT 调试与协议测试。


一、软件概览

NetDebugX 是一款面向开发者的网络调试工具,采用 Electron 前端 + C++ DLL 后端的混合架构,通过 Koffi 实现前后端通信。核心能力包括:

  • 多协议支持:TCP 客户端 / TCP 服务端 / UDP / 组播
  • 灵活数据格式:ASCII、HEX、JSON、文本,支持实时切换
  • 数据包模板:内置时间戳、序号、CRC、校验和等变量宏
  • 日志导出:支持手动导出与自动保存,便于问题回溯

在这里插入图片描述

主界面:功能入口、最近使用记录一目了然


二、主要功能

2.1 主页与导航

启动后首先进入主页,顶部工具栏提供快捷切换:

功能 说明
主页 功能概览与最近使用记录
TCP 客户端 连接远程 TCP 服务,收发数据
TCP 服务端 在本机监听,接受多客户端连接
UDP UDP 收发(支持绑定/仅发模式)
组播 加入组播组,收发组播数据
数据模板 预置与自定义数据包模板
设置 显示、格式、网络、快捷键等配置

状态栏实时显示当前连接状态、地址端口及收发统计。


2.2 TCP 客户端

适用于连接设备或服务器的场景,如调试 Modbus、自定义 TCP 协议等。

核心能力:

  • 连接配置:服务端 IP、端口,可选本地端口绑定、连接超时
  • 自动重连、TCP KeepAlive、Nagle 算法开关
  • ASCII / HEX 双模式发送,支持追加换行、定时发送
  • 快捷指令:常用命令一键发送,可持久化保存
  • 数据模板:从模板库快速插入预定义数据包

在这里插入图片描述

TCP 客户端:连接参数、收发区、快捷指令

收发区特性:

  • 发送(TX)与接收(RX)分色显示,支持时间戳
  • 可在 ASCII / HEX / ASCII+HEX 间切换显示格式
  • 支持校验和追加(累加和、CRC16 等)
  • 自动滚动、消息条数限制,避免界面卡顿

2.3 TCP 服务端

在本机监听指定端口,接受多个客户端连接,适用于模拟服务器或设备联调。

核心能力:

  • 监听配置:地址(0.0.0.0 / 127.0.0.1 / 本机 IP)、端口、最大连接数
  • 客户端列表:显示已连接客户端 IP:Port,可按客户端筛选消息
  • 多选发送:向选中客户端或全体客户端发送数据
  • 自动回复:收到数据后可自动回复指定内容,便于自动化测试

在这里插入图片描述

TCP 服务端:客户端列表、收发区、自动回复

适用场景:

  • 设备模拟器开发
  • 多客户端压力测试
  • 协议兼容性验证

2.4 UDP 通信

支持两种工作模式:绑定模式(收发)与 仅发模式(仅发送)。

绑定模式:

  • 绑定本地地址和端口,可接收任意来源 UDP 包
  • 支持多目标管理:保存常用目标,快速切换
  • 可开启广播,支持 255.255.255.255 广播发送

仅发模式:

  • 无需绑定端口,填写目标地址后直接发送
  • 适用于设备发现、单次探测等场景

在这里插入图片描述

UDP 通信:多目标、广播、收发统计


2.5 组播通信

加入组播组(如 239.0.0.1),实现一对多、多对多通信。

核心能力:

  • 多组加入:支持加入多个组播组,分别收发
  • 本地接口选择:可选择网卡或「全部」
  • TTL、回环控制
  • 发送目标:组地址:端口

在这里插入图片描述

组播通信:组播组列表、收发区


2.6 数据包模板

预置与自定义数据包模板,支持 HEX、ASCII、JSON、文本等格式,并内置丰富变量宏

通用变量:

变量 说明 示例
{TIME} 时:分:秒 09:51:19
{DATE} 日期 2026-03-17
{TIMESTAMP} 时间戳字符串 20260317095119
{TIMESTAMP:unix} Unix 时间戳 4 字节大端 HEX
{TIMESTAMP:bcd} BCD 日期时间 7 字节 HEX
{RANDOM:1} 1 字节随机数 HEX A3
{RANDOM:2} 2 字节随机数 HEX A3 5F
{SEQ} 自增序号 从 1 起
{LEN} 当前数据包长度 字节数

校验变量(HEX 专用):

变量 说明
{CRC16} / {CRC16:modbus} Modbus CRC-16
{CRC16:ccitt} CRC-16/CCITT
{CRC16:xmodem} CRC-16/XMODEM
{CHECKSUM} 累加和校验

在这里插入图片描述

数据包模板:模板列表、编辑器、变量宏

发送时选择模板,变量会在发送前自动替换为当前值,适合心跳包、协议帧构造等场景。


2.7 全局设置

设置页提供多类配置:

分类 配置项
显示设置 界面缩放、数据区字体大小、等宽字体
数据格式 默认显示格式、时间戳、自动滚动、消息条数、HEX 分隔符
发送设置 默认格式、追加换行、发送快捷键、定时发送间隔
网络设置 TCP 超时、KeepAlive、UDP 缓冲区、TTL、DNS 超时
快捷键 Ctrl+Enter 发送、Ctrl+L 清空、Ctrl+D 连接等
日志导出 默认保存路径、格式、自动保存、文件大小限制

在这里插入图片描述

全局设置:多分类、持久化存储


三、使用流程示例

示例 1:TCP 客户端连接设备

  1. 进入「TCP 客户端」
  2. 填写设备 IP 与端口(如 192.168.1.100:502
  3. 点击「连接」
  4. 在发送区输入或选择模板数据,点击「发送」或使用 Ctrl+Enter

示例 2:TCP 服务端模拟 Modbus 从站

  1. 进入「TCP 服务端」
  2. 选择监听地址(如 0.0.0.0)和端口(如 502
  3. 点击「开始监听」
  4. 设备连接后,在客户端列表中选择该连接,收发 Modbus 帧

示例 3:UDP 设备发现

  1. 进入「UDP」,选择「仅发模式」
  2. 目标填入广播地址 255.255.255.255 或网段广播
  3. 发送发现命令(如 DISCOVER
  4. 切换到「绑定模式」,打开端口,接收设备回复

四、技术特点

  • Electron + React:跨平台桌面应用,现代化 UI
  • C++ DLL 后端:高性能网络 IO,Koffi 桥接
  • 多协议统一界面:TCP/UDP/组播操作方式一致
  • 数据持久化:设置、快捷指令、模板等由后端保存
  • 无边框窗口:自定义标题栏,支持置顶

五、下载

版本 说明 下载链接
绿色版 解压即用,无需安装 NetDebugX.rar(访问密码: 1150)
安装版 一键安装,支持卸载 NetDebugX Setup 1.0.0.exe(访问密码: 1150)

六、系统要求

  • 操作系统:Windows 10 及以上(64 位)
  • 运行环境:已内置 Electron 运行时,无需额外安装

七、结语

NetDebugX 面向嵌入式开发、IoT 调试、协议测试等场景,提供一站式网络调试能力。若在使用中遇到问题或有功能建议,欢迎反馈。

公众号: 全栈代码工坊
在这里插入图片描述

Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐