OS · 01
Windows
サブスクリプション、プロキシグループ、システムプロキシをGUIで管理したいデスクトップユーザー向けです。ダウンロード前にシステムアーキテクチャを確認し、現在も保守されているClash Plus、Clash Verge Rev、FlClash、Clash Nyanpasuを優先してください。Clash for Windowsは過去のプロジェクトとしてのみ案内します。
ダウンロードへ
オープンソースクライアント · 設定ドキュメントを継続整理
Clash公式ダウンロード・ドキュメント クライアントのダウンロードとルール設定
OSに合ったメンテナンス状況の明確なクライアントを選び、サブスクリプション導入、ルール照合、ネットワーク通信の引き受けという3つの流れに沿って設定します。mihomoコア、DNS、TUN、よくある接続トラブルの確認先もまとめています。
- 完全無料
- オープンソース
- 5プラットフォーム対応
- 日本語設定ドキュメント
FIG.01
オレンジの経路は、リクエストがルール照合、ポリシー選択、出口接続へ進む順序を示します。プラットフォームの雫は利用可能な入口を示すだけで、特定のバージョンを表すものではありません。
Platform entry · Plate 02
OSからダウンロード一覧へ
同じClash設定を異なるGUIクライアントやmihomoコアで読み込めますが、インストール方法、システム権限、メンテナンス状況はそれぞれ異なります。まず端末のOSを確認し、ダウンロードページでクライアントを比較すれば、アーキテクチャの不一致、更新停止プロジェクト、設定ディレクトリの混在を避けられます。
OS · 02
macOS
Apple SiliconとIntel Macに対応します。インストーラーはプロセッサのアーキテクチャに合わせ、初回起動時にシステムのネットワーク権限とプロキシ権限を確認してください。GUIクライアントは日常的なプロキシグループの切り替えに使えます。細かく制御する場合は、設定ディレクトリ、拡張モード、システム拡張の状態も確認します。
ダウンロードへOS · 03
Android
スマートフォン、タブレット、一部のAndroid TV端末向けです。クライアントは通常、システムVPNインターフェースで通信を引き受けるため、同時に別のVPNアプリで同じインターフェースを使用することはできません。サブスクリプション導入後は、まずプロキシグループを選び、バッテリー最適化とバックグラウンド実行制限を確認してください。
ダウンロードへOS · 04
iOS
iPhoneとiPadでは、システムネットワーク拡張機能を使ってプロキシ接続を確立します。ダウンロードページではClash PlusのApp Store入口と公式情報を案内しています。インストール後、サブスクリプションURLまたは設定ファイルから内容を導入し、システムに表示される権限ダイアログでネットワーク設定の追加を承認します。
ダウンロードへOS · 05
Linux
デスクトップ環境ではGUI付きクライアントを利用でき、サーバー、ルーター、GUIのないシステムではmihomoを直接実行する方法が適しています。導入時はバイナリのアーキテクチャ、設定ディレクトリ、サービスアカウントを分けて考え、プロセスのライフサイクルをsystemd、コンテナ、現在のターミナルのどれが管理するかを明確にします。
ダウンロードへRule chain atlas · Plate 03
リクエストの受信から出口接続まで
Clashの要点は、プロキシを単にオン・オフすることではありません。ドメイン解決、ルール判定、ポリシー選択、システム通信の引き受けを確認可能な一連の処理にすることです。各段階の入力と出力を理解すれば、設定変更やトラブルの切り分けを試行錯誤に頼らず進められます。
Reading order
通常のプロキシリクエストは、まずローカルの待受ポートに入り、設定に従ってDNSとルールで処理されます。TUNモードでは仮想ネットワークインターフェースから、より多くのシステム通信を受け取ります。ルールは設定ファイルの上から下へ順番に照合され、最初に一致した項目が対象のプロキシグループを決めます。その後、プロキシグループが手動選択、自動テスト、フェイルオーバーの結果に基づいて具体的な出口を決定します。ウェブページを開けない場合は、通信の引き受け、名前解決、照合、選択、接続の順に確認し、すべての項目を同時に変更しないようにします。
Specimen 01 · Matching
ルールの順序が通信の行き先を決める
ルールは設定ファイルの先頭から下へ確認され、一致すると直ちに停止します。よく使われる種類には、ドメイン完全一致、ドメインサフィックス、プロセス、IPネットワーク、地理データ、フォールバックルールがあります。カスタムルールは、通信を先に取り込む可能性がある広範なルールより前に置く必要があります。そうしないと、構文が正しくても適用されません。全体スイッチだけを提供するプロキシツールと異なり、Clashではサイト、プログラム、アドレス範囲ごとに独立したポリシーを割り当てながら、照合履歴も追跡できます。
変更前に対象ドメインを記録し、接続画面やログ画面で実際に一致したルールを確認します。期待どおりにならない場合は、ルールの位置、ルールセットの更新状況、ドメインがIPに解決済みか、対象プロキシグループ名が存在するかを順に確認してください。最初からノードを交換するのは避けましょう。ノードの接続性とルールの一致は別の段階です。
DOMAIN-SUFFIX,example.com,PROXYドメインサフィックス → プロキシポリシーGEOIP,CN,DIRECT地域判定 → 直接接続MATCH,FALLBACK未一致のリクエスト → フォールバックポリシーSpecimen 02 · Selection
プロキシグループでルールとノードを分離する
ルールは通常、特定のノードを直接指定せず、select、url-test、fallback、load-balanceなどのプロキシグループを指定します。これにより、サブスクリプションを更新したりノードを入れ替えたりしても、ルール全体を書き直す必要がありません。手動選択グループは出口を明確に制御したい場合に適しています。自動テストグループは測定結果から利用可能な項目を選び、フェイルオーバーグループは順番に確認して、現在の出口が使えないときに次の項目へ切り替えます。
ポリシーの問題を診断するときは、ルールが指定するグループ名と、グループ内で現在選択されている項目を同時に確認します。一部のサイトは開くのに別のサイトがタイムアウトする場合、システムプロキシ全体の停止ではなく、異なるルールが別々のポリシーに振り分けられている可能性があります。プロキシグループ名は大文字・小文字やスペースも区別されるため、参照名は定義と完全に一致させてください。
RULE
→
SELECT
→
OUTBOUND
Specimen 03 · Resolution
DNS設定はドメイン判定と接続先に影響する
DNSはドメインをアドレスに変換するだけではありません。ドメインルールが確認できるか、アドレスルールをどう判定するか、リクエストが最終的にどこへ接続するかにも影響します。mihomoでは、待受アドレス、上流リゾルバー、フォールバックリゾルバー、分流ポリシー、Fake-IPモードを設定できます。Fake-IPを有効にすると、クライアントはまず予約アドレスを返し、内部でドメインとの対応を保持するため、TUN通信でもドメインルールによる処理を維持できます。
IPアドレスではアクセスできるのにドメインで失敗する場合は、まずDNSログ、上流リゾルバーへの到達性、システムが古いリゾルバーを使い続けていないかを確認します。nameserver、fallback、nameserver-policyを変更するときは項目ごとにテストし、現在動作している設定を残してください。名前解決のエラーとノード接続のエラーを混同しないことが重要です。
DOMAIN
RESOLVER
RULE ENGINE
TARGET IP
Specimen 04 · Capture
TUNはシステムプロキシを使わない通信も引き受ける
一部のプログラムはOSのHTTPまたはSOCKSプロキシ設定に従いません。ゲーム、コマンドラインツール、特定のシステムサービスも直接接続する場合があります。TUNモードは仮想ネットワークインターフェースでこうした通信を受け取り、mihomoのDNS、ルール、ポリシー処理へ渡します。対応範囲が広がる一方、管理者権限、ルーティングテーブル、ネットワークドライバー、他のネットワークソフトとの互換性にも関わります。
有効にする前に、通常のシステムプロキシが動作することを確認してからTUNを個別にオンにします。オンにして全体が通信不能になった場合は、仮想ネットワークインターフェースの作成、デフォルトルートの追加、DNSがコアの待受アドレスを向いているか、ファイアウォールや別のVPNが同じ経路を占有していないかを順に確認します。クライアントを何度も再インストールするより、段階的に検証する方が原因を見つけやすくなります。
APP
VIRTUAL NIC
MIHOMO
NETWORK
mixed-port
同じポートでHTTPとSOCKS5のプロキシ接続を同時に受け付けます。デスクトップアプリにローカルプロキシアドレスを一括設定したい場合に適しています。
RULE
ルール表に従ってリクエストの行き先を決める一般的なモードです。日常利用では、直接接続とプロキシの範囲を管理しやすく、通常はグローバルモードより便利です。
Fake-IP
予約アドレスでドメインとの対応を保持し、TUNで引き受けた接続にもドメイン情報を残してルール照合できるようにします。
external-controller
管理パネルが実行状態の取得やポリシー変更に使う管理インターフェースです。LANに公開する前にアクセス制御を設定してください。
Selected questions
よくある質問
まず現象から処理チェーン内の該当段階を特定し、一度に1項目だけ変更します。詳しい手順は使い方ドキュメントで順番に確認できます。
サブスクリプション導入後、ノードが表示されないのはなぜ？
まず、サブスクリプションの応答がClashまたはmihomoで読み込めるYAML設定か確認してください。通常のウェブページ、ログイン画面、他のクライアント専用形式だけが返っている場合は読み込めません。次に、サブスクリプション更新履歴の解析エラーを確認し、インデント、プロキシグループの参照、ノードのフィールドを重点的に調べます。認証が必要なサブスクリプションでは、URLの有効期限も確認してください。詳しくはサブスクリプション導入手順をご覧ください。
クライアントは接続済みなのに、ブラウザでインターネットに接続できない場合は？
接続済みという表示は、コアプロセスが動作していることを示すだけです。システムプロキシが有効か、ブラウザが独自のプロキシ設定を使っていないか、利用可能な出口がプロキシグループで選択されているか、DNSが応答しているかも確認してください。まず直接接続のサイトにアクセスし、接続ログにリクエストが出るかを確認すると、問題が通信の引き受け前にあるのか、ルール処理後にあるのか判断できます。
ルールモード、グローバルモード、直接接続モードはどう選ぶ？
日常利用では通常、ドメイン、アドレス、プロセスに応じて通信先を決めるルールモードを選びます。グローバルモードは引き受け可能なリクエストを1つのポリシーに集約し、ノードの一時的な検証に適しています。直接接続モードはプロキシを迂回するため、障害がプロキシチェーンに起因するかを確認できます。3つのモードが変えるのは通信の判断であり、サブスクリプションやノード自体を修復するものではありません。
TUNモードはいつ有効にする？
対象プログラムがシステムプロキシを読み取らない場合、コマンドラインプログラムを引き受けたい場合、より多くのシステム通信をまとめて処理したい場合にTUNを検討します。まず通常のプロキシモードを安定させ、その後TUNを個別に有効にして、ネットワークインターフェース、ルート、DNSを検証してください。通信不能になっても、基本設定の問題か仮想ネットワークインターフェースの問題かを切り分けられます。詳しい順序は使い方ドキュメントをご覧ください。
Open source record · Plate 04
Clashエコシステムとmihomoコア
クライアント名は似ていても、GUI、コアプログラム、設定形式は同じ階層のものではありません。プロジェクト間の関係を理解してこそ、更新元、互換範囲、問題を報告すべき場所を正しく判断できます。
プロジェクトの歩み：Clashの設定規約から継続的に進化するエコシステムへ
Clashは広く利用されるYAML設定構造、ルール種別、プロキシグループの概念を形成し、その後さまざまなプラットフォーム向けのGUIクライアントが登場しました。元のプロジェクトがメンテナンスを停止した後も、エコシステム全体が自動的に1つの新プロジェクトへ統合されたわけではありません。各クライアントは異なるコア、UIフレームワーク、リリース周期を選択しています。そのため、名前にClashを含むからといって同じメンテナーが公開しているとは限らず、古いガイドだけで現在の互換性を判断することもできません。
クライアントを選ぶときは、GUIプロジェクトと搭載コアのメンテナンス状況を同時に確認してください。古い設定は移行できる場合が多いものの、拡張フィールド、ルールセット形式、DNSの動作、TUNの実装には差異がある可能性があります。ダウンロードセンターでは、現在も保守されている選択肢をプラットフォーム別に掲載し、メンテナンス停止プロジェクトはアーカイブ用途として明示しています。
オープンソースエコシステム：GUI、コア、ルールデータが分担して連携
完全な実行チェーンは通常、GUIクライアント、mihomoコア、サブスクリプション設定、ルールデータで構成されます。GUIクライアントは設定の導入、プロキシグループの表示、システムプロキシの切り替え、プロセス管理を担当します。コアは待受ポート、DNS解決、ルール実行、出口接続の確立を担当し、ルールセットはドメイン、アドレス、アプリの分類を提供します。どれか1層の更新に失敗しても、ノード不足、ルール不一致、リクエストのタイムアウトとして現れることがあります。
オープンソースコードにより、設定の動作、パラメータ定義、変更履歴をコミュニティで確認できます。問題が起きたら、まず障害がGUI操作に属するのかコアの実行に属するのかを確認し、対応するプロジェクトのドキュメントとログを調べてください。すべての問題をクライアント名のせいにすると、実際にエラーが起きたコンポーネントを見落とします。
コアの関係：実際のネットワーク処理を実行するmihomo
mihomoは、現在のClashエコシステムで広く使われている継続メンテナンス中のコアです。ルールセット、DNS、TUN、ドメインスニッフィング、外部コントロールなどの機能を拡張しています。多くのデスクトップ・モバイルクライアントはこれをGUI内部に統合しており、ユーザーが起動をクリックした後、実際にローカルポートを待ち受けて接続を処理するのはコアプロセスです。サーバーやルーター環境では、GUIを介さずコアを直接実行することもできます。
設定が利用できるかどうかは、現在のコアがサポートするフィールドを基準に判断してください。あるクライアントがファイルを導入できても、すべてのフィールドが期待どおり実行されるとは限りません。逆に、コアがサポートする新しいフィールドが、GUIの設定項目として提供されていない場合もあります。細かく設定するときは、実行ログと実際に生成された設定ファイルを照合してください。
更新の仕組み：アプリ、コア、サブスクリプションを個別に確認
クライアント更新、コア更新、サブスクリプション更新は独立した3つの経路です。GUIクライアントを更新すると、画面の修正や新しいコアバージョンが含まれる場合がありますが、サブスクリプションサービスが提供するノードやルールが自動的に変わるわけではありません。サブスクリプションを更新すると設定内容は置き換わりますが、ローカルプログラムがアップグレードされるとは限りません。ルールセットも独自の更新時刻で取得される場合があるため、診断時はどの層に変化があったかを記録してください。
アップグレード前に、現在利用できる設定とカスタム上書きを保存しておくことをおすすめします。完了後は、サブスクリプションの読み込み、プロキシグループの表示、システムプロキシ、DNSを確認してから、TUNや複雑な上書きを段階的に戻します。これにより互換性の差を明確な手順に絞り、1回の更新後に複数の変数へ同時に悩まされる事態を避けられます。
Repository command
mihomoソースコードを取得
次のコマンドで公開リポジトリをクローンできます。設定定義、変更履歴、ビルド手順の確認に適しています。一般的なクライアントユーザーは、日常のインストールにソースコードを使う必要はありません。
git clone https://github.com/MetaCubeX/mihomo.git
Field notes · Plate 05
設定と診断最新記事
記事は具体的な作業ごとに手順を分け、Linuxへの導入、実行ログの読み方、LAN内でのプロキシ共有を扱います。読む際は現在のクライアントの画面名と照らし合わせ、記事中のコアのフィールドを対応する設定項目に読み替えてください。
LinuxにClashクライアントをインストール：GUIとコマンドラインの導入手順
Linux用GUIクライアント、mihomoコマンドラインコア、サービスの自動起動、設定ディレクトリの導入方法を一通り解説し、一時実行と長期的なサービス管理を分けて説明します。
記事を読む →Clashの実行ログの読み方：よくあるエラーの意味と切り分け順
起動、サブスクリプション、DNS、接続、ルール照合の各段階に沿ってログを読み解き、ノードや設定を同時に変更せず、1つのエラー記録から具体的な設定項目を特定する方法を説明します。
記事を読む →Clashの混合ポートとLANプロキシ：スマートフォンや他の端末で共有する設定
mixed-port、LANからのアクセス許可、待受アドレス、ファイアウォールの許可がどう関係するかを解説し、共有端末から接続できない場合の確認順序も示します。
記事を読む →