Clash クライアント/ダウンロードと設定

Clash、Clash Meta、mihomoの関係

Clashでは当初、YAML設定、プロキシグループ、ルールによる振り分けを中心とした使い方が広まりました。オリジナルのプロジェクトがメンテナンスを終了した後も、互換性のあるエコシステムはコミュニティで発展を続けています。mihomoはClash Metaのプロジェクト路線を引き継ぎ、プロキシプロトコル、ルールセット、ドメインスニッフィング、ネットワークへの接続方式などを継続的に進化させています。そのため、古いガイドにあるClash Metaと現在のドキュメントに記載されたmihomoは、同じコアの開発系譜を指すことがよくあります。ただし、古い設定項目がすべて現行の実装でも使えるとは限りません。

クライアントは画面を備えたアプリで、コアはネットワーク接続を実際に処理するプログラムです。クライアントには特定のコアが組み込まれている場合もあれば、ユーザーがコアを変更できる場合もあります。機能が使えるか判断するには、コアが対応しているか、クライアントに設定項目が用意されているか、利用中のOSで必要な権限を得られるかを確認する必要があります。アプリ名だけでは実行環境が分からず、設定がそのまま使えるか判断できないことがほとんどです。iOSなどには独自のネットワーク接続方式があるため、デスクトップ版の仕組みをそのまま当てはめないでください。

公開ドキュメントで設定項目を確認する

設定項目を確認するときは、まずmihomoの設定ドキュメントを参照し、次にmihomoのソースコードリポジトリで解説やリリース情報、課題の議論を確認してください。公開ソースコードは実装の理解や問題の切り分けに役立ちますが、すべてのGUIクライアントで同じ名前の設定項目が使えるとは限りません。当サイトでは、よく使う概念を用語ごとに解説し、設定全体の手順は応用マニュアルにまとめています。画面上の操作手順と内部パラメーターを、ひとつの固定手順として混同しないためです。

サンプルを読むときは、完全な設定ファイルと部分的な記述を区別してください。rulesで指定するプロキシ名は設定内で定義されている必要があります。rule-providersが参照するファイルは実際に存在しなければなりません。DNSの待ち受けポートと制御インターフェースのポートは、他のプログラムと競合しないようにしてください。YAMLの階層はスペースで表し、インデントにタブを使わないでください。保存前にクライアントの設定チェック機能を実行し、再読み込み後にログで成功したことを確認しましょう。画面に古い設定が表示される場合は、同じリンクを何度も読み込むのではなく、現在有効な設定を確認してください。

設定更新とローカル変更の使い分け

アプリ、コア、サブスクリプションの更新は、それぞれ異なる部分に影響します。アプリの更新では画面やサービスコンポーネントが変わる場合があり、コアの更新ではプロトコルの実装や設定項目の動作が変わる場合があります。サブスクリプションの更新ではサーバーやプロキシグループ、ルールが置き換わることがあります。アップグレード前に現在使える設定とローカルオーバーライドを保存し、関連するリリースノートを確認しましょう。アップグレード後は、まず従来の接続を確認してから新機能をひとつずつ有効にしてください。「サブスクリプションの更新成功」はサーバーの稼働を保証せず、「インストール完了」はシステムプロキシがすべてのアプリの通信を取り込んだことを意味しません。

継続して使う場合は、サブスクリプションでリモートの設定を管理し、ローカルオーバーライドで個別の要望を反映する方法がおすすめです。たとえば、少数の業務用ドメインだけにルールを追加したり、ローカルの待ち受けアドレスやDNS設定を保持したりできます。オーバーライドやマージの方法、適用順はクライアントごとに異なります。エディター上の一部分だけで判断せず、最終的に生成された設定を確認してください。複数のサブスクリプションを統合する場合は、名前が重複するプロキシグループ、重複ルール、出口の依存関係にも対処が必要です。詳しい手順は設定応用マニュアルで解説しています。初回接続時にまとめて設定するのは避けましょう。

接続ログから問題を切り分ける

「インターネットに接続できない」という問題は、まず通信の取り込み、名前解決、ルール判定、出口の4段階に分けて考えましょう。ブラウザーがシステムプロキシを参照しているか、コアが接続を認識しているか、ドメインが想定どおりに解決されているか、どのプロキシが選ばれたかを確認すると、設定を何度も変えるより効率的に原因を絞れます。コアに接続ログがない場合は、まず通信の取り込み方法を確認してください。ログはあるもののプロキシの選択が誤っている場合は、ルールの順序とグループ内の選択を確認します。選択が正しいのに接続できない場合は、サブスクリプションの状態、ノードのプロトコル、出口ネットワークを調べましょう。原因を特定するため、設定は一度にひとつだけ変更してください。

レイテンシテストの結果は、特定の測定先、プロトコル、測定時のネットワーク状況を反映するもので、実際の用途での動作確認に代わるものではありません。Webページ、動画、コマンドラインツールでは、DNSや接続の再利用方法、通信プロトコルが異なる場合があります。動作確認では、まず対象アプリをひとつ決め、接続ログを見てから、出口がルールの想定どおりかを確認してください。調査内容を共有するときは、エラーの種類と必要な項目だけを残し、サブスクリプションURLのアクセス情報、サーバーのパスワード、個人を特定できるネットワーク情報を削除しましょう。具体的な手順はよくある質問から確認できます。

初回利用時の設定手順

有効なサブスクリプションをお持ちの場合は、まずOSとCPUアーキテクチャに合ったクライアントをインストールし、設定画面からサブスクリプションを読み込んで現在の設定に選びます。次にRuleモードを選び、実際に使うプロキシグループでノードを選択してから、システムプロキシまたはモバイルのVPN接続を有効にしてください。まず普段使うアプリが接続できるか確認し、その後ルールが想定どおりかを調べます。この順序なら、設定の有効性、通信の取り込み、出口の選択を個別に確認でき、問題が起きたときもどの段階で止まったか判断しやすくなります。ネットワーク設定をすべて一度に有効にして、ひとつずつ原因を推測する必要はありません。

対象アプリがシステムプロキシに従わない場合や、より広い範囲の通信を取り込む必要がある場合に限り、TUNを検討してください。有効にする前に、ルートを変更する可能性のある他のVPNを終了し、現在のDNSとプロキシ設定を記録します。クライアントの案内に従ってサービスをインストールするか、必要な権限を付与してください。ネットワークに問題が起きたら、直前の変更を取り消し、動作が確認できている状態に戻しましょう。使い方ガイドでは、読み込み、選択、通信の取り込み、動作確認までを順に解説しています。用語の確認には用語集をご利用ください。どちらも応用マニュアルとは役割が異なります。