Clash之家 · クライアントと設定項目のリファレンス
mihomoコアを軸に、各OS向けの入手先、YAML設定、ルール振り分けを整理。インストール手順から設定項目まで解説します。
設定ファイルは接続の入口、名前解決、出口をつなぎます。まず各項目の役割を把握し、そのうえで動作を調整しましょう。クライアントの切り替えも、最終的にはコアが読み込める設定に反映する必要があります。
以下の一覧はmihomoでよく使われる項目を基準にしています。GUIクライアントによって設定できる項目、上書き方法、必要な権限は異なる場合があります。設定を移行する前に、クライアントのドキュメントも確認してください。
ルール振り分けでは、順序付きのルールリストを使って接続の出口を決めます。ドメインのサフィックス、宛先アドレス、ルールセットなどで異なる範囲を指定でき、通常は先に一致したルールが適用されます。設定を変えるときは、クライアントがルールモードになっていること、指定したポリシー名が存在することを確認し、最後にフォールバック用のルールを置きます。グローバルモードとの違いはノード数ではなく、接続ごとにルールで経路を選ぶかどうかです。問題が起きたら、速度テストだけで判断せず、接続ログで適用されたルールを確認してください。
rules、rule-providersプロキシグループを使うと、ルールとノードの間に再利用可能な出口名を設けられます。手動選択型なら自分で選択でき、遅延テスト型やフェイルオーバー型はそれぞれの条件で利用可能なメンバーを選びます。ルールからグループ名を参照し、グループからノードまたはノードプロバイダーを参照する形にして、ルールに大量のノード名を直接書かないようにしましょう。テスト先やテスト間隔によって選択結果は変わり、単一の遅延値だけですべての通信品質を判断することはできません。グループ名の不一致、循環参照、削除済みメンバーは設定の読み込みエラーにつながることがあります。
proxy-groups、type、useDNS設定はドメイン名をIPアドレスに変換する方法を決め、ドメイン名に基づく振り分けにも影響します。fake-ipモードでは仮想アドレスを使ってドメインとの対応関係を保ちますが、互換性はアプリやネットワーク環境にも左右されます。変更前に、OSのリゾルバー、クライアントのDNS待ち受けアドレス、上流DNSサーバーを区別してください。名前解決に問題がある場合は、リクエストがコアに届いているか、上流に接続できるか、ドメインに適用されるルールがあるかを順に確認します。暗号化DNSを有効にしただけでは、すべてのアプリのDNS通信が意図した経路を通るとは限りません。
dns、nameserver、enhanced-modeサブスクでは、設定全体を含むものとノードだけを含むプロバイダーを区別する必要があります。前者にはルールやプロキシグループも含まれる場合があり、後者は通常、ローカル設定から参照して使います。読み込む前に、取得した内容がクライアント対応形式であることを確認してください。ログインページや、変換されていないリンク集では読み込めません。サブスクURLにはアカウント情報が含まれる場合があるため、ログを共有する際は該当部分を削除してください。個人用の振り分けルールを残すには、ノードの取得元とローカルルールを分けて管理し、リモート更新で手動変更が上書きされないようにします。更新後もノードとプロキシグループが読み込まれているか確認しましょう。
proxy-providers、url、intervalTUNモードは仮想ネットワークインターフェース経由で通信を取り込み、システムプロキシ設定を参照しないアプリにも適しています。ただし、システムプロキシとは通信を取り込む層が異なるだけで、有効にすれば経路や名前解決の問題がすべて解消するわけではありません。デスクトップではサービスモードや適切な権限が必要な場合があり、モバイルではOSのネットワーク拡張機能に制約されます。有効にする前に通常のプロキシ接続を確認し、自動ルート、DNSの取り込み、LANアクセスを一つずつ点検してください。他のネットワークツールも使う場合はルートの優先順位を確認し、複数の仮想インターフェースが同じ通信を重複して取り込まないようにします。
tun、auto-route、dns-hijack設定の上書きを使うと、サブスクから取得した内容と個人設定を分けて管理でき、ローカルポートの固定、ルールの追加、DNSの調整などができます。上書きは通常、クライアントが設定を読み込む段階で行われます。すべてのクライアントで同じトップレベル項目やスクリプトAPIが使えるとは限りません。移行時は、設定がどのように結合されるか、リストが追加か置換か、生成後のファイルがどこに保存されるかを確認しましょう。一度に変更する項目を一種類に絞り、再読み込み後に反映を確認してください。キャッシュファイルを直接編集しても、次回のサブスク更新やクライアント再起動で置き換わる可能性があります。
rulesとdnsを確認してください。START / 3ステップで確認
ダウンロードページでOSを選び、CPUアーキテクチャとインストール形式を確認します。インストール後はクライアントの設定画面とログ画面を開き、設定の読み込み元やエラーの確認場所を把握しましょう。他のプロキシツールを使っている場合は、設定を控えてから終了し、ポートやシステムプロキシの競合を避けてください。
初回からネットワーク関連の設定をすべて有効にする必要はありません。まず既定の待ち受け範囲のままコアが起動することを確認し、用途に応じてシステムプロキシかTUNを選びます。権限が必要な操作は、目的を理解してから許可してください。
設定画面で信頼できる配布元のサブスクURLを貼り付けるか、既存のYAMLファイルを読み込みます。取得後、その設定を現在の使用対象に指定し、ノードとプロキシグループが表示されるか確認してください。読み込み履歴だけがありノードを使えない場合は、システムプロキシを何度も切り替えるのではなく、形式と読み込みログを確認します。
次にプロキシ画面を開き、使いたいプロキシグループとノードを選んで、動作モードがルールモードであることを確認します。設定の読み込みによってルールと出口の対応関係は作られますが、クライアントがリモートのプロキシサーバーを用意するわけではありません。
現在のOSに適した接続方式を有効にし、到達できることが分かっているサイトにアクセスします。その後、接続画面でドメイン、適用ルール、実際の出口を確認してください。速度テストが示すのはテスト通信の結果に限られます。Webサイトへの接続、名前解決の結果、接続ログを合わせて確認しましょう。
問題が起きたら、ローカルネットワーク、システム時刻、サブスクの内容、ノード接続、DNSの順に切り分けます。一度に変更するのは一項目だけにし、結果を記録してください。クライアントを終了した後はシステムプロキシが元に戻っているか確認し、停止済みのローカルポートをアプリが参照し続けないようにします。
SOURCE / オープンソースのエコシステム
クライアント名は通信プロトコルではありません。
設定構文からサービスの提供元も分かりません。
Clash之家は日本語資料をまとめたサイトであり、各クライアントプロジェクトの配布元ではありません。ダウンロード情報、設定項目の解説、使い方ガイドはそれぞれ異なる範囲を扱います。情報を読む際はこの違いを意識してください。
オープンソースの全体像を見る →オリジナル版Clashや一部の初期GUIクライアントがメンテナンスを終了した後も、エコシステムが単一の新製品に統合されたわけではありません。mihomoは関連するコア機能を引き継ぎ、さらに拡張しています。Clash Verge RevやFlClashなどのGUIプロジェクトは、それぞれのOS向けに画面やシステム連携を提供します。過去のガイドにある画面、ボタン名、設定項目の既定値は、現在のクライアントでは異なる場合があります。違いがあれば、利用中のプロジェクトのドキュメントと実際に適用された設定を確認してください。
「Clash 公式サイト」と検索したときは、何の公式サイトなのかを確認しましょう。コアのリポジトリ、GUIクライアントの公式ページ、サブスクサービスの提供元はそれぞれ別です。情報サイトは索引や解説を提供できますが、互換性を保証する立場ではありません。アーカイブ済みのクライアントは既存環境の調査に使い、新規インストールではメンテナンス中の代替候補を優先して検討してください。
コアはプロトコル接続、DNS処理、ルール判定、出口選択を担当します。GUIクライアントは設定の読み込み、ポリシーの切り替え、ログ表示、システムプロキシなどを管理します。同じコアを複数のGUIから利用でき、同じGUIでも更新によってコアの構成が変わる場合があります。機能が使えるか判断するには、コアの対応状況、クライアントに操作画面があるか、OSから必要な権限が与えられているかを確認してください。
設定ファイルはコアとクライアントの間にあり、期待する動作を記述します。しかし、OSの通信が実際にコアへ届くことまでは保証しません。クライアントに「実行中」と表示されても、一部のコンポーネントが起動したことを示すだけです。通信の取り込みを確認するには、接続履歴とシステム設定も確認してください。そのため、このガイドでは「設定の読み込み」と「接続確認」を別の手順にしています。
mihomoのソースコードとライセンスは公開リポジトリで確認でき、コアはGPL-3.0ライセンスで提供されています。GUIクライアントのライセンスは各プロジェクトの説明を確認してください。オープンソースであることは、実装や変更履歴を確認できるという意味であり、配布ファイル、サブスクの提供元、リモートノードの管理者が同じであることを意味しません。選定時はリリース履歴、課題の議論、ドキュメントの更新状況を参考にし、未確認のダウンロード数や評価だけで判断しないようにしましょう。
問題を報告する前に、原因がGUI、コア、サブスク内容のどこにあるか確認してください。報告にはOS、クライアント名、再現手順、個人情報を伏せたエラー情報を含めると役立ちます。サブスクURL、ノードのパスワード、コントロールAPIの認証情報は、公開する画像やログに含めないでください。設定全体を貼るより、必要な状況を添えるほうが原因を特定しやすくなります。
クライアントの更新、コアの更新、サブスクの更新、ルールセットの更新はそれぞれ別の操作です。前の二つはプログラムの機能を変え、後の二つはプログラムが読み込むデータを変えます。特定のルールが更新されても、クライアント自体が更新されたとは限りません。GUIを更新した後は、個人用の上書き設定が以前と同じ順序で結合されているかも確認してください。動作が変わる更新では、復元できる設定のコピーを残してから、一項目ずつ調整しましょう。
このサイトのトップページには、特定のバージョン情報を固定表示していません。インストーラー、対応アーキテクチャ、メンテナンス状況はダウンロードページに、設定項目の意味はYAMLガイドにまとめています。「どのプログラムを選ぶか」と「ネットワークの動作をどう設定するか」を分けることで、古い画面やファイル名、クライアント間の設定差による誤解を減らします。
MIHOMO / 公開ソースコード
コアのリポジトリを見る ↗git clone https://github.com/MetaCubeX/mihomo.gitこのコマンドはソースコードを取得します。実行にはGitが必要です。通常のインストールでは、ダウンロードページからクライアントを選んでください。
PLATFORMS / ダウンロード
まずプラットフォームを選び、次にクライアントとアーキテクチャを比較しましょう。Clash Plusは、対応プラットフォーム向けのおすすめ候補です。特定のデスクトップ操作やLinux向けのインストール形式が必要な場合は、Clash Verge RevやFlClashも確認できます。全クライアント一覧では、アーカイブ済みプロジェクトのメンテナンス状況も掲載し、古いガイドに出てくる名称を見分けられるようにしています。
OSとCPUアーキテクチャを確認してから、インストーラーを選びましょう。Clash Plus、Clash Verge Rev、FlClashを候補に、Clash for Windowsの代替を探す場合はメンテナンス状況と設定の移行方法を特に確認してください。
システムプロキシが適用されるのは、その設定に従うアプリだけです。より広い範囲の通信を取り込む必要がある場合は、TUNのサービス権限について確認してください。UWPアプリで接続に違いが出る場合は、すべてのノードを変更するのではなく、ループバック制限を個別に点検しましょう。
ダウンロードページへApple SiliconとIntel搭載Macでは、対応するアーキテクチャをそれぞれ選んでください。Clash Plus、Clash Verge Rev、FlClashの画面や設定管理方法を比較できます。以前からClashX Metaを利用している場合は、アーカイブ状況にも注意してください。
初回起動時にセキュリティ警告やネットワーク権限の確認が表示されたら、アプリの配布元と権限の用途を確認してから操作してください。システムプロキシ、ネットワーク拡張、他のVPNツールは互いに影響する場合があります。問題の切り分けでは、どのアプリが通信を取り込んでいるかを先に確認しましょう。
ダウンロードページへAndroid向けClashクライアントにはClash Plus、Clash Meta for Android、FlClashがあり、ダウンロードページにはSurfboardも掲載しています。対応する設定形式はクライアントによって異なるため、読み込む前にサブスクの種類を確認してください。
接続には通常、OSのVPN権限が必要です。バックグラウンドに移ると接続が切れる場合は、バッテリー最適化とバックグラウンド実行の制限を確認してください。アプリごとの通信振り分けでは、OSのVPN対象アプリとコアのルールを区別しましょう。両者は異なる階層で動作します。
ダウンロードページへダウンロードページにはClash PlusのApp Storeへのリンクと、プロジェクト公式サイトclashplus.ioを掲載しています。インストール後は対応する設定を読み込み、OSの案内に従ってネットワーク接続を許可してください。利用できる機能はアプリの説明で確認しましょう。
PC用のYAML設定を確認せずにスマートフォンへ移すのは避けてください。ファイルパス、待ち受けアドレス、スクリプト、システムルートの設定項目はプラットフォームによって異なる場合があります。まず基本的なノードとルールを残し、拡張設定を一つずつ確認しましょう。
ダウンロードページへデスクトップではClash Verge RevやFlClashを確認し、ディストリビューションに合ったインストール形式を選べます。サーバーやルーターで使う場合は、ダウンロードページのコア一覧からmihomoを探し、設定ディレクトリ、プロセス、ネットワーク権限を自分で管理してください。
コマンドラインのプログラムがデスクトップ環境のプロキシ設定を読み込むとは限りません。環境変数とプログラムの引数をそれぞれ確認してください。仮想インターフェースを有効にする前に、ルート、ファイアウォール、サービス権限も点検しましょう。デスクトップクライアントの操作をサーバーにそのまま当てはめないでください。
ダウンロードページへREADING / 新着記事
記事では、設定項目の定義だけでは説明しにくい操作の背景を、具体的な問題ごとに解説します。初めてインストールする場合は、まずクイックスタートを終え、画面の使い方、同期方法、接続トラブルなど、実際に必要になった内容を読んでください。基本的な接続ができる前に、高度な設定をすべて変更する必要はありません。
ノードの速度テストがタイムアウトする場合や接続できない場合に備え、システム時刻、ポートの競合、DNSモード、プロトコル設定を順に確認する手順を紹介します。
サイドバーの順に各画面の用途、よく使うボタン、設定項目の意味を説明し、初めて使う人が画面構成を把握できるようにします。
複数デバイス間で設定を同期する方法を比較し、それぞれの更新頻度、プライバシー上のリスク、OS間の互換性を解説。おすすめの組み合わせも紹介します。