Nginx配置支持WebSocket功能详解

 更新时间:2024年11月18日 16:25:01   作者:浪子尘晨  
Nginx配置支持WebSocket功能需要添加特定配置,网上通用配置只能支持ws请求,而既支持http又支持ws的配置中,使用map$http_upgrade$connection_upgrade块来设置Connection头的值,并指定使用HTTP/1.1版本以保持连接打开,确保Nginx版本是1.3或更高

Nginx配置支持WebSocket功能

刚部署一个项目需要使用到WebScoket实现。但通过域名指向NG做了反向代理,发现通过域名访问不了,通过查找资料后发现需要在Nginx添加WebSocket的转发配置。

一、网上通用配置

在网上找到大部分配置如下所示

location /websocket/ {
        proxy_pass http://myserver;
 
        proxy_http_version 1.1;
        proxy_read_timeout 360s;   
        proxy_redirect off;   
        proxy_set_header Upgrade $http_upgrade; 
        proxy_set_header Connection "upgrade";    #配置连接为升级连接
        proxy_set_header Host $host:$server_port;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

使用如上连接,如果所有的连接仅仅为 "ws" 协议的请求是没有问题的

但是如果要及支持 http 请求又支持 ws 请求上述配置就不起作用了

二、既支持http又支持ws的配置

通过nginx官方关于WebSocket的配置得知,可以自定义变量。

故配置如下,就可以做到既支持 ws 请求,又支持 http请求。

http {
 
   #自定义变量 $connection_upgrade
    map $http_upgrade $connection_upgrade { 
        default          keep-alive;  #默认为keep-alive 可以支持 一般http请求
        'websocket'      upgrade;     #如果为websocket 则为 upgrade 可升级的。
    }
 
    server {
        ...
 
        location /chat/ {
            proxy_pass http://backend;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade; #此处配置 上面定义的变量
            proxy_set_header Connection $connection_upgrade;
        }
    }
}

在这个配置中:

  • map $http_upgrade $connection_upgrade 块用于根据客户端发送的 Upgrade 头的值设置 Connection 头的值。
  • proxy_pass 指向WebSocket服务的后端地址。
  • proxy_http_version 1.1 指定使用HTTP/1.1版本以保持连接打开。
  • proxy_set_header Upgrade $http_upgrade 和 proxy_set_header Connection $connection_upgrade 确保正确的头被发送到后端,以便它可以识别WebSocket连接。

确保您的Nginx版本是1.3或更高,以支持WebSocket。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Nginx速查手册及常见问题

    Nginx速查手册及常见问题

    Nginx是一款轻量级的HTTP服务器,采用事件驱动的异步非阻塞处理方式框架,这让其具有极好的IO性能,时常用于服务端的反向代理和负载均衡,这篇文章主要介绍了Nginx速查手册及常见问题,,需要的朋友可以参考下
    2022-04-04
  • Nginx启用Brotli算法压缩的示例

    Nginx启用Brotli算法压缩的示例

    这篇文章主要介绍了Nginx启用Brotli算法压缩的示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03
  • 详解 Nginx 负载均衡和反向代理配置和优化

    详解 Nginx 负载均衡和反向代理配置和优化

    这篇文章主要介绍了详解 Nginx 负载均衡和反向代理配置和优化的相关资料,需要的朋友可以参考下
    2017-03-03
  • Nginx反向代理实现支持长连接详解

    Nginx反向代理实现支持长连接详解

    这篇文章主要给大家介绍了关于Nginx反向代理实现支持长连接的相关资料,文字介绍的非常详细,对大家具有一定的参考学习价值,需要的朋友们下面跟着小编一起来学习学习吧。
    2017-06-06
  • 在Nginx中拦截特定用户代理的教程

    在Nginx中拦截特定用户代理的教程

    这篇文章主要介绍了在Nginx中拦截特定用户代理的教程,并为这些被拦截的用户设置一个黑名单以方便管理,需要的朋友可以参考下
    2015-06-06
  • 使用Nginx搭建代理服务器(正向代理HTTPS网站)的操作指南

    使用Nginx搭建代理服务器(正向代理HTTPS网站)的操作指南

    在网络应用中,代理服务器是用于中转用户请求和服务端响应的工具,正向代理主要用于客户端与外部服务器之间的访问代理,帮助客户端隐藏其 IP 地址或访问受限资源,本文将详细介绍如何使用 Nginx 搭建正向代理服务器,特别是针对 HTTPS 网站的代理
    2024-11-11
  • windows下nginx的安装使用及解决80端口被占用nginx不能启动的问题

    windows下nginx的安装使用及解决80端口被占用nginx不能启动的问题

    这篇文章主要给大家介绍了关于windows下nginx的安装使用,以及如何解决80端口被占用导致nginx不能启动的问题,文中介绍的非常详细,对大家具有一定的参考价值,需要的朋友们下面来一起看看吧。
    2017-04-04
  • Nginx 防止被域名恶意解析的办法

    Nginx 防止被域名恶意解析的办法

    这篇文章主要介绍了Nginx 防止被域名恶意解析的方法的相关资料,希望通过本文能帮助到大家,让大家掌握理解这部分内容,需要的朋友可以参考下
    2017-10-10
  • nginx安装并转发socket服务实现方式

    nginx安装并转发socket服务实现方式

    文章指导如何安装编译工具、PCRE和Nginx,并通过修改配置文件添加stream块实现端口转发,将9999/801端口分别映射至9988/1557端口
    2025-07-07
  • Nginx如何配置Http、Https、WS、WSS的方法步骤

    Nginx如何配置Http、Https、WS、WSS的方法步骤

    这篇文章主要介绍了Nginx如何配置Http、Https、WS、WSS的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-05-05

最新评论