• mihomo コア
  • YAML設定
  • ルール分岐

Clash クライアント
ダウンロードと設定

Clash をダウンロード ガイドを見る

プラットフォームを選んでクライアントを確認し、サブスクリプションの読み込み、ルール分岐、設定項目をチェック。

オープンソース 日本語ドキュメント 設定リファレンス

CLIENT ROUTES

プラットフォーム別にClashクライアントを選ぶ

まずOSとプロセッサのアーキテクチャを確認し、インストーラーと使い方をチェックします。

Windows デスクトップ向けGUIクライアント Clash PlusやClash Verge Revなどを確認し、普段使いと旧クライアントからの移行を比較します。 ダウンロードへ → macOS Apple Silicon / Intel チップの種類に合ったインストーラーを選び、システムプロキシ、メニューバーの操作、設定の有効状態を確認します。 ダウンロードへ → Android モバイル端末の設定管理 モバイルクライアントを比較し、設定を読み込んだらVPN接続を許可して、バックグラウンド動作の設定を確認します。 ダウンロードへ → iOS App Storeのクライアント Clash Plusのストア掲載ページと設定方法を確認できます。インストール後、OSの案内に従ってVPN構成を追加してください。 ダウンロードへ → Linux デスクトップアプリ / 単体コア デスクトップではGUIクライアントを、サーバーやルーターではコアの導入方法を確認できます。 ダウンロードへ →

インストーラー・設定・通信の取り込み方法を個別に確認

同じプラットフォームでも、インストーラーを使い回せるとは限りません。デスクトップではプロセッサのアーキテクチャ、モバイルではOSの要件を確認し、インストーラーの形式もOSのインストール方法に合わせてください。初めて使う場合は、まずGUIクライアントを選ぶとよいでしょう。設定画面からサブスクリプションを読み込み、プロキシ画面でルールを選択し、ログで接続結果を確認します。単体コアをダウンロードしただけでは、設定エディターやトレイメニュー、システムプロキシの切り替え機能は利用できません。

クライアントは設定を読み込んで接続を処理し、サブスクリプションの内容は設定の提供元が管理します。インストール後は、利用可能なサブスクリプションURLかローカル設定ファイルが必要です。任意のWebページのURLをサブスクリプションURLとして使わないでください。また、同じ設定エラーに対処するためにクライアントを何度もインストールし直す必要はありません。既存の設定を移行できるかどうかは、移行先のコアが対応する項目やプロトコル、クライアントの上書き機能によって決まり、ソフトウェア名が似ているかどうかは関係ありません。

システムプロキシ、モバイル端末のVPN、TUNは、それぞれ異なる通信の取り込み方法です。デスクトップのシステムプロキシは通常、その設定に従うアプリにのみ適用されます。ターミナルのツールでは、プロキシ環境変数を別途設定する場合があります。TUNは仮想ネットワークインターフェース、ルーティング、権限に関わるため、基本的な接続を確認してから有効にするのがおすすめです。ダウンロードページではプラットフォーム別のリンクとインストール方法をまとめています。クライアント選びの違いは選び方ガイドをご覧ください。

すべてのクライアントを見る →

CONFIG ROUTEBOOK

ルール・プロキシグループ・DNS

通信の流れから設定項目の関係を確認し、必要な設定例を参照できます。

具体的なルールを先に、最終ルールを後に

ルールモードでは、接続をファイルの記述順に確認し、一致したルールのポリシーを適用して処理を終えます。ドメインルールは特定のWebサイトに、IPアドレスルールは既知のネットワーク範囲に適しています。併用する場合は、名前解決の動作と対象範囲に注意してください。優先したい具体的な条件を先に置き、範囲の広い地域ルールを続け、最後にMATCHで補完します。ルールの宛先にはDIRECT、REJECTのほか、定義済みのプロキシグループ名も指定できます。問題を調べる際は、ノードを切り替えるだけでなく接続ログの適用ルールを確認すると、原因を絞り込みやすくなります。

rules:
  - DOMAIN-SUFFIX,local,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-KEYWORD,github,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
mihomoコア
GPL-3.0mihomoのオープンソースライセンス
5つのプラットフォームクライアントへのリンクを掲載

設定例は項目の理解に役立ちますが、完全なサブスクリプションの代わりにはなりません

