CLASH · IPV4 · オープンソースクライアント

Clash オープンソースネットクライアントのダウンロードと設定

デバイスに合ったクライアントを選び、日本語ガイドを見ながら設定を読み込み、ポートやルールの動作を確認できます。

  • コアMihomo
  • ライセンスGPL-3.0
  • ルールの宛先DIRECT

127.0.0.1 / クライアント一覧

OS別にClashクライアントをダウンロード

まずOSとCPUアーキテクチャを確認してから、インストーラーを選びましょう。GUIクライアントなら、設定の読み込みやプロキシグループの切り替え、ログの確認をひとつの画面で行えるため、初めて使う方にも便利です。コマンドライン用のコアを使う場合は、デスクトップアプリと取り違えないよう、ダウンロードページでコアの項目を確認してください。

Windows

OSの「バージョン情報」でシステムの種類を確認し、クライアントに記載されたCPUアーキテクチャと照らし合わせてください。初回はシステムプロキシを使ってブラウザーの接続を確認すればよく、最初からTUNを有効にする必要はありません。インストーラーやOSから権限の確認が表示されたら、インストール、サービス、ネットワーク接続のどれに関するものかを確認しましょう。通知が出たからといって、ファイアウォール全体を無効にする必要はありません。古いクライアントを入れ替える前に終了し、設定をバックアップしてください。

ダウンロードページへ

macOS

「このMacについて」でIntelプロセッサとAppleシリコンを確認し、対応するインストーラーを選んでください。起動時にmacOSのセキュリティ警告が表示された場合は、プロジェクトのリリース情報でインストール要件を確認します。起動できても通信を取り込めない場合は、システムプロキシの状態とクライアントのネットワーク権限を確認してください。別のMacへ移行する際は、古いアプリのデータフォルダーをそのままコピーせず、設定を移行する方法を優先しましょう。

ダウンロードページへ

Android

パッケージを選ぶ際は、スマートフォンのチップの宣伝上の仕様だけでなく、端末のOSが対応するアーキテクチャを確認してください。初回接続時にはOSからVPN構成の追加を求められるので、許可した後、クライアントが接続済みになっているか確認します。画面ロック後だけ問題が起きる場合は、アプリのバックグラウンド動作が制限されていないか確認してください。接続直後に切れる場合は、別のアプリがVPNを使用していないか確認しましょう。

ダウンロードページへ

iOS

ダウンロードページからストアのアプリ詳細を開き、動作要件を確認してからインストールしてください。初回接続時はOSの案内に従ってVPN構成の追加を許可します。設定の読み込み完了と接続完了は別の状態です。設定一覧に名前が表示されただけで接続できたと判断しないでください。仕事用のVPN構成がすでにある場合は、切り替えられるかを先に確認しましょう。特に会社管理の端末では注意が必要です。

ダウンロードページへ

Linux

デスクトップでは、ディストリビューション、パッケージ形式、CPUアーキテクチャを確認してからGUIクライアントを選びましょう。システムプロキシの扱いはデスクトップ環境によって異なります。ブラウザーがプロキシを利用できても、ターミナルのコマンドが同じ設定を使うとは限りません。サーバーでコアだけを動かす場合は、設定ファイルの場所とサービス権限も確認し、用途に合った範囲で待ち受けるようにしてください。

ダウンロードページへ

どちらのクライアントも端末に対応している場合は、設定の読み込み方法、メンテナンス状況、ログの確認場所を比べて選びましょう。LANアクセスやTUN、設定のオーバーライドを使う場合は、画面に該当項目があるか、コアが必要なフィールドを読み込むかも確認してください。古い設定ファイルを開くためだけにアーカイブ済みのクライアントを検討しているなら、まずメンテナンス中のクライアントでコピーを試し、元のファイルを繰り返し編集しないようにしましょう。

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

DIRECT / 設定の入口

Clashの設定項目と通信の流れ

ローカル待ち受け、通信の取り込み、ルールによる振り分けは、それぞれ別の役割です。ポートはアプリがリクエストを渡す先を決め、取り込み方法はどのリクエストがコアに届くかを決めます。ルールはコアに届いたリクエストの行き先を決めます。この3点を押さえておけば、通信が届いていないのか、届いた後に経路を誤っているのかを切り分けやすくなります。

ルールの評価順とデフォルトの宛先

ルールモードでは、上から順に各ルールを確認し、最初に一致したルールの宛先を使います。それより下にある、より詳細なルールまで評価されることはありません。例では、プライベートIPアドレス、サンプルドメイン、その他の通信をそれぞれ処理します。1つ目は指定したアドレス範囲を直接接続し、2つ目はドメインの一致と拒否結果を確認するためのもの、最後はどれにも一致しない通信の受け皿です。リモートノードを使わずに試せるため、テスト用設定でログを確認してから、同じ順序を自分の設定に適用できます。実際に編集するときは、拒否ルールのドメイン末尾を広くしすぎないよう注意してください。

  • 具体的な条件を先に書き、MATCH は最後に置きます。
  • no-resolve を指定すると、このアドレスルールのためにドメイン名を積極的にIPアドレスへ解決しません。
