Clash中国語公式サイト
クライアントと設定ガイド

プロジェクトの歴史：オリジナルClashからメンテナンスブランチへ

オリジナルのClashは、YAML設定、プロキシグループ、ルール分岐などの一般的なモデルを確立し、多くのデスクトップ・モバイルクライアントがこのモデルをGUIで提供しました。元プロジェクトがアーカイブされると、コミュニティの保守は継続ブランチへ移行しました。Clash.Metaはプロトコル、DNS、ルール、実行機能を拡張し、その後mihomoという名称で保守が続いています。現在の「Clashクライアント」は、同じリポジトリの異なるインストーラーではなく、複数のGUIプロジェクトが互換コアと設定形式を組み合わせたものです。

この関係は選定に直接影響します。過去のクライアントは動作しても、新しいOSの変化や設定フィールドに継続対応するとは限りません。活発なクライアントは通常、内蔵コア、インストール方法、システム統合機能を更新します。移行時にすべての設定を書き直す必要はありません。サブスクリプションURLと必要なローカル上書きを先にコピーし、プロキシグループ、ルールプロバイダー、DNS、TUN設定が新しいクライアントで正しく認識されるかを順に確認してください。

エコシステムの階層：GUI、コア、ルール、サブスクリプションの役割

GUIクライアントは設定プロファイル、トレイメニュー、起動時実行、コア制御、システムプロキシの切り替えを担います。mihomoコアはプロトコル接続、トラフィックのスニッフィング、DNS処理、ルールマッチ、ポリシー実行を担当します。ルールセットはドメインやIPをどのプロキシグループに送るかを記述し、サブスクリプションはノードや完全な設定を配布します。どこか一つの層に問題が起きても症状は似て見えますが、対処方法はまったく異なります。

たとえば「サブスクリプション更新後に接続できない」場合、サブスクリプションの内容が無効、クライアントが設定を正しく書き込めない、コアが特定のフィールドに非対応、プロキシグループが存在しないメンバーを参照、システムのトラフィックがそもそもクライアントに入っていない、といった原因が考えられます。再インストールを繰り返すより、層ごとに確認する方が効果的です。まず設定を解析できるか、次にコアが起動しているか、その後プロキシグループとログ、最後にシステムプロキシまたはTUNの取得状態を確認します。

コアの関係：設定互換性があっても全フィールドが同一とは限らない

mihomoはClashで一般的な設定構造を引き継ぎ、さらに多くのプロトコル、DNSオプション、ルール機能、実行パラメーターを追加しています。基本フィールドは移行しやすい一方、tun、sniffer、geodata、rule-providers、profile、実験的機能に関する設定は、現在のドキュメントで確認が必要です。クライアントは元のYAML以外にも、独自の上書きファイル、スクリプト、GUI設定を保持することがあります。そのため、設定ファイルを一つエクスポートしただけではローカル状態をすべて含むとは限りません。

互換性を判断する基準は、「クライアントのバージョンがどのコアに対応するか」「そのコアがどのフィールドに対応するか」「現在のサブスクリプションが実際に何を使っているか」の3点です。名前だけで機能を推測したり、あるクライアントの画面にある項目を全プラットフォーム共通の設定と考えたりしないでください。プロトコルハンドブックでは、SS、VMess、Trojan、VLESS、Hysteria2、TUICの設計上の違いと、異なるコアやサブスクリプション形式での表現方法も比較しています。

更新の仕組み：クライアント、コア、サブスクリプションの更新を区別する

クライアント更新は通常、GUI、インストール、権限、OS互換性の問題を修正します。コア更新はプロトコル実装、ルールエンジン、DNS、設定フィールドに影響します。サブスクリプション更新はノード、プロキシグループ、ルールの内容を変更します。3つのタイミングは一致しません。問題が起きたら、直近に発生した変更がどの種類だったかを記録すると、調査範囲を大きく絞れます。サブスクリプションを更新した直後なら設定差分を、クライアントを更新した直後ならコアと権限を、ネットワークだけを変更したならDNS、ルート、接続可否を優先して確認してください。

安全な更新手順は、現在動作している設定を保持し、新バージョンの変更内容を確認し、更新後にまず設定の読み込みと基本接続を検証してから、TUN、上書き、自動プロキシグループを段階的に戻すことです。長期稼働するサーバーでは設定をバージョン管理し、サービスマネージャーで再起動を制御してください。デスクトップユーザーはクライアントの設定バックアップとログ画面を使い、移行の根拠を残すとよいでしょう。