Nginx实战：为SignalR配置WebSocket代理与负载均衡

1. 为什么需要为SignalR配置WebSocket代理

SignalR是一个强大的实时通信库，它允许服务器端代码即时推送内容到连接的客户端。在实际应用中，SignalR会自动选择最佳的传输方式，优先尝试WebSocket，如果不可用则降级到Server-Sent Events或长轮询。而Nginx作为高性能的反向代理服务器，需要正确配置才能支持这些传输协议。

我遇到过不少开发者反映SignalR连接不稳定，经常莫名其妙断开。排查后发现90%的问题都出在Nginx配置上。最常见的就是忘记配置WebSocket协议升级，导致SignalR被迫使用低效的长轮询方式。WebSocket相比传统HTTP最大的优势在于它是全双工通信，建立连接后服务端可以主动推送数据，避免了HTTP的请求-响应模式带来的延迟。

2. 基础配置：让Nginx支持WebSocket

2.1 核心配置解析

要让Nginx正确代理WebSocket连接，关键是要处理HTTP协议升级。下面这个配置片段是SignalR正常工作所需的最低配置：

nginx复制http {
    map $http_connection $connection_upgrade {
        "~*Upgrade" $http_connection;
        default keep-alive;
    }
    
    server {
        listen 80;
        server_name yourdomain.com;
        
        location /chatHub {
            proxy_pass http://backend;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            proxy_http_version 1.1;
        }
    }
}

这里有几个关键点需要注意：

1. map指令用于动态设置Connection头，当客户端请求升级到WebSocket协议时，保留原始的Connection头值
2. proxy_set_header Upgrade $http_upgrade将客户端的Upgrade头传递给后端服务器
3. proxy_http_version 1.1强制使用HTTP/1.1，因为WebSocket协议需要HTTP/1.1支持

2.2 常见问题排查

在实际部署中，我经常遇到以下几个问题：

1. 连接无法升级到WebSocket：检查Nginx错误日志，通常能看到"400 Bad Request"