設定項目ごとに、サブスクリプション・コア・システムネットワークの役割を確認しましょう。
Webページは開けるのに特定のアプリだけ接続できない場合は、まずそのアプリの通信がクライアントを経由しているか確認します。サブスクリプションを追加できても、有効化時にエラーが出るなら、設定項目とコアの対応状況を確認してください。ここでは5つの機能別に操作方法をまとめています。例は設定の一部であり、プロキシやグループを含む完全な設定ファイルの代わりにはなりません。
LAN内のアドレスは直接接続し、それ以外の通信をルールに従って処理する場合は、まずプロキシモードを「ルール」に設定します。コアはルールを上から順に確認し、最初に一致した時点で判定を終了します。そのため、個別のドメインを広範囲に一致するルールより上に置き、MATCHは最後に配置します。全般モードの切り替えだけで運用する場合と異なり、ルールを使えば用途ごとに異なる接続先を維持できます。変更後は「接続」で一致したルールとポリシーを確認してください。サブスクリプションの更新でローカルの変更が上書きされる場合は、クライアントのオーバーライド機能でカスタム設定を保存します。
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECTこの例は構文の説明用で、3つのルールはすべて直接接続です。実際にプロキシを使う場合は、設定ファイルに定義済みのポリシーグループを指定してください。
ルールの順序とMATCHの解説を見る →設定項目でプロトコルが非対応と表示されたり、unknown fieldが出たりした場合は、まずクライアントが使用しているコアを確認します。mihomoはClash Metaの開発系譜を引き継ぎ、プロトコル、ルールセット、通信のスニッフィングなどの機能を拡張しています。デスクトップの画面は操作の入口にすぎず、どのクライアントでも同じ設定項目が使えるとは限りません。オリジナルのコア向け設定から移行する場合は、ファイル名を変えるだけでなく、拡張された項目を一つずつ確認してください。最小限の設定で動作を確かめてから機能を追加すれば、エラーの原因を絞り込みやすく、問題時の復元も簡単です。
mode: rule
log-level: info
ipv6: false基本項目の例です。IPv6が必要かどうかは、利用中のネットワークとサブスクリプションに応じて判断してください。
mihomoとオリジナルのコアの違いを見る →URLを追加したら、まずサブスクリプションのカードが表示されていることを確認し、現在の設定として選択します。リストに表示されていても、コアへの読み込みが完了したとは限りません。ログに解析エラーがないかも確認してください。ダウンロードしたファイルを直接編集するより、クライアントのオーバーライド機能を使うほうが、ポートやルールなどのローカル設定を更新後も維持しやすくなります。更新に失敗した場合は、URLの有効期限、取得内容、接続経路を確認してから、プロキシ経由での更新が必要か判断します。サブスクリプションURLにはアクセス情報が含まれる場合があるため、公開の場に全文を投稿しないでください。
profile:
store-selected: true
store-fake-ip: trueこの設定はポリシーの選択とFake-IPの対応関係を保存するもので、サブスクリプションのダウンロードやURLの保存には使いません。
サブスクリプションの追加方法を見る →ブラウザーは使えるのに、ターミナルなどのアプリが接続できない場合は、まず手動プロキシに対応しているか確認します。システムプロキシの影響を受けるのは、その設定に従うアプリだけです。一方、TUNは仮想ネットワークインターフェースを使い、ルーティング条件に合う通信を取り込みます。有効にする前に、クライアントのサービスモードまたは管理者権限を確認し、経路の競合を防ぐため他のVPNを一時停止してください。TUNは接続トラブルを何でも解決する機能ではありません。ノード自体が使えない場合は、有効にしても接続できません。変更後はDNS、接続履歴、LANへのアクセスも確認します。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: truemihomoの設定例の一部です。必要な権限やDNSの処理方法は、プラットフォームとクライアントによって異なります。
TUNとシステムプロキシのトラブル対処を見る →同じサブスクリプションがPCでは使えるのにスマートフォンで読み込めない場合も、すぐにURLの失効と決めつけないでください。まず両方のコア、プロトコルの対応状況、設定形式を比較し、次にローカルのファイルパスなどOS固有の項目を確認します。ルールやポリシーグループは共用しやすい一方、TUN、システムプロキシ、起動サービスはデバイスごとの設定が必要です。クライアントのデータフォルダー全体をコピーするより、サブスクリプションを移行してローカル設定をやり直すほうが、問題の切り分けが簡単です。YAMLのインデントにはスペースを使い、追加後は基本的な通信を確認してからカスタムルールを戻してください。
mixed-port: 7897
allow-lan: false
mode: rule
log-level: infoポート番号は例です。実際の待ち受けポートはクライアント画面の設定で上書きされる場合があります。
設定の移行と接続確認を見る →OSとプロセッサーのアーキテクチャを確認してから選びましょう。
Clashはクライアントのエコシステムであり、すべてのデバイスに同じアプリをインストールするわけではありません。ダウンロードページではOSごとにクライアントを掲載し、おすすめのものとメンテナンス終了済みのアーカイブを明記しています。初めて使う場合はClash Plusから始められます。使い慣れたクライアントがある場合は、設定の互換性を確認して選んでください。クライアントをインストールしてもサブスクリプションは自動で作成されません。接続に必要な設定は、利用権限のあるサービスから入手してください。
デスクワークや、画面上で設定したい方に適しています。ダウンロード前にシステムの「このMacについて」または「バージョン情報」でデバイス情報を確認し、インストール後はサービスモードとシステムプロキシを確認してください。
Clash PlusやClash Verge Revなど、各クライアントのダウンロード先をプラットフォーム別にまとめています。ウィンドウが起動直後にクラッシュする場合は、エラーを記録してから実行環境とポートの競合を確認してください。何度も上書きインストールしても、原因の特定にはつながりません。初回テストではプロキシクライアントを1つだけ起動し、複数のアプリがシステムプロキシを書き換えるのを防ぎましょう。
ダウンロードへAppleメニューの「このMacについて」でApple SiliconかIntelかを確認してから、対応するインストーラーをダウンロードしてください。アーキテクチャが合わないと起動できない場合があります。
Clash Plus、Clash Verge Rev、FlClashでは操作画面が異なります。初回起動時はシステムの案内に従って権限を付与してください。ネットワーク拡張機能や補助サービスを使う場合は、事前に説明を確認します。ブラウザーが古いプロキシ設定を使い続ける場合は、複数のクライアントを同時に起動せず、システムのネットワーク設定を確認してください。設定を移行する際は、ローカルのパスも改めて確認します。
ダウンロードへスマートフォンやタブレットでは、まずプロセッサーのアーキテクチャを確認して対応するパッケージを選びます。初回接続時には、システムからVPN接続の許可を求められます。
Clash Plus、Clash Meta for Android、FlClash、Surfboardでは、対応する設定形式に違いがあります。ファイルの拡張子だけで互換性を判断しないでください。画面消灯後に接続が切れる場合は、バッテリーの最適化、バックグラウンド実行の権限、ネットワークの切り替え履歴を確認します。アプリ別の通信振り分けによってプロキシを経由するアプリが決まる場合もあるため、利用中のクライアントの設定も確認してください。
ダウンロードへiPhoneやiPadでは、ダウンロードページからClash PlusのApp Storeページを開けます。インストール後、アプリの案内に従って設定を追加し、VPNを許可してください。
初めて使う前にストアのシステム要件を確認し、サブスクリプションの形式に対応しているかも確かめてください。Clash Plusの公式サイトはclashplus.ioです。製品情報はこちらで確認できます。ネットワークの切り替え後に接続できなくなった場合は、アプリとシステムのVPN状態が一致しているか確認してから再テストしてください。サブスクリプション、DNS、ルーティングを同時に変更するのは避けましょう。
ダウンロードへデスクトップ環境に合わせてディストリビューション向けのパッケージを選んでください。ダウンロードページではClash Verge RevとFlClashを紹介しています。利用前にデスクトップ環境と必要な依存関係を確認します。
サーバーやルーターで使う場合は、コアのページもご覧ください。コマンドライン版のコアにはグラフィカルな画面がなく、すべてのプロセスに自動でプロキシを設定するわけでもありません。ターミナルのプログラムでは、プロキシを個別に指定する必要がある場合があります。サービスとして実行する場合は、実行ユーザー、作業ディレクトリ、設定ファイルの読み取り権限に注意してください。まずフォアグラウンドで起動を確認してから、バックグラウンドで実行します。
ダウンロードへLinuxのペンギンアイコン：Font Awesome、CC BY 4.0。
問題がインストール、設定の読み込み、実際の通信のどの段階で起きているかを確認しましょう。一度に変更する設定を1つに絞り、テスト結果を記録すると、すべてのスイッチを同時に切り替えるより原因を見つけやすくなります。
まずプロキシをオフにして元のネットワークに接続できることを確認し、次にクライアントでサブスクリプションが選択され、正常に読み込まれているか確認します。続いてプロキシモード、ポリシーグループの選択、システムプロキシの状態を確認してください。特定のアプリだけ失敗する場合は、そのアプリがシステムプロキシに従うかを確認します。すべての通信が失敗する場合は、ログで具体的なエラーを調べてください。インストールの完了は接続の確立を意味しません。インストーラー、サブスクリプション設定、利用可能な接続先はそれぞれ別の要素です。詳しくはサブスクリプション設定ガイドをご覧ください。
通常はまずURLの有効期限、コピー漏れの有無、サーバーから設定ファイルとWebページのどちらが返されているかを確認します。ダウンロードできても読み込めない場合は、設定形式とプロトコルの対応状況を調べてください。再インストールしても、無効になったサブスクリプションURLは直りません。現在使える設定を残し、更新時のエラーを記録してから、トラブル対処ガイドに沿ってネットワーク取得と解析のどちらで失敗したかを切り分けます。
常に両方を有効にする必要はありません。まずシステムプロキシでブラウザーの通信を確認し、ほかのアプリの通信も取り込む必要があれば、クライアントの説明に従ってTUNを有効にします。両者は通信を取り込む経路が異なるため、併用するかどうかはプラットフォームの実装と用途によります。TUNを有効にした後は、ルーティングやDNS、ほかのVPNとの競合を確認してください。スイッチの表示だけで判断しないようにしましょう。基本設定の手順に沿って、一つずつ確認できます。
自動起動で決まるのは通常クライアントを起動するかどうかであり、サブスクリプションの読み込み、サービスの起動、システムプロキシの復元まで成功するとは限りません。まずシステムにログインし、クライアントの状態とログを確認してから、起動項目がシステムにブロックされていないか調べます。TUNを使う場合はサービスの稼働状況も確認してください。自動起動の経路を調べる前に、手動で正常に接続できることを確かめると、サブスクリプションのエラーと起動権限の問題を切り分けやすくなります。設定方法はクライアントの使い方ガイドをご覧ください。
プロジェクトの由来とメンテナンス範囲
クライアントの画面、プロキシコア、サブスクリプションの提供元を区別して、更新すべきものを確認しましょう。
当サイトではインストール先と日本語の操作ガイドをまとめていますが、すべてのクライアントの開発元ではなく、プロキシノードも提供していません。ダウンロードやトラブル対処の情報は、上流プロジェクトと利用環境に応じてご活用ください。非対応の設定項目、起動できないサービス、サブスクリプションのエラーが発生した場合は、まずどのコンポーネントが該当するかを特定すると、対処方法を絞り込めます。
オリジナルのClashでは、YAML形式の設定、ポリシーグループ、ルール分岐を中心とする使い方が広まりました。その後、派生コアやGUIクライアントが複数登場しています。mihomoはClash Metaの開発路線を引き継いでいます。そのため、古いガイドにあるClash Metaと現在のドキュメントにあるmihomoは、同じ開発の流れを指していることが多いものの、個々の設定項目は使用中のコアのドキュメントで確認してください。
一部の古いクライアントはすでにメンテナンスを終了しており、ダウンロード先にはアーカイブ済みと表示されています。アーカイブされたプログラムが起動しても、新しいプロトコルに対応できるとは限らず、新しいOS環境で動作する保証もありません。新たにインストールする場合は、現在もメンテナンスされているクライアントを優先してください。古いデバイスから移行する場合は、設定をバックアップしてから、プロトコルとルールの互換性を確認しましょう。慣れた名前だけで選ばないようにしてください。
mihomoのソースコード、課題の議論、リリース履歴は公開リポジトリで確認できます。プロジェクトのライセンスはGPL-3.0です。公開コードは設定や動作の理解に役立ちますが、GUIクライアントごとにメニュー、権限の扱い、更新頻度が同じというわけではありません。クライアントのライセンスと使い方は、それぞれのプロジェクトで確認してください。
不具合が疑われる場合は、再現に必要な最小限の設定、システム情報、関連ログを保存してください。共有する前に、サブスクリプションURL、認証情報などの個人情報を削除します。「接続できない」とだけ説明するより、再現手順を明確にするほうが議論に役立ちます。また、サーバー側の問題をクライアントの不具合として報告するのを防げます。
Clash Verge RevやFlClashなどのGUIクライアントは、サブスクリプション管理、各種スイッチ、ログ画面を提供します。コアは設定を解析し、ルールを照合して、接続先への通信を確立します。クライアントが設定を統合または上書きすることがあるため、ローカルファイルを編集した後は、元のサブスクリプションの一行だけを見るのではなく、最終的に適用された内容を確認してください。
画面上では接続済みなのに通信できない場合は、接続履歴に対象の通信が記録されているか、どのルールに一致し、どのポリシーが使われたかを確認します。通信がコアに届いていない場合は、システムプロキシまたはTUNのルーティングを調べてください。届いている場合は、DNSと接続先のエラーを確認します。こうして問題のある経路を絞り込めます。
クライアントの更新では通常、画面、システム連携、コアの機能が更新されます。サブスクリプションの更新では、設定内のプロキシ、ポリシー、ルールの提供元が更新されます。この2つは別の操作です。サブスクリプションの更新が成功してもクライアントが最新になるわけではなく、新しいクライアントをインストールしても無効なサブスクリプションは使えるようになりません。更新前に案内を読み、利用可能な設定を1つ保存しておきましょう。
アップグレード後は、基本的なWebアクセス、LANへのアクセス、よく使うアプリを確認してから、複雑なオーバーライドを戻してください。問題が起きたら、変更前後の動作を記録し、必要に応じて正常に動作していた設定に戻します。長期間使う場合は、特にDNS、TUN、カスタムルールの変更内容を簡潔に記録しておくと、更新を重ねた後も元の設定に戻しやすくなります。
以下のコマンドはソースコードを取得するだけで、クライアントをインストールしたり、プロキシを自動で有効にしたりするものではありません。通常は上のインストール先をご利用ください。設定の実装を調べたり、問題を報告したりする場合は、リポジトリのドキュメントを参照してください。
MetaCubeX / mihomoのリポジトリを開く →git clone https://github.com/MetaCubeX/mihomo.git事前にGitをインストールしてください。コピーしたらターミナルで実行します。
症状に合った項目を開き、エラーの原文を残してから調べましょう。
ログ、ルール、起動時のトラブルは、それぞれ原因となる経路が異なります。クライアントが起動しない場合は、まず実行環境を解決します。画面は開くのに通信できない場合は、設定と通信ログを確認してください。一部のサイトだけ接続経路が誤っている場合は、ルールの順序を優先的に調べます。以下の記事では、基本設定の後に確認できるよう、問題別に詳しく解説しています。毎回最初から再インストールする必要はありません。
ダブルクリックするとウィンドウがすぐ閉じる、または起動画面で固まって応答しない場合はありませんか？この記事では、確認順にWebView2ランタイム、ポートの競合、破損した設定ファイル、サービスモードの残存設定、ウイルス対策ソフトによるブロックを調べ、各プラットフォームでの削除・再インストール方法を紹介します。
起動時のクラッシュへの対処を見る →ルールは記述順に上から照合され、最初に一致した時点で判定が終了します。この記事ではDOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、IP-CIDR、GEOIP、MATCHの構文を解説し、no-resolveの役割とルールの並べ方を説明します。
カスタムルールの解説を見る →mihomo（旧Clash Meta）はオリジナルのコアをベースに、VLESS、Hysteria2、TUICなどのプロトコルに対応し、rule-providersの拡張記法やsnifferなどの設定項目を追加しています。この記事では両者の違いを項目ごとに比較し、設定移行時の注意点をまとめます。
コアと設定項目の比較を見る →