インストール前にプラットフォームとアーキテクチャを確認
デスクトップ用インストーラー、モバイルアプリ、単体コアにはそれぞれ利用条件があります。まずデバイスを選び、設定管理とトラフィックの取り込み方法を比較してください。
まずシステム情報でプロセッサのアーキテクチャを確認します。Clash Plusから始め、Clash Verge RevやFlClashの設定管理方法を比較してください。旧来のクライアントは過去の設定環境を確認する目的に限って利用します。
初回利用時は、システムプロキシが適用されているかを先に確認します。システムプロキシに従わないアプリを取り込む必要がある場合は、TUNに必要なサービスと権限を確認してください。最初からすべての機能を同時に有効にする必要はありません。
ダウンロードへデバイスのアーキテクチャに合うパッケージを選び、システム要件を確認してください。ダウンロードページではClash Plus、Clash Meta for Android、FlClash、Surfboardを紹介しています。設定形式の互換性は拡張子だけでは判断できません。
接続開始時は、システムVPNの許可ダイアログを確認してください。ロック画面後に接続が切れる場合は、バックグラウンド動作とバッテリー制限を優先して確認します。別のVPNが動作している場合は、取り込みの競合が起きていないか確認してください。
ダウンロードへダウンロードページからClash PlusのApp Store詳細ページを開き、現在のシステム要件とアプリの説明を確認できます。プロジェクトサイトはclashplus.ioです。インストール前に対応範囲を確認してください。
インポート時は、アプリが受け取るのが完全な設定なのかノード情報なのかを確認し、システムの案内に従ってVPN構成を追加します。デスクトップのサービス導入やポート待受の手順を、そのままスマートフォンに適用しないでください。
ダウンロードへ「このMacについて」でApple SiliconまたはIntelを確認し、対応するパッケージを選びます。Clash Plus、Clash Verge Rev、FlClashを比較の出発点にできます。アーカイブ済みプロジェクトは、別途メンテナンス状況を確認してください。
ネットワーク拡張や補助サービスに関わる場合は、システムの許可内容を一つずつ確認してください。起動できないという表示が出たら、まず入手元、アーキテクチャ、システム互換性を確認します。システムのセキュリティ機能を無効にすることを通常の手順にしないでください。
ダウンロードへデスクトップではClash Verge RevとFlClashを比較し、ディストリビューションに合うパッケージを選べます。インストール前にアーキテクチャ、デスクトップ環境、依存関係を確認してください。パッケージ形式が違っても、プロキシプロトコルの対応能力が同じ、または異なるとは限りません。
サーバーやルーターでは、Mihomo単体コアも検討できます。コア自体はGUIクライアントではないため、設定パス、起動サービス、ログの保存、ネットワーク権限は利用者が管理する必要があります。
ダウンロードへクライアントをダウンロードしても、ツールの準備が整うだけで、利用可能なプロキシサービスが自動的に提供されるわけではありません。設定前に、信頼できる提供元の有効なサブスクリプションまたはノード情報を用意してください。旧設定を保存してから移行し、複数のクライアントが同時にシステムプロキシを変更しないようにします。そうしないと、いずれかを終了した後もインターネットに接続できない場合があります。
設定項目 — 設定フィールド
よく使う4種類の設定を、同じ設定フローに沿って解説します。説明と例を行単位で照合できるため、複数ページを行き来してフィールドの意味を推測する必要はありません。
Clashのルール分岐では、ドメインや宛先アドレスなどの条件と処理方法を関連付けます。ルールモードを選ぶと、接続はルールの順番に沿って確認され、通常は先にある具体的な条件が優先されます。最後にフォールバックも設定します。ルールの処理先はプロキシグループ、ノード、組み込みアクションなどにできるため、modeフィールドだけで接続問題を解決することはできません。
グローバルモードが変えるのは、コアに入った接続の出口の選択方法であり、デバイス上のすべてのアプリが取り込まれることを意味しません。画面上のモード名を切り替えるだけでなく、接続ログを照合して適用されたルールと実際の出口を確認してから、順番を調整する方が確実です。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECTルール構造だけを示す例です。ここではすべて直接接続で、プロキシノードは含まれません。実際の分岐設定として推奨するものでもありません。
mode: globalモードフィールドだけを示す例です。実際の出口はグローバル設定で選択します。アプリがコアに入るかどうかは、システムプロキシなどの取り込み方法によって決まります。
DNSはドメインを接続に必要なアドレス情報へ変換し、コアがドメインベースのルールを適用できるかどうかにも影響します。Fake-IPモードは仮想アドレスのマッピングによってドメインとの関連を保持しますが、アプリの問い合わせとその後の接続が適切な処理経路に入る必要があります。DNSフィールドを書くだけで、OS、ブラウザー、LAN内のデバイスが自動的にそれを使うわけではありません。
ClashのDNSリークを調べるときは、システムリゾルバー、ブラウザーのセキュアDNS、TUNによるDNS取り込み、上流リクエストの出口を分けて確認します。LANサービスが実アドレスを必要とする場合は、状況に応じて除外項目を設定してください。1つのエラーを消すためにすべてのドメインをフィルターへ追加するのは適切ではありません。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
nameserver:
- 1.1.1.1上流アドレスはリストの書き方を示すためのもので、実際のネットワーク環境とプライバシー要件に応じて選択してください。この断片には、システムDNSの取り込みや上流接続の方針は含まれていません。
プロキシグループはルールの処理先を受け取り、グループ内で選択されたノードやアクションへ接続を渡します。ルールは常に同じグループ名を参照できるため、ノードを変更するたびに各ルールを書き換える必要がありません。手動選択グループは設定の検証に向いています。自動テストやフェイルオーバーグループでは、テスト先、周期、ヘルスチェック条件も必要で、type名を置き換えるだけでは不十分です。
Clashのプロキシグループ名は、ルールでの参照名と完全に一致している必要があります。空白、大文字・小文字、重複名も認識に影響します。テスト結果が示すのは指定したテスト先への到達性であり、すべてのウェブサイトに通用する証明ではありません。初回インポート時は、グループ内に選択肢が実際に含まれていることを確認し、選択項目が意図どおりかを確認してください。
proxy-groups:
- name: 手動選択
type: select
proxies:
- DIRECT
rules:
- MATCH,手動選択例では名前の参照関係を示すため、組み込みの直接接続アクションだけを使っています。実際にプロキシを利用する場合は、有効なノードを別途定義するか、コアの構文に従ってプロキシ集合を接続してください。
サブスクリプションの更新で、ダウンロードした設定が置き換えられる場合があります。サブスクリプション本体を直接編集しても、長期的に保持できるとは限りません。クライアントがローカルオーバーライドに対応していれば、ポートやモードなどの個別設定を分けて保存し、実行用設定の生成時に適用できます。これは設定管理の機能であり、すべてのクライアントに共通するコア構文ではありません。
マージの規則は必ず確認してください。スカラー値は置き換えられる場合があり、マップは再帰的にマージされ、リストは全体置換または順序に沿った挿入になることがあります。トップページでは単純なフィールドだけを示しており、ノードやルールリストも同じ方法でマージされることを意味しません。変更後は最終的な有効設定を確認し、サブスクリプション更新後もカスタム内容が残っているか確認してください。
# ローカルオーバーライドの断片。クライアントに処理させる
mode: rule
allow-lan: falseallow-lan: false はLANからのプロキシ接続を制限するための設定であり、完全なファイアウォールポリシーを意味しません。待受アドレスとシステム権限は別途確認する必要があります。
設定ファイルから接続確認まで
まず説明可能な接続経路を1本確立し、その後で複雑なルールを追加します。詳細な手順はクイックスタートページにまとめ、ここでは各ステップの確認ポイントを紹介します。
クライアントの設定またはサブスクリプション管理画面で、信頼できる提供元のURLを追加するか、ローカルのYAMLをインポートします。サブスクリプションURL、単一ノードの共有リンク、完全な設定は同じ種類の入力ではありません。入口が合わない場合は形式を確認し、適当に別の欄へ何度も貼り付けないでください。
インポート後は、設定が選択されているか、プロキシグループが表示されているか、ノードフィールドが認識されているかを確認します。ダウンロード成功は内容を取得できたことを示すだけで、コアが読み込んだことを意味しません。サブスクリプションURLにはアクセス情報が含まれる場合があるため、スクリーンショット、ログ、問い合わせ内容から機密部分を削除してください。
まずルールモードを使い、プロキシグループで想定する出口を選びます。デスクトップではシステムプロキシから確認し、モバイルではアプリの手順に従ってVPN権限を許可します。システムプロキシはその設定に従うアプリだけに影響します。TUNは取り込み範囲を広げますが、ルーティング、権限、DNSの連携が必要です。
「LANアクセスを許可」を、本体がインターネットへ接続するための必須スイッチと考えないでください。また、同じ接続をテストするために複数のプロキシクライアントを同時に動かさないでください。取り込み方法を1つに絞り、現在の設定を記録したうえで、変更は毎回1項目だけにすると、原因を判断できます。
まずプロキシを無効にした状態で基本ネットワークが正常か確認し、新しいテストリクエストを送ります。クライアントの接続ログで宛先、ルール、出口を確認してください。ブラウザーでウェブページを開けても、すべてのアプリが取り込まれた証明にはなりません。既存の長時間接続が以前の経路を一時的に維持する場合もあります。
タイムアウトが発生したら、ローカルネットワーク、サブスクリプションの有効性、ノードパラメーター、DNS、取り込み方法の順に確認します。ネットワークを切り替えて再確認し、テスト先に到達できないことをノード障害と誤認しないでください。利用を終えるときはシステムプロキシまたはVPNを正常に無効化し、直接接続が戻ったことを確認します。
プロジェクトの出所とメンテナンス範囲
名前が似ているプロジェクトが、同じチームによって管理されているとは限りません。ダウンロード、設定互換性、問題の報告は、具体的なプロジェクトと実際に動作しているコンポーネントに戻って確認してください。
ClashのルールとYAML設定方式は複数のクライアントで引き継がれ、その後さまざまなコアの分岐やUIプロジェクトが登場しました。Mihomoはこのエコシステムに属するオープンソースのコアプロジェクトです。過去の資料にあるClash Metaという名称と関係しますが、Clashの名前を含むすべてのアプリが同じコアを使っているとは限りません。
古いガイドのフィールドが新しい環境でエラーになる場合は、まずコアのドキュメントと変更履歴を確認し、次にクライアントが設定を書き換えていないかを確認します。あるファイル形式をインポートできても、その中のすべてのプロトコル、DNSオプション、実験的フィールドを実行できるとは限りません。同じサブスクリプションでも、2つのクライアントで異なる実行設定になる場合があります。
クライアントの更新では、サブスクリプション編集、システムサービス、オーバーライドの動作が変わることがあります。コアの更新では、プロトコル実装やルールの挙動が変わる可能性があります。更新前に元の設定、オーバーライドファイル、必要なログを保存し、更新後に重要な接続を再確認してください。バックアップなしでクライアント、コア、サブスクリプション形式を同時に変更することは推奨しません。
オープンソースコードは実装の理解や問題追跡への入口になりますが、リポジトリの活発さを接続品質にそのまま置き換えて考えるべきではありません。メンテナンス状況は、プロジェクトの告知、リリースノート、既知の問題を組み合わせて判断してください。アーカイブ済みソフトウェアが起動しても、システム更新後の互換性と保守リスクを考慮する必要があります。
確認先も問題の層に応じて分けてください。インストールや権限の問題はクライアントの説明、フィールド解析エラーはコアのドキュメント、サブスクリプション更新の異常はサービス提供元、ウェブサイトへの到達性はDNSと接続ログを確認します。層を分けることで、何度も再インストールしたり、見慣れない設定全体を流用したりするより、原因を見つけやすくなります。
特集 · 公開日順
基本手順が完了したら、発生した具体的な問題に応じて特集記事を読んでください。まず現象がどの層で起きているかを切り分け、その後で調整する設定を選びます。
DNS問い合わせと接続確立の流れに沿って仮想アドレスのマッピングを解説し、Fake-IPの適用条件、LAN互換性の問題、fake-ip-filterの設定範囲を説明します。
Fake-IP設定の解説を読む →UIのクラッシュとコアの起動失敗を分け、システムアーキテクチャ、実行依存関係、権限、設定ファイルを順に確認します。ログとバックアップを保存してから設定を復元する方法も説明します。
起動トラブルの解決手順を読む →ローカルネットワーク、サブスクリプションの有効性、ノードパラメーター、DNS、プロキシの取り込みを順に確認し、テスト先に到達できない場合と実際の接続失敗を切り分けます。再インストールの繰り返しも避けられます。
接続タイムアウトの診断方法を読む →