mihomoコア · クライアントと設定ドキュメント

Clash Metaのダウンロードと設定ガイド

Clash をダウンロード 使い方を見る

OSに合ったクライアントを選び、サブスクリプションを読み込み、ルール分岐を設定して、プロキシ接続を確認します。

  • オープンソースコア
  • マルチプラットフォーム対応
  • 日本語の設定ガイド

プラットフォームとインストーラー

Clash クライアントをダウンロード

まずOSとCPUアーキテクチャを確認し、GUIクライアントを選びます。インストーラー、システム要件、メンテナンス状況はダウンロードページにまとめています。コアのファイルは別途掲載しています。

Windows

デスクトップでは、まずClash Plusを確認し、画面の好みに合わせてClash Verge Rev、FlClash、Clash Nyanpasuを比較できます。システムプロキシはOSの設定に従うアプリに適しています。より多くの接続を処理する場合は、TUNに必要な権限やサービスを確認してください。インストール前にCPUアーキテクチャを確認し、以前のクライアントのインストール先に新しいプロジェクトを上書きしないようにしましょう。

ダウンロードページへ

macOS

Apple SiliconとIntelを確認してから、対応するインストーラーを選びます。Clash Plus、Clash Verge Rev、FlClashはクライアント選びの候補になります。初回起動時はOSの案内に従って権限を許可してください。クライアントを切り替える前に、使用中のクライアントによるプロキシ制御を停止します。設定の互換性はアプリ名だけで判断せず、実際に使うコアと設定項目を確認してください。

ダウンロードページへ

Android

端末のアーキテクチャに合ったインストーラーを選び、初回接続時にVPNの許可を確認してください。Clash Plus、Clash Meta for Android、FlClashでは設定画面が異なります。まずサブスクリプションを読み込み、アプリごとの通信分岐とバックグラウンド実行の制限を確認しましょう。SurfboardはClash YAMLとは設定形式が異なるため、ファイルの拡張子を変えるだけでは使えません。

ダウンロードページへ

iOS

ダウンロードページにはClash PlusのApp Storeページと公式サイト clashplus.io へのリンクがあります。インストール後、VPN構成の追加を許可し、クライアントが対応するリンクまたはファイルを読み込みます。デスクトップ設定のローカルパス、スクリプト、OS固有の項目は、スマートフォンでは使えない場合があります。読み込みエラーが出たら、内容を編集する前に設定形式とアプリの対応範囲を確認してください。

ダウンロードページへ

Linux

デスクトップ環境がある場合は、Clash Verge RevやFlClashから試し、ディストリビューションに合ったパッケージ形式を選びます。サーバーやルーターで使う場合は、mihomoコア単体のダウンロード先を確認してください。設定ディレクトリ、プロセス、ネットワーク権限は自分で管理する必要があります。GUIクライアントとバックグラウンドサービスが、同じ待ち受けポートや仮想ネットワークインターフェースを同時に使用しないようにしましょう。

ダウンロードページへ

インストールが完了しても、プログラムが起動できることを示すだけで、サブスクリプション、ノード、ルール分岐が機能しているとは限りません。初回はクライアントを1つだけ起動し、元の設定をコピーしてから、「読み込み、選択、確認」の順にチェックしましょう。

すべてのクライアントを見る →

設定機能をチェック

mihomoとルール分岐

GUIは操作を担い、コアは接続とルールの処理を担います。目的に応じて機能を確認し、適用範囲を理解してから有効にするか判断しましょう。

宛先に応じてアウトバウンドを振り分け

ルール分岐では、接続先ごとに異なるアウトバウンドへ振り分けられるため、アクセスのたびにモードを手動で切り替える必要がありません。mihomoはルールを上から順に照合し、最初に一致したルールで接続先が決まります。ドメイン、IPアドレス範囲、ルールセットなどを条件に指定できます。プロキシグループは選択可能なアウトバウンドをまとめるもので、ルールとは別の仕組みです。特定のアプリが意図しない経路を通る場合は、接続ログで適用されたルールを確認して順序を調整しましょう。すべての通信をグローバルモードに切り替えるのは避けてください。

詳しく見る ›

ルールとプロキシグループの違い