mode: rule
rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN,example.org,REJECT
  - MATCH,DIRECT

メモにある mixed-port: 7890 はサンプルであり、すべてのクライアント共通の固定ポートではありません。127.0.0.1 は現在の端末を指すため、スマートフォンで使う同じアドレスがパソコンを指すことはありません。この端末内だけで使う場合は allow-lan: false のままにし、クライアントに表示された待ち受けポートを確認してください。ポートが競合した場合は、現在のポートが使用中であることを確認してから変更し、古いポートを手動で設定したアプリも合わせて更新しましょう。

ポート、モードなど共通設定を確認する →

mixed-port / 初回接続

設定の読み込み、モード選択、接続確認

初回は、ネットワークが正常に使えている状態をできるだけ保ち、一度に変更する設定を一つにしましょう。まず設定を読み込めるか確認し、次にリクエストがコアに届くかを見て、最後にルールの振り分け先を調べます。こうすれば、2段階目でつまずいても、サブスクリプションを読み込み直す必要はありません。

  1. 01 / config.yaml

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

    設定またはサブスクリプションの画面で、手元のファイルかサブスクリプションURLを追加します。読み込み後、プロキシグループとルールが表示されるか確認し、そのプロファイルを選んで現在の有効な設定にします。画面にダウンロード成功とだけ表示され、内容が読み込まれていない場合は、ログに形式やネットワークのエラーがないか確認しましょう。サブスクリプションURLにアクセス用の認証情報が含まれることがあります。エラーを共有する際は、URL全体が写ったスクリーンショットを避けてください。

  2. 02 / mode: rule

    ルールモードと通信の取り込み方法を選ぶ

    普段使いでは、まずルールモードを選びます。転送したい通信に適用されるルールが正しいプロキシグループを指定しているか確認し、そのグループで選択中の出口も確認してください。デスクトップでは、まずシステムプロキシを使い、その設定に従うアプリで動作を試します。スマートフォンでは、クライアントの接続操作に従ってOSの許可を完了してください。ルールモードとシステムプロキシは、どちらか一方を選ぶものではありません。前者は通信の振り分け方を、後者はリクエストを取り込む入口を決めます。

  3. 03 / 127.0.0.1

    接続ログとルールの判定結果を確認する

    新しいWebページを開き、クライアントの接続ログでドメイン名、適用ルール、出口を確認します。新しいログがまったくない場合は、アプリがプロキシの入口を使っているかを調べましょう。ログがあるのに接続できない場合は、プロキシグループ、名前解決、接続エラーを確認します。コマンドラインを試す場合は、ターミナルのプログラムが参照しているプロキシ設定を個別に確認してください。ブラウザーでの結果から推測する必要はありません。

ネットワークを元に戻す場合は、まず直前に有効にした通信の取り込み方法を無効にし、システムプロキシが元の状態に戻っているか確認してください。クライアントのプロセスを直接終了すると、システムプロキシの設定だけが残り、ローカルポートを参照し続けることがあります。復旧したら、どの設定が症状に影響したか記録しておけば、次回はそこから確認でき、再インストールも不要です。

詳しい使い方を見る → 症状から対処方法を探す

config.yaml / プロジェクト情報

ClashのオープンソースエコシステムとMihomoコア

Clash オープンソースネットは、クライアントの入手先や設定例、トラブル対処法をまとめた独立した情報サイトです。クライアントのリリース情報、メンテナンス状況、機能の範囲は各プロジェクトの説明をご確認ください。ソースコードを読む際は、ネットワーク処理を担うコアと、それを操作するクライアントの画面を区別しましょう。

プロジェクトの変遷:同じ名称でも異なるプロジェクト

初期のClashプロジェクトでは、プロキシノード、プロキシグループ、振り分けルールをひとつの設定ファイルにまとめていました。元のプロジェクトはその後メンテナンスを終了しましたが、設定の構造や使い方はコミュニティの別プロジェクトに引き継がれています。古いガイドに載っている画面やメニューの場所、設定項目を、現在のクライアントの手順としてそのまま使うことはできません。古いスクリーンショットは概念の理解にとどめ、実際の操作は現行プロジェクトの説明を確認してください。

古いプロファイルを移行する際は、元のファイルを残してコピーを作成し、共通フィールド、ノードの種類、ルールの宛先を照らし合わせましょう。ファイルを読み込めても、すべての設定が以前と同じように処理されるとは限りません。まず基本的な接続を確認し、その後、依存関係の多い機能を一つずつ戻すほうが、移行時に設定全体を書き換えるより問題を特定しやすくなります。

コミュニティ内の役割:画面の機能と通信の取り込み方法

