nginx 配置 websocket 支持

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

• 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）