Clash リソースサイト · クライアントと設定リファレンス
マルチプラットフォーム対応クライアント、設定項目、プロトコルリファレンスを整理。サブスクリプションの読み込みからルールによる振り分けまで、手順に沿って確認できます。
クライアント一覧 / デバイス別
まずOSとCPUアーキテクチャを確認してから、クライアントを選びましょう。GUIクライアントは設定管理、システムプロキシ、ログ確認を担い、コアはプロトコル接続と通信の振り分けを処理します。両者は別のものです。初めて使う場合はGUIクライアントから始めるのがおすすめです。サーバーやルーターへの導入では、独立したコアの利用を検討してください。
デスクトップブラウザーや開発ツール、日常業務での利用に適しています。Clash Plus、Clash Verge Rev、FlClashなどから選び、インストール前にシステム情報でアーキテクチャを確認しましょう。システムプロキシはプロキシ設定に従うアプリに適しています。より多くのアプリの通信を取り込む場合は、TUNに必要なサービスや権限を確認してください。
インストール後、設定を読み込んでプロキシグループを選び、ローカルの待ち受けポートを確認してからシステムプロキシを有効にします。ほかのネットワークツールも使用する場合は、ポートの競合がないか確認しましょう。複数のプログラムがシステム設定を繰り返し変更する事態を防げます。
Apple SiliconとIntelでインストーラーが異なります。Clash Plus、Clash Verge Rev、FlClashはGUIで操作できます。アーカイブ版のクライアントは、OSとの互換性も確認してください。アプリケーションフォルダーに移動した後、システムの案内に従って必要な権限を許可します。
メニューバーの接続状態とシステムプロキシの設定は、それぞれ確認してください。クライアントを終了する前にプロキシ設定を元に戻すと、ブラウザーが停止済みのローカルポートへ接続し続けるのを防げます。仮想ネットワークインターフェースを使う場合は、関連するバックグラウンドサービスの動作も確認しましょう。
スマートフォンやタブレットでは、Clash Plus、Clash Meta for Android、FlClash、Surfboardの設定対応範囲を比較できます。デバイスのアーキテクチャに合ったインストーラーを選び、設定形式もクライアントに合わせてください。サブスクリプションを読み込めたからといって、すべての設定項目が反映されるとは限りません。
初回接続時には、システムからVPN接続の許可を求められます。省電力設定によって接続が維持されない場合は、必要なバックグラウンド動作を許可してください。通常、システムのVPN接続を同時に使用できるアプリは1つです。別のツールに切り替える前に、現在の接続を停止しましょう。
App StoreでClash Plusを確認できます。クライアントの公式サイトはclashplus.ioです。設定を読み込んだら、システムの案内に従ってVPN構成を追加し、クライアント内でポリシーを選択します。アプリのインストール、サブスクリプションの読み込み、接続の開始はそれぞれ別の手順です。
デスクトップ向け設定のファイルパス、外部コントローラー、仮想ネットワークインターフェースの項目は、モバイルOSで使えない場合があります。設定を移行する前に対応項目を確認し、必要なプロキシとルールを残してください。その後、クライアントの接続ログで実際の出口を確認しましょう。
デスクトップ環境ではClash Verge RevまたはFlClashを選び、ディストリビューションに合ったパッケージ形式でインストールできます。サーバー、コンテナ、ルーターではmihomoを直接実行できますが、設定ファイルのパス、プロセス管理、サービス権限、ネットワークルーティングは自分で設定する必要があります。
パッケージ形式とCPUアーキテクチャの両方を合わせてください。独立したコアだけでは完全なデスクトップ画面は提供されず、システムプロキシも自動では有効になりません。まずログと待ち受けアドレスを確認し、アプリやOSの要件に応じてプロキシの接続先を設定しましょう。
名前が似ているクライアントでも、メンテナンス状況、コアの機能、サブスクリプション形式が同じとは限りません。ダウンロードページではOS別に選択肢、パッケージ形式、システム要件を掲載しています。プロトコルへの対応状況やコアの系統はプロトコルリファレンスで確認できます。まず画面や操作性から選び、その後に機能を照らし合わせましょう。
クライアント一覧を見る →config.yaml / 設定項目一覧
設定ファイルでは、ノードの取得元、ポリシーの選択、ルールの照合、通信の取り込みがそれぞれ別の階層に分かれています。問題が起きたら、まずどの階層に当たるかを確認し、該当する項目を変更しましょう。以下は構造を理解するための例で、サブスクリプションやリモートノードを含む完全な設定ではありません。使用前に、利用中のクライアントとコアの対応範囲を確認してください。
プロキシグループは複数の出口をまとめ、ルールから参照できる名前を付ける機能です。手動選択にはselectを使い、自動判定型のポリシーには対応するプローブ設定が必要です。ルールにはグループ名を指定し、実際に使う出口はクライアント画面で選びます。そのため通常、出口を切り替えるたびにルールを書き換える必要はありません。以下はDIRECTを使った最小限の例です。リモートノードを追加する場合は、ノード名が実際に存在することを確認してください。サブスクリプション更新後に以前の選択肢が削除された場合は、更新成功だけでなく、グループ内の選択状態も確認しましょう。
proxy-groups:
- name: ノード選択
type: select
proxies:
- DIRECTルールプロバイダーを使うと、照合する項目を別ファイルにまとめ、メイン設定からRULE-SETで参照できます。ルールファイルの形式はbehaviorの指定と一致させる必要があります。ドメイン一覧をクラシック形式のルール一覧としてそのまま使うことはできません。以下はローカルのドメインルールセットを宣言する例です。パスはコアの作業ディレクトリを基準に解決されます。実際に使うにはファイルを用意し、参照ルールも追加してください。rulesに直接並べる方法よりグループごとの管理が容易ですが、取得元、形式、参照名をあわせて確認する必要があります。
rule-providers:
local-domains:
type: file
behavior: domain
path: ./rules/local-domains.yamlDNS設定はドメイン名をIPアドレスに変換するもので、プロキシグループの出口を直接決めるものではありません。fake-ipを有効にすると、コアはマッピング情報を使ってドメイン名の通信を処理できますが、一部のアプリでは追加の互換設定が必要です。以下は基本的な名前解決の構成例であり、完全なDNSルーティング設計ではありません。Webページが開けない場合は、まず名前解決のログを確認し、次に上流DNSサーバーへ到達できるか調べましょう。すべてをノードの障害と決めつけると、ローカルでのDNS処理やキャッシュによる違いを見落とすことがあります。
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- 1.1.1.1TUNは仮想ネットワークインターフェースとシステムルーティングを使って通信を取り込みます。対象範囲はブラウザーなどが使うシステムプロキシとは異なります。有効にする前に、クライアントに必要なサービスがインストールされていることと、ネットワークインターフェースの作成やルート変更に必要な権限があることを確認してください。以下はmihomoでよく使われる項目の例です。実際の動作はOSとクライアントの実装によって異なります。初めて設定する場合は、先にシステムプロキシを確認してからTUNを個別に有効にしましょう。DNS、ルーティング、プロキシモードを一度に変更すると、問題の切り分けが難しくなります。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true設定を読むときは、まずインデントと項目の階層を確認し、その後に値を見ます。YAMLで同名項目が重複している、リストの階層が誤っている、参照名が一致しないといった問題があると、設定を読み込めない場合があります。クライアントでファイルを開けたことは、該当段階の処理を通過したという意味にすぎず、各ルールが想定どおりに動く保証にはなりません。接続ログで適用されたルールとポリシーを確認してください。
サブスクリプションの読み込みから読む →オープンソースのエコシステム / 出典と注意点
クライアントを選ぶときは、プロジェクトのメンテナンス状況、実際に搭載されているコア、設定やプロトコルへの対応範囲を確認しましょう。当サイトは情報とドキュメントをまとめたもので、各クライアントの開発チームを代表するものではなく、リモートプロキシサービスも提供していません。アプリ、コア、設定の入手元はそれぞれ確認し、エコシステム全体を1つのプロジェクト名で判断しないでください。
Clashでは、YAMLでプロキシ、ポリシーグループ、通信ルールを記述する設定方式が確立され、その後、各OS向けのGUIクライアントが登場しました。オリジナルプロジェクトの更新終了後も、古いインストーラーが動作することはあります。しかし、起動できることと、プロトコル対応や不具合修正が継続されることは別です。クライアントを選ぶ際は、現在もメンテナンスされているプロジェクトとリリースノートを優先して確認しましょう。古いクライアントを使い続ける場合は、名前に馴染みがあるからではなく、明確な互換性の必要性があるかを判断してください。
画面の見た目だけでメンテナンス状況を判断することもできません。UIの変更、コアの更新、OS互換性の修正はそれぞれ別の作業で、リリースによって更新対象が異なる場合があります。アップデート後に動作が変わったら、クライアント名、使用中のコア、具体的な設定を記録し、プロジェクトの説明と照らし合わせて原因を絞り込みましょう。設定全体をすぐに入れ替えるより、問題を再現しやすくなります。
mihomoはClash Metaの開発路線を引き継ぎ、プロトコル処理、ルール照合、DNS、ネットワークスタックなどの中核機能を担います。GUIクライアントはその上に、サブスクリプション管理、ポリシー選択、システムサービス、ログ表示などの機能を提供します。同じコアを使うクライアントでも、設定の統合方法、初期設定、権限管理の手順は異なる場合があります。別のクライアントのメニュー操作をそのまま当てはめないでください。
プロトコルを選ぶ際は、サーバー側の要件とクライアントのコアが対応しているかをあわせて確認してください。設定にプロトコル名を書いても、古いコアにその機能が追加されるわけではありません。TLS、UDP、トランスポート層の設定も、接続する両側で一致させる必要があります。プロトコルリファレンスでは、主なプロトコルとコアの違いを設計上の特徴から解説しています。クライアントの変更やサブスクリプションの移行前に確認してください。
サブスクリプションURLは設定やノード情報を取得するためのもので、クライアントそのものではありません。設定にはプロキシグループ、リモートルール、DNS設定が含まれる場合もあれば、ノード一覧だけの場合もあります。読み込み後に形式を確認し、ポリシーの追加が必要か判断してください。出所が不明なClashの無料ノードや公開設定を使う場合は、提供元と設定内容を確認しましょう。読み込みに成功しても、サービスの信頼性が証明されたわけではありません。
ClashのプロキシサービスのサブスクリプションURLには、専用のアクセス先が使われることが多く、URL内のパラメーターがアカウント権限に関係する場合があります。問題のスクリーンショットを共有したりログを送信したりする前に、サブスクリプションURL、識別情報、ノードの認証情報を削除してください。調査に必要なのは、エラーの種類、関連する項目名、必要最小限のネットワーク環境情報です。個人用の設定全体を公開の場に貼り付けないようにしましょう。
アプリ、コア、サブスクリプション、ルールデータの更新はそれぞれ別に行われます。サブスクリプションを更新してもアプリは更新されず、アプリを更新してもノード一覧が最新になるとは限りません。Clash GeoIPの更新で変わるのは、関連する地理ルールのデータの取得元です。すべてのドメインルールが更新されるわけではありません。反映状況は、設定で使うデータ形式、ファイルの場所、ルールの種類によって異なります。
移行前に利用可能な設定を保存し、プロキシポート、選択中のプロキシグループ、通信の取り込み方法を記録してください。アプリのアップデート後、まず従来のモードで接続を確認し、その後カスタムDNS、ルールの上書き、TUN設定を1つずつ戻します。Clashのノード遅延テストが示すのは、指定したテスト先と方法での応答時間です。動画の再生、ダウンロード速度、すべてのサイトの利用可否を単独で判断する指標にはなりません。
まずアプリをインストールしてサブスクリプションを読み込み、設定が正常に読み込まれることを確認します。次に、プロキシグループに利用可能な出口があるかを確認し、ルールモードに切り替えます。その後、システムプロキシの設定またはモバイル端末のVPN許可を確認し、対象を明確にしたテスト先へ接続して、接続ログのルールとポリシーを確認してください。接続中と表示されているのにアクセスできない場合は、すべての設定を同時に変えず、名前解決、ルール、出口、ローカルでの通信取り込みを切り分けましょう。
システムプロキシとTUNを同時に有効にする必要はありません。ブラウザーやプロキシ設定に従うアプリだけに使う場合は、まずシステムプロキシで確認しましょう。アプリが独自に接続し、システム設定を参照しない場合は、仮想ネットワークインターフェースの利用を検討してください。クライアントを終了した後にブラウザーの接続がおかしい場合は、システムにローカルプロキシのアドレスが残っていないか確認しましょう。操作手順はClashの使い方ガイド、複雑なプロトコルやコアの互換性についてはプロトコルリファレンスをご覧ください。
技術ノート / 最近の更新
具体的な利用環境に合わせて、設定手順、必要な権限、確認の順序をまとめています。まずガイドに沿って基本接続を設定し、実際の問題に応じて関連するノートを確認してください。ルーターへの導入や仮想ネットワークインターフェースによる通信の取り込みでは、OSのネットワーク設定を変更します。変更前の状態を記録しておくと、1項目ずつ検証して元に戻せます。
仮想ネットワークインターフェースとシステムルーティングテーブルを起点に、TUNモードとシステムプロキシの違い、stackの設定項目、Windows・macOS・AndroidでTUNを有効にする手順と必要な権限を解説します。
ノートを読む →ルーターやバイパスルーターでmihomoコアを直接動かす方法を紹介します。メインルーターとバイパスルーターのネットワーク構成を比較し、アーキテクチャの選び方、メモリ要件、ゲートウェイ設定のポイントを解説します。
ノートを読む →サブスクリプションの更新エラーにつながる主な原因を解説します。URLの失効、形式の非互換、更新リクエストのプロキシ経路に加え、各クライアントで自動更新間隔や更新時のプロキシ使用を設定する場所を紹介します。
ノートを読む →