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 関連のパラメータ)が一致しているかを
1項目ずつ手動で比較する必要があります。これはナレッジベースの中で意図的に残されている
「プレースホルダー項目」です——症状と調査の方向性は記録していますが、汎用的なワンクリック
修復コマンドがあるかのように装うことはしません。将来、本当に汎用的な修復手順が見つかった
ら、その時に追加します。この問題に遭遇した場合は、1つのコマンドで解決することを期待
せず、双方の設定を貼り出して比較してください。