Nginx将WebSocket ws视频流转换为wss视频流的配置方案

将 WebSocket (ws) 转换为安全 WebSocket (wss)，核心在于在通信链路中加入 SSL/TLS 加密层。

通常有两种实现方案：

1. 反向代理方案（推荐）：使用 Nginx 或 Caddy 作为边缘代理，处理 SSL 卸载。
2. 应用层方案：直接在 Node.js/Python/Go 后端代码中配置 SSL 证书。

以下是工业界最常用的 Nginx 反向代理方案。

方案一：使用 Nginx 作为 WSS 代理

这种方式无需修改后端视频流业务代码，性能最高，且方便管理证书。

1. 准备工作

• 你已经有一个运行在 ws://localhost:8080 的视频流服务。
• 你拥有域名（例如 video.example.com）。
• 你拥有 SSL 证书（cert.crt 和 key.key）。

2. Nginx 配置 (/etc/nginx/conf.d/video.conf)

在 Nginx 中，你需要配置一个监听 443 端口的 server 块，并将 wss 请求转发给后端的 ws 服务。

server {
    listen 443 ssl;
    server_name video.example.com;
    # 配置 SSL 证书
    ssl_certificate     /etc/nginx/ssl/video.example.com.crt;
    ssl_certificate_key /etc/nginx/ssl/video.example.com.key;
    # SSL 优化配置（可选）
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    location / {
        # 转发到后端 ws 服务
        proxy_pass http://127.0.0.1:8080;
        # WebSocket 关键头配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        # 传递客户端真实 IP
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        # 解决视频流延迟问题
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
    }
}

3. 为什么这样配置有效？

• SSL 卸载：客户端访问 wss://video.example.com，Nginx 负责进行 TLS 解密。
• 协议转换：Nginx 将解密后的数据通过内部 HTTP 连接转发给后端 ws://127.0.0.1:8080。
• Header 处理：Upgrade 和 Connection 字段是 WebSocket 建立连接的核心，告诉 Nginx 这是一个长连接。

方案二：如果你使用 Node.js 直接部署 (HTTPS 模块)

如果你的后端是 Node.js (例如 ws 库)，你也可以直接在代码中加载证书：

const fs = require('fs');
const https = require('https');
const WebSocket = require('ws');
// 加载证书
const server = https.createServer({
  cert: fs.readFileSync('/path/to/cert.crt'),
  key: fs.readFileSync('/path/to/key.key')
});
const wss = new WebSocket.Server({ server });
wss.on('connection', (ws) => {
  console.log('客户端已连接');
  // 这里处理视频流逻辑
});
server.listen(8443); // 此时访问 wss://your-ip:8443

常见避坑指南

1. 混合内容错误 (Mixed Content)：
   • 如果你的前端网页是通过 https 加载的，你绝对不能在代码中使用 ws://，否则浏览器会因安全策略拦截。必须使用 wss://。
2. 证书链问题：
   • 使用 Nginx 时，ssl_certificate 必须包含完整的证书链（包含中间证书），否则移动端或部分浏览器会报 Self-signed certificate 错误。
3. 连接超时：
   • 如果是长时视频流，确保 Nginx 的 proxy_read_timeout 设置足够大，否则 Nginx 会自动断开 60 秒后没有数据包的连接。
4. 防火墙：
   • 确保服务器的防火墙（ufw 或 firewalld）开放了 443 端口。

建议：生产环境强烈推荐使用 方案一 (Nginx)，因为 Nginx 处理高并发连接的能力远高于 Node.js 或 Python 自带的 HTTP 服务，且更易于维护 SSL 证书的更新。

到此这篇关于Nginx将WebSocket ws视频流转换为wss视频流的配置方案的文章就介绍到这了,更多相关Nginx WebSocket ws视频流转为wss内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！