Clash オープンソースコミュニティ mihomo

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

OSに合ったClash クライアントを選び、mihomo の設定項目を確認。接続ログでルールの判定結果をチェックできます。

  • カーネルのソースコードを公開
  • 日本語ドキュメント

INSTALL / PLATFORM

Clash OS別ダウンロード

まずOSとプロセッサを確認してから、クライアントを選びましょう。同じプロジェクトでも、異なるアーキテクチャ向けのインストーラーが用意されていることがあります。名前が似ていても、互換性があるとは限りません。初めて使う場合は、設定の読み込みや接続の確認、プロキシグループの切り替えを画面上で行えるGUIクライアントがおすすめです。ルーターやサーバーでネットワークサービスを管理している場合は、カーネル単体の導入も検討できます。

Windows

「設定 → システム → バージョン情報」でシステムの種類を確認します。ダウンロードページに記載されたアーキテクチャと照らし合わせて、インストーラーを選んでください。別のクライアントに乗り換えるときは、古いアプリを終了し、タスクトレイにバックグラウンドプロセスが残っていないことも確認しましょう。同じポートを複数のプロセスが待ち受けるのを防げます。

macOS

「このMacについて」でチップまたはプロセッサを確認し、Appleシリコン版かIntel版を選びます。メニューバーにクライアントのアイコンが表示されていても、通常はアプリが起動中というだけです。設定を読み込んだら、使用する設定が有効になっているか確認し、必要に応じてシステムプロキシを有効にしてください。

Android

端末のアプリが対応するアーキテクチャに合ったインストーラーを選びましょう。機種名に「64ビット」とあるだけでは判断できません。初回接続時は、システムのVPN接続許可を確認してください。別のローカルVPNが有効になっている場合は、必要に応じて切断してから新しいクライアントを起動します。

iOS

ダウンロードページからClash PlusのApp Storeページを開き、アプリの詳細でシステム要件を確認します。インストール後は、クライアントが対応する設定のインポート形式をチェックしてください。接続時はシステムの案内に従ってVPN構成を追加し、クライアントに戻って使用中の設定を確認します。

Linux

まずディストリビューションで利用できるパッケージ形式を確認し、次にアーキテクチャを照合します。デスクトップ環境ならGUIクライアント、コマンドラインのみの環境なら設定ディレクトリやプロセスの起動、ログの保存方法を自分で整える必要があります。別のマシンへ移行するときは、メイン設定だけでなくルールセットやローカルファイルの参照先も確認してください。

古いチュートリアルにあるボタンと同じ名前でも、新しいクライアントでは配置が異なることがあります。特にサポートが終了したClash for Windowsから移行する場合は、自分で追加したルールやオーバーライドを控え、新しいクライアントに設定を再インポートしてください。古い作業ディレクトリを丸ごとコピーするのは避けましょう。設定ファイル以外に、キャッシュや旧画面専用の設定が含まれていることがあります。

すべてのクライアントを見る → 機能を比較してクライアントを選ぶ

CONFIG / INSPECTION

mihomo の基本設定

トラブル対処では、リクエストがカーネルに届いたか、どのルールに一致したか、最終的にどの出力先へ接続したかを分けて確認します。以下は各項目の例であり、そのまま置き換えて使える設定一式ではありません。設定項目の値や依存関係は設定項目リファレンスを参照してください。

具体的なルールを先に、最後にフォールバック

ルールモードでは、リストの上から順に判定し、一致した時点で後続の項目は確認されません。サブドメインを親ドメインと異なる経路にしたい場合は、完全一致のドメインを先に記述し、その後に対象範囲の広いサフィックスルールを置き、最後にフォールバックルールを設定します。グローバルモードと異なり、ルールモードでは同じ設定内で異なる出力先を指定できます。変更後は接続ログで実際に一致したルールを確認しましょう。ルールが独自のプロキシグループを参照する場合は、ルール内の名前とグループ名が完全に一致していることも確認してください。

config.yaml · rules
mode: rule
rules:
  - DOMAIN,blocked.example.com,REJECT
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

SETUP / FIRST RUN

設定の読み込み・通信の取り込み・動作確認

初回テストには、普段アクセスできるサイトを使い、プロキシを有効にする前の状態を記録します。その後は設定を一度に1つだけ変更してください。問題が起きても、直前の手順に戻れば、どの変更が原因か特定しやすくなります。

  1. 設定を読み込んで有効にする

    クライアントの「設定」または「サブスクリプション」を開き、ファイルから読み込むか、信頼できる配布元のサブスクリプションURLを入力します。読み込み後はその設定を選択し、ルールとプロキシグループが読み込まれているか確認してください。リストに設定が表示されていても、カーネルがそれを使用中とは限りません。構文エラーが出た場合は、メッセージに示された項目や行番号を記録します。元のファイルを別途保管し、コピー側でインデントやリスト階層、項目の型を修正してください。

  2. ルールモードと通信を取り込む方法を選ぶ

    ルールモードでテストし、対象のプロキシグループで接続先を1つ選択します。デスクトップでは、システム設定を参照するアプリを使ってシステムプロキシを試せます。モバイルでは、クライアントの案内に従ってシステムVPNを設定してください。モード、ノード、通信の取り込み方法を同時に変更するのは避けましょう。ターミナルのツールだけをプロキシ経由にしたい場合は、端末自体のルーティングを変えずに、ツールのドキュメントに従ってプロキシアドレスを設定できます。

  3. 接続ログでルールの一致を確認する

    テスト用のページを開き、クライアントの接続一覧で対象ドメインを探して、ルールと出力先を確認します。接続ログがない場合は、まずアプリの通信が取り込まれているか確認してください。ログはあるのにフォールバックルールが適用されている場合は、ルールの順序とドメインの記述を見直します。正しいルールに一致しているのにタイムアウトする場合は、接続先サイトと選択した出力先への疎通を確認しましょう。エラーが出たら、発生時刻、モード、エラーメッセージを記録してください。ログを共有する前に、サブスクリプションURLと認証情報を削除します。

