mihomoコア · Appleシリコンにネイティブ対応

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

AppleシリコンとIntel Macに対応したGUIクライアント。購読設定とルール振り分けをまとめて管理できます。

オープンソースのコア メニューバーから管理 設定ガイド

クライアント設定の画面例です。項目名やメニューの場所はクライアントによって異なります。スイッチの状態は説明用です。

macOSの設定項目を確認

メニューバー、プロキシモード、購読管理

まず、クライアントの画面、プロキシコア、設定ファイルの役割を分けて考えましょう。画面は操作の入口、コアは接続の処理、設定ファイルはルールと通信経路を決めます。ここではMacでの一般的な使い方に沿って、6種類の設定を解説します。利用できる機能は、選んだクライアントの実装によって異なります。

メニューバーで動作状況を確認

Macクライアントの多くはメニューバーから操作でき、メインウィンドウを開かずに通信モードの切り替え、現在の設定の確認、プロキシの一時停止などを行えます。クライアントの設定で、メニューバーへの表示、ウィンドウを閉じたときの動作、ログイン時の起動を確認しましょう。ウィンドウを閉じてもアプリが終了するとは限りません。使い終わったら、ウィンドウを隠す操作とアプリの終了を区別してください。システムVPNの状態に依存するモバイル端末とは異なり、Macではメニューバーのアプリが動作中か、終了時にシステムプロキシが元に戻るかも確認が必要です。停止したポートを参照する設定が残らないよう注意しましょう。

ログイン時に起動
メニューバーに常駐

Macクライアントの多くはメニューバーから操作でき、メインウィンドウを開かずに通信モードの切り替え、現在の設定の確認、プロキシの一時停止などを行えます。クライアントの設定で、メニューバーへの表示、ウィンドウを閉じたときの動作、ログイン時の起動を確認しましょう。ウィンドウを閉じてもアプリが終了するとは限りません。使い終わったら、ウィンドウを隠す操作とアプリの終了を区別してください。システムVPNの状態に依存するモバイル端末とは異なり、Macではメニューバーのアプリが動作中か、終了時にシステムプロキシが元に戻るかも確認が必要です。停止したポートを参照する設定が残らないよう注意しましょう。

ログイン時に起動
システムプロキシをワンクリックで設定

一般設定で「システムプロキシとして設定」を有効にすると、クライアントがmacOSのプロキシ設定をローカルの待ち受けアドレスに向けます。ブラウザーなど、システム設定に従うアプリでプロキシを利用できます。初回はコアが起動していることを確認してから有効にし、ウェブページにアクセスして動作を確かめましょう。すべてのアプリの通信を強制的にプロキシ経由にする機能ではありません。ターミナルのツールや一部のゲームは独自のネットワーク設定を使う場合があります。システム設定を手動で変更するより簡単に切り替えられますが、実際に利用するネットワークサービスの設定は確認してください。特にWi-FiとEthernetを切り替えた後は注意が必要です。

システムプロキシとして設定
TUNモード

TUNは仮想ネットワークインターフェースとルーティング設定を使い、対象範囲の通信をコアに処理させる機能です。ターミナルや、システムプロキシを参照しないアプリの接続を調べる際に役立ちます。「ネットワーク」や「TUNモード」の画面で設定項目を探し、クライアントの案内に従ってサービスをインストールし、macOSの許可を済ませてから有効にします。その後、接続ログを確認してください。モバイル端末のシステム許可とは手順が異なり、Macではバックグラウンドサービスや管理者権限が必要になることがあります。TUNを有効にしても、すべての通信がプロキシ経由になるわけではありません。最終的な通信先はルールで決まります。他のVPNと併用する場合は、ルーティングやDNSの競合にも注意しましょう。

TUNモード
ルール振り分けとポリシーグループ

ルールモードでは、設定ファイル内の順序に従ってドメインやアドレスなどの条件を照合し、該当するポリシーグループに接続を振り分けます。まず「プロキシ」画面でルールモードを選び、ポリシーグループを開いて利用する接続先を選択します。期待どおりに動かない場合は、「接続」や「ログ」で適用されたルールを確認しましょう。ポリシーグループ名は設定ファイルに由来し、ソフトウェアが固定で提供するサービスではありません。全通信を切り替えるだけのツールと比べ、通信先ごとに経路を変えられる一方、ルールの順序やDNSの結果に左右されます。変更前に設定ファイルを複製し、購読更新で上書きされる内容を直接編集しないようにしてください。

通信モードルールグローバル直接接続
Appleシリコン・Intelの両方に対応

Appleメニューの「このMacについて」を開き、Appleシリコンのチップ名が表示される場合はApple Siliconまたはarm64版、Intelプロセッサの場合はx64版を選びます。両アーキテクチャ対応とは、ダウンロードページにそれぞれのインストーラーが用意されているという意味で、各ファイルがユニバーサルバイナリとは限りません。Rosettaで変換して動かすより、チップに合ったネイティブ版を日常的に使うのがおすすめです。対応するmacOSの最低バージョンはクライアントによって異なります。古いシステムにインストールする前にダウンロードページの説明を確認し、GUIと内蔵コアの両方が現在のシステムに対応しているかも確認してください。

