如何在 Nginx 中配置 WebSocket 支持？

要支持WebSocket连接在Nginx中的应用，需要配置反向代理来完成HTTP到WebSocket的协议升级。以下是基于一位面试者角度总结的核心步骤和配置示例（建议理解原理，并能清晰表述操作流程）：

1. 关键原理解释:
   • WebSocket协议通过在初始HTTP请求中添加Upgrade: websocket头来升级连接为全双工通信。Nginx必须正确转发并识别这些头信息。
   • 主要依赖配置location块来处理特定路径（如/ws/），代理请求到后端真正的WebSocket服务器（如Node.js或Spring Boot应用）。
2. 基本配置步骤:
   • 定位Nginx配置文件:
     • 编辑默认配置文件 nginx.conf 或位于 /etc/nginx/sites-available/default 的文件。
     • 检查配置合法性后重启Nginx：执行 nginx -t 检查配置正确性，成功后重载：nginx -s reload。
   • 添加反向代理规则:
     • 在目标 server 块中添加定义 location，路径通常用于WebSocket请求（如 /wsapp）。
     • 包含关键头设置：升级HTTP版本并处理 Upgrade 和 Connection头。
   • 可选：处理超时和长连接:
     • 设置延长超时避免频繁断开：添加 proxy_read_timeout 86400s 等属性以支持长时间连接的场景。

3. 完整示例配置代码: 以下是一个Nginx配置的简化版（应用于监听80端口域名）：

   在 http 块内，或在 server 块中修改：

   map $http_upgrade $connection_upgrade {
       default upgrade;
       '' close;
   }
   
   server {
       listen 80;
       server_name example.com;
   
       location /wsapp {
           proxy_pass http://127.0.0.1:8080; # Proxy地址
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection $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_read_timeout 86400s; # 设置长超时
       }
   }
   

   • 代码作用详解:
     • map 指令自动检测连接类型升级逻辑: $connection_upgrade.
     • proxy_http_version 1.1: 强制使用 HTTP/1.1协议支持长连接升级逻辑。
     • proxy_set_header覆盖重要参数：复制 Client发送的头（Upgrade,Connection）支持协议变换。
4. 验证和调试技巧:
   • 客户端触发指定路由: ws://example.com/wsapp，发送测试数据进行联通.
   • 监控Log日志进行错误排查：确保错误不在路由解析层面.
   • 考虑HTTPS时支持WSS（WebSocket Secure）: 若监听 443 端口，对应SSL设置类似流程即可迁移。

核心风险是配置细节误漏可能导致连接失败: 故部署前仔细排查语法和后端地址设置的正确性以实现最佳运行框架体系下的实时通讯任务链。