Node-RED中WebSocket反向代理配置指南

问题背景

在使用Node-RED时，许多开发者会选择通过Nginx反向代理来提供HTTPS访问支持。然而，当配置完成后，虽然能够正常登录Node-RED界面，但在实际使用过程中却会遇到WebSocket连接失败的问题，导致调试侧边栏等功能无法正常工作。

问题分析

Node-RED编辑器与后端服务之间通过WebSocket协议进行实时通信，主要用于传递调试侧边栏中的消息等内容。当使用Nginx作为反向代理时，默认配置仅处理普通的HTTP/HTTPS请求，而没有正确处理WebSocket协议的升级请求。

解决方案

要使Nginx正确代理WebSocket连接，需要在Nginx配置文件中添加特定的头部信息。以下是完整的Nginx配置示例：

server {
    listen 443 ssl;
    server_name nodered.example.com;

    ssl_certificate /path/to/certificate.crt;
    ssl_certificate_key /path/to/private_key.key;

    location / {
        proxy_pass https://localhost:1880;
        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_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

关键配置说明

1. proxy_set_header Upgrade $http_upgrade：这个指令将客户端的Upgrade头部传递给后端服务器
2. proxy_set_header Connection "upgrade"：这个指令明确告诉Nginx处理连接升级请求

配置验证

修改配置后，需要执行以下步骤确保配置生效：

1. 检查Nginx配置语法是否正确：nginx -t
2. 重新加载Nginx配置：nginx -s reload
3. 在浏览器中访问Node-RED并检查开发者工具中的网络请求，确认WebSocket连接已建立

扩展知识

WebSocket协议通过在HTTP/HTTPS连接基础上进行协议升级来实现全双工通信。在Node-RED中，WebSocket主要用于：

• 实时显示调试信息
• 节点状态更新
• 编辑器与运行时的交互

理解这一机制有助于更好地配置和维护Node-RED的生产环境部署。