コアmihomo
購読を自動更新

「購読」または「設定」画面で対応する購読URLを追加し、ダウンロード後に現在の設定として選択します。必要に応じて自動更新も有効にしましょう。更新されるのは主にリモートのルールや接続先情報であり、クライアントやコアのアップグレードではありません。ローカルファイルを手動で読み込む方法に比べ、購読管理は継続的な設定更新に便利ですが、サーバーから取得した内容がコアに対応している必要があります。Macがスリープ中は予定どおり更新されないことがあるため、復帰後に手動更新して状態を確認してください。長期的に残したいカスタムルールは、リモート購読から生成されたファイルを直接編集せず、クライアントが対応するオーバーライドやマージ機能を使いましょう。

購読を自動更新

初回インストールでは、まず購読を追加してブラウザーで接続を確認し、その後TUNを有効にするか判断するのがおすすめです。設定項目の依存関係、操作手順、確認方法はクイックスタートを、プロトコルとコアの対応範囲はプロトコルガイドをご覧ください。

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

OSに合ったClashクライアントを選ぶ

Clashはエコシステムの名称であり、GUIクライアントごとに設定画面や対応機能が異なります。ダウンロードページでは、プラットフォーム別にクライアント、アーキテクチャ、インストール要件を確認できます。インストーラーに含まれるのはソフトウェア本体です。利用前に対応する設定ファイルを用意してください。同じ購読を複数の端末で使えるかどうかは、形式やプロトコルの項目、サービス側の条件によって異なります。

Windows

デスクトップで購読やポリシーグループを管理するのに適しています。ダウンロード前にシステムのアーキテクチャを確認し、初回起動時はファイアウォールやバックグラウンドサービスの許可を確認してください。システムプロキシとTUNは別の機能です。最初の設定で両方を有効にする必要はありません。

ダウンロードページへ

macOS

まず「このMacについて」でAppleシリコンかIntelプロセッサかを確認し、対応するインストーラーを選びます。ダウンロードページではClash Plus、Clash Verge Rev、FlClashなどを選べます。メニューバーでの操作、サービスへのアクセス許可、macOSの最低要件もあわせて確認しましょう。

ダウンロードページへ

Android

デバイスのアーキテクチャに合ったインストーラーを選びます。初回接続時は、OSの案内に従ってVPNを許可してください。バックグラウンドで接続が切れやすい場合は、バッテリー最適化やアプリのバックグラウンド制限を確認しましょう。デスクトップの設定をスマートフォンに移した後も、ルールとDNSの動作を改めて確認してください。

ダウンロードページへ

iOS

ダウンロードページではClash PlusのApp Storeへのリンクと、公式サイトclashplus.ioの情報を案内しています。インストール後、アプリの案内に従って設定を読み込み、VPNを許可してください。利用可能なプロトコルや設定項目は、モバイルクライアントの対応状況によって異なります。

ダウンロードページへ

Linux

デスクトップで使う場合は、ディストリビューションに合ったGUIクライアントのパッケージ形式を選びます。サーバーやルーターで使う場合は、コアとGUIを区別し、サービスの起動、権限、ルーティングを別途設定してください。コアだけをダウンロードしても、デスクトップの設定画面は表示されません。

ダウンロードページへ

インストール前に3つの情報を確認

OSのバージョン、プロセッサのアーキテクチャ、現在使っている設定形式を確認します。古いOSでは新しいクライアントが動かない場合があります。アーキテクチャが合わないと変換実行やインストール失敗につながり、設定の互換性がないと読み込みエラーやコアの起動失敗が発生します。原因ごとに対処方法は異なるため、インストーラーを次々に試すより、まず情報を確認するほうが効果的です。

古いクライアントから移行する場合は、復元できる設定とカスタムルールを先にエクスポートしてから、旧アプリを終了します。複数のクライアントでシステムプロキシを同時に変更したり、同じポートを取り合ったりしないようにしてください。新しいクライアントでコアが起動し、設定を読み込み、接続ログが記録されることを確認してから、オーバーライドルールや自動更新の設定を一つずつ移行しましょう。

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

プロジェクトの出所と設定の注意点

Clashエコシステムとmihomoコアを知る

クライアントを選ぶときは、まずコアの機能とメンテナンス状況を確認し、次に画面が使い方に合うかを見ましょう。オープンソースのリポジトリでは実装や変更履歴、設定ドキュメントを確認できます。画面のスクリーンショットやソフトウェア名だけでは、そうした情報の代わりになりません。

オリジナルのClashからmihomoへ