設定を読み込んだら、まずプロキシ画面でプロキシグループのアウトバウンドを選び、ルールモードで新しい接続を試します。手動選択のグループは選択内容を保持し、自動テストを行うグループは設定に従って接続をテストし、切り替えます。オリジナルのClashと比べ、mihomoでは一部のルール機能やプロキシ機能が拡張されていますが、利用できる設定項目はコアのドキュメントで確認してください。独自ルールは優先的に適用する必要がある位置に追加し、クライアントのオーバーライドまたはマージ機能を使いましょう。次回のサブスクリプション更新で変更が失われるのを防げます。

詳しく見る ›

初回起動の流れ

サブスクリプションの読み込みと接続確認

再現できる手順で確認しましょう。まず設定が正常に読み込まれることを確かめ、次にアウトバウンドを選び、最後に実際の接続を確認します。一度に変更する設定は一種類に絞ります。

手順 01 / 設定

Profileを読み込んで有効化

クライアントの設定画面を開き、信頼できる提供元のサブスクリプションURLを貼り付けるか、ローカルのYAMLファイルを選択します。ダウンロードと解析が完了したら、その設定を選択してください。ファイルが一覧に表示されただけでは、コアに読み込まれたとは限りません。現在の設定を示す表示とエラーメッセージの両方を確認しましょう。

読み込みエラーが出たら、URLから設定内容ではなくWebページが返されていないか確認し、形式が現在のコアに対応しているかを調べます。サブスクリプションURLには認証情報が含まれることがあります。スクリーンショットを共有する際はURL全体を隠し、公開の掲示板に貼り付けないでください。オーバーライドやマージを試す前に、復元できる設定のコピーを保存しましょう。

手順 02 / アウトバウンド

モードとプロキシグループを選択

初回接続ではルールモードを使い、設定に含まれるプロキシグループからアウトバウンドを選択します。その後、OSの要件に応じてシステムプロキシを有効にするか、VPN接続を許可してください。遅延テストの結果は、特定のテスト先への接続状況を示すものです。すべてのWebサイトの表示速度を表すわけではなく、実際のリクエストの代わりにもなりません。

まず基本のプロキシ経路が動作することを確認し、必要に応じてTUNを使います。グローバルモードはプロキシの選択方法を変える機能で、システムプロキシを無視するアプリが自動的にプロキシを使うようになるわけではありません。モードを切り替えたら新しい接続を作成して確認しましょう。すでに確立した長時間接続は、切り替え前のアウトバウンドを使い続けることがあります。

手順 03 / 検証

接続と適用ルールを確認

接続先が明確なテスト用サイトにアクセスし、クライアントの接続一覧で対象ドメイン、適用ルール、プロキシグループ、最終的なアウトバウンドを確認します。出口を確認する場合は、信頼できるIPアドレス確認サイトも利用してください。ページが開けたことだけでは、そのリクエストが想定した経路を通ったとは限りません。接続記録もあわせて確認しましょう。

ブラウザーでは正常に動作するのに特定のアプリだけ失敗する場合は、そのアプリがシステムプロキシに従うかを確認し、次に通信の処理範囲とDNSを調べます。Windowsのストアアプリでは、ループバック制限が関係することもあります。問題が起きたアプリ、接続先、ログの概要を記録し、設定、プロキシ経路、名前解決を分けて調査しましょう。複数の項目を同時に変更すると、比較の基準が失われます。

ガイド全文を見る → 初回接続の確認リスト →

プロジェクトとメンテナンス情報

オープンソースのエコシステムとコアの関係

コアプロジェクト、GUIクライアント、サブスクリプションの提供元を区別しましょう。ソースコード、ライセンス、更新履歴は確認できますが、クライアント名だけではすべての設定の互換性は保証されません。

Clash、Meta、mihomoの違い

Clashは、この種のルールベースのプロキシツールの重要な起点です。Clash Metaは関連する設定体系を引き継ぎ、プロトコルやネットワーク機能を拡張しました。その後継となるコアプロジェクトはmihomoの名称で開発が続いています。日常的な検索で「Clash Meta」と書かれている場合、コアを指すことも、そのコアを採用したGUIクライアントを指すこともあります。具体的なプロジェクトを確認する際は、アプリ名、コアの説明、メンテナンス履歴を照らし合わせましょう。3つの名称を、互換性のあるインストーラーとして扱うことはできません。

