クライアントのインストール · サブスクリプション設定 · 日本語ドキュメント

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

OSに合ったクライアントを選び、サブスクリプションの追加、システムプロキシ、ルール振り分けを設定します。最後にログで接続経路を確認しましょう。

  • 日本語ドキュメント
  • オープンソースのコア
  • 複数プラットフォームの設定
プロキシコアmihomoルールとプロトコルの処理
オープンソースライセンスGPL-3.0mihomoコアに適用
設定形式YAMLインポート前に互換性を確認
設定の構造

サブスクリプション、ルール、接続先

クライアントは設定画面を提供し、コアは接続を処理し、サブスクリプションは利用可能な設定を提供します。まずこの3つの役割を切り分けてからプロキシモードを調整すると、問題の発生箇所を特定しやすくなります。以下の設定例は項目同士の関係を理解するためのものです。実際に使える機能は、選択したクライアントとコアのドキュメントで確認してください。

設定機能

Clashのルールとサブスクリプション管理

ルールの順序で接続先を決定

ルールモードでは、ドメイン名や宛先アドレスなどの条件に基づいて接続先を選び、最初に一致したルールが適用されます。すべての通信を同じ接続先に送るのではなく、ローカルサービス、開発ツール、その他の用途ごとに振り分けられます。変更する際は、具体的な条件を先に、最後にフォールバック用のルールを置き、参照先のプロキシグループが定義済みであることを確認してください。接続に問題がある場合は、接続ログで一致したルールを確認し、ルールかプロキシグループのどちらを直すべきか判断します。ノードを切り替えるだけでは、ルールの順序ミスは解消されません。

# PROXY は定義済みのプロキシグループである必要があります
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
インストーラーのダウンロード

OSに合ったClashクライアントを選ぶ

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

まずOSとプロセッサのアーキテクチャを確認し、次にクライアントごとの設定管理方法を比較しましょう。デスクトップでは通常、システムプロキシから始めます。モバイルではシステムのVPN許可が必要です。サーバーやルーターで使う場合は、コアを直接利用することもあります。インストーラー名が似ていても、システム要件が同じとは限りません。古いデバイスでは、ダウンロードページの互換性情報も確認してください。クライアント自体にプロキシサービスは含まれません。インストール後、正規に入手した、選択したコアと互換性のあるサブスクリプションまたは設定ファイルが必要です。

Windows

デスクトップブラウザー、開発ツール、普段使いのアプリに適しています。デバイスのアーキテクチャに合ったインストーラーを選び、サブスクリプションを追加してからシステムプロキシを有効にします。さらに多くのアプリの通信を取り込みたい場合は、TUNサービスを設定してください。ストアアプリに接続問題が起きた場合は、UWPのループバック制限か一般的なネットワーク障害かを切り分けましょう。すぐにクライアントを再インストールする必要はありません。

ダウンロード

macOS

インストール前にシステム情報を確認し、Apple Silicon搭載機かIntelプロセッサ搭載機かを確認してください。初回起動時は、システムの案内に従ってアプリとネットワークの権限を設定し、現在のネットワークサービスでプロキシが有効になっているか確認します。Wi-Fiを切り替えたり、別のVPNを有効にしたりした後は、ルーティングとDNSを再確認してください。ネットワーク切り替え時の問題をサブスクリプションのせいにしないようにしましょう。

ダウンロード

Android

スマートフォンのアーキテクチャに合ったインストーラーを選び、初回接続時にシステムのVPN許可を確認してください。バックグラウンド動作はシステムのバッテリー設定に左右されます。画面消灯後に接続が切れる場合は、バックグラウンド動作の権限と省電力設定を確認しましょう。他のVPNアプリもインストールしている場合は、どのアプリが現在の通信を中継しているかを明確にしてから、接続状態を判断してください。

ダウンロード

iOS

ダウンロードページからClash PlusのApp Storeページに進めます。製品の公式サイトはclashplus.ioです。インストール後、互換性のある設定をインポートし、システムの案内に従ってVPN構成を追加してください。システムにVPN接続中と表示されても、ネットワーク拡張機能が有効であることを示すだけです。意図した接続先を経由しているかは、ルールとアクセス記録で確認してください。

ダウンロード

Linux

デスクトップでは、ディストリビューションのパッケージ管理方式に合ったGUIクライアントを選べます。コマンドラインツールでは、プロキシの環境変数を別途確認してください。GUIデスクトップのシステムプロキシ設定が、ターミナルやバックグラウンドサービスに反映されるとは限りません。TUNを使う場合は、サービスの権限、ルーティング、既存のネットワーク管理ツールを確認し、ひとつずつ有効にするとトラブルの原因を特定しやすくなります。

ダウンロード

ダウンロードページでは、プラットフォーム別のクライアントとシステム要件を掲載しています。インストール方法、サービスの権限、プラットフォームごとの違いはプラットフォーム別ガイドでまとめて解説します。使用可能な設定をすでにお持ちの場合は、下の接続手順に進んでください。

クイックスタート

サブスクリプションの追加から接続確認まで

手順を詳しく見る

