nginx 配置 websocket 支持

落日映苍穹つ 2022-10-27 02:48 262阅读 0赞

本文需要先自行了解的两个知识点：

*  nginx 配置文件 map 的使用方法  
    这个百度搜索关键字 “nginx map” 就有很多答案和示例
 *  http 协议头中的 `Connection` 和 `Upgrade` 的作用  
    `Connection: Upgrade` ，这个头部是给 proxy 看的。  
    `Upgrade: websocket`，表示浏览器想要升级到WebSocket协议（也会有其他的比如升级为 http2 等）。这个头部是给最终处理请求的程序看的。  
    如果只有 `Upgrade: websocket`，而没有 `Connection: Upgrade`，则 proxy 不知道要升级为 websocket，会默认视为普通HTTP请求。

然后就是关于修改 nginx 配置文件的示例了，如下示例配置文件是被 nginx 主配置文件 include 的：

upstream nexus.shanhy.com {
      server 192.168.111.64:8081;
    }
    upstream harbor.shanhy.com {
      server 192.168.111.64:843;
    }
    
    # connection_upgrade
    map $http_upgrade $connection_upgrade {
        default Upgrade;
        '' $http_connection;
    }
        
    server {
        listen 80;
        server_name  *.shanhy.com;
        
        # 设置请求实体的大小限制
        client_max_body_size 50m;
        
        location / {
            proxy_pass  http://$host;
       }
    }
    
    server {
        listen 443 ssl;
        server_name  *.shanhy.com;
        ssl_certificate /etc/letsencrypt/shanhy.com/cert.pem;  # 指定证书的位置，绝对路径
        ssl_certificate_key /etc/letsencrypt/shanhy.com/key.pem;  # 绝对路径，同上
        ssl_session_timeout 5m;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
        ssl_prefer_server_ciphers on;
        location / {
        
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            
            proxy_pass  https://$host;
       }
    
    }

其中为了支持 websocket，修改前和修改后的配置区别如下：

# connection_upgrade
    map $http_upgrade $connection_upgrade {
        default Upgrade;
        '' $http_connection; # http_upgrade 为空的时候，使用原来传递的 http_connection 值
    }

和

proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

> 其他配置代码只是示例附带的，与支持 websocket 无关。

--------------------

（END）