オリジナルのClashは、ルール振り分け、ポリシーグループ、YAML設定といった一般的な使い方の基礎を築きました。その後、コミュニティでさまざまなコアやクライアントが派生し、mihomoは元のClash Metaの技術路線を引き継いでいます。名称が似ていても機能がすべて同じとは限りません。古い設定の一般的な項目が引き継がれていても、新しいプロトコル、ルールの種類、DNS設定は各コアのドキュメントで確認してください。移行時は元のファイルを保存し、ログで互換性がないと明示された項目から対処しましょう。

Mac用ソフトを選ぶ際に、クライアントとコアの名前を分けて考える必要があるのはこのためです。クライアント名は操作画面を、コア名はネットワーク接続を処理するプログラムを指します。画面が更新されてもコアがアップグレードされるとは限らず、コアが対応していても、すべてのクライアントに操作ボタンが用意されているとは限りません。機能が使えるか判断するときは、メニューに似た項目があるかだけでなく、クライアントの説明、コアの対応範囲、現在の設定をあわせて確認しましょう。

オープンソースコードとコミュニティドキュメント

mihomoのコード、変更履歴、問題に関する議論はプロジェクトのリポジトリで確認できます。ドキュメントを読む際は、対象のコアと機能の範囲を確認し、別のコア向けの設定例をそのまま既存ファイルにコピーしないようにしましょう。問題を報告する際は、OSのバージョン、チップの種類、クライアント名、再現手順、関連するログがあると、単に「接続できない」と伝えるより原因を特定しやすくなります。ログを公開する前に、購読URL、認証情報などの個人情報を削除し、エラーの説明に必要な最小限の内容だけを残してください。

このサイトではダウンロード先と設定ガイドをまとめています。異なるコミュニティプロジェクトを、同一の公式アプリとして扱うものではありません。ダウンロードページのメンテナンス状況は、選択時のリスクを判断するための参考情報です。アーカイブ済みのクライアントは、互換性が明確に必要な場合に適しています。長く使う場合は、現在もメンテナンスされており、最新のmacOSに対応し、重要な設定を説明するドキュメントがあるものを優先しましょう。オープンソースであっても、第三者が配布するパッケージが上流のビルドと完全に同じとは限りません。

3種類の更新を分けて管理

クライアントの更新では主に画面、システム連携、インストール済みサービスが変わります。コアの更新はプロトコルの実装、ルール処理、ネットワークの挙動に関わります。購読の更新ではリモートの設定内容が置き換わります。これらは個別に行われるため、購読の更新に成功してもソフトウェアがアップグレードされたとは限りません。アップグレード前にカスタムポート、DNS設定、オーバーライドルールを記録し、更新後はコアの起動、設定の読み込み、実際の接続を順に確認しましょう。問題が起きた際に、どの層の変更が原因か判断しやすくなります。

自動更新を有効にしていても、必要な確認は欠かせません。購読元が一時的にエラーページを返したり、特定のコアでしか使えない項目が含まれたりする場合があります。更新直後に起動できなくなったら、すぐにシステムネットワークを変更せず、まず設定の解析エラーを確認してください。Macがスリープから復帰した後やネットワークサービスを切り替えた後、ほかのVPNを起動・停止した後には、ルーティング環境が変わることもあります。トラブル時は一度に一つの設定だけを変更し、変更前後の結果を記録すると、複数の要因が重なったことによる誤診を防げます。

クライアントとネットワークサービスの違い

クライアントをインストールしても、接続先が自動で用意されるわけではありません。購読は通常、利用者が契約しているサービスから提供されるか、自分で管理する設定を使います。読み込む前に、配布元が信頼できるか、形式に互換性があるか、ルールやDNS設定の内容を確認してください。購読URLにアクセス認証情報が含まれることがあるため、公開の掲示板に投稿したり、むやみにオンライン変換サービスへ入力したりしないでください。形式を変換する必要がある場合は、どの項目が失われる可能性があるかを確認し、変換後のポリシーグループとルール参照をローカルでチェックしましょう。

接続の問題は、層ごとに切り分けます。接続記録がない場合は、アプリの通信がプロキシに入っているか確認します。ルールが適用されているのに接続できない場合は、接続先とネットワークを確認してください。一部のドメインだけで問題が起きる場合は、DNS、ルールの順序、接続先サイトの状態を調べましょう。システムプロキシもTUNも、あらゆる問題を直す万能スイッチではありません。症状に応じてヘルプセンターを確認するか、用語集で混合ポート、ポリシーグループ、仮想ネットワークインターフェースの違いを確認してから、該当する設定を変更してください。

mihomoプロジェクトのソースコードを見る

Gitをインストール済みの方は、コマンドをコピーしてターミナルから公開リポジトリをダウンロードできます。このコマンドはソースコードを取得するだけで、クライアントのインストールやシステムプロキシの変更は行いません。

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

設定・トラブル対処の記事

購読形式、証明書の問題、クライアント選び

基本的な接続ができたら、問題に応じて各ガイドを確認しましょう。形式変換では設定項目の互換性、証明書エラーではセキュリティ上の注意点、クライアント比較では操作性とOSの対応状況がポイントです。それぞれ異なる問題なので、同じ方法で対処することはできません。

記事一覧を見る →