TCP 客户端
主动向服务端发起连接并双向收发——验证「我的程序能不能和某个 TCP 服务对上话」的第一件工具。
Overview
总体概览
TCP 客户端测试工具用于主动向指定的 TCP 服务端发起连接,并在连接建立后与服务端完成双向数据交互,是验证“我的程序能不能和某个 TCP 服务对上话”时最直接的工具。TCP 是面向连接、可靠传输的通信协议,具备数据确认、重传与拥塞控制机制,保障数据有序完整到达。在良友工控助手中填写服务端 IP 地址与服务端口、点击连接即可发起请求;连接成功后日志给出本端与服务端的地址信息,按钮自动切换为断开状态。发送与接收可分别以 Hex 字符串或文本字符串展示与发送,并支持 UTF-8、ASCII、Unicode、GB2312、ANSI 五种字符编码;还可勾选自动重连观察链路恢复行为,日志带毫秒级时间戳并按事件着色,多开实例则可同时连接多个服务端做对比调试。
Screenshots
界面预览



Highlights
特性速览
填写 IP 与端口即可发起连接,按钮随连接状态自动切换
发送与接收的 Hex / 文本模式独立设置,标签随模式同步变化
五种字符编码:UTF-8 / ASCII / Unicode / GB2312 / ANSI(跟随操作系统)
可勾选自动重连,完整记录重连次数与重连失败信息
毫秒级彩色日志:发送蓝、接收绿、状态黑、错误红,每条标注字节数
Hex 输入自动忽略空格,长度为奇数时明确提示 Data Length Error
支持多开实例,同时连接多个服务端进行对比调试
Features
核心特性
连接管理
填写目标服务端 IP 地址与服务端口后点击 Connect 发起连接请求;连接成功后日志给出本端与服务端的地址信息,按钮自动切换为断开状态,点击 Disconnect 主动断开。连接与断开状态一目了然,避免误操作。
双模式数据收发
发送与接收的数据可以分别以 Hex 字符串或文本字符串展示与发送,两种模式可独立设置,标签随模式切换同步变化。Hex 模式便于直接粘贴设备手册中分段带空格的报文,输入时空格会被自动忽略;文本模式适合 AT 指令、JSON 等文本协议。当输入长度为奇数时会明确提示 Data Length Error。
多编码支持
使用文本字符串与服务端通信时,可以选择字符编码:UTF-8、ASCII、Unicode、GB2312 与 ANSI(跟随操作系统)。与使用 GB2312 编码的设备通信时切换到对应编码,中文即可正确解析显示。
自动重连
勾选自动重连后,连接被服务端关闭或网络中断时会在后台持续尝试重连,并完整记录重连次数与重连失败信息,方便观察设备或链路的断线恢复行为,适合长连接的稳定性与断线重连测试。
毫秒级彩色日志
收发日志带毫秒级时间戳并按事件着色——发送为蓝色、接收为绿色、状态为黑色、错误为红色;每条收发记录都标注字节数,便于核对报文完整性。
Scenarios
典型使用场景
验证 TCP 服务端连通性
排查连接失败、端口不通、握手异常等网络问题:先确认服务在线,再逐层排查防火墙与路由。
模拟业务客户端下发指令
按协议构造报文向服务端下发指令,对照返回结果调试服务端的业务处理逻辑。
校验应答数据格式
捕获服务端返回的原始报文,用 Hex 模式逐字节核对,校验应答数据格式是否符合协议约定。
工控设备联调
模拟工控 TCP 客户端设备,与网关、PLC、上位机程序做联调测试。
长连接稳定性测试
结合自动重连开展长连接的稳定性与断线重连测试,观察链路恢复表现。
Get Started
快速上手
在左侧插件树中找到 TCP 客户端,创建功能实例(可多开)。
填写目标服务端 IP 地址与服务端口(如 192.168.1.100:502)。
点击 Connect 建立连接,日志给出本端与服务端的地址信息。
设置发送与接收模式(Hex 或文本),按需选择字符编码。
输入内容点击 Send 发送,在日志区观察蓝色的发送与绿色的接收记录。
需要观察断线恢复时勾选自动重连;调试完毕点击 Disconnect 断开。
Under the Hood
深入一点 · 技术要点
FAQ
常见问题
Works Well With
与其他插件协同使用
TCP 服务端
本机自建服务端,与 TCP 客户端形成完整的收发闭环测试。主机发现与端口扫描
先扫描确认目标端口开放,再建立 TCP 连接。Modbus 主站
手工构造与观察 Modbus TCP 原始报文,与主站的自动轮询互补。串口调试
串口转 TCP 网关联调:一端串口、一端 TCP,双向验证转发逻辑。
豫公网安备41018402001089号