Nginx反向代理WebSocket(wss)

WebSocket 是一种类似 HTTP 协议的协议，建立在 TCP 协议之上。它能实现双向通信，传输数据更加实时和高效，通常用于实现实时通信和推送服务。

WebSocket 的连接方式需要和 HTTP 略有不同，因此在 Nginx 中需要进行特殊的配置，以实现反向代理 WebSocket（wss）连接。

配置 WebSocket（wss）服务

在进行反向代理之前，我们需要首先配置原始的 WebSocket（wss）服务。本文以 Node.js 的 WebSocket 库 socket.io 为例进行说明。

const app = require('http').createServer(handler);
const io = require('socket.io')(app);

app.listen(3000);

function handler (req, res) {
  res.writeHead(200);
  res.end('Hello World!');
}

io.on('connection', (socket) => {
  console.log('a user connected');

  socket.on('chat message', (msg) => {
    console.log('message: ' + msg);
    io.emit('chat message', msg);
  });

  socket.on('disconnect', () => {
    console.log('user disconnected');
  });
});

在上面的代码中，我们创建了一个 HTTP 服务器并使用 socket.io 库实现了一个最基本的聊天室应用程序。在客户端连接到服务端时会打印出一条日志信息，客户端发送消息时会将消息广播给所有客户端，客户端断开连接时也会打印出一条日志信息。

配置 Nginx 反向代理

接下来我们将使用 Nginx 实现反向代理 WebSocket（wss）连接。在 Nginx 中需要配置 proxy_http_version、proxy_set_header 和 proxy_pass 等参数，以实现正确的反向代理。

在 Nginx 的配置文件中，添加以下内容：

location /socket.io/ {
  proxy_pass http://localhost:3000/socket.io/;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "Upgrade";
}

在上面的配置中，我们指定了请求路径以 /socket.io/ 开头的请求将被反向代理到 http://localhost:3000/socket.io/ 上。proxy_http_version 指定了使用的 HTTP 版本为 1.1，proxy_set_header Upgrade $http_upgrade; 和 proxy_set_header Connection "Upgrade"; 则指定了使用的协议为 WebSocket。

测试

在正确配置了 WebSocket（wss）服务和 Nginx 反向代理后，我们可以开始测试连接。

在客户端使用以下代码进行连接：

const socket = io('wss://your.domain.com/socket.io/', {
  path: '/socket.io',
  transports: ['websocket']
});

socket.on('connect', () => {
  console.log('connected');
});

socket.on('chat message', (msg) => {
  console.log(msg);
});

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

socket.emit('chat message', 'hello world');

将 your.domain.com 替换为你的域名，并确保域名解析正确。

在客户端连接成功后，可以发送消息，消息会被广播给所有客户端。

小结

通过 Nginx 的反向代理技术，我们可以实现 WebSocket（wss）协议的反向代理和负载均衡，从而更加高效地支持实时通信和推送服务。

在进行配置时，需要注意参数的正确性，以避免连接失败或者损坏的问题。