上の例では、ルール、プロキシグループ、DNSの一部の構造を示していますが、実際のプロキシサーバーは含まれていません。既存の設定に追加する前に、同じトップレベル項目がすでにファイルにないか確認してください。rulesやdnsを重複して記述すると、解析結果が異なったり、後の記述で先の内容が上書きされたりすることがあります。YAMLではインデントに半角スペースを使い、同じ階層の幅を統一してください。リスト項目と親項目の関係も保つ必要があります。

クライアント画面のスイッチが、元のサブスクリプションファイルに直接反映されるとは限りません。実行時に設定を統合する場合もあれば、上書きファイルを使って反映する場合もあるため、実際に適用されている設定とログを確認してください。長期的に使うルールは、クライアントが正式に対応する上書き機能から設定するのがおすすめです。自動更新されるサブスクリプションファイルを直接編集すると、次回の取得時に変更が失われる可能性があります。設定項目の関係と統合時の注意点は設定リファレンスをご覧ください。

SOURCE & MAINTENANCE

Clashのオープンソースエコシステムとメンテナンス状況

コア、クライアント、設定の提供元を区別し、手元の環境に合う情報か確認します。

プロジェクトの変遷：名前が似ていても開発方針は異なる

Clashは当初、ルールベースのプロキシプロジェクトとして広く使われ、その後、設定形式やGUI、異なるコアを中心としたエコシステムが形成されました。元のプロジェクトや一部の旧クライアントのメンテナンス終了後も、コミュニティではそれぞれの方針で開発が続いています。検索結果に表示される古いガイドは、過去の画面や旧コア、配布終了済みのインストーラーを前提としている場合があります。タイトルにClashとあるだけで判断せず、クライアント名、使用するコア、説明されている機能をあわせて確認してください。

このサイトでは、旧クライアントと現在選べる選択肢を分けて紹介しています。ダウンロード数や評価、根拠が確認できないコミュニティ規模を、選定基準の代わりにはしません。メンテナンスが終了したクライアントは、旧環境の理解やデータ移行に役立ちます。普段使いのために新規インストールする場合は、現在もメンテナンスされ、OSの要件を満たすものを優先してください。移行前に元の設定と上書き内容をバックアップし、プロキシプロトコル、プロキシグループの参照、ルールセットのパス、起動設定を確認します。サブスクリプションURLだけを移して、ローカルのカスタマイズを忘れないようにしましょう。

コアとGUI：接続処理と操作画面の役割

mihomoはClashエコシステムで開発が続くオープンソースのプロキシコアで、Clash Metaの開発路線を引き継いでいます。コアはプロトコル処理、ルール判定、DNS、ネットワーク接続などを担います。GUIクライアントはサブスクリプションの管理、ポリシー選択、ログ確認、システムプロキシやサービスの管理などの操作画面を提供します。コアとクライアントの更新時期は一致するとは限りません。特定の設定項目が使えるかどうかは、Clashという名前の付いたクライアントすべてに対応していると推測せず、現在のコアのドキュメントとクライアントへの組み込み方法を確認してください。

同じ機能名でも、画面によって実装が異なることがあります。たとえばOS起動時の自動起動は、GUIだけを起動する場合も、バックグラウンドサービスも同時に起動する場合もあります。メインウィンドウを閉じても、画面が隠れるだけでプロキシが停止するとは限りません。スイッチの名前ではなく、実際の動作状態を確認してください。モバイル端末では、OSのVPN接続状態とノードへの接続結果も区別が必要です。VPN接続済みという表示は通信経路が確立したことを示すだけで、アクセス先のWebサイトに到達できる証明にはなりません。

オープンソースの確認方法：コード・ライセンス・変更履歴

mihomoのコードとライセンスは公開リポジトリで確認できます。GPL-3.0はこのプロジェクトのオープンソースライセンスの条件を示すもので、すべてのGUIクライアントやサブスクリプションサービスにも同じ条件が適用されるとは限りません。ソースコード、リリースノート、課題の議論を読むと、機能の範囲や既知の問題を把握しやすくなります。ソフトウェアを利用する際は、現地の法律、利用するネットワークの管理規則、関連サービスの利用規約を守ってください。公開コードと実際の実行設定は別のものなので、設定の提供元も確認しましょう。

