在容器环境中配置 nginx 代理 websocket,核心在于修改 `nginx.conf` 以支持 http 1.1 升级机制。具体做法是定位到 `location` 块,设置 `proxy_pass` 指向后端服务,并添加 `upgrade` 和 `connection` 头部映射。这样配置后,nginx 就能正确处理从 http 切换到 websocket 协议的请求,保持长连接稳定。

Nginx 配置文件中的关键参数有哪些
关键参数包括 proxy_http_version、proxy_set_header Upgrade 和 proxy_set_header Connection。这些参数告诉 Nginx 使用 HTTP/1.1 协议进行代理,并将客户端的升级请求头原样传递给后端服务器。

server {
listen 80;
server_name example.com;
location /ws {
proxy_pass http://backend:3000;
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;
}
}
上述配置中,proxy_http_version 1.1 是必须的,因为 WebSocket 握手需要 HTTP/1.1 支持。$http_upgrade 变量会捕获客户端发送的 Upgrade: websocket 头,而 Connection "upgrade" 则确保连接被正确标记为可升级。如果客户端不发送 Upgrade 头,$http_upgrade 为空,但 Connection 仍设为 upgrade,这通常不会导致问题,因为后端通常会忽略空的 Upgrade 头或仅在有 Upgrade 时才切换协议。更严谨的做法是使用条件判断,但在大多数标准配置中,直接设置即可。
如何验证 WebSocket 代理是否正常工作
可以通过编写一个简单的测试脚本来验证。创建一个前端页面或使用命令行工具如 wscat 连接到配置的 Nginx 地址,观察连接是否建立成功以及消息是否能双向传输。
可水平扩展的 WebSocket 中心模式,支持懒加载 Redis 订阅、连接注册表和优雅关闭。适用于构建可跨多实例扩展的实时 WebSocket 服务器。

// 简单的 Node.js 测试脚本示例
const WebSocket = require('ws');
const ws = new WebSocket('ws://example.com/ws');
ws.on('open', () => {
console.log('Connected to WebSocket server');
ws.send('Hello Server');
});
ws.on('message', (data) => {
console.log('Received:', data.toString());
ws.close();
});
ws.on('error', (err) => {
console.error('WebSocket Error:', err);
});
运行此脚本,如果看到 Connected to WebSocket server 和接收到的消息,说明代理配置正确。如果连接失败或超时,检查 Nginx 错误日志和后端服务状态。确保后端服务监听的是正确的端口,并且防火墙规则允许流量通过。
当后端服务返回非 101 状态码时如何处理
如果后端服务没有正确响应 101 Switching Protocols,WebSocket 握手将失败。此时,Nginx 会将后端返回的错误页面(通常是 HTML)作为响应体返回给客户端。开发者应检查后端服务的日志,确认其是否正确处理了 WebSocket 升级请求。此外,可以配置 Nginx 的 proxy_intercept_errors 来拦截后端错误,但这通常用于 HTTP 错误,对于 WebSocket 握手失败,主要依赖后端服务的正确实现。










