计算机网络 / 系统课时

用 Node.js 启动 WebSocket 服务

用 Node.js 启动 WebSocket 服务

这一节会用 Node.js 和 ws 搭出一个最小可运行的回显服务:浏览器建立连接后发送一条文本消息,服务端接收并原样返回。完成后你能从终端和浏览器控制台同时确认连接、收发与关闭行为。

学习目标

  • 安装 ws 并启动一个监听 WebSocket 连接的 Node.js 服务
  • 处理连接、消息、错误和关闭事件,并完成消息回传
  • 使用浏览器原生 WebSocket 对象验证端到端通信

准备项目

先在一个空目录中初始化 Node.js 项目并安装 ws。ws 用于 Node.js 侧的 WebSocket 客户端与服务端实现;浏览器侧应直接使用浏览器原生 WebSocket 对象。([GitHub][1])

bash
npm init -y
npm install ws

预期结果

text
npm 命令正常结束,package.json 的 dependencies 中包含 ws。

安装日志中的包数量和版本号会随时间变化,只要没有出现安装错误即可继续。

编写最小回显服务

新建 server.js,使用固定教学端口 8080。收到文本或二进制消息后,服务端把同一份数据发回客户端;错误事件单独监听,避免连接错误变成未处理异常。

js
const { WebSocketServer } = require('ws');

const wss = new WebSocketServer({ port: 8080 });

wss.on('connection', (socket, request) => {
  const remoteAddress = request.socket.remoteAddress || '<unknown>';
  console.log(`client connected: ${remoteAddress}`);

  // 连接级错误必须显式处理,便于定位异常断开。
  socket.on('error', (error) => {
    console.error('socket error:', error.message);
  });

  socket.on('message', (data, isBinary) => {
    const logValue = isBinary ? '<binary>' : data.toString();
    console.log(`received: ${logValue}`);

    // 保留原始数据和消息类型,构成最小 echo 行为。
    socket.send(data, { binary: isBinary });
  });

  socket.on('close', () => {
    console.log('client disconnected');
  });
});

wss.on('listening', () => {
  console.log('WebSocket server listening on ws://localhost:8080');
});

wss.on('error', (error) => {
  console.error('server error:', error.message);
});

这段代码的核心只有两层事件:WebSocketServer 负责接受连接,每个 socket 负责处理该连接上的消息。真实项目通常会在消息处理前增加鉴权、协议解析和参数校验,但首个可运行版本先把通信链路跑通。

启动并验证消息回传

在项目目录启动服务:

bash
node server.js

预期输出

text
WebSocket server listening on ws://localhost:8080

保持终端运行,然后打开任意浏览器页面的开发者工具控制台,执行下面的浏览器端代码:

js
const socket = new WebSocket('ws://localhost:8080');

socket.addEventListener('open', () => {
  socket.send('hello websocket');
});

socket.addEventListener('message', (event) => {
  console.log('echo:', event.data);
});

预期输出

text
echo: hello websocket

服务端终端同时会出现类似结果,其中客户端地址的实际值可能不同:

text
client connected: <IP>
received: hello websocket

如果再在浏览器控制台执行 socket.close(),服务端应打印 client disconnected。到这里,连接建立、客户端发送、服务端接收、服务端回传四个关键环节已经全部验证。

典型失败怎么定位

出现 EADDRINUSE 时,说明 8080 已被其他进程占用,可以关闭占用进程,或把服务端和浏览器端地址一起改成另一个端口。若浏览器立即报连接失败,先确认 node server.js 仍在运行,再核对协议、主机名和端口是否一致。

若页面本身通过 HTTPS 加载,生产环境通常应使用 wss://,并由 HTTPS 服务或反向代理终止 TLS;不要把本地的 ws://localhost:8080 配置直接照搬到公网。最小回显服务只用于验证链路,真正业务还应继续补上鉴权、消息格式校验、心跳与重连策略。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Node.js 启动 WebSocket 服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通