まず通信がクライアントにどう取り込まれるかを確認し、次に接続先を決めます。6つの設定例では、よく使われる項目を紹介します。画面上の名称はクライアントによって異なり、設定項目は使用中のコアに準じます。
mode: ruleルールモードでは、設定したルールに基づいて接続先が選ばれます。DIRECTとプロキシを使い分けたい場合に便利です。グローバルモードは、コアに取り込まれたリクエストをグローバルポリシーに従って処理します。ルールの誤判定を調べる際に一時的に使えますが、すべてのアプリの通信を自動で取り込む機能ではありません。DIRECTモードでは、取り込まれたリクエストを宛先へ直接接続します。モードを切り替えたらリクエストを再送し、接続ログで適用ルールと接続先を確認してください。既存の長時間接続は切り替え前の経路を使い続けることがあるため、接続を切って再試行します。普段はルールモードを選び、プロキシグループで実際に選ばれている接続先も確認しましょう。
接続モードの解説を見る →mixedtun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: trueTUNは仮想ネットワークアダプターを使って通信を取り込むため、システムプロキシ設定を参照しないアプリにも適しています。有効にする前に、クライアントのサービスや必要な権限が設定済みか確認し、ルーティングとDNSをコアが処理しているかも確認してください。stackはプロトコルスタックの実装を指定します。選択肢や互換性はコアとOSによって異なるため、すべてのデバイスに共通する正解はありません。最初のテストではクライアントの既定値を維持し、通信の取り込み方式だけを変更します。他のVPN、仮想アダプター、企業ネットワーク用ツールと競合する場合は、まず一方を無効にしてログを確認してください。
TUNの詳細設定を読む →rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYルールは上から順に照合され、最初に一致したルールの接続先が使われます。DOMAIN-SUFFIXはドメインとそのサブドメインに一致し、GEOIPは宛先IPアドレスを地理情報データベースと照合します。MATCHは最後のフォールバックです。例のPROXYはプロキシグループ名なので、実際の設定に存在する必要があります。DIRECTは組み込みの直接接続先です。ルールを追加する際は、具体的なドメインを広い条件より前に置き、接続画面で適用結果を確認してください。ルールセットをサブスクリプションで利用する場合は、読み込み状況とローカル設定での参照順序をそれぞれ確認します。
プロキシグループとルールの参照方法を見る →dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-queryfake-ipはドメインに対応するアドレスを返し、コアがその対応関係からドメインを復元して接続先を選びます。上記の設定例は主要項目のみを示したもので、単独で動作する完全な設定ではありません。有効にする前に、アプリのDNSリクエストがコアに届いているか確認してください。ブラウザーが独自に暗号化DNSを使う場合は、名前解決の経路が異なることがあります。LAN内のデバイス、ログインポータル、特定アプリで問題が起きたら、まずドメインとログを記録し、必要に応じて例外を設定します。DNSモードを切り替えた後は関連するキャッシュを消去して再接続し、古い名前解決結果が検証に影響しないようにしてください。
DNS設定の解説を見る →サブスクリプションを更新すると、リモートの設定が再取得されます。ノードがすぐ利用可能になるわけではなく、通信の取り込みに関する問題が自動修復されるわけでもありません。GUIクライアントでは通常、サブスクリプションまたは設定の詳細画面で更新間隔を指定できます。コアのプロキシグループとルールセットにはそれぞれ別の更新項目があり、混同しないようにしてください。まず手動で更新し、取得が成功して設定を読み込めることを確認してから、定期更新を有効にします。ローカル変更を維持する場合は、クライアントの上書き・マージ機能を使い、次回更新で直接編集した内容が置き換わらないようにしてください。サブスクリプションURLは機密情報として管理しましょう。
サブスクリプションの追加手順を見る →external-controller: 127.0.0.1:9090外部コントローラーのAPIでは、接続情報の取得やプロキシグループの切り替え、一部の実行状態の変更ができます。アプリが使う混合プロキシポートとは別のものです。ブラウザーのプロキシ先を9090に設定しても、7890の代わりにはなりません。ローカルでのみ使う場合は、ループバックアドレスで待ち受ける設定を維持してください。クライアントがAPIや認証を自動設定している場合は、その管理方法を優先します。リモートパネルが必要な場合は、認証とアクセス制限を設定し、管理APIをインターネットに直接公開しないでください。パネルに接続できないときは、待ち受けアドレス、ポートの競合、認証設定の順に確認します。
ポート関連の用語を見る →Profileにはプロキシ項目、プロキシグループ、振り分けルール、DNSなどの設定が保存されます。クライアントはサブスクリプションの追加や接続情報の表示を行い、システムプロキシやサービス権限も管理します。コアは最終的な設定を読み込み、名前解決、ルール照合、通信転送を実行します。画面上のスイッチを切り替えても、元のサブスクリプションファイルが変更されるとは限りません。問題を調べる際は、サブスクリプションの原文だけでなく、クライアントが生成した実行時設定を確認してください。
上記のYAMLは部分的な例です。コピーする前に現在動作している設定をバックアップし、インデント、プロキシグループ名、コアの対応状況を確認してください。最初の接続では設定を1つ、通信の取り込み方式を1つに絞って検証します。結果を再現できることを確認してから、ルールセット、上書き、自動選択を追加しましょう。各項目の意味を確認するには、用語集を参照し、続いて設定ガイド（応用編）で詳しい例を確認してください。
まずOSとCPUアーキテクチャを確認してから、クライアントを選びましょう。同じコアを使っていても、画面、権限の設定手順、設定の上書き方法は異なります。ダウンロードセンターではインストール先とシステム要件をまとめています。ホームではOS別に案内し、インストーラーの直接配布は行いません。
普段使いのデスクトップクライアントならClash Plusから試せます。ルール管理に慣れている場合はClash Verge Rev、FlClash、Clash Nyanpasuも比較してみてください。インストール前にOSの種類を確認し、CPUアーキテクチャとOSのビット数を混同しないようにしましょう。
初回起動時にサブスクリプションを追加してルールモードを選び、システムプロキシを有効にします。ブラウザーでは接続できてもターミナルではできない場合、ターミナルのアプリがシステムプロキシを参照しているか確認してください。必要なアプリを確認してからTUNやサービスモードを使うか決め、複数の設定を一度に変更するのは避けましょう。
Windows版をダウンロード →システム情報でApple SiliconかIntelかを確認してから、対応するインストーラーをダウンロードしてください。Clash Plus、Clash Verge Rev、FlClashはそれぞれ設定管理画面が異なります。旧クライアントから移行する場合は、サブスクリプションとローカルの上書き設定を先に保存しましょう。
インストール後は、OSの案内に従って必要な権限を許可し、現在のネットワークサービスにクライアントのプロキシが設定されているか確認してください。Wi-Fiの変更、ドッキングステーションの接続、他のVPNの使用後は、プロキシの設定先を再確認します。クライアントを終了する前にシステムプロキシを無効にすると、停止済みのローカルポートへアプリが接続し続けるのを防げます。
macOS版をダウンロード →ダウンロードセンターでは、Clash Plus、Clash Meta for Android、FlClash、Surfboardを紹介しています。対応するアーキテクチャを確認してからインストール方法を選んでください。設定形式や項目の対応状況は、利用するアプリによって異なります。サブスクリプションURLを貼り付けられることだけで互換性を判断しないでください。
初回接続時に、OSのVPN権限を許可してください。バックグラウンドに切り替えると切断される場合は、バッテリー最適化とバックグラウンド実行の権限を確認し、クライアントのログも確認します。アプリごとの振り分けとドメインルールは別の設定です。前者はどのアプリの通信を取り込むか、後者は取り込んだ通信の接続先を決めます。
Android版をダウンロード →iPhoneとiPadでは、ダウンロードセンターからClash PlusのApp Storeページに進めます。公式サイトはclashplus.ioです。インストール後、サブスクリプションまたは設定を追加し、OSによるVPN構成の作成を許可してから、アプリに戻って接続を開始してください。
接続アイコンは通信の取り込みが開始されたことを示すだけで、すべてのルールが意図どおり動作しているとは限りません。実際に使うアプリで接続を試し、選択中のプロキシと設定の更新日時を確認しましょう。他のVPN構成がある場合は、現在有効なものを確認してください。問題を調べる間は通信の取り込み方式を1つに絞り、何度も切り替えて判断が混乱しないようにします。
iOS版をダウンロード →デスクトップではClash Verge RevとFlClashを比較し、ディストリビューションのパッケージ形式に合ったインストール方法を選べます。サーバーやルーターでは、ダウンロードセンターのmihomoコアから、設定ディレクトリ、起動オプション、サービス管理方法を自分で決めてください。
デスクトップ環境のシステムプロキシ設定が、コマンドラインのプログラムに適用されるとは限りません。コマンドラインツールでは、プロキシ用の環境変数を個別に設定する必要がある場合があります。TUNを有効にする場合は、権限、ルーティング、ファイアウォールも確認してください。長期間稼働するサービスとして導入する前に、まずフォアグラウンドで設定を読み込み、起動ログとポートの待ち受けを確認してからサービス管理ツールに登録します。
Linux版をダウンロード →別のクライアントの作業フォルダーを丸ごとコピーするより、元のサブスクリプションを再追加する方法を優先してください。画面の設定、サービス設定、キャッシュは通常そのまま移行できません。ローカルルールは新しいクライアントの上書き方法に合わせて1つずつ移します。正常に接続できる設定を1つ残し、動作を確認してから旧クライアントを削除すると、権限やDNSの違いが起きたときに元へ戻せます。
「グローバルモードでは使えるのにルールモードでは失敗する」場合は、まずルールが参照するプロキシグループの有無を確認し、次にルールの照合順序を確認してください。すべてのモードで失敗する場合は、ローカルポートと実際の接続先を確認します。モードは接続先の選択方法、システムプロキシとTUNは通信を取り込む範囲を決めるため、別々に検証してください。関連する用語は用語集で確認できます。
Clashでは、プロキシ項目、プロキシグループ、ルール照合をひとつの設定体系で管理します。アプリごとにプロキシ先の一覧を設定し直すことなく、ドメインやアドレスなどの条件に応じて接続先を振り分けられます。この仕組みを理解しておけば、互換クライアントに移行しても設定の考え方の多くを引き継げます。ただし、互換性があっても、すべての項目、画面、更新方法が同じとは限りません。
旧Clashプロジェクトと、現在も開発が続くエコシステムのプロジェクトは分けて考えましょう。古いガイドに記載されたクライアント名、設定項目、権限の手順は、現在のデバイスと異なる場合があります。クライアントを選ぶ際は、対応OSに加え、プロジェクトのメンテナンス状況、搭載コア、設定の扱い方も確認してください。ダウンロードセンターでは、アーカイブ済みのクライアントを別途表示しているため、移行時の確認に役立ちます。
mihomoはClashエコシステムで開発が続くオープンソースコアです。プロトコル処理、ルール照合、DNS、通信転送などを担います。GUIクライアントはコアを利用し、サブスクリプション管理、プロキシグループの選択、接続ログ、OSとの連携機能を提供します。この記事の設定画面は概念を示すイメージです。すべてのクライアントで同じ画面が使われることや、全OSで同じ通信の取り込み方式が使われることを示すものではありません。
クライアントを比較する際は、コアの機能と画面の機能を分けて確認しましょう。たとえば、コアがある設定項目に対応していても、GUIに専用スイッチがあるとは限りません。画面から上書きできても、リモートのサブスクリプション原文が永続的に変更されるわけではありません。実際の動作を確認するには、ボタン名だけでなく、実行時設定、アプリのログ、プロジェクトのドキュメントを確認するのが確実です。
mihomoのソースコード、ライセンス、リリースノート、課題の議論はプロジェクトのリポジトリで確認できます。リリースノートでは、プロトコルの修正、OSごとの制限、設定の変更点を把握できます。課題を報告する前に、同じログのキーワードで検索し、設定を簡略化して再現できるか確認してください。当サイトではダウンロード先と日本語の操作ガイドを案内しています。開発状況やリリースの記録は、メンテナーのリポジトリを参照してください。
設定の問題を調べるには前後関係が必要ですが、サブスクリプション全体を公開するのは避けてください。ログや再現手順を共有する前に、サブスクリプションURL、認証情報、実際のサービスアドレスを削除します。必要なルール構成、OS、クライアント名、エラー部分だけを残してください。最小構成で再現を試すと、無関係な設定をひとつの報告に混在させずに済みます。
クライアント、コア、サブスクリプションの更新は、それぞれ異なる問題に対応します。クライアントの更新は画面やOSとの連携に、コアの更新はプロトコルや設定の実行に、サブスクリプションの更新はリモートで提供されるプロキシやルールの内容に影響します。サブスクリプションを更新してもソフトウェアの更新にはならず、クライアントを更新してもリモート設定の互換性が保証されるわけではありません。更新する前に、解決したい問題を明確にしましょう。
元に戻せる設定を残し、変更内容を確認してから更新することをおすすめします。更新後は、設定を読み込めるか確認し、よく使うアプリ、ルールの適用、DNSの名前解決を検証してください。長期間稼働するデバイスでは、有効にした通信の取り込み方式とローカルの上書き設定を記録し、差異があれば1つずつ元に戻して確認します。接続アイコンや一度のテスト成功だけで、設定全体の検証が完了したと判断しないでください。
以下のコマンドはソースコードのリポジトリをクローンするもので、GUIクライアントはインストールされません。一般的なデスクトップ利用ではダウンロードセンターをご利用ください。開発者はリポジトリでビルド方法やライセンスを確認できます。
git clone https://github.com/MetaCubeX/mihomo.git各記事では、具体的な問題を取り上げ、まず確認できる症状を説明してから対処方法を紹介します。初めてインストールする場合は、まず使い方ガイドをご覧ください。接続はできていて、権限、通信の取り込み、ノード選択について詳しく知りたい場合は、該当する記事を参照してください。複数の問題を一度に変更するのを避けられます。
アプリの設定に依存するシステムプロキシと、仮想ネットワークアダプターで通信を取り込むTUNの違いを比較。用途、DNSへの影響、切り替え時の注意点も解説します。
記事を読む →macOSで初回起動がブロックされる場合の対処から、システム拡張・ネットワーク拡張の許可、サービスモードのインストール、キーチェーンのパスワード入力画面まで、原因と手順を解説します。
記事を読む →遅延テストの数値が示すものと限界を解説し、通信量倍率、接続先の地域、通信プロトコルを踏まえて、用途に合ったノードを選ぶ方法を紹介します。
記事を読む →