proxy-groups:
- name: AUTO
type: url-test
use: [subscription]
url: https://www.gstatic.com/generate_204
interval: 300
Clash
設定ガイド
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
ルール分岐では、宛先ごとに使用するプロキシを指定し、すべてのリクエストが同じ経路を通るのを防ぎます。クライアントでルールモードを選び、設定ファイルのrulesセクションに条件を記述します。ルールは上から順に評価され、最初に一致した項目で接続先が決まります。MATCHは最後にフォールバックとして配置してください。例のPROXYは、定義済みのプロキシグループに対応させる必要があります。グローバルモードと異なり、ルールモードではローカルサービスへの直接接続を維持できます。また、アプリ単位の振り分けより、複数のサービスにアクセスするアプリをドメイン単位で制御するのに適しています。
proxy-groups:
- name: PROXY
type: select
proxies:
- AUTO
- DIRECT
- name: AUTO
type: url-test
use:
- subscription
url: https://www.gstatic.com/generate_204
interval: 300
プロキシグループを使うと、ルールと実際の接続先を分けて管理できます。まずproxy-groupsでグループを定義し、クライアントのプロキシ画面で接続先を選択します。selectは手動選択向け、url-testは指定したURLへの接続テスト結果に基づく自動選択向けです。例のsubscriptionは、プロキシプロバイダーで事前に定義してください。ルールごとにノードを指定する方法と比べ、プロキシグループならサブスクリプションを切り替えてもルール構成を維持できます。接続テストの結果は指定先への到達性を示すもので、すべてのサイトのダウンロード速度を保証するものではありません。アクセスに問題がある場合は、実際の接続ログも確認してください。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query
fake-ip-filter:
- "*.lan"
- "localhost"
DNS設定は、ドメイン名の解決とルール判定に影響します。該当フィールドに対応したコアを使い、DNS設定で名前解決を有効にしてからfake-ipの拡張モードを選択します。fake-ipではアプリに仮想IPアドレスを返し、コアが元のドメイン名と関連付けて接続を処理します。一方、redir-hostは実際の名前解決結果を返します。主な違いはドメイン名の対応付け方であり、単純な速度の優劣ではありません。LAN内の機器や特定のアプリで問題が起きる場合は、該当ドメインをfake-ip-filterに追加してください。この設定だけでシステムのDNS問い合わせがすべてコアを通るわけではないため、OS側の名前解決経路も確認が必要です。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
TUNモードは仮想ネットワークアダプターを通じて通信を取り込み、システムプロキシ設定に従わないアプリにも適しています。対応クライアントでサービスをインストールまたは起動してから、TUNを有効にしてください。設定例のフィールドは互換性のあるmihomoコア向けです。ほかのコアでは、それぞれのドキュメントを確認してください。システムプロキシと異なり、TUNはルーティングやDNSの経路にも影響するため、権限不足、別のVPN、ネットワークアダプターの切り替えなどで接続に失敗することがあります。まずシステムプロキシでサブスクリプションが使えることを確認してから、仮想ネットワークアダプターを有効にしてください。LANへのアクセスに問題がある場合は、ルートの除外設定を確認し、すべてのルール分岐を削除するのは避けてください。
proxy-providers:
subscription:
type: file
path: ./providers/subscription.yaml
proxy-groups:
- name: PROXY
type: select
use:
- subscription
サブスクリプションを使うと、リモートまたはローカルのプロキシ情報をクライアントで管理できます。多くのGUIクライアントには、URLから設定一式を読み込む機能があります。一方、設定例で示すのはローカルのプロキシプロバイダーです。ファイルはプロバイダー用の形式に合わせる必要があり、任意の完全な設定ファイルで代用することはできません。サブスクリプション全体を置き換える方法と比べ、プロバイダーを使えばノードの提供元と独自ルールを分離できますが、プロキシグループとの参照関係は自分で管理する必要があります。更新前に現在使える設定を保存し、クライアントが上書き設定を維持するか確認してください。サブスクリプションURLには認証情報が含まれることが多いため、スクリーンショットやログを共有する前に完全なURLを削除してください。
ここに示した設定例はフィールド間の関係を説明するもので、そのまま起動できる完全な設定ではありません。プロキシ接続先、プロキシグループ、プロバイダー、ルールの参照先を一致させる必要があります。また、クライアントによっては一部のフィールドをGUIで生成したり、上書きしたりすることがあります。初回設定では一度に一項目だけ変更し、再読み込み後にログを確認してから次へ進んでください。構文エラー、参照先の不足、ネットワークへの到達不可を切り分けやすくなり、設定を一度に変更しすぎて元に戻せなくなる事態も防げます。
rule-providers:
local:
type: file
behavior: classical
path: ./rules/local.yaml
rules:
- RULE-SET,local,DIRECT
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090
secret: "your-local-secret"
allow-lan: false
CLIENT / PLATFORM
Clashクライアントのダウンロード
OS、CPUアーキテクチャ、必要なコアを確認してからインストーラーを選びましょう。クライアントのダウンロードとサブスクリプションサービスは別のものです。アプリをインストールしただけではプロキシ接続先は設定されません。設定を読み込んだ後も、有効期限やプロキシの選択、現在のネットワークを確認する必要があります。ダウンロードページでは、プラットフォーム別にクライアント、インストール方法、メンテナンス状況を掲載しています。設定記事からインストーラーを探す必要はありません。
Windows
デスクトップブラウザーや開発ツール、システムプロキシを使うアプリに適しています。ダウンロード前にシステム情報でCPUアーキテクチャを確認してください。インストール後はサブスクリプションを読み込み、システムプロキシを有効にして、ブラウザーで接続を確認します。Clash PlusやClash Verge Revなどは、サービスのインストール方法がクライアントごとに異なる場合があります。TUNを有効にする前に、必要な権限を設定してください。インストールの成功とプロキシ接続の成功は別々に確認しましょう。
ほかのプロキシツールがすでに動作している場合は、ポートやルートが競合しないよう、先にプロキシ制御を停止してください。クライアントを終了してもネットワークに接続できない場合は、システムプロキシに古いアドレスが残っていないか確認しましょう。すぐにアプリを再インストールする必要はありません。
ダウンロードページへmacOS
Apple SiliconまたはIntelに合ったインストーラーを選択してください。初回起動時は、OSの案内に従ってアプリを許可します。システムプロキシに従わないアプリの通信も取り込みたい場合は、クライアントのサービスモードと仮想ネットワークアダプターへの対応を確認してください。インストールの成功とプロキシ接続の成功は、別々に確認する必要があります。
旧クライアントから移行する場合は、先にサブスクリプションURL、独自ルール、プロキシグループの選択内容を保存してから、新しいクライアントに設定を読み込んでください。アプリのデータフォルダー全体をそのまま置き換えるのは避けましょう。プロジェクトによって設定ファイルやサービスの登録方法が異なり、互換性がない場合があります。
ダウンロードページへAndroid
ダウンロード時はCPUアーキテクチャを確認してください。不明な場合は、まずデバイス情報とクライアントのインストールガイドを確認しましょう。Clash Plus、Clash Meta for Android、FlClashでは設定画面が異なるため、読み込み前にサブスクリプションの形式を確認してください。接続を開始するときは、OSによるVPNの作成を許可します。アプリごとの通信制御は、クライアントの該当設定で調整してください。
画面ロック後に接続が切れる場合は、バッテリー最適化、バックグラウンド動作の制限、ほかのVPNアプリを優先して確認してください。バックグラウンド動作を許可してから問題を再現し、ログを見てOSがプロセスを終了しているか判断しましょう。接続切れをすべてサブスクリプションの失効と決めつける必要はありません。
ダウンロードページへiOS
ダウンロードページではClash PlusのApp Storeページと公式サイトclashplus.ioを案内しています。インストール後、アプリ内の設定画面からサブスクリプションを読み込み、OSの案内に従ってVPN構成の追加を許可してから、使用するプロキシを選択してください。ステータスバーにVPNと表示されても、トンネルが確立したことを示すだけです。接続先が使えるかどうかは、実際にサービスへアクセスして確認してください。
Wi-Fiとモバイルデータ通信の切り替え後に問題が起きた場合は、まず再接続し、サブスクリプションで選択しているプロキシを確認してください。特定のアプリだけ接続できない場合は、ルールの適用結果を調べましょう。システムのネットワーク設定をすべて削除する操作を繰り返すのは避けてください。
ダウンロードページへLinux
デスクトップ環境では、Clash Verge RevまたはFlClashから始められます。ディストリビューションのパッケージ管理方式に合った形式を選んでください。GUIで設定するシステムプロキシが、ターミナルのコマンドに適用されるとは限りません。コマンドラインツールでは、プロキシ環境変数を別途設定するか、適切に設定したTUNルーティングで通信を取り込む必要があります。
サーバーやルーターで使う場合は、ダウンロードページのMihomoコア欄を確認し、設定ファイルのパス、サービスの起動、ログを自分で管理してください。手動で導入する前に、実行ユーザーと待ち受け範囲を明確にしましょう。コントロールAPIはローカルホストだけにバインドし、インターネットに直接公開しないでください。
ダウンロードページへSOURCE / CONFIGURATION
オープンソースコアとクライアントの関係
Clashは、設定ファイル、プロキシポリシー、通信ルールを中心に形成されたエコシステムです。画面の名前が似ていても、内部のコアまで同じとは限りません。クライアントを選ぶときは、プロジェクトのメンテナンス状況、実際に使われるコア、対応する設定フィールドをあわせて確認しましょう。設定が使えるかどうかを判断するには、画面のスクリーンショットよりも、こうした情報が参考になります。
プロジェクトの歴史とコミュニティフォーク
オリジナル版Clashや一部の初期GUIクライアントは、すでにメンテナンスを終了しています。現在のクライアントの多くは、後継のコミュニティ製コアを採用しています。Clash Metaは関連フォークで使われていた名称で、mihomoは現在広く使われるコアプロジェクト名の一つです。オンラインのガイドではこれらの名称が混在することがあるため、対象プロジェクトのドキュメントを確認してください。拡張子がどちらもYAMLだからといって、すべてのフィールドが使えるとは限りません。
オープンソースプロジェクトの利点は、コードやドキュメント、問題の議論を公開情報として確認できることです。再現可能な不具合が起きたら、まずプロジェクトのドキュメントと関連する報告を確認し、機密情報を除いたログを添えてください。既知の互換性問題か、ローカル設定の誤りかを切り分けやすくなります。コミュニティのリポジトリはサブスクリプションサービスではなく、第三者のプロキシ接続先の利用可能性を保証するものでもありません。
GUIとプロキシコア
クライアントのGUIは通常、設定の読み込み、プロキシの選択、システムプロキシの切り替え、プロセス管理を担当します。コアはプロトコル接続、ルール判定、DNS、通信処理を担います。同じ設定でもクライアントによって動作が異なる場合、コアの対応状況が違うか、GUIが既定のフィールドを自動でマージしている可能性があります。問題を調べるときは、サブスクリプションの原文だけでなく、最終的に適用される設定を確認してください。
同じプロトコル名でも、拡張パラメーターまで共通とは限りません。サブスクリプションの提供元が、使用するコアに対応した形式を提供している必要があります。読み込み時に未知のフィールド、プロキシグループの不足、プロバイダーの読み込み失敗が表示された場合は、まず設定間の参照関係を修正してください。DNSを何度も切り替えても、構文や参照先の問題は解決しません。接続テストに進む前に、コアが設定を正しく読み込める状態にしましょう。
更新と設定の引き継ぎ
クライアントの更新、コアの更新、サブスクリプションの更新は、それぞれ別の作業です。クライアントの更新では画面やサービス管理が変わることがあり、コアの更新では対応フィールドや通信動作が変わる場合があります。サブスクリプションの更新では、提供元の設定内容が置き換わります。更新前に現在の動作状況を記録し、ローカル設定と独自の上書き設定を保存してください。更新後はまず設定が読み込めることを確認し、システムプロキシ、ルール判定、TUNを個別に検証しましょう。テストのためにすべての機能を同時に有効にするのは避けてください。
ダウンロードセンターでは、プラットフォーム別のダウンロード先と日本語の操作手順をまとめていますが、各プロジェクトのリリース情報に代わるものではありません。ガイドと画面の名称が異なる場合は、まずクライアントとコアの種類を確認してから、該当するドキュメントを参照してください。メンテナンスが終了したアプリは移行時の参考にとどめ、新しいOS環境では、必要なフィールドに対応し現在もメンテナンスされているクライアントを優先して検討しましょう。ノードのタイムアウト、サブスクリプションの読み込み失敗、システムプロキシの設定残りを確認する手順は、トラブル対処ガイドをご覧ください。
NOTES / CONFIGURATION
Clash設定ガイド
以下の3記事は日付の新しい順に並んでおり、コア選び、カスタムルール、DNSの拡張モードをそれぞれ解説します。まず設定を適用するコアを確認してから、ルールの順序や名前解決の方法を変更すると、互換性の問題をネットワーク障害と誤認しにくくなります。記事内の設定例は既存のプロキシグループと組み合わせて使い、サブスクリプション全体を置き換えないでください。
Clashオリジナル版・Meta・mihomoの違い|プロトコル対応と設定の互換性
オリジナルコアの開発終了後のフォークの変遷を整理し、Metaとmihomoのプロトコル対応、ルール拡張、設定フィールドの違いを比較。クライアント選びの判断材料も解説します。
コアの比較記事を読む →Clashのカスタムルール設定|ルールの種類と評価順、MATCHによるフォールバック
DOMAIN、DOMAIN-SUFFIX、IP-CIDR、GEOIP、PROCESS-NAMEなどのルールタイプを整理し、上から順に評価される仕組み、no-resolveパラメーター、rule-providersの組み合わせ方を解説します。
ルールの解説を読む →Fake-IPとredir-hostの選び方|拡張モードの仕組みと使いどころ
Fake-IPが仮想アドレスを割り当てる仕組みを解説し、redir-hostとの名前解決速度や互換性の違い、fake-ip-filterの一般的な使い方を紹介します。
名前解決の解説を読む →