• Clashエコシステム · 日本語ガイド

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

端末に合ったクライアントを選び、サブスクリプションの追加からルールによる通信の振り分けまで、接続設定を順に確認しましょう。

オープンソースのコアYAML設定日本語の手順解説

プラットフォームから選ぶ Clashクライアント

まずOSとプロセッサのアーキテクチャを確認し、対応するデスクトップクライアントを選びましょう。ダウンロードページでは入手先、対応プラットフォーム、メンテナンス状況をまとめて確認できます。初めて使う場合、コマンドラインのコアから始める必要はありません。

Windows

デスクトップブラウザーや開発ツール、日常業務での利用に適しています。まずClash Plusを確認し、Clash Verge RevやFlClashなどと画面や設定方法を比較してみましょう。Clash for Windowsから移行する場合は、既存の設定をエクスポートし、独自ルールやポートを控えてから作業してください。既存のフォルダーをそのまま上書きしないよう注意が必要です。

ダウンロードページへ

macOS

「このMacについて」でチップ情報を確認し、Apple Silicon用とIntel用のインストーラーを選びましょう。初回起動時に、ネットワーク拡張機能や補助サービスの許可を求められることがあります。ブラウザーの通信だけなら、まずシステムプロキシを利用します。他のアプリの通信も処理する場合は、クライアントの説明に従ってTUNと必要な権限を設定してください。

ダウンロードページへ

Android

モバイル端末では通常、システムのVPN機能を使って通信を処理します。インストール後に設定を追加し、VPNの許可ダイアログを確認してください。別のVPNに接続中の場合は、インターフェースの競合がないか先に確認します。画面ロック後に切断されるときは、サブスクリプションを何度も追加し直すのではなく、バッテリー最適化、バックグラウンド実行、自動起動の設定を確認しましょう。

ダウンロードページへ

iOS

ダウンロードページからClash PlusのApp Storeページに進めます。公式サイトのclashplus.ioもご覧ください。初回接続時はVPN構成の追加を許可します。設定を追加した後も、利用可能なプロキシグループを選択する必要があります。正常に使えるかどうかは、サブスクリプションの内容、ノードのプロトコル、クライアントの対応状況によって異なります。

ダウンロードページへ

Linux

デスクトップ環境ではClash Verge RevまたはFlClashを選び、ディストリビューションに合ったパッケージを使いましょう。サーバーやルーターで使う場合は、Mihomoコアの入手先を確認してください。コマンドラインで導入する場合は、設定ファイルの保存先、サービス権限、プロセス管理も別途設定が必要です。インストールしただけでは通信はプロキシ経由になりません。

ダウンロードページへ
すべてのクライアントを見る →

ルール・プロキシグループ・ネットワーク設定

以下はmihomoの設定仕様を参考に、各項目の関係を示した例です。部分的な設定例であり、そのまま接続に使える完全な設定ではありません。各GUIクライアントの項目対応や上書き方法は個別に確認してください。

具体的な条件から照合し、残りの通信を処理

ルールモードでは、接続を一覧の上から順に照合し、一致した時点で対応するポリシーを適用します。ドメインサフィックスルールはサイトとサブドメインをまとめて指定するのに便利ですが、キーワードルールは照合範囲に注意が必要です。具体的なルール、アドレスに関する条件の順に並べ、最後にMATCHをフォールバックとして置きます。グローバルモードと異なり、ルールモードではDIRECTとプロキシを併用できます。例のPROXYは、設定内に存在するプロキシグループ名またはプロキシ名に置き換えてください。ルールを追加しても利用可能な通信先がなければ、接続は失敗します。

rules:
  - DOMAIN-SUFFIX,google.com,PROXY
  - DOMAIN-KEYWORD,github,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

左側の設定項目を選んでから、右側の設定例を確認してください。手動で切り替えると自動再生は停止します。各用語の定義は用語集を、症状別の対処方法はトラブルシューティングをご覧ください。

サブスクリプションの追加と接続確認:3つの手順

