在 linux 中配置 nginx 实现 wss(websocket secure)反向代理,核心在于同时启用 https 和 websocket 协议升级。你需要配置一个监听 443 端口的 server 块,加载 ssl 证书以支持加密传输,并通过 proxy_set_header upgrade 和 proxy_set_header connection 指令将客户端的升级请求透传给后端 websocket 服务。

Nginx 如何配置 SSL 证书以支持 WSS 连接
要让 Nginx 接受 WSS 连接,必须配置有效的 SSL 证书。这通常涉及使用 Let's Encrypt 等工具获取证书,并在 server 块中指定证书路径。Nginx 会处理 TLS 握手,解密流量后通过内部网络转发给后端。

server {
listen 443 ssl;
server_name your_domain.com;
ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem;
# 其他 SSL 优化配置...
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
}上述配置中,listen 443 ssl 声明了加密监听。ssl_certificate 和 ssl_certificate_key 指向实际的证书文件。如果证书无效或过期,浏览器会拒绝建立 WSS 连接。确保域名解析正确,且防火墙允许 443 端口入站。
Nginx 如何配置 WebSocket 协议头透传
仅配置 SSL 不足以支持 WSS,还必须处理 HTTP 到 WebSocket 的协议升级。当客户端发起 WSS 连接时,它会发送带有 Upgrade: websocket 和 Connection: Upgrade 头的请求。Nginx 需要将这些头原样传递给后端,并禁用可能干扰长连接的缓冲机制。

location /ws/ {
proxy_pass http://backend_websocket_server;
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;
}在这个 location 块中,proxy_http_version 1.1 是必须的,因为 WebSocket 协议基于 HTTP/1.1。$http_upgrade 变量捕获客户端的升级请求,而 Connection "upgrade" 明确指示 Nginx 保持连接开启。如果不设置这些,Nginx 可能会将 WebSocket 连接视为普通 HTTP 请求并立即关闭它,导致连接失败。
当后端返回非 101 状态码时 Nginx 的行为是什么
如果后端服务器无法升级协议(例如返回 404 或 500),Nginx 默认会将该错误响应直接返回给客户端。WSS 连接建立失败,客户端 JavaScript 通常会触发 onerror 事件。为了调试,可以检查 Nginx 的错误日志,其中会记录后端返回的具体状态码和错误信息。


















