当前位置：首页 > 文章列表 > 文章 > 前端 > HTTPS网站部署WSS服务器教程

HTTPS网站部署WSS服务器教程

2026-02-15 15:09:49 0浏览收藏

本文深入剖析了WSS连接失败的根本原因——浏览器强制要求wss://必须基于真实HTTPS服务进行TLS加密通信，而非简单复用HTTP服务；并提供了一套完整、可落地的解决方案：从正确使用https.createServer集成SSL证书、精准监听upgrade事件处理WebSocket升级，到客户端URL严格匹配、生产环境推荐Nginx反向代理卸载SSL的健壮架构，手把手教你绕过常见误区，让wss://连接稳定可靠、符合安全规范。

如何在 HTTPS 网站上正确部署 WebSocket 服务器（WSS）

本文详解为何 `wss://` 连接失败的根本原因，并提供完整、可运行的 Express + WebSocket（ws）服务端配置方案，涵盖 HTTPS 证书集成、端口复用、升级处理及客户端连接要点。

WebSocket 客户端使用 wss:// 协议时，必须通过 HTTPS 服务器进行 TLS 加密通信，而不能直接复用纯 HTTP 服务或未配置证书的 http.createServer()。你原代码中调用 http.createServer(app).listen() 启动的是明文 HTTP 服务，却试图让浏览器以安全协议 wss:// 连接 —— 浏览器会直接拒绝握手，抛出 WebSocket connection failed 错误，这是由浏览器安全策略强制执行的，无法绕过。

✅ 正确做法：复用 HTTPS 服务并显式处理 Upgrade 请求

你需要：

使用 https.createServer() 启动主服务，传入 SSL 私钥（.key）和证书（.crt 或 .pem）；
将 Express 应用挂载到该 HTTPS 服务上；
监听 'upgrade' 事件，在收到 WebSocket 升级请求时，交由 wss.handleUpgrade() 处理（而非在路由中调用）；
确保前端 WebSocket 构造函数 URL 与服务端 HTTPS 域名、路径、协议完全一致。

以下是修复后的完整服务端代码（server.js）：

const fs = require('fs');
const https = require('https');
const express = require('express');
const WebSocket = require('ws');

const app = express();
const wss = new WebSocket.Server({ noServer: true });

// ✅ 关键：读取真实 SSL 证书（请替换为你的实际路径）
const httpsOptions = {
  key: fs.readFileSync('/etc/letsencrypt/live/example.com/privkey.pem'),
  cert: fs.readFileSync('/etc/letsencrypt/live/example.com/fullchain.pem')
};

// ✅ 使用 https.createServer，而非 http
const server = https.createServer(httpsOptions, app);

// ✅ 暴露 /multiplayerChat2/ 路由仅作“触发升级”的入口（返回 200 即可）
app.get('/multiplayerChat2/', (req, res) => {
  res.status(200).send('WebSocket endpoint ready. Connect via wss://example.com/multiplayerChat2/');
});

// ✅ 监听 upgrade 事件，精准匹配路径后交由 wss 处理
server.on('upgrade', (req, socket, head) => {
  if (req.url === '/multiplayerChat2/') {
    wss.handleUpgrade(req, socket, head, (ws) => {
      console.log('✅ Client connected via WSS');
      ws.on('message', (data) => {
        const msg = data.toString('utf8').substring(0, 50);
        wss.clients.forEach(client => {
          if (client.readyState === WebSocket.OPEN) {
            client.send(msg);
          }
        });
      });
      ws.on('close', () => console.log('❌ Client disconnected'));
      ws.on('error', (err) => console.error('WebSocket error:', err));
    });
  } else {
    socket.destroy(); // 拒绝非目标路径的升级请求
  }
});

// ✅ 绑定到标准 HTTPS 端口（443），需 root 权限；生产环境建议用反向代理（如 Nginx）卸载 SSL
const PORT = process.env.PORT || 443;
server.listen(PORT, () => {
  console.log(`✅ HTTPS + WSS server running on https://example.com:${PORT}`);
});

? 客户端注意事项（关键修正）

确保 WebSocket URL 中的域名与证书绑定域名完全一致（如 wss://example.com，不能是 www.example.com 除非证书也覆盖它）；
若使用 Let’s Encrypt，推荐通配符证书或 SAN 证书包含所有子域；
开发调试时可临时用 wss://localhost:443 + 自签名证书（需手动信任），但生产环境必须使用权威 CA 签发证书；
浏览器控制台 → Security 标签页可验证当前页面是否为“Secure context”，只有 secure context 才允许 wss://。

⚠️ 常见误区澄清

错误做法	正确做法
http.createServer().listen(443)	必须用 https.createServer(options)，HTTP 无法承载 WSS
在 app.get() 内调用 wss.handleUpgrade()	handleUpgrade 必须在 'upgrade' 事件中调用，否则无 socket 和 head 参数
未校验 req.url 就处理所有 upgrade	攻击者可伪造任意路径升级请求，务必白名单校验
用 process.env.PORT 但未配置反代或权限	若直接监听 443，Node 进程需 sudo；更佳实践是用 Nginx 反向代理：Nginx 终止 SSL → 转发 ws://localhost:8080 到 Node

✅ 推荐生产架构（免 root & 高可靠）

# Nginx 配置片段（/etc/nginx/sites-available/example.com）
location /multiplayerChat2/ {
  proxy_pass http://localhost:8080;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
}

此时 Node 监听 localhost:8080（无需证书），Nginx 负责 HTTPS 终止与 WebSocket 协议升级转发 —— 安全、灵活、符合运维规范。

至此，你的 wss://example.com/multiplayerChat2/ 将稳定建立连接。记住核心原则：WSS 不是独立服务，而是 HTTPS 连接上的协议升级通道，一切必须围绕 HTTPS 服务构建。

以上就是《HTTPS网站部署WSS服务器教程》的详细内容，更多关于的资料请关注golang学习网公众号！