オープンソースプロジェクトmihomo エコシステム

Clash オープンソースクライアントダウンロード

OSに合ったクライアントを選び、mihomoの設定例を参考にサブスクリプションを追加してルールで通信を振り分けます。その後、必要に応じてDNSやネットワーク制御の方法を調整してください。

  • インストーラーの選び方
  • YAML設定例
  • 日本語ドキュメント
config.yaml 設定例
mixed-port: 7890mode: ruledns:  enable: true  enhanced-mode: fake-iprules:  - GEOIP,CN,DIRECT  - MATCH,Proxy
コア:mihomo
オープンソースのリポジトリとリリース情報を見る

MIHOMO / CONFIG SCENES

設定例から該当するマニュアルを探す

応用設定ガイドを見る

CONFIG REFERENCE

mihomoの設定
と動作

プロキシグループで通信の出口を決め、ルールでその出口を使う接続を指定します。まずこの2つを確認して振り分けを調べ、次にDNSの応答が想定どおりか、通信がコアに届いているかを確認しましょう。

config.yaml

プロキシグループ名と出口の選択

ルールの振り分け先をプロキシグループにすると、ドメインリストを書き換えずに通信の出口を変更できます。selectはユーザーがメンバーを選び、url-testは接続テストの結果に基づいて選択します。fallbackはリストの先頭から利用可能なメンバーを優先します。ここでは参照関係を示すため、組み込みのプロキシだけを使っています。サブスクリプションを追加したら、グループ名とメンバー名を確認し、接続ログでルールに一致したグループと最終的な出口を確かめてください。クライアントの画面では一部の項目が表示されないことがあります。トラブル時は実際に適用されている設定を確認しましょう。

proxy-groups:
  - name: Proxy
    type: select
    proxies: [DIRECT, REJECT]
rules:
  - MATCH,Proxy
プロキシグループの種類と使い方を見る

PLATFORM PACKAGES

OSに合わせてClashクライアントを選ぶ

まずOSとプロセッサーのアーキテクチャを確認し、そのうえでクライアントを選びます。GUIクライアントなら画面上で設定を管理できます。mihomoを単独で動かす場合は、設定ディレクトリ、プロセス管理、システムのネットワーク設定を自分で扱う必要があります。既存のクライアントから乗り換える場合は、ローカルオーバーライドとプロキシグループの選択を保存してから旧クライアントを終了してください。ポートが使用中の場合は、まず旧プロセスが終了しているか確認します。問題を回避するためにサブスクリプションのポートをすぐ変更しないでください。

Windows

GUIでの管理や、アプリごとのプロキシ動作の確認に向いたデスクトップ環境です。システムの「バージョン情報」でプロセッサーのアーキテクチャを確認し、ダウンロードページに記載されたパッケージと照らし合わせてください。初回接続では、まずシステムプロキシを有効にしてブラウザーで動作を確認します。TUNを検討するのは、対象アプリがシステムプロキシを参照しない場合です。アップグレード前に旧クライアントを終了し、バックグラウンドサービスも停止していることを確認してください。クライアントを終了してもブラウザーがインターネットに接続できない場合は、システムプロキシにローカルポートの設定が残っていないか確認します。組織の管理下にあるデバイスでは、管理者権限やファイアウォールの設定について、端末の管理ルールに従ってください。

ダウンロードページへ

macOS

「このMacについて」でチップ情報を確認し、Apple SiliconとIntelを区別してください。システム画面や発売年から推測せず、ダウンロードページに記載された対応アーキテクチャを確認しましょう。メニューバーからプロキシを切り替える場合は、システム設定のネットワーク項目で状態を確認できます。起動直後に終了する場合は、インストーラーのアーキテクチャとシステム要件を確認してください。一部のアプリだけ接続できない場合は、まずアプリ独自のプロキシ設定を確認します。旧設定を移行する際は、サブスクリプションURL、ローカルファイル、プロキシグループの選択を個別に確認してください。新しいクライアントが別のクライアントの作業ディレクトリを読み込むとは限りません。

ダウンロードページへ

Android

端末のアーキテクチャに合ったAPKを選びます。ダウンロードページに汎用パッケージがあれば、アーキテクチャの選択ミスを避けるために利用できます。初回接続時は通常、システムのVPN接続リクエストを承認する必要があります。ほかのVPNがインストールされている場合は、システムでどのアプリのVPN接続が許可されているか確認してください。まずバッテリー設定を変更せずに、アプリを前面で使う場合と画面ロック中の動作をテストし、その後必要に応じてバックグラウンド権限を調整します。ロック後に切断される問題と、Wi-Fiの切り替え後に切断される問題は、原因が異なることがあります。前者はプロセスが停止されていないか、後者は新しいネットワークでシステムVPNが再接続しているかを確認しましょう。

