WSS是WebSocket over TLS,即WebSocket协议运行在TLS加密通道之上;它不修改WebSocket本身,仅将底层TCP替换为TLS连接,服务端须用ListenAndServeTLS启动并配置有效证书,客户端需正确校验证书,且Upgrader需适配HTTPS来源的Origin校验。

WSS不是单独协议,而是WebSocket跑在TLS之上
WSS(wss://)本质上就是 WebSocket over TLS,它不改变 WebSocket 协议本身,只是把底层 TCP 连接换成了 crypto/tls.Conn。gorilla/websocket 不需要额外“适配”TLS——只要 HTTP 服务器用 ListenAndServeTLS 启动,或者客户端 Dial 时传入带 TLS 配置的 websocket.Dialer,握手和后续帧传输就自动走加密通道。
关键点在于:TLS 层由 Go 标准库 crypto/tls 负责,WebSocket 库只管应用层帧格式。你不能在 WebSocket 连接建立后再“加”TLS,也不能跳过 TLS 配置直接让 ws:// 变成 wss://。
服务端必须用 ListenAndServeTLS,不能只改 URL
常见错误是:写了 http.HandleFunc("/ws", wsHandler),然后以为把前端连接地址改成 wss:// 就行了——这完全无效。服务端没启用 TLS,浏览器连握手都发不出去,会直接报 ERR_CONNECTION_CLOSED 或 net::ERR_CERT_INVALID。
正确做法是用 http.Server 显式配置 TLS 并启动:
立即学习“go语言免费学习笔记(深入)”;
srv := &http.Server{
Addr: ":443",
Handler: mux,
TLSConfig: &tls.Config{
MinVersion: tls.VersionTLS12,
CurvePreferences: []tls.CurveID{tls.X25519, tls.CurveP256},
},
}
log.Fatal(srv.ListenAndServeTLS("cert.pem", "key.pem"))
-
cert.pem和key.pem必须是 PEM 格式,私钥不能有密码保护(否则ListenAndServeTLS会 panic) - 若用 Let’s Encrypt 证书,注意 fullchain.pem 是证书链,不是单个 cert.pem;应传
fullchain.pem和privkey.pem - 本地测试可生成自签名证书:
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out cert.pem
客户端 Dial 时要指定 TLS 配置,尤其校验证书
浏览器自动处理证书校验,但 Go 客户端默认会拒绝自签名或域名不匹配的证书,报错 x509: certificate signed by unknown authority。不能简单设 InsecureSkipVerify: true 上生产,但开发调试时需明确控制:
dialer := &websocket.Dialer{
TLSClientConfig: &tls.Config{
InsecureSkipVerify: true, // 仅限测试
// 或:RootCAs: x509.NewCertPool().AppendCertsFromPEM(pemBytes)
},
}
conn, _, err := dialer.Dial("wss://example.com/ws", nil)
- 生产环境必须提供可信 CA 证书池(如系统根证书或自建 CA 的 PEM),不能关校验
-
InsecureSkipVerify: true会导致中间人攻击风险,且某些企业网络会拦截此类连接 - 如果服务端证书域名是
localhost,但你用127.0.0.1访问,也会触发域名不匹配错误
Upgrader 不需要改,但要注意 Origin 和 CORS
gorilla/websocket.Upgrader 本身不涉及 TLS,它的 CheckOrigin 回调仍需处理来源校验——只不过现在来源是 https:// 页面,不是 http://。常见疏漏是:
- 忘记设
Upgrader.CheckOrigin,导致 HTTPS 页面无法连接 WSS(浏览器同源策略限制) - 写死只允许
http://localhost,但实际页面是https://localhost,结果被拒绝 - 反向代理(如 Nginx)后,
r.Header.Get("Origin")可能为空或被篡改,需配合X-Forwarded-Proto判断真实协议
最简安全写法:
upgrader := websocket.Upgrader{
CheckOrigin: func(r *http.Request) bool {
origin := r.Header.Get("Origin")
return origin == "https://your-app.com" || origin == "https://localhost:3000"
},
}
证书、域名、Origin 校验、代理头——这四个点任意一个没对齐,WSS 就会静默失败,错误日志里往往只显示 “connection closed”,容易误判为网络问题。


















