Node.js使用net和dgram模块实现TCP/UDP局域网通信

作者:星河时间:2026-11-18 09:01:50浏览:377

本文深入讲解在Node.js中使用内置net和dgram模块实现局域网TCP可靠长连接与UDP无连接数据报/广播通信的原理、完整步骤与实战代码,并详解局域网联调排错关键点。

在局域网(LAN)环境中实现多台设备互联、进程间数据同步或智能硬件发现时,Node.js 提供了两个无需安装任何外部依赖的原生网络核心模块:负责传输控制协议的 net 模块和负责用户数据报协议的 dgram 模块。net 模块提供基于连接、顺序保障且带有流量控制的可靠双向流式通信;而 dgram 模块则提供轻量、低延迟、面向无连接的数据报投递,并天然具备局域网广播能力。本文将从通信机制、核心 API、代码实装及局域网避坑指南四个维度,系统讲解如何使用这两个模块构建可用的局域网通信系统。

Node.js使用net和dgram模块实现TCP/UDP局域网通信
缩略示意:Node.js 局域网网络通信核心模块 net 与 dgram 全景

一、局域网网络模型与模块选型依据

局域网通信通常运行在同一个子网或广播域(如家用千兆交换机或机房同网段环境)内,物理丢包率极低且传输延迟通常在毫秒级以内。然而,应用层对数据传输的要求各不相同,直接决定了应该选用 net 还是 dgram 模块:

  • TCP(net 模块): 面向连接的流式传输协议。通信双方在传输数据前必须经历“三次握手”建立逻辑会话,内核会负责序列号管理、应答确认(ACK)与重传机制,保证数据不丢、不重、不乱序。适用于业务指令分发、状态同步、文件传输以及需要长会话维持的局域网交互场景。
  • UDP(dgram 模块): 无连接的离散数据报协议。发送端直接将携带目标 IP 与端口的 Buffer 数据包交由网卡发出,无需建连和挥手,开销极小。更关键的是,UDP 支持 255.255.255.255 子网全局广播,这使得局域网节点在未知对端 IP 的情况下能够实现设备自发现与嗅探。
Node.js使用net和dgram模块实现TCP/UDP局域网通信
图 1:net (TCP) 面向连接管道与 dgram (UDP) 离散数据报的局域网架构对比

本质理解: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);
});
Node.js使用net和dgram模块实现TCP/UDP局域网通信
图 2:net 模块 TCP 建立、全双工交互与断开的生命周期时序流程

2.3 必须处理的“流式传输与粘包现象”

初学者在局域网内进行高频小数据包测试时,常常会发现客户端连续调用三次 socket.write(),而服务端的 data 事件却只触发了一次,将三段数据拼在一起接收。这是 TCP 协议栈底层 Nagle 算法合并优化与字节流特性共同决定的,并非 Bug。

解决方案:在应用层引入封包协议,最简单实用的做法包括:

  1. 特殊分隔符法:每条消息以特定字符(如 或
作者最新文章
相关文章
更多