このサイトはクライアントとドキュメントへのナビゲーションを提供するもので、掲載プロジェクトをすべて代表するものではありません。また、プロキシサーバーのアカウントやサブスクリプションサービスも提供していません。サブスクリプションURLにはアクセス認証情報が含まれる場合があります。ログやスクリーンショットを共有する際は、URLのパラメーター、アカウント、サーバーアドレスなどの機密情報を隠してください。相談時はOS、クライアント名、操作手順、エラーの一部を記載すると役立ちます。診断に必要な情報は残しつつ、サブスクリプション全体を公開の掲示板に貼り付けないでください。

更新の仕組み：クライアント・コア・サブスクリプションは別々に管理

クライアントの更新では主に画面や統合コンポーネントが変わり、コアの更新ではプロトコル対応や設定項目の動作が変わることがあります。サブスクリプションの更新では、設定の提供元が公開するノードやルールの内容が置き換わります。この3種類の更新はそれぞれ別に考えてください。サブスクリプションの更新に成功しても、クライアントが更新されたわけではありません。クライアントを新しくインストールしても、古いサブスクリプションが新機能に自動対応するわけではありません。アップグレード前に変更内容を読み、現在使える設定をバックアップし、ローカルの上書き設定の場所を記録しておくと、変更点を個別に確認できます。

更新後に問題が起きたら、まず設定が正常に読み込まれたか確認し、次にルールの宛先とプロキシグループの参照をチェックします。最後にDNS、ポート、通信の取り込み方法の変更を比較してください。すべての設定を同時に変えると、どの変更が結果に影響したか分かりにくくなります。ダウンロードページではクライアントを、ガイドページでは初回接続の手順を、設定リファレンスでは項目の意味を確認できます。この順に調べると、インストール、設定、ネットワークの問題を切り分けやすくなります。

METACUBEX / MIHOMO

mihomoのソースコードを見る

リポジトリをクローンすると、コードやプロジェクトの説明を確認できます。GUIクライアントが直接インストールされたり、プロキシのサブスクリプションが作成されたりするわけではありません。

プロジェクトのリポジトリを開く ↗ 
git clone https://github.com/MetaCubeX/mihomo.git

初回接続の確認手順

まず設定画面で、サブスクリプションがダウンロードされ、現在の設定として選択されていることを確認してください。リストに記録があるだけでは不十分です。次にプロキシ画面で、ルールが参照するプロキシグループに利用可能な宛先があるか確認し、ルールモードを選んで端末に合った通信の取り込み方法を有効にします。接続先が明確なWebサイトを開き、接続ログでドメイン、適用ルール、最終的な出口を確認しましょう。ログに接続が記録されていない場合は、ノードが使えないと判断する前に、アプリの通信がクライアントを経由しているか調べてください。

一部のWebサイトにしかアクセスできない場合は、失敗したリクエストと成功したリクエストを比較します。名前解決の段階でエラーになったのか、接続後にタイムアウトしたのか、同じプロキシグループで失敗しているのか、特定のルールだけが誤った宛先を指定しているのかを確認してください。遅延テストの結果は、特定の条件下での接続性の参考にすぎず、実際の通信を保証するものではありません。クイックスタートで基本の手順を終えてから、TUN、カスタムDNS、自動起動などを一つずつ有効にすると、原因を追いやすくなります。

よくある質問・トラブル対処

ClashにサブスクリプションURLを読み込んでも接続できないのはなぜ？

まず設定が有効になっているか確認し、次にプロキシグループの選択、動作モード、システムプロキシを確認します。読み込み成功は設定が読み取られたことを示すだけです。初回接続の手順を見る →

Clashでインターネットに接続できない場合、まずDNSを変更すべき？

まずリクエストがクライアントに届いているか確認し、名前解決の失敗と接続の失敗を切り分けます。複数の設定項目を同時に変更しないでください。トラブル対処のQ&Aを見る →

ルールモードとグローバルモードの違いは？

ルールモードはルールに従って通信先を選び、グローバルモードは全体に適用するポリシーを使います。直接接続モードではプロキシを経由せず接続します。モードの切り替えと通信の取り込み方法の変更は別の操作です。モードの違いを読む →

ローカルルールをサブスクリプション更新で上書きされないようにするには？

クライアントが対応する上書き・統合機能を使い、生成後の実行設定を確認してください。自動ダウンロードされる元ファイルだけを編集するのは避けましょう。上書きと統合の説明を見る →

READING NOTES

Clashの設定・使い方ガイド

設定の構造、画面の操作、プロキシモードについて解説します。

すべての記事を見る →