clash-doctor

Clash Verge の診断

Clash Verge または mihomo を調査し、プロファイル固有のルーティングを管理して、接続を診断します。

ルーティング

• 対象のプロファイル、制約、要求されたアクセス経路、および完了条件を確認します。
• コマンド、テンプレート、診断マトリクスについては、references/full-guide.md を読み込みます。
• hub、align、roles、clone、setup-ai、switch を実行する前と、以前の同期が反映されなかったとユーザーが述べた場合は、references/local-hub.md を読み込みます。
• 変更は要求された対象に限定します。

安全性

• 診断と調整は読み取り専用です。書き込みには、内容を示した要約と明示的な確認が必要です。
• 拡張オーバーレイ、または確認済みのローカルハブ YAML を編集します。サブスクリプションの生データは編集しません。
• tun.route-exclude-address は追加のみ可能です。DIRECT は TUN のバイパスではありません。
• ノードの IP、認証情報、サブスクリプション UID、マシンのホスト名を決して推測したり、表示したりしません。
• オーバーレイまたはハブ YAML を書き込んだ後は、Clash Verge を終了して再起動します。PUT /configs ではオーバーレイは再マージされません。

モード

引数	モード
空欄またはホスト名	診断
profiles / list / ls	ローカルおよびリモートのプロファイルを一覧表示
status	ライブのカーネル、TUN、選択中のノード
hub / roles	ローカルハブのトポロジー
align / sync-check	読み取り専用の複数マシン比較
switch-check / health	切り替え前のヘルスチェック
clone / setup-ai / switch	確認済みのプロファイル書き込み
rustdesk / bypass	リレー IP 用の TUN 除外

setup-ai の前に、名前付きの対象を特定します。対象が type: remote の場合に限り、空港形式の拡張オーバーレイを適用します。対象が type: local の場合は、指定されたハブ YAML を編集します。

検証

• 書き込みのたびに対象の YAML を解析します。
• まず両方の Unix ソケットを試し、続いて設定済みの HTTP コントローラーを使って mihomo に問い合わせます。ソケットの存在だけで判断せず、リクエストが失敗した場合にフォールバックします。
• ルートでは、chains[-1] は一致したグループ、chains[0] は接続に使われたノードです。
• 変更したファイル、実行したコマンド、根拠、残るリスクを報告します。

参照資料

• references/full-guide.md — コマンド、テンプレート、診断マトリクス
• references/local-hub.md — ハブの管理責任、ノードの役割、調整、注意点