本文深入讲解在Node.js中使用内置net和dgram模块实现局域网TCP可靠长连接与UDP无连接数据报/广播通信的原理、完整步骤与实战代码,并详解局域网联调排错关键点。
Node.js使用net和dgram模块实现TCP/UDP局域网通信
时间:2026-11-18
浏览:376
文章目录
在局域网(LAN)环境中实现多台设备互联、进程间数据同步或智能硬件发现时,Node.js 提供了两个无需安装任何外部依赖的原生网络核心模块:负责传输控制协议的 net 模块和负责用户数据报协议的 dgram 模块。net 模块提供基于连接、顺序保障且带有流量控制的可靠双向流式通信;而 dgram 模块则提供轻量、低延迟、面向无连接的数据报投递,并天然具备局域网广播能力。本文将从通信机制、核心 API、代码实装及局域网避坑指南四个维度,系统讲解如何使用这两个模块构建可用的局域网通信系统。
一、局域网网络模型与模块选型依据
局域网通信通常运行在同一个子网或广播域(如家用千兆交换机或机房同网段环境)内,物理丢包率极低且传输延迟通常在毫秒级以内。然而,应用层对数据传输的要求各不相同,直接决定了应该选用 net 还是 dgram 模块:
- TCP(
net模块): 面向连接的流式传输协议。通信双方在传输数据前必须经历“三次握手”建立逻辑会话,内核会负责序列号管理、应答确认(ACK)与重传机制,保证数据不丢、不重、不乱序。适用于业务指令分发、状态同步、文件传输以及需要长会话维持的局域网交互场景。 - UDP(
dgram模块): 无连接的离散数据报协议。发送端直接将携带目标 IP 与端口的 Buffer 数据包交由网卡发出,无需建连和挥手,开销极小。更关键的是,UDP 支持255.255.255.255子网全局广播,这使得局域网节点在未知对端 IP 的情况下能够实现设备自发现与嗅探。
本质理解:TCP 通信操作的是持续流动的“水管(Stream)”,数据本身没有天然的消息边界;UDP 通信操作的是独立的“信封(Datagram)”,每个信封独立封包投递且自带发送方与接收方地址信息。
二、使用 net 模块实现 TCP 局域网可靠通信
在 Node.js 中,net 模块封装了底层操作系统的 Socket 套接字。实现局域网 TCP 通信分为服务端创建与监听、客户端连接与双向事件读写三个关键阶段。
2.1 TCP 服务端搭建与多客户端接入
服务端的核心是 net.createServer(connectionListener)。在局域网中,最关键的一点是将监听地址绑定至 0.0.0.0(监听本机所有网络适配器),而不是默认的本地回环 127.0.0.1。若仅绑定 127.0.0.1,同一局域网下的其他机器发起连接时将会遭遇“Connection Refused”拒绝连接错误。
以下为完整的 TCP 服务端实现代码 tcp_server.js:
// tcp_server.js
const net = require('net');
const PORT = 8080;
const HOST = '0.0.0.0'; // 关键:允许局域网外部设备访问
const server = net.createServer((socket) => {
const clientKey = `${socket.remoteAddress}:${socket.remotePort}`;
console.log(`[TCP Server] 收到来自局域网客户端的连接: ${clientKey}`);
// 设置文本编码,自动将接收到的 Buffer 转换为字符串
socket.setEncoding('utf8');
// 接收客户端数据流
socket.on('data', (data) => {
console.log(`[TCP Server] 收到 [${clientKey}] 的消息: ${data.trim()}`);
// 向客户端回送应答
const reply = `ACK: 已收到指令 [${data.trim()}]\n`;
socket.write(reply);
});
// 客户端正常断开连接
socket.on('end', () => {
console.log(`[TCP Server] 客户端主动断开连接: ${clientKey}`);
});
// 错误捕获(如客户端异常拔线、网络中断等)
socket.on('error', (err) => {
console.error(`[TCP Server] 套接字异常 [${clientKey}]:`, err.message);
});
});
server.listen(PORT, HOST, () => {
console.log(`[TCP Server] 正在监听局域网地址: ${HOST}:${PORT}`);
});
server.on('error', (err) => {
console.error('[TCP Server] 服务端监听故障:', err.message);
});
2.2 TCP 客户端发起连接与会话保持
客户端使用 net.createConnection({ host, port }) 建立与服务端的连接。host 填写服务端在局域网中的实际 IP 地址(例如 192.168.1.100)。
以下为完整的 TCP 客户端实现代码 tcp_client.js:
// tcp_client.js
const net = require('net');
const SERVER_HOST = '192.168.1.100'; // 服务端局域网实际 IP 地址
const SERVER_PORT = 8080;
const client = net.createConnection({ port: SERVER_PORT, host: SERVER_HOST }, () => {
console.log(`[TCP Client] 已成功连接到服务端 ${SERVER_HOST}:${SERVER_PORT}`);
// 发送业务测试数据包,尾部加入换行符以便于边界切分
client.write('HELLO_LAN_SERVER: NODE_DEVICE_01\n');
});
client.setEncoding('utf8');
client.on('data', (data) => {
console.log('[TCP Client] 收到服务端应答:', data.trim());
// 测试完成后可主动优雅关闭
setTimeout(() => {
console.log('[TCP Client] 交互完成,关闭连接');
client.end();
}, 2000);
});
client.on('end', () => {
console.log('[TCP Client] 服务端已关闭连接通道');
});
client.on('error', (err) => {
console.error('[TCP Client] 连接失败或发生错误:', err.message);
});
2.3 必须处理的“流式传输与粘包现象”
初学者在局域网内进行高频小数据包测试时,常常会发现客户端连续调用三次 socket.write(),而服务端的 data 事件却只触发了一次,将三段数据拼在一起接收。这是 TCP 协议栈底层 Nagle 算法合并优化与字节流特性共同决定的,并非 Bug。
解决方案:在应用层引入封包协议,最简单实用的做法包括:
- 特殊分隔符法:每条消息以特定字符(如
或
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。