Windows
デスクトップクライアントとシステムプロキシGUI、ルール確認、OS起動時の自動起動が必要なデスクトップユーザーに適しています。ダウンロード前にシステムアーキテクチャを確認し、導入後は設定を読み込んでからシステムプロキシを有効にします。ストアアプリだけ通信できない場合は、UWPループバック設定も確認してください。
ダウンロードへCapability archive
ルールのマッチからシステム全体の制御までを整理
Clashの設定は、互いに無関係なスイッチの集まりではありません。リクエストはまずDNSで解決され、ルールの順番に従って照合された後、プロキシグループによって直接接続・プロキシ・拒否が決まります。ここではよく使う機能を分けて解説し、確認可能な設定キーと画面状態も示します。
現在の概要
ルールは設定順にマッチし、プロキシグループが最終的な出口を選ぶ
Clashはrulesの先頭からリクエストを確認し、マッチすると後続の照合を停止します。そのため、完全一致のドメインルールは広範なルールセットより前に置き、フォールバックのMATCHは通常末尾に配置します。プロキシグループはルール結果と実際のノードを分離します。ルールは通信をPROXY、DIRECTなどの指定グループへ送り、実際の出口はグループの種類とユーザーの選択で決まります。
分流を調べるときは、まず設定が再読み込み済みか確認し、接続詳細で対象ドメイン、マッチしたルール、転送先のポリシーを確認します。全体スイッチだけを備えたプロキシツールと違い、Clashではルール順、ポリシー名、最終出口を一つずつ確認できます。日本国内への直接接続、指定ドメインのみプロキシ、LANの例外を併用したい場合に適しています。
DOMAIN,api.example.com,PROXY完全一致ドメインDOMAIN-SUFFIX,example.org,PROXYドメインサフィックスGEOIP,CN,DIRECT,no-resolveIPアドレスの地域MATCH,FINALフォールバック
照合方法：上から順に
出口の制御：プロキシグループ
結果の確認：接続ログ
DNSの概要
ドメイン解決を分流の判断に組み込む
内蔵DNSを有効にすると、クライアントは待ち受けアドレス、上流リゾルバー、フォールバックリゾルバー、拡張モードを設定に応じて選択できます。Fake-IPはまず予約アドレスを返し、コアがドメインとアドレスの対応を保持します。これにより、対象IPだけを含む接続からでもドメインを復元してドメインルールに参加させられます。実際のWebサイトのアドレスを変更する機能ではありません。
設定前に、ローカルの別サービスが待ち受けポートを使用していないことを確認し、LAN共有の必要性に応じて外部インターフェースで待ち受けるか決めます。LAN機器、プリンター、特定アプリで互換性の問題がある場合は、該当ドメインをfake-ip-filterに追加します。確認は解決結果、ルールマッチ、上流への到達性の順に行い、最初から複数のDNS項目を同時に変更しないようにします。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
respect-rules: true
拡張モード：Fake-IP
フィルターキー：fake-ip-filter
確認方法：DNSクエリとログ
通信制御の概要
システムプロキシとTUNモードは異なる範囲の通信を処理する
システムプロキシは、OSのプロキシ設定に従うブラウザーや一部のデスクトップアプリに主に作用します。TUNモードは仮想ネットワークインターフェースを通じて、より広い範囲のTCP・UDP通信を制御し、システムプロキシ設定を読まないプログラムにも適しています。両方を同時に有効にする必要はありません。初回設定では、まずシステムプロキシでサブスクリプション、ノード、ルールを確認し、必要に応じてTUNを追加します。
TUNの起動失敗は、権限、仮想NIC、ルート競合、他のネットワークツールが原因になることがあります。まず同種のソフトを終了し、管理者権限を確認してから、クライアントログでインターフェース作成の結果を確認します。LAN共有にはallow-lanの個別設定と、ファイアウォールで待ち受けポートを許可する操作も必要です。
システムプロキシプロキシ設定に従うプログラム向け
TUNモード仮想インターフェースで通信を制御
LANを許可同一ネットワークの機器に待ち受けポートを公開
基本の制御：システムプロキシ
拡張の制御：TUN
共有設定：allow-lan
設定の概要
サブスクリプションはリモート設定、ローカル上書きは個別設定を担う
サブスクリプションは通常、サービス提供元が管理し、更新時にプロキシノード、プロキシグループ、ルールが再書き込みされます。サブスクリプション生成ファイルを直接編集すると、次回更新で上書きされる可能性があります。ポート、DNS、ルールの追加、ポリシー変更は、クライアントの上書きまたはマージ機能に入れるほうが安定します。
導入に失敗したら、まずリンクが完全か、認証が必要か、返却内容がClashで認識できるYAMLかを確認します。導入できても接続できない場合は、プロキシグループで利用可能な項目を選んだか、設定の構文チェックを通過したか、システムプロキシを有効にしたかを確認します。「設定の取得」と「設定の利用」を分けて検証すると、再導入を繰り返すより早く原因を特定できます。
リモートサブスクリプションproxies · proxy-groups
ローカル上書きdns · rules · tun
マージ結果実行設定
リモートソース：サブスクリプションリンク
ローカル変更：上書きまたはマージ
読み込み前の確認：YAML構文
Platform entry
OS別にダウンロードページへ進む
トップページではプラットフォームへの入口のみを案内し、インストールファイルは直接配布していません。ダウンロードページでシステムのアーキテクチャ、クライアントのメンテナンス状況、導入方法を確認してソフトを選びます。モバイル端末では、システム権限とバックグラウンド実行の制限にも注意してください。
macOS
IntelとApple SiliconmacOSのインストーラーは通常、プロセッサーのアーキテクチャ別に分かれています。「このMacについて」でチップの種類を確認し、対応するビルドを選択してください。初回起動時は、システムの案内に従ってネットワーク拡張機能やプロキシ変更の権限を許可し、複数のクライアントを何度も切り替えないようにします。
ダウンロードへAndroid
VpnServiceによる制御Androidクライアントは、システムのVpnServiceでローカルVPN接続を確立します。初回接続では権限確認のダイアログを承認してください。画面ロック後に頻繁に切断される場合は、クライアントをバッテリー最適化の対象外にし、バックグラウンド動作と必要な自動起動権限を許可します。
ダウンロードへiOS
App StoreクライアントiPhoneとiPadでは、App Storeからクライアントを入手します。サブスクリプション導入後、初回接続時にVPN構成の追加を求められます。システム設定に対応するVPN項目が表示され、権限を許可して初めてクライアントがネットワーク経路を確立できます。
ダウンロードへLinux
デスクトップUIとMihomoコアデスクトップ環境ではGUI付きクライアント、サーバー、ルーター、コンテナ環境ではMihomoコアを直接実行する構成が適しています。導入前に実行ユーザー、設定ディレクトリ、ログの保存先、起動方法を決めておくと、更新やトラブル対応が容易になります。
ダウンロードへクライアントの種類が分からない場合は、まずプラットフォームからダウンロードページへ進み、各クライアントカードの用途とメンテナンス状況を確認してください。
すべてのクライアントを見る →Quick start
初回接続の3ステップ
インストールが完了しても、通信がすでにClashを経由しているとは限りません。設定の導入、ポリシーの選択、システムによる通信制御を順番に行い、接続記録で結果を確認する必要があります。3つには明確な依存関係があります。有効な設定がなければプロキシグループを生成できず、利用可能なポリシーを選ばなければ接続の問題を判断できません。制御を有効にしなければ、ブラウザーは従来のネットワーク経路を使い続けます。
完全ガイドを見る →-
01
サブスクリプションまたはローカル設定を導入
クライアントの設定、サブスクリプション、Profilesページに完全なリンクを貼り付け、ダウンロードと構文解析が終わるまで待ちます。ローカルYAMLファイルの場合は、ファイルのインポート機能を使います。導入後は設定名、プロキシグループ、ルールが表示され、空のリストだけが表示される状態になっていないことを確認してください。形式エラーが出たら、まずリンクの返却内容を確認し、更新ボタンを連続して押さないでください。
-
02
モードとポリシーを選択
通常はルールモードから始め、設定内のルールに従ってリクエストを分流します。プロキシまたはポリシーページを開き、主要なプロキシグループで利用可能な出口を選びます。自動選択グループは独自のロジックで動作し、手動選択グループは現在の選択を使用します。グローバルモードは短時間の確認に適しており、ルール設定の長期的な管理に代わるものではありません。
-
03
通信制御を有効にしてマッチを確認
デスクトップではまずシステムプロキシを有効にし、モバイルではVPN権限を確認します。続いて対象サイトへアクセスし、クライアントの接続ページでドメイン、ルール、ポリシーの行き先を確認します。Webページが開くだけでは接続可能としか分かりません。マッチ結果が期待どおりで初めて、分流設定が正しいと判断できます。ゲームや特殊なプログラムを制御する必要がある場合は、その後でTUNの有効化を検討します。
Open-source context
オープンソースのエコシステム、コアの関係、更新範囲
Clash関連のクライアントは複数の独立したプロジェクトで構成されています。ソフトの提供元、機能、メンテナンス状況を判断する際は、コア、GUI、設定形式、配布経路をそれぞれ確認し、名前にClashが含まれるかだけで判断しないでください。
プロジェクトの沿革が現在のエコシステムを形作る
Clashは、ルール駆動のプロキシコアとYAML設定によって、幅広いクライアントエコシステムを築きました。元のプロジェクトが更新を停止した後も、コミュニティでは互換コアやGUIクライアントが独立して開発されています。現在よく使われるデスクトップ・モバイルクライアントは、Mihomoコアを採用している場合もあれば、独自のサービス層や設定管理画面を統合している場合もあります。同じルール構文でもUI機能が完全に同じとは限らないため、ガイドでは共通の設定原理とクライアント固有の操作を分けて説明します。
ダウンロード時は、どのOS向けのソフトか、どのコアを内蔵または利用するか、プロジェクトが現在も更新を公開しているかという3点を確認してください。メンテナンスが停止したクライアントでも旧設定の確認には使えますが、新しいコアの機能をすべて備えているとは限りません。ダウンロードページでは、メンテナンス状況とプラットフォームのアーキテクチャを同じカードにまとめ、古いガイドの名称だけでソフトを選び間違えないようにしています。
Mihomoは設定機能を継承・拡張
Mihomoは現在よく使われているClash互換コアの一つです。ルール、プロキシグループ、DNS、コントロールインターフェースなどの基本概念を引き継ぎながら、より充実したルールセット、TUN、ドメインスニッフィング、設定機能を継続的にサポートしています。GUIクライアントはこれらの機能を設定項目、ステータス画面、導入フローに変換し、コアは設定の解析、接続の確立、ルールの実行、ログの出力を担当します。
設定項目の名称が異なる場合は、設定キーとログに戻って確認します。たとえば画面の「LANを許可」は通常allow-lan、「混合ポート」はmixed-port、「拡張モード」はDNSのenhanced-modeに対応します。古い画面のスクリーンショットをなぞるより、設定キーを共通の手がかりにするほうが確実です。
更新はクライアント、コア、設定の3層に分ける
クライアントの更新はUI、システム連携、インストールの問題を修正します。コアの更新では、プロトコル、ルール、ネットワークスタックが変わることがあります。サブスクリプションの更新は主にノード、プロキシグループ、リモートルールを変更します。3者は提供元も更新頻度も異なります。問題が発生したら、最近変わった層を記録してから、設定のロールバック、サブスクリプションの再読み込み、リリースノートの確認を選びます。
ルールセットはメイン設定とは別に更新できます。rule-providersで外部ルールを参照すると、メインファイルにはルールセット名、動作種別、ソース、更新間隔だけを残せます。保守しやすくなる一方、ルールセットの形式がbehaviorと一致するか、参照名がrulesに実際に存在するかを確認する必要があります。
提供元を確認
プロジェクト名、配布経路、対応プラットフォームが一致していることを確認します。名前が似たクライアントでも開発者が異なる場合があり、インストーラーの形式や設定ディレクトリも異なることがあります。ダウンロードページではプラットフォーム別にクライアントを整理し、コアの圧縮ファイルをGUIソフトのインストーラーと取り違えないようにしています。
設定を確認
まずクライアントの構文チェックまたはログで、YAMLが正常に読み込まれたことを確認します。インデントエラー、重複キー、プロキシポリシー名の不一致、ルール参照の欠落は、設定の読み込み失敗や期待と異なる分流結果につながります。
動作を確認
接続記録で、対象ドメイン、対象アドレス、マッチしたルール、ポリシーチェーンを確認します。Webページが開くかどうかだけで設定を判断すると、DNS、ルール、ノード、システムプロキシの問題が混ざり、調査範囲が広がります。
Selected questions
初回利用でよく確認する4つのポイント
ここではトラブル対応の入口だけを示します。詳しいQ&Aは、基礎知識、導入と設定、活用方法、トラブル対処に分けてヘルプセンターに整理しています。
サブスクリプションを導入したのに、なぜシステムの通信が変わらない？
設定を導入しただけではデータを読み込んだ状態にすぎません。設定を有効にし、主要なプロキシグループで出口を選び、システムプロキシまたはモバイルのVPNを有効にする必要があります。その後、接続記録を確認してください。新しい接続がまったくない場合は、サブスクリプションを再導入する前に、システムによる通信制御が有効か確認します。初回接続ガイドも参照してください。
ルールモード、グローバルモード、ダイレクトモードはどう選ぶ？
ルールモードは設定に従ってリクエストを一つずつ照合し、日常利用に適しています。グローバルモードは大半のリクエストを同じポリシーへ送り、出口の短時間の確認に向いています。ダイレクトモードはローカルネットワークの確認や、一時的にプロキシを迂回する場合に使います。モードを切り替えても無効なサブスクリプションは修復できないため、調査では具体的な接続とログを確認してください。
ルールを書いたのにマッチしない場合、まず何を確認する？
まず設定が保存され、再読み込みされているか確認します。次に、ルールがより広範なルールより前にあるか、ポリシー名が存在するか、対象接続にドメインが残っているかを確認してください。前のルールがすでにマッチしていれば、後続のルールは実行されません。詳しい構文と優先順位は高度な設定ガイドを参照してください。
TUNを有効にしたら通信できない場合、どう切り分ける？
まずTUNを無効にし、システムプロキシで正常に接続できることを確認します。次に他のVPN、仮想NIC、ネットワークフィルターツールを終了し、管理者権限とクライアントログを確認してください。基本のプロキシも利用できない場合は、先に設定、DNS、ポリシーの問題を解決します。分類別の詳しい対処はヘルプセンターで確認できます。
ヘルプセンターでは、ClashのUWPループバック、GeoIPの更新、LAN共有、Fake-IPフィルター、システムプロキシ設定も扱っています。
すべてのQ&Aを見る →Recent notes
設定操作とトラブル対応の記録
各記事は一つの場面に絞り、設定キー、操作経路、確認手順を示します。すべてのパラメーターを体系的に確認する場合は高度な設定ガイド、手順全体に沿って進める場合は初回接続ガイドを利用してください。
混合ポートとLAN共有：同じネットワークの機器を一つのClashプロキシ経由にする
mixed-portとallow-lanを起点に、待ち受けアドレス、ファイアウォールの許可、モバイル端末のプロキシ入力方法、接続失敗時の確認順を解説します。
Androidクライアントの要点：VpnServiceの許可とバッテリー最適化除外
AndroidのローカルVPNに必要な権限フローを解説し、バックグラウンド動作、バッテリー設定、画面ロック後の切断を調べる方法を整理します。システムによってクライアントが頻繁に終了される場合に役立ちます。
カスタムルールの書き方：DOMAIN、IP-CIDRなどの構文とマッチ優先順位を詳しく解説
よく使うルールの種類、上から順に照合する仕組み、no-resolveパラメーターを一つずつ説明し、ルールがマッチしない場合に再利用できる確認手順を紹介します。
記事一覧では、iPhoneクライアントの入手、中国本土と海外の分流構成、カスタムルールの管理なども扱っています。
すべての記事を見る →