Skip to content

WebSocket 或实时连接失败 ​

聊天、实时推送、在线客服、流式输出等场景通常需要 WebSocket 或长连接。只打开 CDN 开关还不够,源站代理、应用和缓存策略也必须配套。

检查清单 ​

  • 套餐和网站是否支持 WebSocket。
  • 网站详情“高级设置”是否开启 WebSocket。
  • 源站 Nginx/网关是否转发 Upgrade 和 Connection 头。
  • 回源协议、端口和 TLS 是否与 WebSocket 地址一致(ws:// / wss://)。
  • 长连接路径是否被缓存或 CC 规则拦截。
  • 代理和应用的读取超时是否过短。
  • 浏览器 Console 中是否出现跨域、证书或握手失败。

修改配置后用浏览器 Network 查看握手状态。101 Switching Protocols 表示握手成功;401/403 通常是鉴权或安全策略,502/504 通常是回源或代理问题。

纯静态站点不需要开启 WebSocket;不必要的长连接会增加源站连接数和监控噪声。

基于 VitePress 构建