首页 插件模块

TCP 客户端

TCP 客户端

TCP CLIENT |
网络通信
主动向服务端发起连接并双向收发——验证「我的程序能不能和某个 TCP 服务对上话」的第一件工具。
自动重连
Hex / 文本双模式
彩色日志

Overview

总体概览

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

Screenshots

界面预览

TCP 客户端 界面
TCP 客户端 界面
TCP 客户端 界面

Highlights

特性速览

填写 IP 与端口即可发起连接,按钮随连接状态自动切换

发送与接收的 Hex / 文本模式独立设置,标签随模式同步变化

五种字符编码:UTF-8 / ASCII / Unicode / GB2312 / ANSI(跟随操作系统)

可勾选自动重连,完整记录重连次数与重连失败信息

毫秒级彩色日志:发送蓝、接收绿、状态黑、错误红,每条标注字节数

Hex 输入自动忽略空格,长度为奇数时明确提示 Data Length Error

支持多开实例,同时连接多个服务端进行对比调试

Features

核心特性

01
连接管理

填写目标服务端 IP 地址与服务端口后点击 Connect 发起连接请求;连接成功后日志给出本端与服务端的地址信息,按钮自动切换为断开状态,点击 Disconnect 主动断开。连接与断开状态一目了然,避免误操作。

02
双模式数据收发

发送与接收的数据可以分别以 Hex 字符串或文本字符串展示与发送,两种模式可独立设置,标签随模式切换同步变化。Hex 模式便于直接粘贴设备手册中分段带空格的报文,输入时空格会被自动忽略;文本模式适合 AT 指令、JSON 等文本协议。当输入长度为奇数时会明确提示 Data Length Error。

03
多编码支持

使用文本字符串与服务端通信时,可以选择字符编码:UTF-8、ASCII、Unicode、GB2312 与 ANSI(跟随操作系统)。与使用 GB2312 编码的设备通信时切换到对应编码,中文即可正确解析显示。

04
自动重连

勾选自动重连后,连接被服务端关闭或网络中断时会在后台持续尝试重连,并完整记录重连次数与重连失败信息,方便观察设备或链路的断线恢复行为,适合长连接的稳定性与断线重连测试。

05
毫秒级彩色日志

收发日志带毫秒级时间戳并按事件着色——发送为蓝色、接收为绿色、状态为黑色、错误为红色;每条收发记录都标注字节数,便于核对报文完整性。

Scenarios

典型使用场景

验证 TCP 服务端连通性

排查连接失败、端口不通、握手异常等网络问题:先确认服务在线,再逐层排查防火墙与路由。

模拟业务客户端下发指令

按协议构造报文向服务端下发指令,对照返回结果调试服务端的业务处理逻辑。

校验应答数据格式

捕获服务端返回的原始报文,用 Hex 模式逐字节核对,校验应答数据格式是否符合协议约定。

工控设备联调

模拟工控 TCP 客户端设备,与网关、PLC、上位机程序做联调测试。

长连接稳定性测试

结合自动重连开展长连接的稳定性与断线重连测试,观察链路恢复表现。

Get Started

快速上手

7

在左侧插件树中找到 TCP 客户端,创建功能实例(可多开)。

7

填写目标服务端 IP 地址与服务端口(如 192.168.1.100:502)。

7

点击 Connect 建立连接,日志给出本端与服务端的地址信息。

7

设置发送与接收模式(Hex 或文本),按需选择字符编码。

7

输入内容点击 Send 发送,在日志区观察蓝色的发送与绿色的接收记录。

7

需要观察断线恢复时勾选自动重连;调试完毕点击 Disconnect 断开。

Under the Hood

深入一点 · 技术要点

基于 .NET 异步 Socket 通信模型(封装于通信层的 TcpClient 配置与端口抽象)。收发数据经事件回调投递,不阻塞界面;日志经有界通道异步投递并线程安全地刷新界面,保证高吞吐下界面不卡顿。Hex 字符串到字节数组的转换要求偶数长度,这是协议调试工具的通用约定。

FAQ

常见问题

连接失败怎么办?
发送了数据但没有响应?
接收到的中文乱码?
Hex 模式提示 Data Length Error?
自动重连会一直重试吗?

Works Well With

与其他插件协同使用

TCP 服务端

本机自建服务端,与 TCP 客户端形成完整的收发闭环测试。

主机发现与端口扫描

先扫描确认目标端口开放,再建立 TCP 连接。

Modbus 主站

手工构造与观察 Modbus TCP 原始报文,与主站的自动轮询互补。

串口调试

串口转 TCP 网关联调:一端串口、一端 TCP,双向验证转发逻辑。

想要更完整的技术细节?

完整文档包含功能详解、进阶技巧、技术原理与常见问题,与源码一一对应。
查看完整 README
An unhandled error has occurred. Reload

连接已中断

当前会话仍然保持,我们将持续尝试恢复连接。

正在重新连接服务器…

重连失败,将在 秒后重试。

重连失败。请重试或刷新页面。

会话已被服务器暂停。

恢复会话失败。请重试或刷新页面。