网络调试助手 NetAssist 下载与使用：TCP/UDP/MQTT 联调（v5.15）

NetAssist 是野人家园（云想物联）的网络调试助手，和同一家的 UartAssist 串口调试助手是姊妹产品。它解决的是这类问题：你写了一个网络程序、或者手上有一台串口服务器 / DTU / 网关，需要一个对端来验证它到底有没有正常收发。

本文记录时版本 5.15，更新于 2025-07-30，648KB，官方标注免费软件，下载不要积分，累计下载 243,929 次。

四种工作模式，分别什么时候用

NetAssist 支持四种模式，选错模式是最常见的第一道坎：

TCP Client（客户端）——你的设备是服务端、在监听某个端口，你要连过去。调串口服务器、网关这类设备时多数是这种。

TCP Server（服务端）——反过来，你的设备是客户端、要主动连上来。DTU、4G 模块、上报型传感器通常是这种，它们上电后会去连一个配置好的 IP 和端口。这时你需要先把 NetAssist 开成服务端等着。

UDP——无连接，双方都能直接发。做组播、广播、局域网发现协议时用。

MQTT Client——连 MQTT Broker 收发主题消息。物联网设备接云平台时验证链路用。

判断标准很简单：谁主动发起连接，谁就是客户端。 想不清楚就看设备手册里有没有配置「服务器 IP / 端口」——有，说明设备是客户端，你得开服务端。

连不上时按这个顺序查

一、端口有没有被占用。 做服务端时最常见。换个端口试一下，能起来就说明是占用问题。

二、防火墙。 Windows 防火墙默认会拦截入站连接。第一次把 NetAssist 开成服务端时，系统通常会弹窗询问，点了「取消」之后就再也连不上了，而且不会有任何提示。这一条排查起来最费时间，因为现象和「对端没连」完全一样。

三、IP 和端口对不对。 设备配的服务器地址是不是你这台机器的实际 IP。多网卡、连了 VPN、或者用了虚拟机的情况下，很容易配到一个对端根本到不了的地址。

四、对端到底有没有发起连接。 服务端模式下，如果连接列表一直是空的，说明设备压根没连过来，问题在设备侧的配置或者网络路径上，跟 NetAssist 无关。

区分「没连上」和「连上了但数据不对」很重要——前者是网络层问题，后者是协议层问题，排查方向完全不同。

做服务端时的两个实用功能

多客户端管理。 作为 TCP 服务端时可以同时接多个客户端连接，并且能选择向指定客户端或全部客户端发送。现场有一批设备同时上报时，这个功能能让你逐台确认。

黑白名单。 可以按名单管控哪些客户端允许接入。现场网络里有一堆设备都在连同一个端口时，用白名单把测试目标单独隔出来，日志会清爽很多。

数据格式与自动化

支持 ASCII / HEX 两种模式收发，十六进制和 ASCII 之间可以随时切换。这对二进制协议是必须的——用文本模式看二进制数据只会看到一堆问号。

还支持自动发送校验位（多种校验格式）、发送脚本代码实现动态数据、以及从外部文件导入待发送内容。

IPv6 是原生支持的，不用切换模式或额外配置。

TCP 还是 UDP：别照抄别人的配置

设备手册没写清楚时，很多人是随便试一个能通就用了。这两者的差别在调试阶段会以很隐蔽的方式咬人：

TCP 是流，没有消息边界。 你发两次「AA」和「BB」，对端可能一次收到「AABB」，也可能分三次收到。这不是 bug，是 TCP 的设计。所以基于 TCP 的自定义协议必须自己带长度字段或结束符，否则拆不出来。调试时看到数据粘在一起，先想这一层，别急着怀疑设备。

UDP 保留消息边界，但不保证送达和顺序。 你发一包就是一包，对端要么完整收到要么收不到，不会收到半包。代价是可能丢、可能乱序、可能重复。局域网内丢包率通常很低，所以很多人在实验室测得好好的，一到现场跨网段就开始丢——这类问题在实验室里复现不出来。

NetAssist 两种都支持，切换只要改工作模式。怀疑是协议边界问题时，用 UDP 模式对照发一次：如果 UDP 下数据完整、TCP 下粘连，那基本可以确定是你的拆包逻辑没写对，而不是设备发错了。

它和同族其他工具的分工

同一家还有两个产品，功能有重叠，选哪个取决于你要不要同时看串口：

• 只调网络——用 NetAssist，界面最专注。
• 串口和网络都要，而且想在同一个窗口里对照——用 SCOMM。串口服务器、DTU 这类「一端串口一端网络」的设备，两边同时开着看，问题在哪一段一眼就能看出来。
• TCPCOM 是早期的二合一版本，已经停更八年，功能是 SCOMM 的子集，新项目没有理由再选它。

它的边界

只有 Windows 版。

MQTT 支持是「够用」级别——能连、能收发主题消息，验证链路没问题；但要做主题树管理、保留消息调试、大规模压测这类专业活儿，还是得用专门的 MQTT 客户端。

它是调试工具不是压测工具，不要指望用它测吞吐量。