在现代Web开发中，WebSocket 是实现服务器与客户端实时双向通信的重要技术。然而，当你使用 Nginx 作为反向代理时，默认配置可能无法正确转发 WebSocket 连接，导致连接失败或自动断开。本文将详细讲解如何配置 Nginx 反向代理以支持 WebSocket，即使你是完全的小白，也能轻松上手！
什么是WebSocket？
WebSocket 是一种网络通信协议，允许客户端和服务器之间建立持久连接，实现低延迟、高效率的双向数据传输。常用于聊天应用、在线游戏、股票行情推送等场景。
为什么Nginx默认不支持WebSocket？
Nginx 默认将 HTTP 请求视为短连接，处理完就关闭。而 WebSocket 是基于 HTTP 协议升级（Upgrade）而来的一种长连接。如果不做特殊配置，Nginx 会中断这个升级过程，导致 WebSocket 连接失败。
配置Nginx支持WebSocket的关键
要让 Nginx 正确代理 WebSocket，核心在于设置以下三个请求头：
Upgrade：告知服务器客户端希望升级协议。Connection：设置为upgrade，表示连接将被升级。Proxy_set_header：将原始请求头传递给后端服务。
完整配置示例
假设你的后端 WebSocket 服务运行在 http://localhost:8080，以下是完整的 Nginx 配置文件（通常位于 /etc/nginx/sites-available/default 或自定义站点配置中）：
server { listen 80; server_name your-domain.com; location / { proxy_pass http://localhost:8080; 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_http_version 1.1;：必须设置为 HTTP/1.1，因为 WebSocket 升级依赖该版本。proxy_set_header Upgrade $http_upgrade;：将客户端的 Upgrade 头传递给后端。proxy_set_header Connection "upgrade";：明确告诉 Nginx 这是一个升级连接。
测试WebSocket是否正常工作
你可以使用浏览器开发者工具或在线 WebSocket 测试工具（如 websocket.org echo test）来验证连接是否成功。如果配置正确，连接应能保持打开状态并收发消息。
常见问题排查
- 连接立即断开：检查是否遗漏了
Upgrade和Connection头。 - 400 Bad Request：确认后端服务确实监听了指定端口，并支持 WebSocket。
- HTTPS 下失效：若使用 HTTPS，请确保 SSL 配置正确，且 WebSocket 地址使用
wss://。
总结
通过正确配置 Nginx 的反向代理规则，你可以轻松支持 WebSocket 通信。记住三个核心指令：proxy_http_version 1.1、Upgrade 和 Connection "upgrade"。掌握这些，你就能构建高性能、可扩展的实时 Web 应用！
希望这篇关于 Nginx反向代理 和 WebSocket配置 的教程对你有帮助。如果你正在学习 Nginx WebSocket 相关知识，不妨动手实践一下这个 反向代理教程 中的配置步骤！
