Clash Meta for Android · オープンソースのmihomoコア

Clash Android版Androidクライアントのダウンロードと設定

デバイスに合ったクライアントを選び、サブスクリプションの読み込み、VPNの許可、ルールによる振り分けを設定します。

  • YAMLルール例
  • 中国語の設定ドキュメント
設定ドキュメントを読む

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

まずOSを選び、次にプロセッサのアーキテクチャとインストール形式を確認します。クライアントを乗り換える前に、サブスクリプションのURLか設定ファイルを控えておくと、再読み込みが簡単です。

インストールパッケージの選び方

スマートフォンのプロセッサが64ビットに対応していても、OSがすべての64ビットアプリをインストールできるとは限りません。ダウンロードページに複数のアーキテクチャ向けパッケージがある場合は、OSが実際に対応しているアプリのアーキテクチャを選んでください。判断できない場合は、クライアントに汎用パッケージがあるか確認しましょう。機種名に含まれる数字だけで決めないでください。同じ名前のアプリがインストール済みだと表示された場合は、先に設定をバックアップし、両方が同じ配布元のものか確認してください。

旧クライアントからの移行方法

サポートが終了したClash for Windowsから移行する場合は、現在有効な設定と手動で選択したプロキシグループを控えてから、元のサブスクリプションまたはローカルファイルを新しいクライアントに読み込みます。アプリのデータフォルダー全体をそのままコピーするのは避けてください。旧クライアントが残したシステムプロキシの設定が、以前のポートを指していることがあります。切り替え前に旧クライアントの通信制御を停止し、同じブラウザーから新しいリクエストを送って、新クライアントの接続ログに記録されることを確認しましょう。

クライアントの通信振り分けと設定機能

まず、システムによる通信制御、ルール判定、接続先の選択を切り分けて確認します。一つの段階が正常でも、次の段階が正常とは限りません。

まず通信がクライアントに届いているか確認

初回接続時にAndroidのシステムダイアログでVPN接続要求を許可します。許可後、制御対象のアプリ通信がクライアントに届くため、アプリごとにプロキシアドレスを設定する必要はありません。VPNがすでに別のアプリに割り当てられている場合や、仕事用プロファイルに独自の制限がある場合もあります。一部のアプリだけ動作しないときは、まずクライアントのアプリ制御範囲を確認し、次に接続ログを確認してください。「全通信の制御」は通信の入口を指すもので、必ずグローバルプロキシモードを使うという意味ではありません。ルールモードなら、通信をルールに応じて直接接続することもできます。

初回のVPN許可手順を見る →
振り分けに問題がある場合は、通信の入口、ルール、接続先の順に確認
症状まず確認すること再テストの方法
接続ログにリクエストが表示されないシステムで許可されているか、対象アプリが通信制御の範囲内かを確認します。デスクトップでは、アプリがシステムプロキシを参照しているかも確認してください。アプリで開いているページを閉じてから、もう一度開きます。操作前後のログを比較し、対象のアドレスが記録されたか確認します。
ログはあるが、ルールが想定と異なる現在の動作モードがルールモードか確認します。具体的なルールが先行する汎用ルールに上書きされていないか、設定が再読み込みされているかも確認してください。同じアプリから同じ接続先にアクセスします。ネットワークとプロキシグループは変えず、新しい接続ログのルール名を確認してください。
ルールには一致するが、接続できないドメインの名前解決、接続先への接続失敗、アプリの応答タイムアウトを切り分けます。ルールに一致したことは接続先が選ばれたことを示すだけで、データが届いたことを意味しません。通信の制御方法とルールは変えず、対象のプロキシグループの接続先だけを変更して、エラーに変化があるか確認します。

オープンソースプロジェクトと設定資料

上流のソースコード、変更履歴、クライアントのドキュメントで機能を確認しましょう。ダウンロード先、コアの対応機能、サブスクリプションサービスはそれぞれ別のものです。

旧Clash、Clash.Meta、mihomoの違い

初期のClashでは、現在もよく見られる設定の基本が確立されました。ノードをまとめて定義し、プロキシグループで接続先を整理し、ルールから順に参照します。Clash.Metaはこの仕組みを拡張し、その後mihomoとして開発が続いています。古いガイドには、以前の二つの名称が残っていることもあります。同じ設定キーが出てきたら基本的な用途を理解する参考にはできますが、初期値、対応範囲、適用条件まで同じとは限りません。トラブル対処では、まず現在のクライアントがどの系統のコアを使うか確認し、対応するプロジェクトの資料を参照してください。

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

