まずは3つの役割を整理しましょう。設定ファイルは設定を保存し、ルールは照合条件を定め、プロキシグループは接続先の選択肢を提供します。互いに関連しますが、同じ設定項目ではありません。
ルール振り分けとは、ドメインやアドレスなどの条件に応じて、接続の出口を選ぶ仕組みです。ルールは通常、上から順に確認され、最初に一致したルールに対応するポリシーが適用されます。DOMAIN-SUFFIXはドメインの末尾、GEOIPはIPアドレスの地域、MATCHはそれまでに一致しなかった接続を処理します。問題を調べるときは、まず接続ログで一致したルールを確認し、そのルールが参照するプロキシグループを見ます。ノードを切り替えても、ルールの判定結果が変わるとは限りません。図のPROXYは例示用のグループ名です。実際の設定では、同じ名前のプロキシグループをあらかじめ定義してください。
まず一致したルールを確認し、出口を切り替えるか判断しましょう。YAMLはインデントで階層を表すテキスト形式です。トップレベルの各項目が設定の種類を示し、リストの先頭にあるハイフンは要素を表します。読むときは、まずポートとモードを確認し、次にproxies、proxy-groups、rulesの参照関係を見ましょう。最初からすべての項目を覚える必要はありません。編集前に元のファイルを保存し、インデントにはスペースを使って、同じ階層の項目をそろえてください。サブスクリプションの更新で設定が再生成される場合があります。変更を維持するには、配信された設定を何度も直接編集するのではなく、クライアントのオーバーライド機能を使うのがおすすめです。各項目が使えるかどうかは、利用中のコアの対応状況も確認してください。
まず構造を読み、次に項目を変更。一度に変更するのは1か所だけにしましょう。プロキシグループは、ルールから参照される接続先の選択肢をまとめたものです。selectは通常、ユーザーが手動で選択します。url-testは設定したテスト結果に基づいて接続先を選び、fallbackは利用可能な接続先に切り替えます。グループにはノードだけでなく、別のプロキシグループも指定できます。そのため、画面上のボタンがサーバーに直接対応するとは限りません。初めて使う場合は手動選択から始め、接続を確認してから自動選択を試しましょう。テスト結果が示すのは特定のテスト先での状態であり、すべてのWebサイトで同じとは限りません。設定を変える前に、グループ名がルール内の名前と完全に一致しているかも確認してください。
ルールがグループを指定し、グループが接続先を決めます。クライアントは操作画面、コアは接続を実際に処理するプログラムです。同じ設定でも、コアの機能やクライアントのオーバーライド方法によって動作が異なる場合があります。項目のエラーが出たら、まず使用中のコアを確認し、該当項目の対応状況を調べましょう。画面上の名称だけで互換性を判断しないでください。最初の画面に表示されるターミナルはルールの一例であり、プロキシノードを含む完全なサブスクリプションではありません。
YAMLマニュアルで項目を調べる →まずOSを選び、次にプロセッサのアーキテクチャを確認します。クライアントをインストールしただけでは接続できません。信頼できるサブスクリプションかローカル設定を別途用意してください。ダウンロード先からプロキシサービスを利用することはできません。
デスクトップ向けなら、まずClash Plusを確認し、使い方に合わせてClash Verge RevやFlClashなどと比較できます。ダウンロード前に、システム設定の「システム情報」でデバイスの種類を確認し、一般的なx64とARMの違いを見分けましょう。インストーラー名が似ているだけで実行しないでください。
初回の動作確認では、まずシステムプロキシを使い、システム設定に従うブラウザーで接続を試します。ネットワーク設定をアプリ側で個別に管理するものは、システムプロキシを利用しない場合があります。その場合は、ガイドを確認してからTUNモードを検討してください。これは仮想ネットワークインターフェースで通信を処理する方式です。インストール時や権限の確認画面は、項目ごとに内容を確認しましょう。
ダウンロード Windowsクライアント「このMacについて」でApple SiliconかIntelかを確認し、対応するインストーラーを選びましょう。ダウンロードページではクライアントごとに対応するファイルを案内しています。初めて使う場合はClash Plusから確認できます。既存の設定を移行する場合は、移行先のクライアントが元の項目に対応しているかも確認してください。
システムプロキシとネットワーク拡張機能は役割が異なります。有効化の方法はクライアントの画面で確認してください。複数のプロキシツールで同時に通信を処理しないようにしましょう。クライアントを切り替えるときは、以前のツールを終了して古いシステムプロキシ設定を解除してから、新しい設定を追加すると、ポートの競合や通信経路の混乱を防げます。
ダウンロード macOSクライアントモバイル向けではClash Plusのほか、Clash Meta for Android、FlClash、Surfboardも比較できます。最近の端末の多くはARM64ですが、端末情報で確認してください。クライアントによって対応する設定形式は異なるため、どのサブスクリプションでもそのまま使えるとは限りません。
接続時にVPNの許可を求められるのは、クライアントがシステムの通信処理機能を使うためです。システムがリモートノードを自動で提供するという意味ではありません。画面ロック後に接続が切れる場合は、バックグラウンド実行やバッテリー制限を確認してください。まず基本的な接続をテストし、その後でバックグラウンド設定を一つずつ調整しましょう。
ダウンロード AndroidクライアントiPhoneやiPadでは、ダウンロードページからClash PlusのApp Storeリンクと公式サイトclashplus.ioを確認できます。インストール後は、まずアプリ内のインポート手順を読み、サブスクリプション形式を確認してからVPN構成の追加を許可してください。インストール前に、ストアの製品ページに記載されたシステム要件を確認しましょう。
モバイルアプリでは、接続のオン・オフ、オンデマンド接続、プロキシ選択が別々の画面にある場合があります。インポート後は、設定を選択してから接続を開始してください。他のネットワークツールもインストールしている場合は、別のVPN構成が動作していないか確認しましょう。ツールの切り替えをノードの不具合と誤認するのを防げます。
ダウンロード iOSクライアントデスクトップではClash Verge RevとFlClashを比較し、ディストリビューションに合ったパッケージ形式を選びましょう。インストール方法を決める前に、ディストリビューション、プロセッサのアーキテクチャ、デスクトップ環境を確認してください。サーバーやルーターではコアを個別に導入することが多く、デスクトップクライアントとは手順が異なります。
ブラウザー、デスクトップ環境、コマンドラインのプログラムで、プロキシ設定が共通とは限りません。まずプロキシに対応したアプリでテストし、次にターミナルの環境変数、サービスの権限、ルーティングを確認します。仮想ネットワークインターフェースを有効にする前に、現在のネットワーク設定を把握してください。リモート操作中は、接続を復旧できる方法をあらかじめ確保しましょう。
ダウンロード Linuxクライアントまずは、動作を確認できる一連の手順を完了しましょう。ここでは重要な順序を示し、詳しいガイドでは各手順の画面、確認方法、失敗した場合の対処を解説します。
Profileは、切り替えて使える設定一式を指します。「設定」または「サブスクリプション」画面で信頼できる配布元のURLを追加するか、ローカルのYAMLファイルを読み込みます。追加後は、一覧に表示されているだけでなく、現在の設定として選択されていることを確認してください。
失敗した場合は、まずネットワークのダウンロードエラーか、内容の形式エラーかを確認します。ブラウザーでURLを開けても、互換性のある設定が返されるとは限りません。ログイン画面やエラーページはサブスクリプションとして読み込めません。サブスクリプションURLにはアクセス認証情報が含まれる場合があるため、公開するスクリーンショットに載せないでください。
ルールモードでは、設定された条件に従って接続を処理します。通信の振り分けを理解するには、まずこのモードを使うとよいでしょう。プロキシまたはプロキシグループの画面で、ルールが参照しているメインのプロキシグループを見つけ、利用可能な接続先を選びます。グループが入れ子になっている場合は、最終的に選択される接続先まで確認してください。
一度に多くの条件を変えないよう、DNSなどのネットワーク設定はまず初期状態のままにします。グローバルモードは通信に適用するポリシーを変えるもので、ノードの不具合を直すものではありません。DIRECTモードではリモートプロキシの正常性を確認できません。モードを確認したら、システムプロキシまたはクライアントが求める接続スイッチを有効にしてください。
テスト対象のWebサイトを開き、クライアントの接続ログで接続先、適用されたルール、出口を確認します。テスト先にアクセスできるかどうかと、通信がクライアントに届いているかどうかは分けて判断してください。接続一覧に該当する記録があれば、そのリクエストが現在の処理経路に入ったことを確認できます。
一覧に記録がない場合は、まずアプリのプロキシ設定を確認します。記録があるのにアクセスできない場合は、選択した出口、DNSの名前解決、ログのエラーを調べてください。テスト時刻とエラーのキーワードを記録し、一度に一つだけ変更して再テストしましょう。変更前後を比較しやすくなり、元の設定にも戻しやすくなります。
名前が似ていても、同じプロジェクトとは限りません。コア、画面、設定の入手元を分けて理解すると、手順がどの環境に当てはまるかを正しく判断できます。
Clashのルール設定方式は、多くの後続プロジェクトで引き継がれています。オリジナルのClashプロジェクトは開発が終了しましたが、コミュニティでは異なるコアやクライアントの開発が続いています。mihomoは進化を続けるオープンソースコアの一つで、プロジェクトの系譜はClash.Metaに関連しています。古いガイドに記載された名称と、現在の画面に表示される名称が異なる場合があります。資料を読むときは、Clashという名前が付いたソフトをすべて同じ製品と見なさず、対象のプロジェクトを確認してください。
クライアントは設定の読み込み、プロキシグループの表示、スイッチやログの管理を担い、コアは設定を解析して接続を処理します。クライアントにコアが同梱されている場合や、コアの切り替え・更新機能がある場合もあります。画面に項目があっても、現在のコアがその設定項目に対応しているとは限りません。反対に、コアが対応する機能を画面から利用できない場合もあります。互換性の問題が起きたら、「Clashでエラーが出る」とだけ伝えるより、クライアント名とコアの情報を記録しておくと役立ちます。
オープンソースプロジェクトのコード、ドキュメント、課題の議論から、機能の経緯をたどれます。ガイドを読むときは、まず対象プロジェクトのドキュメントで項目の定義を確認し、その後に具体的な事例を参照しましょう。リリースノートでは設定変更の理由を、課題の議論では再現条件を確認できます。ただし、あるユーザーの解決方法がすべての端末に適するとは限りません。以下にmihomoの公開リポジトリを掲載します。ソースコードの確認やコアの動作を調べたい場合に参照してください。通常の利用でプログラムを自分でビルドする必要はありません。
クライアント、コア、サブスクリプション、GeoIPデータの更新は、それぞれ異なる操作です。サブスクリプションを更新するとルールやノードが置き換わる場合があり、GeoIPデータの更新はIPアドレスの地域判定に影響します。プログラムの更新では、設定項目への対応やシステムとの連携方法が変わることもあります。更新前にローカルでの変更と動作する設定を保存し、変更内容を確認してから個別に更新してください。問題が起きたら、まず利用できていた設定と状態に戻しましょう。変更を重ねると原因の特定が難しくなります。
Clash入門ガイドは、日本語の入門情報とダウンロード先をまとめたサイトです。各エコシステムプロジェクトの開発チームではなく、プロキシノードやサブスクリプションサービスも運営していません。当サイトでは共通する操作の考え方を解説しています。権限、システムの対応範囲、個別の設定項目の動作については、利用するクライアントとコアのドキュメントを確認し、居住地域の法律とネットワーク利用に関する規則を守ってください。
Gitを利用できる環境では、コマンドを実行してソースコードを取得できます。このコマンドはリポジトリの内容をダウンロードするだけで、インストールやプロキシ設定の変更は行いません。
git clone https://github.com/MetaCubeX/mihomo.git基本的な接続を確認したら、実際に起きている問題に合わせて詳しく調べましょう。まず現象に合う記事を選び、すべての設定を一度に変更する必要はありません。起動の失敗、アプリがプロキシを通らない問題、設定構文のエラーは、それぞれ別に確認します。
ログファイルの場所から始め、ポートの競合、設定構文のエラー、コアファイルの不足など、起動時のクラッシュ原因を順に確認します。安全な設定の復元方法と、クリーンインストールの手順も紹介します。
記事を読む →config.yaml全体を上から順に読み解き、各セクションの役割や参照関係、よくある記述ミスを解説します。
記事を読む →UWPのネットワーク分離によってローカルループバックが制限される仕組みを解説し、クライアント内蔵ツールとCheckNetIsolationコマンドを使ってストアアプリの制限を解除する方法を紹介します。
記事を読む →クライアントは設定の管理や接続処理を行いますが、リモートプロキシのノードを自動で用意するものではありません。信頼できるサブスクリプションまたはローカル設定を準備し、読み込んで現在の設定として選択したうえで、プロキシグループの接続先を確認してください。接続スイッチが表示されても、設定内に利用可能なノードがあるとは限りません。手順は使い方ガイドをご覧ください。
設定を理解し始めた段階では、まずルールモードを使い、リクエストにどのルールが適用されるか確認しましょう。グローバルモードでは通常、コアに届いた接続をグローバルポリシーで処理しますが、もともとクライアントに届いていないアプリの通信を自動で取り込むわけではなく、利用できないノードを直す機能でもありません。切り替え後に結果が変わった場合は、接続先と接続ログを照らし合わせて判断してください。モード名だけから原因を決めつけないようにしましょう。ルールの構造はYAMLマニュアルで確認できます。
ノードのテストで確認できるのは特定のリクエストだけで、目的のWebサイトに必ずアクセスできるとは限りません。まずWebページへのリクエストが接続一覧に表示されるかを確認し、次に適用されたルールと実際の接続先を調べます。リクエストがクライアントに届いている場合は、DNSの名前解決とログのエラーも確認してください。ブラウザーのキャッシュ、接続先サイトの制限、アプリ独自のプロキシ設定が影響することもあります。トラブル対処の項目を順に確認し、むやみに再インストールしないようにしましょう。
上書きされる場合があります。リモートサブスクリプションを更新すると設定が再取得されるため、生成されたファイルを直接編集しても変更が残らないことがあります。まず元のファイルをバックアップし、クライアントにオーバーライド、マージ、独立したルール管理の機能があるか確認してください。長期間維持する変更は、永続化に対応した場所に保存し、更新後に実際に適用された設定を確認しましょう。具体的な動作はクライアントによって異なるため、ファイル名だけでは判断できません。まず設定のオーバーライドとマージの解説をご覧ください。