WebSocket 系列—（1）WebSocket 安装与配置手册

目录

一、WebSocket 概述

二、服务端安装与配置

1. Node.js 环境

安装依赖

创建服务器

启动服务器

2. Java（Spring Boot）环境

Maven 依赖

WebSocket 配置类

处理器类

3. Python（FastAPI + WebSocket）

安装依赖

代码示例

4. C / ESP32 设备端（嵌入式）

三、前端连接配置

浏览器端 JavaScript

使用 Secure WebSocket（wss://）

四、反向代理与 SSL 配置（Nginx）

基本配置

五、调试与验证

使用浏览器开发者工具

使用命令行工具

六、生产部署建议

WebSocket 安装与配置 的详细指南，分别从 前端、后端、服务器部署、调试 四个层面讲解，适用于常见开发场景（如 Node.js、Java、Python、C++/ESP32 等）。

一、WebSocket 概述

WebSocket 是一种基于 TCP 的全双工通信协议，常用于：

• 实时消息推送（IM、聊天室）

• IoT 设备通信（如智能锁）

• 实时监控与控制（如状态面板、报警系统）

• 在线协作与游戏同步

区别于 HTTP：

• HTTP 是无状态的请求-响应

• WebSocket 是持续连接、双向通信

二、服务端安装与配置

1. Node.js 环境

安装依赖

npm install ws

创建服务器

// server.js
const WebSocket = require('ws');
const server = new WebSocket.Server({ port: 8080 });

server.on('connection', (socket) => {
  console.log(' 客户端已连接');
  socket.send('欢迎连接 WebSocket 服务器！');

  socket.on('message', (message) => {
    console.log('收到消息:', message);
    socket.send(`服务端已收到: ${message}`);
  });

  socket.on('close', () => {
    console.log(' 客户端断开连接');
  });
});

console.log(' WebSocket 服务器运行于 ws://localhost:8080');

启动服务器

node server.js

2. Java（Spring Boot）环境

Maven 依赖

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-websocket</artifactId>
</dependency>

WebSocket 配置类

import org.springframework.context.annotation.Configuration;
import org.springframework.web.socket.config.annotation.*;

@Configuration
@EnableWebSocket
public class WebSocketConfig implements WebSocketConfigurer {
  @Override
  public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
    registry.addHandler(new MyWebSocketHandler(), "/ws").setAllowedOrigins("*");
  }
}

处理器类