Clash Meta for Androidは設定の管理とAndroid側のVPN接続を担い、mihomoは設定の解析、ルール判定、接続先への接続を担います。設定ファイルを保存できたのは、ファイルがクライアントに取り込まれたことを示すだけです。読み込みの可否やルールの一致は、コアの動作ログで確認してください。反対に、システムの許可がない場合や省電力機能によってバックグラウンドサービスが終了した場合は、YAMLの接続先を変更しても解決しません。問題を報告する前に、この二つの層を切り分けましょう。インストール、システムダイアログ、画面表示の問題はクライアントのプロジェクトを確認し、設定項目、ルール、接続先の解析に関する問題はコアの資料を参照してください。

コミュニティの情報を確認する方法

上流リポジトリではソースコードやコミット履歴を確認でき、Issuesでは同じエラーの報告を探せます。検索時は具体的な項目名やエラーの種類を残し、まず投稿者が使っているプラットフォームと実行方法を確認しましょう。たとえば、デスクトップでシステムプロキシが動作しても、AndroidのVPN設定が正しい証拠にはなりません。再現手順を共有する場合は、最小限の設定、操作の順序、個人情報を伏せたエラー部分を残します。公開前にサブスクリプションURL、プロキシの認証情報、個人用ドメインを削除してください。接続ログの接続先から、実際の閲覧内容がわかることもあります。

更新前に使える設定をバックアップ

クライアントのインストーラー、コアの変更、サブスクリプションの内容は、それぞれ異なる周期で更新されます。クライアントの更新でコアが変わる場合があり、サブスクリプションの更新でノード名、プロキシグループ、ルールの順序が変わることもあります。更新後に通信の振り分けが変わった場合は、現在のファイルをバックアップし、直前に使えていたコピーも残してください。変更履歴と設定の差分を照合し、クライアントの再インストール、サブスクリプションの更新、DNSの変更を同時に行わないようにします。一度に一項目だけ変更し、同じネットワーク、アプリ、接続先で再テストすれば、原因を絞り込めます。

インストールと設定のよくある質問

インストール後もプロキシグループが空なのはなぜ?
インストーラーに含まれるのはクライアントで、プロキシグループは現在使用中の設定から読み込まれます。サブスクリプションを正しく読み込み、有効にしたか確認してください。ファイルを一覧に追加しただけでは、現在動作中の設定は切り替わりません。
VPNアイコンが表示されているのに、一部の通信が直接接続されるのはなぜ?
VPNアイコンは、システムがVPN接続を確立したことを示します。クライアントを経由するリクエストでも、DIRECT に一致すれば直接接続されます。まず接続がログに表示されるか確認し、一致したポリシーを調べてください。
Wi-Fiを切り替えたときだけ問題が起きる場合、まず何を確認すればよい?
まず新しいネットワークで認証が必要か、ドメインを正常に名前解決できるかを確認し、次にクライアントが接続を再確立したか確認します。ルールは変えずに再テストすると、ネットワークの変更と設定の変更を切り分けられます。
ポートを変更したのに、ターミナルが古いアドレスを使うのはなぜ?
すでに開いているターミナルは、古いプロキシ環境変数を保持している場合があります。そのターミナルのセッションと、コマンド自体のプロキシ設定を確認してください。システムプロキシの新しいポートが、ターミナルにも反映されるとは限りません。

技術ノート

実際の症状から記事を探せます。バックグラウンドにすると切断される、デスクトップアプリがプロキシを使わない、ドメインの名前解決が想定と異なる場合など。

Clash Meta for Androidをバックグラウンドで維持する方法:VpnServiceの許可と省電力設定

VpnServiceの許可ダイアログの意味、メーカーごとの省電力機能がバックグラウンド接続を終了させる理由、電池の最適化対象からの除外と自動起動の設定手順を解説します。

バックグラウンド動作の設定を見る →

システムプロキシを有効にしても動かない:ブラウザーとコマンドラインを分けて確認

ブラウザー拡張機能によるプロキシ設定の上書き、システムプロキシを参照しないターミナル、ポートの不一致が主な原因です。この記事ではブラウザーとターミナルに分けて、確認手順と環境変数の設定方法を解説します。

システムプロキシのトラブル対処を見る →

ClashのDNSリークを確認する方法:fake-ipとnameserver-policyによる対策

まず検査ページでDNSリクエストの経路を確認し、次にenhanced-mode、fallback、nameserver-policyの設定を見直します。そのまま照合できるYAML例も掲載しています。

DNS設定のトラブル対処を見る →