ダウンロードページへ

iOS

ダウンロードページからクライアントのApp Storeページを開き、まずシステム要件を確認してください。インストール後、アプリの案内に従ってVPN構成を追加し、既存のサブスクリプションを読み込みます。デスクトップでは使えるサブスクリプションをモバイルで読み込めない場合は、サーバーアドレスを変更する前に、クライアントが対応する設定形式や項目を確認しましょう。Wi-Fiとモバイル通信の両方でテストし、特定の接続方法だけで問題が起きるか確認できます。組織や学校の管理下にある端末では、管理ポリシーによってVPN設定が制限されていることがあります。利用可能な範囲を事前に確認してください。

ダウンロードページへ

Linux

デスクトップOSでは、ディストリビューションのパッケージ管理方法とプロセッサーのアーキテクチャに合わせてインストーラーを選びます。デスクトップのプロキシ設定がターミナルに引き継がれるとは限らないため、コマンドラインツールが対応するプロキシ環境変数を参照しているか個別に確認してください。サーバーやルーターでは、コアを単独で実行し、設定ディレクトリ、実行ユーザー、ログの保存先を明示する方法が適しています。起動に失敗した場合は、パッケージの非互換、依存関係の不足、サービス権限の不足を切り分けます。接続に失敗した場合は、待ち受けアドレスとルーティングを確認しましょう。起動の問題と接続の問題では調べる箇所が異なるため、テストのためにファイアウォールとシステムルートを同時に変更する必要はありません。

ダウンロードページへ

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

FIRST CONNECTION

Clashの初回接続:設定の追加・通信制御・確認

まず正常に起動できる設定を1つ保存し、振り分けルールやネットワーク制御の方法を少しずつ変更しましょう。一度に変更する設定は1つにし、同じ接続先をテストして、どの設定が影響したか確認します。

  1. 設定を追加して有効にする

    インストール後、「設定」または「サブスクリプション」画面を開き、URLから既存のサブスクリプションを追加するか、ローカルのYAMLファイルを読み込みます。リストに新しい項目が表示されたら、それを選択して適用されていることを確認してください。設定名が表示されても、保存されたことを示すだけで、コアが正常に読み込んだとは限りません。適用に失敗した場合は、エラーに示された項目や行番号を確認し、インデント、参照名、クライアントが対応する項目を照合します。人に相談するときは、関連する設定項目とエラーだけを共有し、サブスクリプションURLや設定全体を公開の場に貼らないでください。

  2. ルールモードと通信制御の方法を選ぶ

    動作モードを「ルール」に設定し、設定ファイルに記述された振り分けロジックを使います。デスクトップでは、まずシステムプロキシを使って対応アプリの動作をテストします。モバイルでは、システムの案内に従ってVPN接続を確立してください。対象アプリが接続一覧に表示されない場合は、アプリ固有のプロキシ設定やTUNを検討します。システムプロキシはアプリのリクエストをクライアントに渡すかどうかを決め、動作モードはコアが受け取ったリクエストの処理方法を決めます。この2つは互いに代用できません。ほかのネットワーク制御ツールが動作している場合は、サブスクリプションの問題とルートの競合を混同しないよう、旧ツールを停止してテストしてください。

  3. 接続ログでルールの適用結果を確認する

    直結されるはずの接続先と、プロキシを通るはずの接続先を1つずつ選び、新しい接続を開始します。接続ログで宛先のドメイン名、一致したルール、最終的な出口を確認してください。ページが開くかどうかだけで振り分けを判断しないようにしましょう。ログがあり出口が想定と異なる場合は、ルールの順序とプロキシグループの現在のメンバーを確認します。ログがない場合は、アプリの接続がクライアントに渡されているかを確認してください。ルールを変更した後は新しい接続を作って比較しましょう。アプリが既存の接続を再利用すると、変更前の結果が表示されることがあります。

ガイド全文を見る →

SOURCE / RELEASES

mihomoのソースコードとリリース情報

オリジナル版Clashと後継フォーク

