TCP 服务端监听配置与多连接管理

什么是 TCP Server 模式

TCP Server 模式让 NetAssist 在指定的本地端口上"监听"，等待远程客户端主动发起连接。这是联调中最常用的场景之一：当你开发一个客户端程序，需要它连接到一个服务端时，可以用 NetAssist 先充当这个服务端，观察客户端发过来的请求数据。

基本配置步骤

1. 在"协议类型"下拉菜单中选择 TCP Server。
2. 在"本地主机地址"中填写监听地址。

• 填写 127.0.0.1 只允许本机连接。
• 填写 0.0.0.0 或留空表示监听所有网卡，允许局域网和外部访问。
• 有多个网卡时可以指定具体网卡的 IP。

1. 在"本地主机端口"中填写一个未被占用的端口号（1 - 65535）。
2. 点击左侧 打开 按钮启动监听。

启动成功后，状态区会显示"监听中"，此时外部客户端可以通过 IP:端口 连接进来。

多连接管理

NetAssist 的 TCP Server 支持同时接受多个客户端连接。每个客户端连接会在左侧列表中单独显示远端地址和端口。

• 点击列表中的某个连接，可以将它设为当前活跃连接，收发数据都针对这个连接进行。
• 接收区收到的数据包会标记来源客户端，方便区分。
• 右键列表可以断开指定连接，或清空所有连接。

对于压力测试场景，多连接管理功能允许同时观察多个客户端的请求行为。

IPv6 监听

V5.0.9.0 及以上版本全面支持 IPv6。在启用 IPv6 的网络中，可以在本地主机地址处填写 IPv6 地址（如 ::1 表示 IPv6 本地回环），其他配置步骤与 IPv4 完全一致。

常见问题

端口被占用怎么办？

Windows 自带命令可以查看：打开命令提示符，输入 netstat -ano | findstr <端口号>，可以看到哪个进程占用了该端口。结束那个进程，或者换一个端口即可。

客户端连接不上？

先检查以下几点：

• Windows 防火墙是否放行了 NetAssist 的入站连接。首次启动监听时系统可能弹窗询问，建议允许专用网络。
• 本地主机地址是否填错。127.0.0.1 只能本机访问，外部连不上。
• 端口号是否填对，客户端连接时的目标地址和端口要与这里完全匹配。

防火墙管控

V5.15 新增的 TCP Server 防火墙功能，可以在服务端侧设置黑白名单，只有白名单内的客户端 IP 才能接入，黑名单内的 IP 会被直接拒绝。详见 TCP 防火墙黑白名单。