网站要推送消息、支持在线聊天,或实时同步设备状态时,常会用到 WebSocket。启用加密后,连接地址使用 wss://,而不是 ws://。在阿里云上部署,域名、TLS证书、代理转发和后端程序都要配合正确;只开放一个端口,通常还不够。
WSS连接是怎么建立的
WebSocket 会先通过 HTTP 请求发起握手,服务器同意协议升级后,连接就能保持开放,让客户端和服务器双向传输数据。WSS 则是在 TLS 加密连接上运行的 WebSocket,可以加密传输内容,并验证服务器身份。
如果网页通过 HTTPS 加载,浏览器通常要求实时连接也使用加密协议。此时前端仍请求 ws://,可能会被浏览器按混合内容策略拦截。常见地址写法是 wss://ws.example.com/socket:域名要能正确解析,/socket 路径也要与代理和后端配置一致。
部署前先确认这些信息
- 域名:准备已完成解析的域名或子域名,例如 ws.example.com,并确认它指向实际对外服务的入口。
- TLS证书:证书需要覆盖客户端访问的域名,并部署在负责 TLS 握手的服务上。
- 后端服务:记录 WebSocket 程序监听的地址、端口和路径,例如本机 127.0.0.1:8080。
- 云上入口:确定由负载均衡、Nginx 等反向代理处理连接,还是由应用直接处理 TLS。具体功能和配置方式以当前产品控制台及文档为准。
- 安全规则:只开放业务需要的公网入口。若流量经代理转发到 ECS,后端端口尽量限制为代理或内网可访问。
阿里云wss协议配置步骤
1. 将域名解析到服务入口
在 DNS 中为 WebSocket 域名添加解析记录,指向负载均衡或服务器的公网入口。使用 CDN、负载均衡等中间层时,也要确认它支持 WebSocket,并能把连接转发到正确的后端。记录修改后,可以检查域名解析结果是否为预期地址。
2. 在入口配置证书
把有效证书部署到实际处理 TLS 握手的入口,例如负载均衡监听或 Nginx。客户端建立 WSS 连接时,TLS 握手发生在客户端与这个入口之间。入口若通过普通 HTTP 将请求转发到内网后端,后端链路是否也需要加密,应按实际安全要求设计。
证书部署后,核对证书覆盖的域名、有效期和证书链。证书名称与访问域名不匹配时,浏览器可能直接报错,后端 WebSocket 程序即使运行正常也无法解决。
3. 配置代理转发协议升级请求
反向代理要正确处理握手请求中的 Upgrade 和 Connection 请求头,并把请求送到匹配的后端地址和路径。Nginx 配置可参考下面的写法,域名、端口和路径需要按实际环境调整:
location /socket/ {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection “upgrade”;
proxy_set_header Host $host;
}
改完配置,先检查语法,再平滑重载 Nginx。若使用云负载均衡,还需核对监听、后端服务器组和健康检查中的协议与端口,并确认当前产品支持所需的 WebSocket 转发方式。
4. 检查端口和长连接超时
安全组、防火墙和服务器本机规则都要允许实际需要的流量。一般只需让客户端访问对外提供 HTTPS/WSS 的入口,后端应用端口不必直接暴露公网。长连接还可能被代理或负载均衡的空闲超时断开;应检查入口的超时设置,并根据业务实现心跳和断线重连。
案例:页面正常打开,聊天连接却失败
某团队的聊天页面运行在 HTTPS 网站上,后端程序部署于 ECS 的 8080 端口,Nginx 对外提供 443 服务。网页可以打开,但浏览器开发者工具显示 WebSocket 握手失败。
排查后发现,前端仍在请求 ws://ws.example.com/socket。将地址改为 wss://ws.example.com/socket 后,连接依旧失败。查看 Nginx 日志才发现,代理没有传递协议升级请求头。补齐 Upgrade、Connection 配置,并核对后端监听端口和请求路径后,握手返回成功,连接也能正常保持。
遇到类似情况,别只盯着证书或安全组。浏览器请求地址、证书、代理升级设置、后端监听和网络规则都可能造成握手失败,按链路逐项核对更容易定位问题。
常见连接问题怎么查
- 浏览器提示混合内容或证书错误:确认页面使用 HTTPS、WebSocket 地址使用 WSS,再检查证书是否覆盖访问域名且仍在有效期内。
- 返回404或握手失败:对照前端请求路径、代理路由和后端服务配置,确认它们指向同一路径。
- 返回502或连接被拒绝:检查后端进程是否运行、监听地址和端口是否正确,以及代理能否连通后端。
- 连接一段时间后断开:检查代理或负载均衡的空闲超时;根据业务需要设置心跳和重连策略。
- 偶发失败或负载不均:检查多台后端配置是否一致。若业务依赖会话状态,还要考虑共享状态或合适的会话保持方案。
上线前核对配置链路
阿里云wss协议能否正常工作,取决于域名解析、TLS证书、入口的协议升级转发,以及后端路径和端口是否匹配。上线前可用浏览器开发者工具查看握手状态,再结合代理和应用日志排查。相比不断增加开放端口,按链路逐段检查更安全,也更容易找到故障所在。