Nginx中配置WebSocket代理的详细步骤

 更新时间:2025年02月10日 09:54:45   作者:用心去追梦  
Nginx 可以配置为 WebSocket 代理,将 WebSocket 连接从客户端转发到后端服务器,以下是如何在 Nginx 中配置 WebSocket 代理的详细步骤和示例配置,需要的朋友可以参考下

1. 安装 Nginx

确保你已经安装了 Nginx。如果没有安装,可以使用以下命令进行安装:

sudo apt-get update
sudo apt-get install nginx

2. 配置 WebSocket 代理

编辑 Nginx 配置文件,通常位于 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available/default。以下是一个示例配置,展示了如何配置 WebSocket 代理。

示例配置:

http {
    # 定义 upstream 块,指定后端 WebSocket 服务器
    upstream websocket_backend {
        server backend1.example.com:8080;
        server backend2.example.com:8080;
    }

    server {
        listen 80;
        server_name example.com;

        # 配置 WebSocket 代理
        location /ws {
            proxy_pass http://websocket_backend;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            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 X-Forwarded-Proto $scheme;

            # 可选:设置超时时间
            proxy_read_timeout 86400s;
        }

        # 配置静态文件或其他路径
        location / {
            root /var/www/html;
            index index.html index.htm;
        }
    }
}

3. 参数解释

  • proxy_pass:指定后端 WebSocket 服务器的地址。
  • proxy_http_version 1.1:设置 HTTP 版本为 1.1,WebSocket 协议需要 HTTP/1.1。
  • proxy_set_header Upgrade $http_upgrade:传递客户端的 Upgrade 头部。
  • proxy_set_header Connection "upgrade":传递客户端的 Connection 头部,指示这是一个 WebSocket 升级请求。
  • proxy_set_header Host $host:传递客户端的 Host 头部。
  • proxy_set_header X-Real-IP $remote_addr:传递客户端的真实 IP 地址。
  • proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for:传递客户端的 X-Forwarded-For 头部。
  • proxy_set_header X-Forwarded-Proto $scheme:传递客户端的协议(HTTP 或 HTTPS)。
  • proxy_read_timeout 86400s:设置读取超时时间,WebSocket 连接通常是长连接,因此需要设置较长的超时时间。

4. 测试配置

在重新加载 Nginx 之前,先测试配置文件是否有语法错误。

sudo nginx -t

6. 验证配置

确保 WebSocket 连接可以正常建立和通信。可以在前端使用 WebSocket 客户端进行测试。

示例前端代码:

<!DOCTYPE html>
<html>
<head>
    <title>WebSocket Test</title>
</head>
<body>
    <script>
        var socket = new WebSocket('ws://example.com/ws');

        socket.onopen = function() {
            console.log('WebSocket connection opened');
            socket.send('Hello, WebSocket!');
        };

        socket.onmessage = function(event) {
            console.log('Message from server:', event.data);
        };

        socket.onclose = function() {
            console.log('WebSocket connection closed');
        };

        socket.onerror = function(error) {
            console.error('WebSocket error:', error);
        };
    </script>
</body>
</html>

总结

通过上述配置,Nginx 可以作为 WebSocket 代理,将客户端的 WebSocket 连接转发到后端服务器。这些配置确保了 WebSocket 连接的正确性和稳定性。

到此这篇关于Nginx中配置WebSocket代理的详细步骤的文章就介绍到这了,更多相关Nginx配置WebSocket代理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 使用Nginx、Nginx Plus抵御DDOS攻击的方法

    使用Nginx、Nginx Plus抵御DDOS攻击的方法

    DDOS 是一种通过大流量的请求对目标进行轰炸式访问,导致提供服务的服务器资源耗尽进而无法继续提供服务的攻击手段。这篇文章主要介绍了使用Nginx、Nginx Plus抵御DDOS攻击的方法,感兴趣的小伙伴们可以参考一下
    2018-06-06
  • Nginx 动态域名解析过程详解

    Nginx 动态域名解析过程详解

    这篇文章主要为大家介绍了Nginx 动态域名解析过程,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-03-03
  • Nginx Rewrite使用场景及代码案例详解

    Nginx Rewrite使用场景及代码案例详解

    这篇文章主要介绍了Nginx Rewrite使用场景及代码案例详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-08-08
  • CentOS利用Nginx搭建下载功能服务器

    CentOS利用Nginx搭建下载功能服务器

    这篇文章主要介绍了CentOS利用Nginx搭建下载功能服务器,需要的朋友可以参考下
    2017-06-06
  • Nginx的缓存配置与其他配置方法

    Nginx的缓存配置与其他配置方法

    Nginx的压缩功能配置是通过gzip压缩技术,可以使原来的网页的内容大小压缩成原来的30%,这样,用户在访问网页的时候,由于传输的内容比原内容小很多,故而速度会快很多,本文给大家介绍Nginx的缓存配置与其他配置方法,感兴趣的朋友一起看看吧
    2023-12-12
  • Nginx+Tomcat反向代理与负载均衡的实现

    Nginx+Tomcat反向代理与负载均衡的实现

    这篇文章给大家详细介绍了如何实现Nginx+Tomcat反向代理与负载均衡,文中的流程步骤介绍的非常详细对我们的学习或工作有一定的帮助,需要的朋友可以参考下
    2023-07-07
  • Nginx配置多个HTTPS域名的方法

    Nginx配置多个HTTPS域名的方法

    本篇文章主要介绍了Nginx配置多个HTTPS域名的方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07
  • 通过Nginx代理转发配置实现跨域的方法(API代理转发)

    通过Nginx代理转发配置实现跨域的方法(API代理转发)

    这篇文章主要给大家介绍了关于如何通过Nginx代理转发配置实现跨域(API代理转发)的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用Nginx具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-11-11
  • Nginx跨域使用字体文件的配置方法

    Nginx跨域使用字体文件的配置方法

    这篇文章主要介绍了Nginx跨域使用字体文件的配置方法,使用HttpHeadersModule模块实现,需要的朋友可以参考下
    2014-06-06
  • 解决Nginx配置静态资源文件404 Not Found问题

    解决Nginx配置静态资源文件404 Not Found问题

    在使用Nginx作为静态资源服务器时,如果配置了根目录root导致404错误,而使用前缀URL配置alias则需要正确处理目录路径,使用alias时要确保目录名后加‘/’,并且在需要时使用root和alias配置,本文介绍Nginx配置静态资源文件404 Not Found问题解决方法,感兴趣的朋友一起看看吧
    2025-03-03

最新评论