GUIクライアントは通常、設定プロファイル、OSとの連携、ログの表示を管理します。似たコアを使うクライアント同士でも、トレイメニュー、OS起動時の自動起動、バックグラウンドサービス、オーバーライドの場所は異なる場合があります。OSの許可やインストール画面に関する問題は、まずクライアントプロジェクトの説明を確認しましょう。ルールの判定やプロトコルの機能は、コアのドキュメントを参照するのが適切です。

公開されている問題報告を調べる際は、記載されたOSと再現条件を確認してください。同じエラーメッセージでも、ファイル権限、OSのネットワークサービス、設定の構文など、原因は異なる場合があります。問題を報告する際は、必要なフィールドだけを抜き出し、発生手順と関連ログを添えてください。ノード情報、サブスクリプションURL、ログに含まれる個人情報は事前に削除しましょう。

コアの変遷:Clash.MetaからMihomoへ

Mihomoは、Clash.Metaから発展を引き継いだプロジェクト名です。公開リポジトリはMetaCubeXのもとで管理され、ライセンスにはGPL-3.0を採用しています。対応するクライアントは、ユーザーが選んだ設定をコアに渡し、コアが待ち受け、ルール判定、接続転送を担います。クライアントが画面上の設定を最終的な設定に統合する場合もあるため、読み込んだファイルとコアが実際に読み込む内容が完全に一致するとは限りません。

設定項目が反映されているか確認するには、保存した設定とクライアントが表示する有効な設定を比べてから、コアのログを確認してください。ボタンの名前だけで内部の状態を判断しないようにしましょう。たとえば、システムプロキシが有効でも、TUNが有効とは限りません。それぞれ通信の入口が異なります。

クライアント、コア、サブスクリプションを個別に確認

アプリのアップデートで更新されるのはクライアント本体です。コアもインストーラーと一緒に更新されるかどうかは、プロジェクトによって異なります。サブスクリプションの更新では設定内容が変わり、ルールセットには別の更新間隔が設けられている場合もあります。画面上ではどれも「更新」と表示されがちですが、更新対象はそれぞれ異なります。問題が起きたら、直前にどれを更新したかを記録し、該当するプロジェクトの変更履歴を確認しましょう。

変更前に、以前正常に使えていた設定のコピーを残し、変更後はまず以前通っていたリクエストを再テストしましょう。サブスクリプションの更新直後に問題が起きた場合は、プロキシグループやルールの参照先が変わっていないか確認します。アプリのアップデート後に発生した場合は、OSの権限と起動ログを確認してください。接続を一度復旧させるために、サブスクリプションの更新、設定の上書き、コアの入れ替えを同時に行うのは避けましょう。

Mihomoのソースコードを見る

MetaCubeX/mihomoリポジトリでは、ソースコード、ライセンス、リリース履歴を確認できます。以下のコマンドを実行するにはGitのインストールが必要です。現在のディレクトリ内にある mihomo サブディレクトリへソースコードを取得するだけで、クライアントのインストールやシステムプロキシの変更は行いません。実行可能なプログラムが必要な場合は、ダウンロードページでOSに合ったパッケージを選んでください。

git clone https://github.com/MetaCubeX/mihomo.git

127.0.0.1 / トラブル対処

Clashのインストール・トラブル対処記事

トラブル対処の記事は症状ごとにまとめています。アプリが開かない場合は起動ログを、起動しても通信がない場合はアプリとローカルポートの接続を確認しましょう。特定のアプリだけ接続できない場合は、そのアプリのプロキシ設定から調べます。現在の症状に近い記事を選んでください。

トラブル対処

Clashクライアントが起動直後に落ちる場合の対処法:設定構文、ポート競合、コアファイルを確認

起動直後のクラッシュは、YAMLの構文エラー、ポートの競合、コアファイルの不足が主な原因です。ログを手がかりに、起動できる状態へ段階的に戻します。

メイン画面が表示される前にアプリが終了する場合に役立ちます。設定の読み込み前後のどちらで終了したかを切り分け、設定のバックアップへの復元、ポートの空き確保、インストールの修復から適切な対処を選びましょう。

プラットフォーム別ガイド

Windows版Clashのインストールと初期設定:ファイアウォール、UAC、TUNモードの注意点

インストーラーの選択から管理者権限、ファイアウォールの許可、TUNの有効化まで、Windowsでの設定手順とつまずきやすい点を解説します。

OSの権限確認やサービスのインストールで止まっている方におすすめです。どの手順で権限が必要かを確認し、通常どおり許可するか、システムプロキシのみを使う設定に戻すか判断できます。

トラブル対処

Clashのシステムプロキシを有効にしても反映されない:ブラウザーとターミナルを個別に確認

ブラウザー拡張機能によるプロキシ設定の競合、ターミナルがシステムプロキシを使わない問題、環境変数の不足はよくある原因です。ブラウザーとターミナルの両方から順に切り分けます。

ブラウザーとコマンドラインで結果が異なる場合に役立ちます。両方のアプリが同じローカルポートを使っているかを確認し、問題がアプリ側の入口にあるのか、ルールの振り分けにあるのかを判断しましょう。

すべての記事を見る →