mihomoコアオープンソースクライアントを継続更新

Clash Meta導入と設定

mihomoコアをベースに、サブスクリプションの読み込みからルール分岐まで、設定項目ごとにプロキシ、DNS、TUNを解説します。

コアのソースコードを公開中国語の設定ドキュメントYAML設定

CONFIGURATION INSPECTOR

mihomo設定チェッカー

設定ファイルは、通信の受け入れから名前解決、ルール判定、送信先までを順に定めます。まずリクエストがコアに届いていることを確認し、次にマッチしたルールとプロキシグループを調べましょう。複数の設定を一度に変えるより、該当する項目に絞って確認するほうが原因を特定しやすくなります。

RULES / FIRST MATCH

上から順に判定し、最初の一致を適用

ルールは上から順に評価され、一致すると指定されたプロキシグループで処理されます。ドメインサフィックスは対象サイトの指定に、地理情報ルールはIPアドレスの地域判定に使えます。最後のMATCHは、ほかのルールに一致しなかった通信を受け持ちます。サイトへの接続先が想定と異なる場合は、接続ログでドメイン、マッチしたルール、最終的なプロキシグループを確認してください。選択中のノードだけを見ても原因は分かりません。Ruleモードではこのルール一覧が適用され、Globalモードではグローバルポリシーが使われます。モードを切り替えてもルール自体は修正されません。例で参照するPROXYグループは事前に定義が必要です。また、GEOIPルールには利用可能な地理情報データが必要です。

mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

CLIENT ENTRY POINTS

ClashクライアントのOS別ダウンロード

まずOSを選び、次にCPUアーキテクチャを確認してください。GUIクライアントは設定管理やシステムとの連携を担い、コアはルールの判定と通信の転送を処理します。インストーラーの対応状況、TUNに必要な権限、設定形式の互換性はそれぞれ確認が必要です。クライアント名だけで判断しないでください。

Windows

まずはClash PlusなどのGUIクライアントから始めましょう。初回接続ではシステムプロキシの動作を確認し、アプリに応じてTUNを有効にします。ポート競合やサービス権限の警告が出た場合は、サブスクリプションを何度も変更するのではなく、まずローカル環境を確認してください。

ダウンロードページへ

macOS

Apple SiliconまたはIntelに合ったインストーラーを選んでください。システムプロキシとネットワーク拡張では許可する場所が異なるため、インストール後にシステムの案内を確認します。スリープからの復帰後やネットワーク切り替え後は、接続先と名前解決が正常か再確認してください。

ダウンロードページへ

Android

デバイスのアーキテクチャとインストール権限を確認し、サブスクリプションを読み込んだらVPN接続を許可します。バックグラウンドの省電力設定でサービスが停止することがあります。画面ロック後に切断される場合は、バッテリー制限と、ほかのVPNアプリが通信の取り込み機能を使用していないか確認してください。

ダウンロードページへ

iOS

ダウンロードページからClash PlusのApp Storeページへ進んでください。公式サイトはclashplus.ioです。読み込み前に設定形式の互換性を確認し、初回起動時はシステムの案内に従ってVPN接続を許可してから、ルールと接続先を検証してください。

ダウンロードページへ

Linux

デスクトップではGUIクライアントを選べます。サーバーやルーターで使う場合は、コアのダウンロード先を確認してください。インストール前に、ディストリビューションのパッケージ形式、CPUアーキテクチャ、サービスの実行ユーザーを確認しましょう。デスクトップのプロキシ設定だけで、端末全体の通信が取り込まれるとは限りません。

ダウンロードページへ

ダウンロードページでは、OS別にクライアント、アーキテクチャ、システム要件を確認できます。すでに別のクライアントを使っている場合は、移行前に設定をエクスポートし、ローカルルール、オーバーライド、プロキシグループの選択内容を記録してください。同じサブスクリプションでも、ツールによって変換処理が異なる場合があります。画面が似ていても、設定の処理方法まで同じとは限りません。

Clash for Windowsは更新が終了していますが、古いインストーラーがチュートリアルのスクリーンショットに残っている場合があります。新たに導入する場合は、メンテナンスが続いている選択肢を優先し、アーカイブ版は明確な互換性要件がある場合に限って利用してください。移行後は古いツールの自動起動とシステムプロキシを無効にし、複数のプロセスによるポート競合やシステム設定の上書きを防ぎましょう。

クライアント一覧を見る →

FIRST CONNECTION

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

クライアントをインストールしただけでは、通信がプロキシ経由になるとは限りません。「設定を読み込む → プロキシグループを選ぶ → 通信を取り込んで検証する」の順に進めると、サブスクリプションの取得、ノードへの接続、ローカル通信の取り込みを切り分けられます。以下の画面は設定項目の一例です。具体的なメニュー名は使用するクライアントによって異なります。

01

サブスクリプション設定を読み込む

設定またはサブスクリプションの画面を開き、リモート設定を追加して既存のURLを貼り付けます。取得できたら、その設定を選択してプロキシグループが表示されることを確認してください。URLを保存しただけで設定を有効にしていない場合、現在の接続は変わりません。