まずは必要最低限の接続を確立し、その後ルールや高度な機能を追加しましょう。各手順で確認結果を記録しておけば、問題が起きても該当箇所からやり直せます。最初からすべての操作を繰り返す必要はありません。

  1. 設定を追加して選択する

    クライアントの「サブスクリプション」または「設定」画面で、URLから追加する項目を選び、URL全体を貼り付けて保存します。ダウンロードと解析が終わったら、追加した設定を選択してください。サブスクリプションの記録が増えただけでなく、プロキシグループやルールが画面に表示されることを確認します。ログインページやエラーメッセージが返される場合、別のクライアントを使ってもURL側の問題は解決しません。

    ローカルファイルを追加するときは、拡張子とテキストエンコーディングを確認し、Webページを保存したファイルをYAMLとして読み込まないようにしてください。初めて適用する前に設定名を控えておきます。複数のサブスクリプションがある場合は、現在選択されているものを確認し、以降の更新も同じ設定に対して行いましょう。

  2. ルールモードと通信先を選ぶ

    プロキシモードを「ルール」に設定し、設定内の主要なプロキシグループを開いて、利用可能な通信先を選択します。デスクトップではシステムプロキシを有効にし、モバイルではVPNを許可してください。グローバルモードは一時的な比較には使えますが、利用できないノードを復旧するものではありません。DIRECTモードにしても、クライアントのプロセスが終了するわけではありません。

    初回接続時は複数のプロキシアプリを同時に起動しないでください。ブラウザーにプロキシ切り替え拡張機能がある場合は、システム設定を上書きしていないか確認しましょう。TUN、LAN共有、カスタムDNSの設定は、基本的な接続を確認してから行うと、権限やルーティングの問題を切り分けやすくなります。

  3. 接続ログで結果を確認する

    接続先のWebサイトを開き、「接続」または「ログ」画面で該当ドメインを探します。適用されたルール、プロキシグループ、実際の通信先を確認してください。ログがあるのにアクセスできない場合は、通信先とDNSを調べます。ログがまったくない場合は、アプリがシステムプロキシに従っているか、通信がクライアントに届いているかを確認しましょう。

    普段はDIRECTで接続するサイトも比較対象に使い、ひとつのページだけでネットワーク全体を判断しないようにします。設定変更は一度にひとつにし、変更後に接続し直してください。問題を報告する際は、「インターネットにつながらない」だけでなく、OS、クライアント名、操作手順、エラーの原文を記録すると原因を特定しやすくなります。

詳しい使い方を見る →

オープンソースのコアとクライアントの仕組み

コア、GUIクライアント、サブスクリプションサービスの役割を区別すると、各機能の提供元や問題を調べる場所が分かります。このサイトではダウンロード先と日本語の解説を掲載しています。上流プロジェクトのリリース情報や設定ドキュメントに代わるものではありません。

Clash・Meta・mihomoの関係

Clashは、この種類のルールベースのプロキシツールの礎となり、その設定形式を中心にクライアントやルールのエコシステムが形成されました。Clash Metaは機能を拡張し、その後継コアはmihomoの名称で開発されています。検索結果には複数の名称が表示されることがありますが、必ずしも同じプログラムを指すとは限らず、ファイル名だけで機能を判断することもできません。

古い解説にある設定項目、起動オプション、プロトコルへの対応状況は、現在のクライアントでは使えない場合があります。未対応の項目がある場合は、実際に読み込まれているコアとそのドキュメントを確認してから、設定を修正するかクライアントを変更しましょう。高度な設定を一度にすべて移行するより、正常に使えている設定のバックアップを残す方が安全です。

GUIクライアントとコアは別々に開発・管理される

GUIクライアントはトレイメニュー、サブスクリプション管理、プロキシ選択、システム連携を提供し、コアは設定の解析、ルールの照合、ネットワーク接続の処理を担います。同じコアを使うクライアント同士でも、上書きの順序、権限の設定方法、設定ファイルの保存場所が異なる場合があります。画面上のスイッチ名が似ていても、生成される設定が完全に同じとは限りません。

移行時は設定ファイルの内容とシステム設定を別々に確認してください。ポート、自動起動、システムプロキシ、TUNの権限は、サブスクリプションをコピーするだけでは引き継がれないことがよくあります。このサイトのダウンロードページでは、メンテナンス状況とプラットフォーム別の入手先をまとめています。開発が終了したクライアントにはアーカイブの表示があり、古い解説との対応を確認できます。

公開ソースコードから動作を理解する

