### 将 Docker 中的 WebSocket 协议从 ws 更改为 wss 的配置方案 为了将 Docker 容器中的 WebSocket (WS) 连接升级到安全版本 WSS，需要完成以下几个方面的调整： #### 1. 修改 Nginx 配置支持 WSS WSS 是基于 SSL/TLS 加密的安全版 WebSocket。因此，Nginx 需要启用 HTTPS 并代理 WSS 请求。 以下是针对 WSS 的 Nginx 配置示例： ```nginx server { listen 443 ssl; server_name your-domain.com; # SSL 配置 ssl_certificate /etc/nginx/ssl/server.crt; ssl_certificate_key /etc/nginx/ssl/server.key; ssl_session_timeout 5m; ssl_protocols TLSv1.2 TLSv1.3; # 推荐仅使用现代协议 ssl_ciphers HIGH:!aNULL:!MD5; ssl_prefer_server_ciphers on; location /ws/ { proxy_pass http://localhost:8088/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; proxy_set_header Host $host; proxy_ssl_verify off; # 如果后端是本地容器可禁用验证 } } ``` 此配置中启用了 `listen 443 ssl` 和必要的 SSL 参数[^2]。同时，通过设置 `proxy_set_header Upgrade` 和 `Connection "Upgrade"` 来确保 WebSocket 握手正常工作。 --- #### 2. 更新 Docker Compose 文件以挂载证书文件 如果使用 Docker Compose，则需更新 `docker-compose.yml` 文件以便将 SSL 证书挂载至运行 Nginx 的容器中。 以下是一个典型的 Docker Compose 配置片段： ```yaml version: '3' services: nginx: image: nginx:latest ports: - "443:443" volumes: - ./nginx.conf:/etc/nginx/nginx.conf - ./ssl/:/etc/nginx/ssl/ networks: - app-network networks: app-network: driver: bridge ``` 在此配置中，SSL 证书被挂载到了 `/etc/nginx/ssl/` 路径下，供 Nginx 使用[^2]。 --- #### 3. 后端 WebSocket 服务的支持 确保 WebSocket 服务器能够处理加密连接请求。通常情况下，WebSocket 库会自动适配来自前端的握手协议（无论是 WS 还是 WSS）。例如，在 Node.js 中可以通过如下方式监听消息并响应： ```javascript const WebSocket = require('ws'); const wss = new WebSocket.Server({ port: 8088 }); wss.on('connection', function connection(ws) { console.log('Client connected'); ws.on('message', function incoming(message) { console.log(`Received message => ${message}`); ws.send(`Echo: ${message}`); // 响应消息 }); }); ``` 注意：无需额外修改代码即可兼容 WSS，因为实际通信仍由反向代理（如 Nginx）负责解密和转发[^3]。 --- #### 4. 测试 WSS 连接 测试完成后，可通过浏览器开发者工具或命令行工具确认 WSS 是否成功建立连接。例如，使用 JavaScript 创建 WSS 客户端实例： ```javascript const socket = new WebSocket('wss://your-domain.com/ws/'); socket.addEventListener('open', () => { console.log('Connected to WSS server'); socket.send('Hello Server!'); }); socket.addEventListener('message', event => { console.log(`Message from server: ${event.data}`); }); ``` --- ### 总结 通过上述步骤可以顺利将 Docker 环境下的 WebSocket 从不安全的 WS 切换为安全的 WSS。核心在于正确配置 Nginx 支持 HTTPS/WSS，并确保后端 WebSocket 服务能正常接收和解析加密流量。 ---