“配置Nginx以代理WebSocket（WS）和WebSocket Secure（WSS）请求

22天前更新

064837

使用Nginx代理WebSocket（WS）或WebSocket Secure（WSS，即加密的WebSocket）请求通常涉及配置Nginx以正确处理这些升级后的连接。以下是一个基本的步骤指南，介绍如何配置Nginx来代理WS和WSS请求：

1. 安装Nginx和必要的模块

首先，确保你的Nginx服务器已经安装，并且包含了stream模块（对于TCP/UDP代理）或者http模块中的upgrade和websocket支持（对于HTTP/HTTPS代理）。大多数现代Nginx构建都默认包含这些模块。

2. 配置Nginx以代理WebSocket

HTTP/HTTPS代理（WS/WSS）

对于通过HTTP或HTTPS升级的WebSocket连接，你需要在Nginx配置文件中设置一个location块来处理这些请求。这里是一个基本的例子：

http {
    ...
    server {
        ...
        location /ws/ {
            proxy_pass http://backend_server_ws;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "Upgrade";
            proxy_set_header Host $host;
            # 如果后端服务器需要Origin验证，可以添加以下行：
            # proxy_set_header Origin $http_origin;

            # 对于WSS（WebSocket Secure），确保后端服务器支持HTTPS
            # 并且你可能需要配置SSL/TLS以在Nginx和后端服务器之间加密通信
            # 这通常通过stream模块在另一个上下文中配置，但在这个例子中我们假设
            # 后端服务器直接处理WSS连接，而Nginx只负责将请求转发到正确的端口
        }

        # 其他location块和服务器配置...
    }

    # 定义后端服务器（在这个例子中是WebSocket服务器）
    upstream backend_server_ws {
        server backend1.example.com:8080;
        # 可以添加更多服务器以实现负载均衡
        # server backend2.example.com:8080;
    }
    ...
}

在这个配置中，proxy_pass指令指定了后端WebSocket服务器的地址。proxy_http_version 1.1;和proxy_set_header指令是必需的，以确保Nginx正确地处理WebSocket连接升级。

TCP/UDP代理（使用stream模块，适用于非HTTP/HTTPS协议）

如果你的WebSocket连接不是通过HTTP/HTTPS升级的，而是直接通过TCP/UDP建立的，你可能需要使用Nginx的stream模块来配置代理。这里是一个基本的例子：

stream {
    ...
    server {
        listen 12345;  # Nginx监听的端口

        proxy_pass backend_server_ws_tcp:12345;  # 后端WebSocket服务器的地址和端口
        # 注意：这里的端口号应该与后端服务器监听的端口号相匹配
        # 并且这个配置不处理HTTP头部，因为它用于TCP/UDP流量
    }

    # 定义后端服务器组（在这个例子中是TCP WebSocket服务器）
    upstream backend_server_ws_tcp {
        server backend1.example.com:12345;
        # 可以添加更多服务器以实现负载均衡
        # server backend2.example.com:12345;
    }
    ...
}

然而，请注意，直接使用TCP/UDP代理通常不是WebSocket的标准做法，因为WebSocket通常是通过HTTP/HTTPS协议升级的。上面的TCP/UDP代理示例更多是用于其他类型的TCP/UDP应用程序，而不是标准的WebSocket。

3. 处理WSS（WebSocket Secure）

对于WSS（WebSocket Secure），你需要确保Nginx和后端WebSocket服务器之间的通信是加密的。这通常意味着你需要为Nginx配置SSL/TLS证书，以便它能够安全地与后端服务器通信（如果后端服务器也要求加密连接的话）。然而，在大多数情况下，Nginx只负责将WSS请求转发到后端的WS服务器，而后端服务器负责实际的加密和解密工作。

在Nginx配置中，你不需要为WSS做特别的设置，只要确保你的WebSocket服务器能够处理WSS连接，并且Nginx正确地将请求转发到该服务器即可。如果后端服务器需要特定的SSL/TLS配置或证书验证，你可能需要在Nginx的http块中配置这些设置。