NodeNanny

---
title: 常见故障：vmess+ws 客户端反复掉线
summary: 目前没有现成的一键修复命令，需要人工排查——先如实说明这一点
order: 7
updated: 2026-07-22
tags: [故障排查, vmess, 已知限制]
kbRef: vmess-ws-mux-mismatch
---

## 现象

用 vmess+websocket 协议的客户端连接不稳定，反复掉线，日志里能看到
"websocket: bad handshake" 或 vmess 相关的 unexpected EOF。

## 原因

这类问题通常**不是服务端进程崩了**，而是客户端和服务端的 ws path / mux 参数没对上，
或者中间经过的 CDN、反向代理层对分片数据做了不兼容的处理。

## 目前的处理方式（如实说明：还没有一键修复）

这一条知识库条目目前**没有可以直接执行的修复命令**，需要人工逐项比对客户端和
服务端的配置文件（尤其是 ws path 和 mux 相关参数）是否一致。这是知识库里刻意
保留的一个"占位条目"——记录问题现象和排查方向，但不假装有一个通用的一键修复
命令，等以后确实找到普适的修复步骤，再补充进去。遇到这个问题时，请把双方配置
贴出来对比，而不是指望一条命令解决。