コアは設定の解析、ルール照合、接続処理を担います。GUIクライアントは通常、サブスクリプション一覧、トレイ操作、システムプロキシの切り替え、ログ画面などを提供します。同じコアでもGUIは異なり、GUIごとに設定を読み込む前の処理方法が違う場合もあります。移行時は、書き出した内容が標準的なコア設定なのか、特定のクライアントでのみ使われる管理データなのかを確認してから、取り込む方法を決めてください。

ソースコードとライセンス

mihomoのソースコードとプロジェクトの説明は、MetaCubeXの公開リポジトリで確認できます。コアのライセンスはGPL-3.0です。ライセンスにはコードの使用、改変、再配布に関する条件が定められていますが、すべてのGUIクライアントが同じライセンスを採用しているわけではありません。また、サブスクリプションサービスをコアプロジェクトが提供していることを示すものでもありません。再配布や二次開発を行う場合は、利用する各プロジェクトのライセンスと依存関係の説明を確認してください。

ソースコードを確認する目的は、実装とドキュメントを照合することです。スター数を接続品質の保証と見なすことではありません。この記事では、変動する人気度の数値は掲載していません。機能が使えるか判断する際は、公開ドキュメント、変更履歴、現在のクライアントに統合されているコアを優先して確認しましょう。コミュニティの議論は既知の問題を探すのに役立ちますが、報告を投稿する前に、設定内の認証情報や個人情報を削除してください。

mihomoのオープンソースリポジトリを見る ↗

更新の仕組みと互換性の範囲

クライアント、コア、サブスクリプション、ルールセットの更新は、それぞれ別のものです。クライアントの更新では画面や権限の手順が変わることがあります。コアの更新では、プロトコルや設定項目が変更される場合があります。サブスクリプションの更新は主にリモート設定の内容を更新し、ルールセットの更新はルールが参照するデータを変更します。問題が発生したら、まずどの層が更新されたかを特定し、該当する履歴を確認しましょう。あらゆる問題をサブスクリプションのせいにせずに済みます。

更新前に設定のコピーとローカルのオーバーライドを保存します。更新後は以前と同じテスト先で基本の接続を確認し、次に独自ルールを検証してください。古い設定を解析できても、以前と同じ動作が保証されるわけではありません。逆に、新しい設定の拡張項目を古いコアが読み込めない場合もあります。アーカイブされたクライアントは旧環境の確認に使えますが、日常利用ではメンテナンス履歴があり、対応OSが明確なプロジェクトを優先しましょう。

サブスクリプションの提供元とガイドの対象範囲

このサイトでは、クライアントのダウンロード先、操作手順、用語を解説しています。サブスクリプションに含まれるアウトバウンド、サーバーの設定項目、リモートURLへのアクセス可否は、それぞれの設定提供元によって決まります。クライアントをインストールしただけでは接続できず、有効な設定が必要です。インストーラーそのものがサブスクリプションサービスを提供するわけではありません。設定項目を確認するときは、プロトコル、形式、利用条件を設定提供元に問い合わせましょう。クライアント名から接続情報を推測しないでください。

クライアントによってボタン名や設定画面の場所は異なるため、ガイドでは「設定を読み込む、アウトバウンドを選ぶ、通信を処理する、接続を確認する」という流れで説明します。画面が異なる場合は、該当する機能を探せばよく、すべてのスイッチを手順どおりに設定する必要はありません。プロキシグループ、ルールセット、DNS拡張モードについて知りたい場合は、まず用語ガイドを確認してください。プロトコルやコアの機能を比較する場合は、プロトコルガイドをご覧ください。

用語ガイド › プロトコルガイド › よくある質問 ›

mihomoのソースコードを取得

Gitをインストール済みの環境では、以下のコマンドを実行できます。クローンで取得できるのはソースコードのリポジトリです。GUIクライアントが自動でインストールされたり、システムプロキシが有効になったりすることはありません。ビルドと実行の要件はリポジトリのドキュメントをご確認ください。

git clone https://github.com/MetaCubeX/mihomo.git

ローカルのターミナルに貼り付けて実行できます。実行前にコマンドの内容を確認してください。

設定とトラブルの記録

最近の技術記事

設定管理、DNSの動作、アプリの互換性について解説します。まず問題が発生している層を特定し、記事の手順に沿って一つずつ確認してください。

すべての記事を見る →