チュートリアルをすべて見る →

よくある初回トラブル

ノードの遅延は表示されるのに、Webページを開けないのはなぜ?

速度テストとWebページの通信では、異なるルールや接続先が使われることがあります。まずページへのリクエストが接続一覧に記録されているか確認し、実際の出力先を調べてください。表示される遅延は、そのテストを実行したときの結果にすぎません。用語については用語集をご覧ください。

サブスクリプションの更新に失敗した場合、古い設定を削除すべき?

まず、現在使えている設定は残しておきましょう。更新エラーがタイムアウト、認証失敗、形式の解析エラーのどれなのか確認し、原因に応じて対処します。配布元の内容を取得できない場合、クライアントを何度再インストールしても解決しないことがほとんどです。サブスクリプションとローカル設定の違いは用語集で確認できます。

ブラウザーはつながるのに、ターミナルは同じ経路を使わないのはなぜ?

コマンドラインのプログラムがシステムプロキシを参照するとは限りません。環境変数を読むものや、個別の設定が必要なものもあります。まずツールの説明を確認し、次にクライアントの接続ログに通信が記録されているか調べてください。通信を取り込む方法については用語集をご覧ください。

SOURCE / MAINTENANCE

mihomoのソースコードとプロジェクトの役割

プロジェクト名、クライアント名、サブスクリプションの配布元は、それぞれ別のものです。設定項目を調べるときは、実際に設定を読み込んでいるカーネルを確認してください。インストールや更新、画面表示の問題は、使用しているクライアントのドキュメントを参照します。

Clashからmihomoへ

Clashエコシステムでは、YAMLで受け入れ側の設定や出力先、ルールを記述します。mihomoは、以前Clash.Metaと呼ばれていたカーネルプロジェクトを引き継いでいます。古い資料で以前の名称が使われているのは珍しくありません。旧ドキュメントの画面やパラメーターを参照するときは、どのプロジェクトの情報か確認してください。名前が似ていることは検索の手掛かりにはなりますが、設定項目が現在も使えることや、同じ開発元のインストーラーであることの根拠にはなりません。

オープンソースライセンスとプロジェクトの役割

mihomoのソースコードリポジトリは、GPL-3.0ライセンスを採用しています。上流リポジトリではコードや変更履歴、課題の議論を確認できます。このライセンスが適用されるのはカーネルプロジェクトであり、すべてのGUIクライアントが同じライセンスだとは限りません。GUIを提供する各プロジェクトは、画面操作やOS連携、配布パッケージをそれぞれ開発・管理しています。サブスクリプションは設定の配布元が管理するもので、更新してもクライアントが置き換わったり、システムに新しいカーネルがインストールされたりすることはありません。

GUIと実際に適用される設定

カーネルは通信を受け入れ、ルールに基づいて出力先を選び、接続を処理します。GUIクライアントは情報を表示するだけでなく、サブスクリプションやオーバーライド、全体設定を組み合わせてから、結果をカーネルに渡すことがあります。設定ファイルにはルールがあるのに画面上で反映されない場合は、まず有効な設定を確認し、次にオーバーライドの適用順を調べ、最後に接続ログと照合してください。編集画面に表示された元のファイルだけでは、クライアントが後から追加した設定を見落とすことがあります。

アップデート前に確認する変更履歴

インストーラーを変更する場合は、まずクライアントのリリースノートを確認します。ルールの構文やDNSの動作、仮想ネットワークインターフェースの対応に関わる場合は、使用中のカーネルの変更履歴も調べてください。更新前に現在の設定と通信の取り込み方法を記録し、ローカルルールとオーバーライドのコピーを保存します。更新後は同じ接続先でテストしましょう。ルールを1つ追加するだけなら、プログラムやルールセット、サブスクリプションを同時に更新するより、ルールだけを保存してテストするほうが変更点を特定しやすくなります。

NOTES / LATEST

技術ノート

接続ログがない場合は、まずプロキシが通信を取り込んでいるか確認します。ログはあるのに経路が違う場合は、モードを見直してください。クライアントを乗り換える前に、必要な機能と設定の移行方法も確認しましょう。

記事をすべて見る →