オリジナル版Clashのメンテナンス終了後、関連するクライアントやコアの各プロジェクトは、それぞれのリポジトリで開発を続けています。mihomoはClash.Metaのフォークを起源とし、なじみのあるルール、プロキシグループ、YAML設定の構造を引き継ぎながら、独自の設定項目や動作も発展させています。名前にClashが含まれていても、同じメンテナーやリリース周期を共有しているとは限りません。過去のガイドを読む際は、オリジナルのコア、後継フォーク、GUIクライアントのどれを対象にしているかを確認してください。特にインストール方法、サービスモード、DNS設定の違いに注意が必要です。

アーカイブされたクライアントの設定を移行する場合は、まずコピーを読み込み、コアの起動ログとクライアントが生成した実際の設定を確認してください。古い設定項目を解析できても、以前と同じネットワーク動作が保たれるとは限りません。システム権限、ルーティング、DNSのデフォルト設定が変わることもあります。

クライアントとコアの役割

mihomoは設定を解析し、接続を受け付け、ルールを適用して通信の出口を選びます。Clash Verge RevやFlClashなどのGUIクライアントは、その上に設定管理、メニューからの切り替え、接続状況の表示などを提供します。トレイ操作、サブスクリプション更新画面、オーバーライド編集機能は通常、GUI側の機能です。ルールの不一致やモジュール初期化エラーは、コアのログを確認してください。「システムプロキシ」という同じ名前の設定でも、クライアントによってシステム設定の管理方法が異なることがあります。問題がどちらの層にあるかを先に切り分ければ、画面上の問題を解決するためにYAML全体を書き直す必要はありません。

同じサブスクリプションでもクライアントごとに動作が異なる場合は、それぞれで適用されているローカルオーバーライドと有効なプロキシの入り口を確認してください。有効な設定を書き出せる場合は、関連項目を並べて比較すると、設定画面全体を見比べるより違いを特定しやすくなります。

リポジトリ、Issue、問い合わせ先

上流リポジトリではソースコード、変更履歴、公開Issueを確認できます。設定の問題は、エラーメッセージや設定項目名で検索するところから始めましょう。特定のクライアントのインストーラーが起動しない場合は、そのクライアントのリリース情報やIssueを確認してください。報告する際は、OSとアーキテクチャ、通信制御の方法、再現手順、実際の結果を記載します。最小限の設定で再現できれば、設定項目の組み合わせ、ネットワーク環境、画面上の設定のどこに原因があるか判断しやすくなります。サブスクリプションの内容全体を添付する必要はありません。このサイトではクライアントの入手先と日本語ドキュメントを案内しています。各プロジェクトの機能やメンテナンス状況については、上流の記録をご確認ください。

特定のネットワークに接続したときだけ同じ問題が起きる場合は、いつから再現するようになったか、元のネットワークに戻すと解消するかも記載してください。環境による制限と、安定して再現するソフトウェアの不具合をメンテナーが切り分けやすくなります。

変更内容を確認してから更新する

GUIクライアントとmihomoコアのリリースは別々に行われます。画面の更新にコアの更新が伴うとは限らず、コアだけを置き換えるとクライアントのサポート対象外になる場合もあります。インストール前に安定版とプレリリースを区別し、OSとアーキテクチャに合ったパッケージを確認してから、DNS、TUN、権限、設定移行に関する変更内容を読みましょう。更新後は既存の設定を使い、起動、サブスクリプションの読み込み、直結、プロキシ経由の通信を確認します。問題が起きた場合に切り戻したり変更点を特定したりできるよう、旧設定と更新前の正常な動作記録を残してください。

クライアントの更新と同時にルールセットを変更したり、上流DNSを設定し直したり、新しいモードを有効にしたりする必要はありません。アップグレードと設定変更を分けて行えば、ネットワークに問題が起きても、どの手順から戻すべきか明確になります。

mihomoのソースコードを入手

このコマンドはソースコードを閲覧するためのものです。既成のクライアントをインストールする場合はダウンロードページを利用してください。コアをビルドする場合は、リポジトリの手順に従って環境を準備します。

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

TECHNICAL NOTES

設定・プラットフォーム別の最新記事

プラットフォーム別ガイド

WindowsにClashクライアントをインストールする方法:システムプロキシ、ファイアウォール、管理者権限の注意点

インストーラーの選び方、初回起動、サブスクリプションの追加、システムプロキシとサービスモードの設定を解説。ファイアウォールによるブロック、ポートの競合、セキュリティソフトの誤検知など、Windowsでよくある問題も取り上げます。

記事をすべて見る →

Clash ダウンロード