Webページやログイン画面が返る場合、または内容が空の場合は、まずサブスクリプション提供元にURLとアカウントの状態を確認してください。アカウント情報を含むURLを公開変換サイトに送信したり、サブスクリプションの内容を公開の質問掲示板に貼り付けたりしないでください。

02

ルールと接続先を選ぶ

初回はRuleモードを選び、実際のルールから参照されているプロキシグループでノードを指定してテストします。遅延テストの結果は特定の接続先への測定値であり、すべてのWebサイトの表示速度を示すものではありません。

テストがタイムアウトしても、ノードが完全に使えないとは限りません。測定先や名前解決経路に問題がある場合もあります。実際のWebサイトへの接続やログも確認し、まず接続先を一つに固定して検証してから、自動テストやフォールバックを設定してください。

03

通信を取り込んで動作を確認

まずシステムプロキシを使ってブラウザーで動作を確認します。プロキシ設定に従わないアプリでは、必要に応じてTUNを有効にしてください。対象サイトを開き、接続ログでマッチしたルール、プロキシグループ、最終的な接続先が想定どおりか確認します。

検証時は、ブラウザー、ターミナル、その他のアプリを分けて確認してください。ターミナルのツールでは、プロキシ環境変数を個別に設定する必要がある場合があります。また、IP確認サイトに表示されたアドレスはその問い合わせの接続先を示すだけで、すべての通信が同じ経路を通っている証拠にはなりません。

詳しいガイドを見る →

SOURCE & MAINTENANCE

オープンソースのコアとクライアントの役割

Clash Metaとmihomoの関係

Clash Metaは、このコアの系統で初期に使われていた名称です。現在、コアプロジェクトはmihomoとして開発・保守されています。検索結果、設定ガイド、一部のクライアント名には、今もMetaの表記が残っています。ドキュメントが使えるか判断するときは、ウィンドウのタイトルではなく、実際に動作しているコアと対応する設定項目を確認してください。古いスクリーンショットにあるボタン名が、現在の画面では変わっていることもあります。

mihomoは設定の解析、プロトコル処理、ルール判定、DNSなどを担います。GUIクライアントはその上に、サブスクリプション管理、トレイメニュー、システムプロキシ、サービス管理などを提供します。クライアントの更新とコアの更新は別々です。設定キーが認識されない場合は、更新する前に実際のコア情報と読み込みログを確認し、どちらの層を更新すべきか判断してください。

ソースコードとドキュメントで動作を確認

公開リポジトリのコード、ライセンス、課題、リリースノートは、動作を確認するための重要な情報源です。ガイドと実際の画面が一致しない場合は、該当プロジェクトのドキュメントとリリース履歴を確認し、設定項目の名称やデフォルト値が変わっていないか、新しい実行権限が必要かを調べてください。当サイトは中国語の操作ガイドを提供するもので、上流プロジェクトによる機能説明に代わるものではありません。

mihomoの上流リポジトリを見る ↗ · 当サイトの掲載範囲について →

設定とサービスの提供元を分けて管理

プロキシコアやクライアントは、プロキシサービスそのものではありません。サブスクリプションに含まれるノード、回線の稼働状況、通信量、アカウントの有効期限はサービス提供元によって決まります。クライアントを新しくダウンロードしても、期限切れのサブスクリプションは復旧しません。いわゆるClash向けVPNサブスクリプションは、サービス提供元から渡される設定の入口です。利用前に提供元、プロトコルの対応状況、サービス規約を確認し、コアプロジェクトに通信サービスが付属していると誤解しないでください。

ルール一覧、地理情報データ、プロキシのサブスクリプションには、それぞれ異なる更新周期があります。ClashのGeoIPデータを更新する場合は、設定で使われているデータ形式とファイルの保存先を確認してください。サブスクリプションを更新する場合は、ノード一覧とローカルのオーバーライドが保持されているか確認します。更新作業を分けて実行すると、問題が起きても既知の状態に戻しやすくなります。

更新前に記録し、更新後に動作確認

現在動作している設定、重要なオーバーライド、起動オプションを保存し、変更内容を確認してから更新してください。更新後は、起動とYAMLの読み込みを確認してから、DNS、よく使うWebサイト、通信を取り込む必要があるアプリをテストします。差異が見つかった場合は、機密情報を伏せたエラーメッセージを保存してください。問い合わせ時はOS、アーキテクチャ、クライアント、コアの情報を伝え、実際のサブスクリプションURL、パスワード、アカウント情報全体は共有しないでください。

SOURCE / GIT CLONE

ソースコードの取得は実装の確認や変更履歴の追跡に使います。cloneで取得できるのはリポジトリの内容であり、クライアントが自動でインストールされるわけではありません。一般的なデスクトップ環境では、ダウンロードページのインストーラーを利用できます。

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

CONFIGURATION NOTES

接続確認とトラブル対処の記事

基本設定が終わったら、症状に合ったガイドを確認してください。システムプロキシが効かない、ルールが誤ってマッチする、ノードが利用できないといった問題は、それぞれ異なる段階で発生します。現状を保ったままリクエストがどこで想定から外れるかを特定し、関連する設定だけを変更しましょう。