mihomoコアはGPL-3.0のオープンソースライセンスで公開されています。ソースコード、Issue、リリース履歴を確認すれば、設定の動作や変更理由を調べられます。オープンソースライセンスが定めるのはコードの利用・再配布条件であり、個々のサブスクリプションサービスの品質を保証するものではありません。また、設定の入手元を確認する代わりにもなりません。GUIクライアントのライセンスは、それぞれのプロジェクトの説明をご覧ください。

機能を確認するときは、まず設定項目のドキュメントを参照し、関連するIssueに再現条件が記載されているか調べましょう。問題を報告する際は、最小限の設定例と個人情報を伏せたログを添えてください。状況を判断できる情報は残しつつ、サブスクリプション全体やアカウント情報はアップロードしないでください。再現手順のないスクリーンショットだけでは、設定の問題かプログラムの不具合かを区別しにくい場合があります。

更新前に互換性と切り戻し方法を確認する

クライアントの更新では、画面、コア、システム補助コンポーネントが同時に変更されることがあります。更新前に独自ルール、上書き設定、現在有効な設定を保存し、リリースノートで互換性に影響する変更を確認してください。更新後は、まず従来どおり接続できるか確認してから新機能を有効にします。DNSの変更、TUNの切り替え、設定ファイルの変更を同じテストでまとめて行わないでください。

サブスクリプションの更新とクライアントの更新は分けて考えましょう。前者はリモート設定の内容を変更し、後者はプログラムの動作を変更します。サブスクリプションの更新後だけ問題が起きるなら、グループ名、ルールの参照先、サービスの状態を確認してください。プログラムの更新後だけ起きる場合は、リリースノートと権限設定を確認します。発生した順序を明確にすると、調査範囲を絞りやすくなります。

mihomoの上流ソースコードを見る

以下のコマンドはソースコードをクローンするだけです。クライアントのインストールやプロキシサービスの起動は行いません。実行するにはGitがインストールされている必要があります。一般ユーザーはリポジトリのドキュメントを読むだけでも構いません。

mihomoのソースコードリポジトリを開く ↗
git clone https://github.com/MetaCubeX/mihomo.git

あらかじめ区別しておきたい用語

サブスクリプションを追加できたのに接続できないのはなぜ?

追加に成功したことが示すのは、クライアントが設定を取得して解析できたことだけです。設定が適用されているか、プロキシグループで利用可能な通信先を選んだか、アプリの通信が実際にクライアントへ届いているかも確認してください。まず接続ログを見てから、ノード、ルール、システムプロキシの問題を切り分けましょう。詳しくはサブスクリプションと設定の用語をご覧ください。

システムプロキシとTUNモードは同時に有効にする必要がありますか?

常に両方を有効にする必要はありません。システムプロキシはその設定に従うアプリで使われ、TUNは仮想インターフェース経由で通信を処理します。実際に処理される範囲は、ルーティングとクライアントの実装によって異なります。まずどちらか一方で基本の接続を確認し、必要に応じてもう一方を使いましょう。用語の定義はネットワーク関連の用語をご覧ください。

ノードの疎通テストに成功すれば、すべてのサイトにアクセスできますか?

疎通テストの結果が示すのは、指定された確認先とその時点の接続状況だけです。サイトごとにDNS解決、ルールで選ばれる通信先、必要なプロトコル、アクセス制限が異なるため、実際のリクエストを確認してください。テスト結果だけでは判断できません。詳しくはプロキシとプロキシグループの用語をご覧ください。

サブスクリプションを更新したら独自ルールが消えたのはなぜ?

サブスクリプションから取得したファイルを直接編集すると、更新時に内容が再生成され、変更が上書きされる場合があります。クライアントが正式にサポートする上書き・マージ機能を使い、最終的なルールの適用順序を確認してください。ローカルルールとリモート設定の違いは設定ファイルの用語をご覧ください。

LinuxのペンギンアイコンにはFont AwesomeのTuxを使用し、CC BY 4.0ライセンスに基づいて掲載しています。プラットフォームのアイコンはOSの識別にのみ使用しています。

利用メモと特集記事

最新の3記事では、モバイル端末のバックグラウンド権限、Fake-IPの名前解決の仕組み、複数端末間での設定同期を解説しています。基本の接続を確認してから、実際の利用環境に合った記事をご覧ください。ひとつのプラットフォーム向けの手順を別の端末にそのまま適用しないようご注意ください。