nginx配置webSocket

最新推荐文章于 2025-07-01 10:22:34 发布

原创

最新推荐文章于 2025-07-01 10:22:34 发布 · 1.3k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#negix #negix配置Websocket

本文详细介绍了在Nginx中配置WebSocket的步骤和注意事项，包括解决由于超时导致的连接中断问题。通过设置`proxy_connect_timeout`、`proxy_read_timeout`、`proxy_send_timeout`等参数以及心跳包策略，可以确保WebSocket长连接的稳定。同时，文章讨论了WebSocket与HTTP、Socket的区别，强调了WebSocket在实时通信和资源效率上的优势。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Negix 配置Websocket

问题描述：这里先把用nginx需要关注的问题点先列出来

(Nginx代理webSocket经常中断的解决方法（也就是如何保持长连接）

现象描述：用nginx反代代理某个业务，发现平均1分钟左右，就会出现webSocket连接中断，然后查看了一下，是nginx出现的问题。

产生原因：nginx等待第一次通讯和第二次通讯的时间差，超过了它设定的最大等待时间，简单来说就是超时！)

（文章下方有解决方案,请仔细阅读）

先上代码配置详细的原理在文本下方

1）编辑nginx.conf，在http区域内一定要添加下面配置：

map $http_upgrade $connection_upgrade {

    default upgrade;

    '' close;

}

map指令的作用：

该作用主要是根据客户端请求中$http_upgrade 的值，来构造改变$connection_upgrade的值，即根据变量$http_upgrade的值创建新的变量$connection_upgrade，

创建的规则就是{}里面的东西。其中的规则没有做匹配，因此使用默认的，即 $connection_upgrade 的值会一直是 upgrade。然后如果 $http_upgrade为空字符串的话，

那值会是 close。

2）编辑vhosts下虚拟主机的配置文件，在location匹配配置中添加如下内容：

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection $connection_upgrade;

//=====================完整主要代码实例===========================

http {

     map $http_upgrade $connection_upgrade {

        default upgrade;

        ''      close;

    }

    sendfile        on;



server {

        listen       8880;

        server_name  localhost;

        location /{

          root /data/nginx-1.15/html/