CLASH 設定ガイド · 全プラットフォーム対応
サブスクリプションの追加からルール分岐まで、順を追ってクライアントを設定し、接続を確認できます。
CONFIG.YAML / 設定のポイント
まず設定で解決したい問題を確認し、必要な項目だけ有効にしましょう。以下は各フィールドを説明するための例で、そのまま接続に使える完全な設定ではありません。ノード、プロキシグループ、リゾルバーは、利用するサブスクリプションやネットワーク環境に合わせて追加してください。
mixed-port: 7890allow-lan: falsemode: rulelog-level: infoルールモードでは、設定した条件に応じて直接接続するかプロキシ経由にするかを決めます。ローカルのサービスと外部サービスを併用する場合に便利です。クライアントのモードメニューで「ルール」を選び、使用中のサブスクリプションにルールとプロキシグループが含まれていることを確認してください。グローバルモードは、クライアントが取り込んだ通信をすべてグローバルポリシーに振り分けます。一時的な切り分けには使えますが、システムプロキシやTUNの代わりにはなりません。特定のサイトで想定外の経路が使われる場合は、まず接続ログで適用されたルールを確認してから修正しましょう。モードを何度も切り替えても根本原因は解決しません。クライアントによってボタンの名称は異なる場合がありますが、コアの分岐処理は同じです。
tun: enable: true stack: mixed auto-route: true auto-detect-interface: trueTUNは仮想インターフェースとルーティングを使って通信を取り込みます。ゲームやコマンドラインツールなど、システムプロキシを参照しないアプリに適しています。デスクトップではサービスのインストールや管理者権限が必要な場合があり、スマートフォンではシステムのVPN接続要求を許可する必要があります。まずシステムプロキシでサブスクリプションが使えることを確認し、その後TUNを個別にテストすると、権限の問題をノードの障害と取り違えずに済みます。TUNは通信速度を上げる機能ではなく、すべての通信を取り込めるとは限りません。他のVPN、仮想マシンのネットワークアダプター、独自のルーティング設定が影響する場合もあります。有効化後にLAN内の機器へ接続できない場合は、ルーティングの除外設定を確認し、すべてのルールを削除するのは避けてください。
dns: enable: true enhanced-mode: fake-ip fake-ip-range: 198.18.0.1/16fake-ipはドメインに仮想IPアドレスを割り当て、接続時にコアがドメイン情報を保持してルールを適用できるようにします。実際のDNS処理方法と組み合わせる必要があり、この設定を1行変えただけでDNSリクエストがすべてクライアントに届くわけではありません。まずクライアントのDNS機能が有効か確認し、次にTUNのDNS hijack、ブラウザーのセキュアDNS、システムのプライベートDNSを確認しましょう。一部のLANサービスや実IPアドレスを必要とするアプリでは、フィルターリストへの追加が必要な場合があります。仮想IPが表示されても、名前解決の失敗とは限りません。互換性に問題がある場合は、該当ドメインだけ例外に設定し、変更後にキャッシュを消去して再テストしてください。
proxy-providers: service: type: http url: "https://example.com/proxies.yaml" path: ./providers/service.yaml interval: 86400プロキシプロバイダーを設定すると、ノード一覧を定期的に取得できます。ノードが更新されるたびにローカルルールを書き直す必要はありません。例のURLは設定の構造を示すもので、実際にはサービス提供元が対応しているプロキシプロバイダーのURLを指定し、プロキシグループからuseで参照してください。更新間隔の単位は秒です。必要以上に短く設定する必要はありません。クライアントの「サブスクリプション更新」とコアのプロキシプロバイダー更新は別の処理です。また、完全な設定用サブスクリプションをプロバイダーとしてそのまま使えるとは限りません。取得に失敗したら、レスポンス内容、URLの有効期限、保存先へのアクセス権を確認してから、ネットワーク接続方法を見直しましょう。クライアントを何度も再インストールする必要はありません。
rules: - DOMAIN-SUFFIX,example.com,DIRECT - GEOIP,CN,DIRECT - MATCH,DIRECTルールは上から順に照合します。具体的なドメイン条件を広い条件より先に置き、最後にフォールバックルールを追加してください。例では構文を示すためにDIRECTを指定しています。プロキシを使う場合は、設定に存在するプロキシグループ名に置き換え、名前と大文字・小文字を一致させてください。サブスクリプションの更新で直接記述したルールが上書きされることがあります。継続的に変更する場合は、クライアントのオーバーライドや設定のマージ機能を使うのがおすすめです。問題を調べるときは、接続ログでドメイン、適用ルール、最終的な出口を確認しましょう。Webページが開くかどうかだけでは、ルールが正しく適用されたか判断できません。ルールセットの取得失敗とノードの接続不能も、分けて確認してください。
CLIENTS / デバイス別に選ぶ
まずOSを選び、CPUアーキテクチャとクライアントの要件を確認してください。デスクトップとスマートフォンで同じサービスのサブスクリプションを使える場合でも、画面操作、対応フィールド、システム通信の取り込み方法は異なることがあります。設定一式をそのまま別の端末へコピーするのは避けましょう。
まずはClash Plusを試し、Clash Verge RevやFlClashなどと比較するのもよいでしょう。OSの「バージョン情報」でデバイスのアーキテクチャを確認し、ダウンロードページの説明に従ってインストーラーを選んでください。旧版のClash for Windowsは開発が終了しています。アーカイブ版に頼り続けるより、設定を引き継いで別のクライアントへ移行するのがおすすめです。
ブラウザーなど一般的なアプリには、システムプロキシが適しています。TUNを有効にする前に、必要なサービスコンポーネントがインストールされているか確認してください。他の通信制御ツールも動作している場合は、まずどちらか一方を停止し、ルーティングと接続ログを確認しましょう。
ダウンロードへ Windowsクライアントダウンロード前に「このMacについて」でApple SiliconとIntelを確認してください。Clash Plus、Clash Verge Rev、FlClashはそれぞれ操作方法が異なります。以前の設定を引き継ぐ場合は、メニューバーの見た目だけでなく、オーバーライドルール、プロキシポート、ログイン時の起動設定も確認しましょう。
初回起動時は、システムの案内に従ってアプリのアクセス権を設定してください。システムプロキシの設定とネットワーク拡張の許可は別の手順です。インストールが完了しても、通信が取り込まれているとは限りません。操作手順は、詳しいドキュメントのプラットフォーム別の章をご覧ください。
ダウンロードへ macOSクライアントClash Plus、Clash Meta for Android、FlClashなどから、使い方に合うものを選べます。インストーラーのアーキテクチャは端末に合わせてください。新しい端末ではARM64が一般的ですが、端末のシステム情報で確認するのが確実です。設定を追加したら、使用する設定が選択されていることを確認し、システムのVPN接続要求を許可してください。
バックグラウンドに移動すると接続が切れる場合は、バッテリー管理やバックグラウンド実行の制限を確認してください。接続を維持するためだけに常時動作機能をすべて有効にする必要はありません。頻繁な速度測定や短すぎる更新間隔も、バッテリー消費を増やします。
ダウンロードへ AndroidクライアントClash PlusはApp Storeからインストールできます。公式サイトは clashplus.io です。アプリ内でサブスクリプションを追加して設定を選択し、VPN構成の追加を許可してください。デスクトップ向け設定にあるシステムサービス関連の項目を、スマートフォンにそのまま適用しないでください。
接続はシステムのネットワーク拡張によって管理され、バックグラウンドでの動作はデスクトップとは異なります。接続に問題がある場合は、まず設定が有効か確認し、アプリのログを確認してください。オンデマンド接続を使うかどうかは、普段のネットワーク切り替え方法に合わせて判断しましょう。
ダウンロードへ iOSクライアントデスクトップではClash Verge RevとFlClashを比較し、各ディストリビューションに合ったパッケージを選びましょう。サーバーやルーターではmihomoコアの説明を参考に、サービスの起動設定、ファイルの保存先、実行権限を個別に設定する方法が適しています。GUIをインストールする必要はありません。
デスクトップ環境のシステムプロキシが、ターミナルのプログラムに適用されるとは限りません。アプリが環境変数、明示的なプロキシ引数、TUNのどれを使うか確認し、リクエストがコアに届いているか調べましょう。リモート操作中は、現在の管理用接続を維持してください。
ダウンロードへ Linuxクライアントすべてのクライアントを見る → システム要件、アーキテクチャ別の選択肢、アーカイブ版の案内はダウンロードページにまとめています。
QUICK START / 3ステップで確認
クライアントは設定やネットワークリクエストを処理するためのツールであり、接続先のノードを提供するものではありません。開始前に、サービス提供元から有効なサブスクリプションURLを入手し、端末の日時が正しく、現在のネットワークからURLにアクセスできることを確認してください。サブスクリプションURLには認証情報が含まれる場合があります。公開フォーラムへの貼り付けや、画面のスクリーンショット共有は避けましょう。
クライアントで「設定」「サブスクリプション」または「Profiles」を開き、URLから追加する項目を選択します。URL全体を貼り付けて更新してください。追加後はその設定を選択し、プロキシグループが表示されることも確認しましょう。サブスクリプション名だけが表示され、ノードが出てこない場合は、まず更新ログを確認してください。URLの期限切れ、レスポンス形式の不一致、ネットワークリクエストの失敗を切り分け、すぐにグローバルモードへ切り替えて何度も試すのは避けましょう。
サービス提供元が複数の形式を用意している場合は、使用中のコアに対応するClashまたはmihomo設定を選びます。手動で編集する前に元のファイルをバックアップしてください。特にYAMLのインデントとコロンの後のスペースに注意しましょう。ノードのパスワードなどの機密情報を他人に送って、問題を調べてもらうのは避けてください。サブスクリプションの追加手順を見る →
初めて使う場合はルールモードを選び、プロキシグループで接続可能なノードを選択してからシステムプロキシを有効にしてください。スマートフォンでは、システムの案内に従ってVPN接続を許可します。システムプロキシを使わないアプリがある場合に限り、TUNをテストし、必要なアクセス権が付与されていることを確認しましょう。既存のVPN、アクセラレーター、他のプロキシツールがルーティングを競合させることがあります。原因を調べる間は通信の取り込み方法を1つに絞り、条件を減らしてください。
グローバルモードは、クライアントに取り込まれた通信の出口をどう選ぶかを示すもので、端末上のすべてのリクエストが自動的にプロキシを通るという意味ではありません。ルールモードで直接接続されても、クライアントが動作していないとは限りません。アクセス先と適用されたルールを併せて確認してください。モードの選び方を見る →
確認したいWebサイトを開き、クライアントの接続ログも確認します。新しいリクエストが記録され、想定したルールとポリシーが適用されていることを確認してください。その後、ローカルサイト、LAN内の機器、普段使うアプリも試し、ルール分岐が通常のアクセスに影響していないか確かめましょう。遅延測定はその時点での結果にすぎません。実際のダウンロード速度を示すものでも、すべてのサイトにアクセスできる保証でもありません。
ブラウザーだけ使えてターミナルから接続できない場合は、まずターミナルのプロキシ設定を確認してください。どのアプリからも接続できない場合は、サブスクリプション、ノード、通信の取り込み設定を順番に見直します。安定して使えることを確認してから、OS起動時の自動起動や自動更新を有効にし、変更した項目を記録しておくと次回のトラブル対処に役立ちます。
設定ガイドの全文を見る → 初めての方は基本手順から。プラットフォームごとの権限や詳細設定は詳しいドキュメントをご覧ください。
OPEN SOURCE / プロジェクトとメンテナンス
クライアントを選ぶときは、GUI、プロキシコア、サブスクリプションサービスを分けて考えましょう。それぞれ操作画面、通信処理、ノードの提供を担います。いずれかで問題が起きても、単純に「Clashが使えない」と結論づけるのは適切ではありません。
Clashはルール分岐とYAML設定で広く使われるようになり、その後デスクトップやモバイル向けのクライアントが複数登場しました。オリジナルのプロジェクトや一部の旧クライアントの開発が終了した後も、エコシステムが一つの選択肢だけになったわけではありません。Clash.Metaが関連機能の開発を引き継ぎ、後にmihomoという名称になりました。古いガイドでは、これらの名称が併記されている場合があります。
名称が似ていても、設定がすべて共通とは限りません。新しいプロトコル、ルール構文、DNSパラメーターは、特定のコアだけが対応している場合があります。移行時はフィールドの対応状況を確認し、ファイルの拡張子をYAMLに変えるだけで済ませないでください。元の設定を読み込めても、すべての項目が認識されるとは限りません。
mihomoは設定の解析、接続の確立、ルールの実行を担当します。GUIクライアントはサブスクリプションの管理、ノードの選択、システムプロキシの切り替え、ログの表示を行います。クライアント独自のオーバーライド、マージ機能、設定テンプレートが加わることもあるため、画面上の項目と最終的にコアへ渡される設定ファイルが必ずしも一対一に対応するとは限りません。
問題を調べるときは、実際に動作している設定とログを優先して確認しましょう。画面では無効に見える項目がサブスクリプション側で有効になっていたり、ローカルの変更が更新で上書きされたりすると、「変更したのに反映されない」ことがあります。別のクライアントへ移行する際は、サブスクリプションURLとカスタムルールを個別に保存してください。
mihomoはGPL-3.0ライセンスを採用しています。ソースコード、コミット履歴、課題の議論はプロジェクトのリポジトリで確認できます。オープンソースであることは、実装やライセンス条件を確認できるという意味であり、サードパーティーサービスのノード品質を保証するものではありません。実際のネットワーク環境でのテストに代わるものでもありません。当サイトは設定情報とダウンロード先をまとめており、コアプロジェクトやすべてのクライアントの公式運営元ではありません。
ソフトウェアの不具合が疑われる場合は、できるだけ小さな設定で再現し、OS、クライアント、コアの情報とエラー内容を記録してください。問題を報告する前に、サブスクリプションURL、ノードの認証情報、個人のネットワーク情報を削除しましょう。設定ファイル全体をそのまま公開するより、安全に共同で調査できます。
クライアント、コア、サブスクリプション、ルールデータの更新は、それぞれ異なる問題を解決します。画面を更新してもコアが同時に更新されるとは限らず、サブスクリプションを更新してもシステム権限の問題は直りません。アップグレード前に動作中の設定を保存し、プロジェクトの変更履歴を確認してください。互換性に影響する変更がある場合は、設定を確認してから普段使う環境を切り替えましょう。
GeoIPやルールセットの取得に失敗した場合は、リソースのパス、アクセス条件、ログに記録されたエラーの詳細を確認してください。特定のノードだけが遅い場合は、別のノードに切り替えて比較しましょう。更新、再インストール、DNS変更を同時に行うより、問題を一つずつ切り分けた方が手がかりを残せます。関連用語は用語集で確認できます。
リポジトリ：MetaCubeX/mihomo。以下のコマンドはソースコードをダウンロードするもので、GUIクライアントはインストールされません。日常的に利用する場合は、ダウンロードページからクライアントを選んでください。
git clone https://github.com/MetaCubeX/mihomo.gitFIELD NOTES / 設定メモ
基本的な接続ができたら、実際に困っている内容に合わせて各ガイドを確認しましょう。クライアントを移行するときは既存の設定を残し、DNSを変更するときはリクエストの経路を確認し、コアを比較するときは必要な機能を先に整理します。一度に一つだけ条件を変えれば、どの操作が変化につながったか把握できます。
検査ページを使ってDNSリークを確認し、fake-ip、nameserver-policy、TUNのDNS hijackを順に設定して、DNSリクエストの漏えいを防ぎます。
旧クライアントの開発終了後に移行する方法を解説。サブスクリプションとカスタムルールを保存し、プラットフォームに合った更新中の代替クライアントを選んでスムーズに切り替えます。
3つのコアの変遷を整理し、プロトコル対応、ルール構文、DNS機能の違いを比較。古い設定をmihomoへ移行する際に変更が必要なフィールドも解説します。
サブスクリプションの取得に失敗したら、まずClashのサブスクリプション更新エラーをご確認ください。測定結果のばらつきが大きい場合は、Clashのノード遅延についての解説を参考にできます。インストールやプラットフォーム別の設定に関するよくある質問は、詳しいドキュメントのFAQにまとめています。すべての設定を最初から読む必要はありません。