-
安装Nginx:
首先,确保您安装了最新版本的Nginx,因为Websocket支持通常在较新版本中表现更佳。 -
设置HTTP升级头:
当Websocket客户端请求与服务器建立连接时,它会发送一个HTTP请求,请求中含有Upgrade: websocket
和Connection: upgrade
头。Nginx需要侦听并理解这些头部以实现正确的协议升级。在Nginx配置(例如,在/etc/nginx/nginx.conf
或特定站点配置文件中)中,确保包含以下指令:map $http_upgrade $connection_upgrade {default upgrade;'' close; }
这里定义了一个映射,将
$http_upgrade
变量的值转换为一个新变量$connection_upgrade
。 -
配置服务器块:
将相应的服务器块(server
)配置添加到Nginx设置中。确保指定正确的服务器名(server_name
)以及监听的端口(通常是80用于HTTP或443用于HTTPS)。在该服务器块中添加location块,以处理特定路径(例如/ws
)的Websocket连接请求。server {listen 80;server_name your_websocket_server.com;location /ws {proxy_pass http://websocket_backend; # 转发到后端WebSocket服务proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection $connection_upgrade;proxy_set_header Host $host;# 当使用Websocket时,通常您需要适合的超时设置proxy_read_timeout 7d; # 设置较高的读取超时时间} }
-
额外的代理设置:
如果您的WebSocket服务器正在运行在不同的主机或端口上,确保proxy_pass
指向正确的地址。Websocket连接会保持长时间的连接,并且可能需要调整超时时间的配置,如proxy_read_timeout
设置到更长的时间,以避免连接过早关闭。 -
处理SSL:
如果您的应用程序运行在SSL上,需要在443端口上设置监听,并配置SSL证书。同时确保Nginx代理在这种情况下也指定了HTTP升级的相关设置。例如:server {listen 443 ssl;server_name your_websocket_server.com;ssl_certificate /path/to/ssl/certificate.pem;ssl_certificate_key /path/to/ssl/key.pem;location /ws {proxy_pass http://websocket_backend;proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection $connection_upgrade;proxy_set_header Host $host;proxy_read_timeout 7d;} }
-
防火墙配置:
确保您的服务器防火墙配置允许WebSocket使用的端口(如80, 443)。 -
应用更改:
最后,每次更改Nginx配置后,都需要重新加载或重启Nginx服务来应用配置更改。