NetDebugX 网络调试助手 — 功能介绍
一款基于 Electron + C++ DLL 架构的跨平台网络调试工具，支持 TCP、UDP、组播多协议，内置数据包模板与丰富变量宏，助力嵌入式开发、IoT 调试与协议测试。
一款基于 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 客户端连接设备
- 进入「TCP 客户端」
- 填写设备 IP 与端口（如
192.168.1.100:502） - 点击「连接」
- 在发送区输入或选择模板数据，点击「发送」或使用 Ctrl+Enter
示例 2：TCP 服务端模拟 Modbus 从站
- 进入「TCP 服务端」
- 选择监听地址（如
0.0.0.0）和端口（如502） - 点击「开始监听」
- 设备连接后，在客户端列表中选择该连接，收发 Modbus 帧
示例 3：UDP 设备发现
- 进入「UDP」，选择「仅发模式」
- 目标填入广播地址
255.255.255.255或网段广播 - 发送发现命令（如
DISCOVER） - 切换到「绑定模式」，打开端口，接收设备回复
四、技术特点
- Electron + React：跨平台桌面应用，现代化 UI
- C++ DLL 后端：高性能网络 IO，Koffi 桥接
- 多协议统一界面：TCP/UDP/组播操作方式一致
- 数据持久化：设置、快捷指令、模板等由后端保存
- 无边框窗口：自定义标题栏，支持置顶
五、系统要求
- 操作系统：Windows 10 及以上（64 位）
- 运行环境：已内置 Electron 运行时，无需额外安装
六、结语
NetDebugX 面向嵌入式开发、IoT 调试、协议测试等场景，提供一站式网络调试能力。若在使用中遇到问题或有功能建议，欢迎反馈。