初回設定では、変更する項目をできるだけ絞りましょう。起動するプロキシクライアントは1つだけにし、まず動作確認済みの設定を使います。DNS、ルール、仮想ネットワークアダプターを同時に変更しないでください。再現可能な接続を確認してから、自動起動や個人用オーバーライドを少しずつ追加します。設定を1つずつ変えれば、問題が起きたときに直前の正常な状態へ戻しやすくなります。

  1. サブスクリプションを追加して選択

    設定管理でリモート設定を新規作成し、サービス提供元から案内されたURL全体を貼り付け、内容の取得が完了するまで待ちます。続いて、その設定を選択し、プロキシグループとルールが読み込まれていることを確認してください。インポート履歴があっても設定を有効にしていなければ、メイン画面のスイッチがオンでも、コアが意図した設定を使っていないことがあります。更新に失敗した場合は、URLに余分な空白がないか、サブスクリプションの期限が切れていないかを確認し、クライアントのログを調べましょう。設定をすべて削除する操作を繰り返す必要はありません。

    サブスクリプションの追加手順を見る →
  2. ルールモードと通信の取り込み方法を選ぶ

    プロキシモードをルールに設定し、手動選択が必要なプロキシグループで接続先を選んでから、システムプロキシを有効にします。グローバルモードは短時間の比較や切り分けには使えますが、あらゆる問題を解決するスイッチではありません。対象アプリがシステムプロキシに従わないと確認できた場合にのみ、TUNを検討してください。TUNを有効にしても、有効なルールと利用可能な接続先は必要です。仮想ネットワークアダプターが変えるのは通信をコアに取り込む方法であり、サブスクリプション内の接続情報に代わるものではありません。

    システムプロキシの設定を見る →
  3. ルールの適用状況と実際の通信を確認

    プロキシ経由になる想定のWebサイトを開き、クライアントの接続記録でドメイン名、適用ルール、接続先を確認します。次にLAN上のサービスにもアクセスし、直接接続が必要な通信が維持されていることを確かめましょう。遅延テストの成功は、テスト用リクエストが完了したことを示すだけです。実際のWebページ閲覧、ダウンロード、アプリでの利用確認の代わりにはなりません。ブラウザーは使えて特定のアプリだけ失敗する場合は、そのアプリのプロキシ接続方法を優先して確認します。すべての通信に失敗する場合は、サブスクリプション、DNS、ローカルポートの順に調べましょう。

    ルールと接続確認の説明を見る →
オープンソースエコシステム

コアの提供元と更新の範囲

Mihomoプロジェクトを見る

Clash、Meta、Mihomoの関係

Clashエコシステムは、ルールベースのプロキシコアと、そのコアを基盤に構築されたクライアントで構成されています。元のClashプロジェクトが開発終了した後も、コミュニティではさまざまな互換実装の開発が続いています。MihomoはClash.Metaの系譜を引き継ぎ、互換性のある設定を基盤に、プロトコル、ルール、DNS機能を拡張しています。検索結果には現在もこれらの名称が混在することがあります。互換性を判断する際は、製品名にClashとあるかどうかではなく、実際に使われているコアを確認してください。

オープンソースプロジェクトのリポジトリでは、コード、コミット履歴、Issue、ライセンスを確認できます。特定の設定項目がサポートされているか、同様の問題がすでに議論されているかを調べるのに役立ちます。コミュニティのプロジェクトは単一のチームが一括して保守しているわけではありません。コア、GUI、サブスクリプションサービスはそれぞれ異なるペースで更新されます。当サイトではダウンロード先と操作ガイドを紹介していますが、ブランド名は上流の各プロジェクトを共同で保守していることを意味しません。配布元とライセンスの範囲は、各プロジェクトの説明を確認してください。

クライアント、コア、サブスクリプションはそれぞれ更新

クライアントの更新では、画面、システム連携、または同梱コアが変わることがあります。サブスクリプションの更新では、サービス提供元の設定を再取得します。両者は互いの代わりにはなりません。コアを内蔵するクライアントもあれば、独立した更新機能を備えるクライアントもあります。実行前にそれぞれのリリースノートを確認してください。設定を解析できない場合は、構文の非互換性かリモートの内容の異常かを切り分けてから、ソフトウェアの更新、設定の修正、サブスクリプション提供元への問い合わせのどれが必要か判断しましょう。複数の箇所を同時に変更するのは避けてください。

アップグレード前に、現在使えている設定と個人用オーバーライドを保存し、プロキシモードや通信の取り込み方法など重要な設定を記録しておきましょう。アップグレード後は、設定が読み込まれたことを確認してから、普段のアクセスとLAN上のサービスをテストします。必要に応じてログの変化も比較してください。古いクライアントは起動できても、新しいプロトコルやシステム互換性の修正に対応していない場合があります。開発が終了したアプリは過去の設定を理解する目的にとどめ、普段使いには現在も保守され、利用中のシステムに合ったものを選びましょう。

ルールは共有できても、アクセス情報は別途保護が必要

オープンソースとは、ライセンスに基づいてコードを閲覧・利用できるという意味です。プロキシサービスが無料であることや、サブスクリプションの内容を公開してよいことを意味しません。サブスクリプションURLにはアカウントへのアクセス権が含まれることがあり、設定ファイルにはサーバーの認証情報が含まれる場合もあります。不具合を報告する際は、エラー項目、ルールの順序、実行環境を残しつつ、サブスクリプションURLや認証情報を削除してください。設定全体を公開するより、必要な部分だけに整理した再現例のほうが、議論にも原因の特定にも役立ちます。

使い方とトラブル解決

接続確認とトラブルシューティング

すべての記事を見る

以下の記事では、初回接続、ノードのタイムアウト、遅延テストの3つのよくあるケースを取り上げます。症状に合わせて確認を進めましょう。プロキシが有効かまだ分からない場合は、接続確認から始めます。同じ設定で何度もリクエストが失敗するなら、タイムアウトの原因を調べてください。テスト結果の数値と実際の使用感に差がある場合は、往復遅延、スループット、パケットロスを区別する必要があります。サブスクリプションを何度もインポートし直すより、問題発生時のログを残すほうが役立ちます。