Clash Meta / mihomo コア
デバイスに合ったクライアントを選び、サブスクリプションの読み込みからルールによる振り分けまで、mihomo コアの設定方法とトラブル対処を確認できます。
対応プラットフォーム
設定項目から通信経路を理解しましょう。テーマを選ぶと、用途や有効化の手順、YAMLの例を確認できます。サンプルは一部の設定例です。既存の設定に追加し、プロキシグループ名とルールの対象を一致させてください。
ルールモードでは、rulesを上から順に確認し、最初に一致したルールのポリシーを適用します。一致後は以降のルールを調べません。ドメイン末尾一致は同じサービスのサブドメインをまとめて指定する場合に、IPルールは既知のアドレス範囲に、MATCHは他のルールに一致しない接続に使います。個別に処理するルールを先に置き、その後に地域別ルールと最後のポリシーを追加しましょう。mihomoは一般的なClashルールの書き方を引き継ぎつつ、ルール機能を拡張しています。旧設定から移行する場合は、使用するルールタイプとデータファイルが現在も対応しているか確認してください。以下の例では、PROXYはプロキシグループ名です。設定内で先に定義する必要があり、ルールだけをコピーしても起動できません。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYプロキシグループを使うと、ルールの対象と実際の接続先を分けられます。接続先を変更しても、ルールを一つずつ書き換える必要はありません。selectは手動選択、url-testはテスト結果に基づく選択、fallbackは順番に利用可能な接続先を探す方式です。手動で切り替えるか自動で切り替えるかを決めてから、グループの種類と候補を設定しましょう。mihomoは一般的な旧形式のプロキシグループにも対応していますが、新しいフィールドは旧コアで認識されない場合があります。移行時は実際に使用するコアのドキュメントを確認してください。以下の例では、解析可能な最小構成としてDIRECTを指定しています。サブスクリプションを読み込んだ後、proxiesまたはuseで実際の接続先を追加すると、ルール内のPROXYから接続先を選択できます。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECTfake-ipはドメインに仮想IPアドレスを割り当て、後続の接続でもドメイン情報を保持することで、ドメインルールを適用できるようにします。dnsを有効にしたら、アプリのDNSリクエストが実際にコアを経由しているかも確認してください。enhanced-modeを変更するだけで、システムの名前解決がすべて自動的に切り替わるわけではありません。旧コアと比べてmihomoはDNSポリシーの選択肢が多いため、移行時に出所不明の設定をそのまま流用するのは避けましょう。LAN内のサービスや特定のアプリで問題が起きる場合は、ドメインごとにfake-ip-filterを設定し、キャッシュも確認してください。以下は基本構成のみです。上流DNSサーバーは、利用するネットワークから実際にアクセスできるものを選んでください。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- '*.lan'
nameserver:
- https://dns.alidns.com/dns-queryTUNは仮想ネットワークインターフェースを通じて通信を処理するため、システムプロキシ設定を参照しないプログラムに適しています。デスクトップでは通常、管理者権限またはクライアントのサービスモードが必要です。スマートフォンではシステムのVPN機能を利用します。有効にする前に通常のプロキシで接続できることを確認し、自動ルーティングやDNSの横取りを段階的に設定しましょう。接続先の障害をルーティングの問題と取り違えにくくなります。旧コアやクライアント、OSによってTUNの実装は異なります。設定ファイルにtunと書かれていても、現在のプログラムが読み込めるとは限りません。起動後にLANへ接続できなくなった場合は、クライアントを何度も再インストールするのではなく、ルート、ネットワークアダプター、他のVPNとの競合を確認してください。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53完全な設定を含むサブスクリプション、proxy-providers、rule-providersは、それぞれ内容が異なります。完全なサブスクリプションはプロキシ、グループ、ルールを上書きする場合があります。プロキシセットは接続先のみ、ルールセットは照合条件のみを提供します。分けて管理すれば、ローカルのポリシーを保ったまま必要なデータだけ更新できます。mihomoは複数のルールセット形式に対応していますが、旧コアではすべての形式やフィールドを認識できるとは限りません。移行前にbehaviorとformatを確認してください。以下の例では、ローカルのclassicalルールファイルをRULE-SETで参照します。ファイルをあらかじめ用意し、payloadリストを含める必要があります。リモートのサブスクリプションURLにはアクセス権限の情報が含まれます。ログや設定を共有する前に削除してください。
rule-providers:
local-direct:
type: file
behavior: classical
format: yaml
path: ./rules/local-direct.yaml
rules:
- RULE-SET,local-direct,DIRECT
- MATCH,PROXY外部コントローラーは、パネルから接続情報の読み取りやポリシーの切り替え、実行状態の変更を行うための機能です。ブラウザー用のプロキシポートではありません。external-controllerを有効にしたら、パネル側にも対応するアドレスを設定します。external-uiには、設定ディレクトリに配置したパネルのフォルダーを指定します。mihomoは一般的なコントローラーAPIの使い方を引き継いでいますが、新機能への対応状況はパネルによって異なります。まずはループバックアドレスにバインドし、ローカルからのみアクセスできるようにしてください。リモート管理が必要な場合は、認証とネットワークアクセスの範囲を設定します。一部のGUIクライアントはコントローラーのアドレスや認証情報を自動管理します。手動設定と実行時の上書きが競合しないよう、まずクライアントの設定を確認してください。
external-controller: 127.0.0.1:9090
external-ui: ./ui
log-level: infoGUIクライアントはサブスクリプション管理、システムプロキシ、日常の操作を担当し、コアはプロトコル、名前解決、ルールの処理を担います。まずデバイスに合ったクライアントを選び、CPUアーキテクチャ、OSの要件、設定の対応範囲を確認しましょう。
まずはClash Plusなど、継続的にメンテナンスされているGUIクライアントを検討しましょう。インストール後にサブスクリプションを読み込み、システムプロキシを有効にして、ブラウザーの接続を確認します。ゲームやストアアプリの通信も処理したい場合は、TUNとループバックの制約について確認してください。
Clash for Windowsから移行する場合は、サブスクリプション、カスタムルール、上書き設定を先にバックアップしてください。新しいクライアントでは設定ディレクトリやサービスモードが異なる場合があるため、旧ディレクトリ全体をそのまま上書きしないでください。システムプロキシのポートも、新しいクライアントに表示される値を使用しましょう。
をダウンロードApple SiliconとIntelのどちらを搭載しているか確認してから、対応するインストーラーを選びます。Clash PlusやClash Verge Revなどのクライアントで、サブスクリプションやルールを管理できます。インストール後のネットワーク権限は、OSの案内に従ってください。
システムプロキシとTUNでは、必要な権限が異なります。ブラウザーは接続できるのにターミナルから接続できない場合は、コマンドラインのプログラムがプロキシ環境変数を参照しているか確認してください。通信を透過的に処理する必要がある場合に限ってTUNを有効にし、既存のVPNと同時にデフォルトルートを変更しないようにしましょう。
をダウンロードClash PlusやClash Meta for Androidなどのクライアントを選べます。設定を読み込んだ後、VPN接続を許可し、アプリから通信できるか確認してください。インストールパッケージのアーキテクチャは端末に合わせる必要があります。不明な場合は、まず端末のプロセッサ情報を確認しましょう。
バックグラウンドで切断されても、サブスクリプションが無効とは限りません。まずバッテリー最適化、バックグラウンド実行、自動起動の権限を確認し、Wi-Fiなどの接続先を切り替えた後に復旧するか試してください。一度に変更する設定を一つに絞ると、OSによるアプリの終了か通信経路の変化かを判断しやすくなります。
をダウンロードダウンロードページではClash PlusのApp Storeへのリンクと、公式サイトclashplus.ioを案内しています。インストール後、クライアントが対応する形式でサブスクリプションを読み込み、VPN構成の追加を許可してください。その後、システム設定で接続状態を確認します。
同じサブスクリプションでも、クライアントによって対応フィールドが異なる場合があります。読み込みに失敗したら、リンクの応答が完全な設定なのかプロキシセットなのかを確認し、具体的なエラー内容を調べてください。デスクトップ版の待ち受けアドレス、ファイルパス、TUN設定を、そのままスマートフォンに流用しないでください。
をダウンロードデスクトップではClash Verge RevやFlClash、サーバーやルーターではmihomoコアのパッケージを検討できます。インストール前に、ディストリビューションのパッケージ形式とCPUアーキテクチャを確認し、設定ディレクトリと実行権限を設定してください。
コマンドラインで実行する場合は、まずフォアグラウンドでログを確認し、設定が読み込まれることを確かめてからサービス管理ツールに登録します。一般ユーザーによるポートの待ち受け、TUNデバイスの作成、ルートの変更では必要な権限が異なります。設定エラーと権限エラーを分けて対処してください。
をダウンロードコア、クライアント、設定の入手元を分けて理解しましょう。ソースコードでは実装方法、リリースノートでは変更点を確認できます。具体的な操作手順はクライアントの画面によって異なります。
Clash Metaは、このコアプロジェクトが初期に使用していた名称です。現在はmihomoの名称で開発が続いています。チュートリアルを検索すると、旧名称や以前のリポジトリURL、異なるクライアントの画面が見つかることがあります。設定が利用できるかどうかは、クライアント名にMetaが含まれているかではなく、実際に動作するコアとそのドキュメントで判断してください。GUIの更新とコアの更新は、同時に行われるとは限りません。
mihomoはプロキシプロトコル、DNS名前解決、ルールによる振り分けを処理し、GUIクライアントはその上に設定管理、システム連携、操作画面を提供します。サブスクリプションは、ユーザーが選んだサービスまたは自分で作成した設定から取得します。クライアントをインストールしても利用可能な接続先が自動で作成されるわけではなく、ソースコードが公開されていてもサブスクリプションの内容が公開されるわけではありません。当サイトではダウンロード先と日本語の利用情報を紹介しています。各プロジェクトの開発、リリース、問い合わせ対応は、それぞれのメンテナーが担当します。
コアのソースコードはMetaCubeX/mihomoリポジトリで確認できます。ライセンスはリポジトリ内のLICENSEファイルを参照してください。コミット履歴、Issueの議論、リリースノートを確認すると、特定のフィールドが対応しているか、動作に変更があったかを判断できます。以下のコマンドで閲覧用のソースコードを取得できます。GUIクライアントをインストールする一般ユーザーには必須の手順ではなく、サブスクリプションの読み込みやネットワーク設定の代わりにもなりません。
クライアントやコアを更新する前に、現在の設定とローカルの上書き内容をバックアップし、変更内容を確認してください。更新後は、まず設定が正常に読み込まれたことを確かめてから、DNS、ルールの適用状況、接続先を個別に確認します。問題が起きた場合は、OS、クライアント名、コアの情報、最小限の再現手順を記録してください。ログを共有する前に、サブスクリプションURL、認証情報、個人用ドメインを削除します。設定全体のスクリーンショットより、再現手順が明確な方が問題を特定しやすくなります。
コアの実装、設定の変更、コミュニティの議論を確認できます。デスクトップ版とモバイル版の機能対応は、それぞれ個別に確認してください。
コアのソースコードを見る ↗git clone https://github.com/MetaCubeX/mihomo.git初めて使う場合は、「サブスクリプションを読み込む、ルールモードを選ぶ、プロキシを有効にする、接続を確認する」の順に進めましょう。すべてのネットワーク機能を一度に有効にする必要はありません。ブラウザーで接続できたら、ターミナル、ストアアプリ、LAN内のデバイスに必要な設定を追加します。
サブスクリプション、モード、ポートの入門ガイド →インターネットに接続できない場合は、サブスクリプションの取得失敗、設定の読み込み失敗、接続先への接続失敗を切り分けます。それぞれ問題のある経路が異なるため、ログで最初に発生した有効なエラーから順に調べましょう。
症状からトラブル対処を確認 →ルールモードとグローバルモード、システムプロキシとTUN、HTTPポートとコントローラーポートは混同しやすい項目です。設定を変更する前に、どの階層を制御する項目なのか確認してください。通信を広範囲に取り込む設定で、元の問題を覆い隠さないようにしましょう。
よくある問題の解決方法を見る →よくある利用シーンから確認できます。初心者向けの設定、旧クライアントからの移行、Windowsアプリのループバック制限などを、操作手順と適用条件を交えて解説します。
UWPアプリで既定ではローカルのループバックアドレスにアクセスできない理由を解説します。GUIの例外設定ツールとCheckNetIsolationコマンドを使った解除方法、TUNモードによる代替方法も比較します。
トラブル対処の手順を読む →更新が終了したクライアントの現状とリスクを整理し、プラットフォーム別に代替となるmihomoコア搭載クライアントを紹介。サブスクリプション、カスタムルール、上書きスクリプトの移行手順も解説します。
移行手順を読む →初めて使うときにつまずきやすい10の疑問を解説します。サブスクリプションの入手先、ルールモードとグローバルモードの選び方、ポート7890の役割、mihomoと旧コアの関係などを、設定場所とあわせて紹介します。
初心者向け10の疑問を読む →