mihomo コア · 全プラットフォーム対応クライアントの使い方まずクライアントを選び、サブスクリプションの登録、ルールモード、システムプロキシの設定を行います。
クライアント、設定、通信の入口を順番に確認すると、問題を切り分けやすくなります。
クライアントの設定またはサブスクリプション画面を開き、サービス提供元から受け取ったURLをすべて貼り付けて保存し、更新します。サブスクリプションはノードや設定を取得するためのURLで、通常のWebページのアドレスとは異なります。設定名が表示されたら、現在使用する設定として有効にしてください。URLを保存しただけでは利用開始になりません。
まずサブスクリプションが有効か確認してから、クライアントの設定に進みます。URLにアカウント情報が含まれる場合があるため、スクリーンショットを共有するときは必ず隠し、見慣れないオンライン変換サイトにも貼り付けないでください。
設定 → 新規作成 → インポート → 有効化動作モードを「ルール」にし、プロキシグループから利用可能な接続先を選びます。プロキシグループは設定内で複数のノードをまとめるもので、グループ名はサブスクリプションによって異なり、解説の画面例と一致するとは限りません。ルールは通信をプロキシ経由にするか直接接続するかを決め、プロキシグループは実際に使う接続先を決めます。
まずはサブスクリプションに含まれるルール設定をそのまま使い、接続できてから変更しましょう。グローバルモードは一時的な切り分けに利用できます。初回接続のためにルール全体を書き換える必要はありません。
mode: ruleデスクトップクライアントでシステムプロキシを有効にし、ブラウザーで目的のページを開いて、接続ログに該当ドメインが記録されるか確認します。システムプロキシはOSがアプリに通知するプロキシ設定ですが、すべてのアプリが利用するわけではありません。ターミナルのコマンドや一部のゲームでは個別の設定が必要です。
テストが終わったら、システムプロキシをオフにする場所を確認しておきましょう。クライアントを終了する前に無効化してください。停止後もアプリが以前のローカルポートへ接続し続けるのを防げます。
アプリ → ローカルポート → ルール → 接続先OSとCPUアーキテクチャを確認してから、ダウンロードページでインストーラーを選びます。
GUIクライアントなら、ボタン操作で設定のインポートやプロキシグループの切り替え、ログの確認ができます。mihomo コアは実際の通信を処理するプログラムで、単体で動かすには設定ファイルを自分で用意する必要があります。一般的なデスクトップやスマートフォンでは、まずクライアントを選びましょう。サーバーやルーターで使う場合は、ダウンロードページにあるコアの選択肢も検討できます。クライアントによってメニューの位置は異なりますが、「設定」「モード」「プロキシ」「ログ」を手がかりに機能を探せます。
日常的なデスクトップ利用に適しています。まずシステム情報でOSの種類を確認し、対応するアーキテクチャのクライアントを選びましょう。インストール後はタスクトレイで動作状態を確認します。ポートが使用中の場合は、別のプロキシソフトが同時に起動していないか確認してください。
ダウンロードへ「このMacについて」で Apple Silicon か Intel かを確認してから、対応するインストーラーを選びます。初回起動時にシステムの許可を求められたら、表示内容を確認してから許可してください。ネットワークを切り替えた後に接続できない場合は、現在のネットワークサービスのプロキシ設定を確認します。
ダウンロードへ端末のアーキテクチャに合ったアプリをインストールし、初回接続時にシステムのVPN利用許可を確認してください。VPNインターフェースは端末の通信を取り込むために使われます。別のアプリが使用中の場合は、そのアプリを停止してからクライアントを起動します。
ダウンロードへダウンロードページから Clash Plus のストアページを開いてインストールし、対応する設定を読み込みます。画面の案内に従ってVPN接続を許可してください。モバイル端末ではアプリ内の接続スイッチを使います。対応機能や設定の範囲は、クライアントの説明を確認してください。
ダウンロードへデスクトップ環境では Clash Verge Rev または FlClash を選び、ディストリビューションに合ったパッケージ形式を使います。サーバーでは mihomo を直接実行できますが、設定ディレクトリ、プロセス権限、サービスの起動方法を自分で管理する必要があります。
ダウンロードへ各設定がどの部分を制御するかを確認してから、変更するか判断しましょう。
まずはルールモードを使い、設定された条件に応じて通信の接続先を選びます。グローバルモードでは、コアに届いた通信をグローバルプロキシグループへ送ります。ルールによる振り分けが原因かを一時的に確認するのに便利です。ダイレクトモードでは、コアに届いたリクエストを宛先へ直接接続します。モードの切り替えで変わるのはコアの処理方法であり、すべてのアプリの通信がクライアントを経由するわけではありません。切り替え後はリクエストを再実行し、接続ログを確認してください。既存の接続は以前の接続先を使い続ける場合があります。以下の説明を切り替えても、端末の設定は変更されません。
mode: ruleルールを上から順に照合し、最初に一致した条件のポリシーまたはプロキシグループを使います。
mode: globalコアに届いた通信をグローバルプロキシグループへ送ります。短時間の比較テストに適しています。
mode: directコアに届いたリクエストを直接接続し、プロキシ利用時との結果を比較します。
設定全体のサブスクリプションとプロキシプロバイダーを区別しましょう。前者にはプロキシグループ、ルール、DNS設定が含まれる場合があります。後者は通常ノードのみを提供し、メイン設定から参照されます。クライアントのサブスクリプション更新と、コアのプロキシプロバイダー更新は別の操作である場合があります。登録後は、最終更新日時、設定が有効か、プロキシグループに選択可能な接続先があるかを確認してください。自動更新の間隔は必要に応じて設定します。カスタムルールを維持するには、クライアントが対応する上書き機能を使い、リモート更新で手動の変更が上書きされないようにしましょう。
https://example.com/subscriptioninterval: 3600接続で実際に適用されたルールを確認してから、ルールの順序を調整します。ドメインサフィックスルールはドメイン名で照合し、GeoIPルールは宛先IPの地域データに基づいて判定します。MATCHは、それ以前のルールに一致しなかったリクエストを受け取ります。コアは通常、ルールを上から順に照合し、最初に一致した時点で判定を終了します。そのため、具体的な条件を広い条件より上に配置してください。例の PROXY は、設定内に実在するプロキシグループ名に置き換える必要があります。ルールをコピーする前にグループ名を確認し、地域判定に使うデータファイルも利用可能な状態にしてください。
DOMAIN-SUFFIX,google.com,PROXYGEOIP,CN,DIRECTMATCH,PROXYまずシステムプロキシを有効にしてブラウザーで動作を確認し、その後でTUNを検討しましょう。システムプロキシはアプリにプロキシのアドレスを知らせる設定で、アプリによっては利用されません。TUNは仮想ネットワークインターフェースで、ルーティング設定と組み合わせてより多くの通信を取り込めますが、権限が必要で、DNSやネットワーク経路にも影響します。両者は同じ接続スイッチではありません。初回設定では一度に一項目だけ変更し、接続ログを確認してから次に進みます。社内ネットワーク、別のVPN、仮想マシンのネットワークインターフェースを使っている場合は、すべての通信取り込み機能を同時に有効にするのではなく、まずルートの競合を確認してください。
ローカルの待ち受けポートとコントロールインターフェースは別のものです。混合ポートはアプリからのプロキシリクエストを受け付け、コントロールインターフェースは動作状況の取得や設定の管理に使われます。互いに置き換えることはできません。トップページのターミナルにある断片は項目を見分けるための例であり、ノード、プロキシグループ、ルールを含む完全な接続設定ではありません。初めて使う場合は、有効な設定を読み込んでから、クライアントに表示される実際のポートを確認して設定してください。
ダウンロード数ではなく、プロジェクトのソースコードとリリース情報を確認しましょう。
コアとGUIを分けて考えると、クライアントによって似た設定項目がある理由が分かります。Clashエコシステムは、設定の解析、ルールによる振り分け、プロキシ転送を中心に広がっています。オリジナルのClashと、その後に登場した派生プロジェクトは、同じソフトウェアとして継続的に更新されているわけではありません。Clash Meta は後に mihomo へ名称変更されましたが、古いチュートリアルや設定には旧名称が残っている場合があります。古い情報を参照するときは、まず対象のコアとクライアントを確認してから、手順が適用できるか判断してください。
クライアントの「バージョン情報」、コア設定、リリース情報を確認しましょう。GUIクライアントは設定管理、タスクトレイの操作、システムプロキシなどの機能を提供し、コアは通信を処理します。画面上の名称が似ていても、機能が同じとは限りません。プロトコルや設定項目への対応、更新方法はプロジェクトによって異なります。特に、デスクトップクライアントのメニュー手順をすべてのモバイルアプリに当てはめないでください。このサイトは導入情報とダウンロード先をまとめたもので、すべての上流プロジェクトの公式配布元ではありません。
クライアント、コア、サブスクリプションデータをそれぞれ確認します。クライアントの更新では画面やOSとの連携に関する問題が修正されることがあり、コアの更新ではプロトコルや設定の対応状況が変わることがあります。サブスクリプションの更新では、サービス提供元が配布するノードやルールが新しくなります。GeoIP、GeoSiteなどの地域・ドメイン分類データベースにも、それぞれ独立した更新方法があります。問題が発生したときは、どの層を変更したか記録しましょう。すべてを一度に更新すると原因を特定しにくくなります。
現在動作している設定、上書き内容、重要な項目を保存してから変更しましょう。mihomo を直接実行する場合は、設定をテストしてからサービスを起動できます。GUIクライアントでは、内蔵の設定チェック機能やログ画面を優先して使ってください。公開の不具合報告には必要なエラー情報だけを残し、サブスクリプションURL、ノードの認証情報、アカウント情報は隠します。個人設定を漏らさずに問題を説明できます。
まずクライアントが起動中か、現在の設定が有効かを確認し、アプリからのリクエストが接続ログに表示されるか確認します。ログがまったくない場合は、システムプロキシ、アプリ独自の設定、TUNによる通信の取り込みを優先して確認してください。ログがあるのに接続できない場合は、適用されたルール、プロキシグループの選択、ノードの利用可否を確認します。ブラウザーでは接続できてもターミナルで失敗する場合、コマンドラインツールのプロキシ設定を別途確認する必要があります。ブラウザーの結果だけで、すべてのアプリが接続できるとは判断できません。
エラー全文を保存し、問題が起きる前に変更した内容を記録すると、再インストールを繰り返すより原因を絞り込みやすくなります。クライアントを終了してもインターネットに接続できない場合は、まずシステムプロキシ設定を元に戻してください。特定のドメインだけ失敗する場合は、DNSの名前解決とルールを確認します。基本用語は用語集、よくある操作はFAQで確認できます。順番に切り分けたい場合は、トラブル診断ページをご覧ください。
初回接続ができたら、実際に直面した問題に合わせて詳しい解説を読み進めましょう。
dnsセクションの enhanced-mode、nameserver、fallback、fallback-filter、dns-hijack を項目ごとに解説。用途別に、そのまま参考にできる設定例も紹介します。
DNS設定の解説を読むコアとGUIを分けて、オリジナルのClashからClash Metaがmihomoへ名称変更された経緯と、各プラットフォームの主要クライアントがどのコアを採用しているかを整理します。
プロジェクトの関係を読むコアのログ確認から始め、設定の構文エラー、ポートの競合、権限、サービスモードを順に切り分けます。設定ファイルを安全にバックアップして復元する方法も紹介します。
クラッシュの対処手順を読む