オープンソース · 全プラットフォーム向けクライアント

Clash リリースページ:全プラットフォーム対応クライアントと設定ガイド

プラットフォームに合ったクライアントを選び、サブスクリプションのインポートルールによる振り分けTUNモードから設定を始めましょう。ダウンロード先、基本概念、トラブル対応をまとめて確認できます。

完全無料 オープンソース 日本語ドキュメント ルールとサブスクリプション解説

プロキシの管理方法

分散した設定から統合クライアント

プロキシツールで難しいのは、インストーラーそのものよりも、設定、モード、システムへの適用、トラブル対応の情報が分散していることです。まず操作の順序を整理しておくと、クライアントの変更や設定の移行もスムーズになります。

利用を中断しやすいポイント

  • ダウンロード先とプラットフォームの種類が混在している

    Windowsのインストーラー、macOSのチップアーキテクチャ、Androidのインストール形式はそれぞれ異なります。ファイル名だけでは、どれを選ぶべきかすぐに判断しにくい場合があります。

  • サブスクリプションをインポートしてもポリシーを選んでいない

    設定がクライアントに読み込まれていても、プロキシグループがデフォルトのままだと、実際の通信経路が想定と異なることがあります。

  • システムプロキシとTUNモードを同時に使う

    2つの方式は通信を取り込む階層が異なります。目的が明確でないまま同時に有効にすると、問題の原因を切り分けにくくなります。

  • 障害発生後にクライアントを何度も再インストールする

    ポートの競合、設定構文、権限、DNSなどが接続不良の原因になるため、クライアントを再インストールしても解決しないことがあります。

より確実な対応手順

  • まずOSに合わせてダウンロードページを開く

    プラットフォームのタブから対応するクライアント一覧を開き、デバイスのアーキテクチャ、GUIの必要性、メンテナンス状況を確認してインストーラーを選びます。

  • 設定を更新してからプロキシグループを確認する

    サブスクリプションの更新日時と設定状態を確認し、プロキシ画面で自動選択、手動ノード、DIRECTなどのポリシーを選びます。

  • 対象アプリの範囲に合わせて通信の取り込み方式を選ぶ

    ブラウザーなどシステム設定に従うアプリは、まずシステムプロキシを使うのが適しています。より広い範囲の通信を対象にする場合は、TUNを個別に確認して有効にします。

  • ログと設定の検証から切り分ける

    まずエラーのキーワードを確認し、ポート、設定、権限、ネットワーク環境を調べることで、原因特定にかかる時間を短縮できます。

基本設定への道筋

よく使う3つの操作を順番に確認

以下では、ルールモード、サブスクリプション更新、ログによるトラブル対応に分けて説明します。各項目はクライアントにある実際の設定に対応しており、マウス、タッチ操作、キーボードの方向キーで切り替えられます。

MODE / RULE

ルールモードとプロキシグループの役割

ルールモードでは、設定ファイルのドメイン、IP、プロセス、ルールセットなどに基づいて通信を順番に照合し、該当するプロキシグループへ渡します。「グローバル」モードが通常1つのポリシーに通信をまとめて渡すのに対し、ルールモードではDIRECT、プロキシ、ブロックなど複数の経路を併用できます。実際に使う際は、まずクライアント上部のモードが「ルール」になっていることを確認し、プロキシ画面で各グループの選択状態を確認してください。

プロキシグループは、ノード一覧の別名ではありません。ノードは具体的な接続を確立し、プロキシグループは手動選択、自動選択、フォールバックなどの選択ロジックを管理します。サブスクリプションをインポートした後も、プロキシグループが目的に合っているか確認が必要です。フィールドの関係、ルールの順序、マッチング方法については設定ファイル完全リファレンスも参照してください。

動作モード ルール
プロキシグループ 自動選択
未照合の通信 MATCH

システムプロキシは小さな範囲から使う

システムプロキシは、アプリがOSのプロキシ設定を読み取ることで機能します。ブラウザー、ダウンロードツール、多くのデスクトップアプリがこの設定に従うため、初回の接続確認に適しています。特定のアプリがシステムプロキシを無視する場合は、最初から複数のネットワーク設定を変更せず、より広い範囲を取り込む方式を検討します。

TUNモードは通信を取り込む階層に注目する

TUNモードは仮想ネットワークアダプターを通じてIP層で通信を処理し、システムプロキシ設定を読み取らないアプリにも対応できる場合があります。管理者権限、ルーティングテーブル、DNSの動作に関わる可能性があるため、有効にする前に現在の設定を保存し、基本的なプロキシ接続が利用できることを確認してください。詳しくはTUNモードとシステムプロキシの違いを参照してください。

デバイスから選ぶ

Clashクライアントのプラットフォーム一覧

同じ設定を複数のデバイスで使える場合でも、インストール形式、システム権限、操作画面は異なります。まず現在のデバイスに対応するタブを開き、そのプラットフォームで利用できるGUIクライアントを比較してください。

Windows

デスクトップGUI、システムプロキシの切り替え、設定管理が必要なユーザーに適しています。ダウンロード前にOSのアーキテクチャとクライアントのメンテナンス状況を確認してください。旧版のClash for Windowsで不足する場合は、現在も保守されている代替クライアントを比較できます。

ダウンロードへ

macOS

Macのデスクトップ環境でシステムプロキシ、メニューバーの状態、サブスクリプション設定を管理したい場合に適しています。ダウンロードページではApple SiliconとIntelを区別し、対応するインストーラーを選んでください。

ダウンロードへ

Android

スマートフォンやタブレットでのサブスクリプション管理、アプリごとの振り分け、VPN接続に適しています。デバイスによってプロセッサーのアーキテクチャが異なるため、不明な場合は汎用インストール項目を確認し、VPN接続に必要な権限をシステムの指示に従って許可してください。

ダウンロードへ

iOS

iPhoneとiPadでストアからクライアントをインストールし、システムのネットワーク拡張機能で接続を管理したい場合に適しています。ダウンロードページでClash PlusのApp Storeへのリンクと公式情報を確認し、クライアント画面からサブスクリプションをインポートしてください。

ダウンロードへ

Linux

Linuxデスクトップ、開発環境、GUIで設定を管理したいユーザーに適しています。インストール前にディストリビューションのパッケージ形式を確認してください。サーバー、ルーター、自動化環境でコアだけを動かす場合は、ダウンロードページのMihomoコアの項目へ進みます。

ダウンロードへ

オープンソースエコシステムとメンテナンスの範囲

クライアント、コア、設定の関係を理解する

Clashエコシステムは、コア、GUIクライアント、ルールプロジェクト、設定ツールで構成されています。これらの層を区別すると、ソフトウェア名だけを覚えるよりも、選択やトラブル対応がしやすくなります。

プロジェクトの変遷

Clashは当初、ルール駆動型のプロキシコアとして広く使われ、その後、各OS向けのGUIクライアントが登場しました。初期のプロジェクトにはすでに開発が終了したものもありますが、設定構文、プロキシグループ、ルールマッチングなどの基本概念は後続のエコシステムにも受け継がれています。クライアントを選ぶ際は、慣れた旧名称だけで判断せず、メンテナンス状況、採用コア、対応プラットフォームを確認してください。

オープンソースでの協業

コードが公開されているため、開発者は実装を確認し、問題を報告し、プラットフォーム対応を改善できます。また、ルールセット、DNS、透過プロキシ、ユーザーインターフェースを中心に複数のプロジェクトが発展しています。クライアントによって画面や更新頻度が異なり、採用するコアによって基盤機能も変わります。本サイトではクライアントの入口と概念ドキュメントを分けて整理し、目的に応じて確認できるようにしています。

mihomoコア

mihomoは、現在のClashエコシステムで広く使われている継承系コアの一つです。ルールモード、プロキシグループ、DNS設定、TUNなどに対応しています。GUIクライアントは通常、設定管理、システム統合、状態表示を担い、実際の通信マッチングと接続処理はコアが実行します。機能に違いがある場合は、まずクライアントが採用しているコアと、対象の設定フィールドがサポートされているかを確認してください。

更新の仕組み

クライアントの更新、コアの更新、サブスクリプションの更新は別々のものです。クライアント更新ではGUIやシステム統合が変わり、コア更新ではプロトコルや設定機能が変わる可能性があります。サブスクリプション更新では、利用中のノード、ポリシー、ルールが更新されます。異常を切り分ける際は、最近の変更がどの層に属するかを記録すると、設定の問題をインストールの問題と誤認しにくくなります。

mihomoのソースコードを見る git clone https://github.com/MetaCubeX/mihomo.git

資料から実際の操作へ進むおすすめの順序

初めて使うときは、すべての設定フィールドを先に読み終える必要はありません。まずダウンロードページでデバイスに合ったGUIクライアントを選び、はじめにの手順に沿ってサブスクリプションのインポート、ルールモードの選択、システムプロキシの有効化、基本確認を行います。接続できたら、アプリへの適用範囲に応じてTUNが必要か判断し、用語解説でDNS、プロキシグループ、ルールセット、仮想ネットワークアダプターなどの概念を確認してください。

YAMLを変更する場合は、まず正常に読み込める設定のコピーを保存してから、項目を一つずつ調整します。ポート、DNS、プロキシグループ、ルール一覧を同時に変更すると、エラーの原因を特定しにくくなります。1回につき1つのテーマだけを変更し、設定を再読み込みしてログを確認する方法が安全です。コアが構文エラーを示した場合は、直前の動作する内容に戻し、インデント、フィールドの型、参照名を確認してください。

設定とトラブル対応の記事

最近の記事

画面の見方、設定の構造、起動時の障害まで、実際の操作場面に沿って解説します。チュートリアルページでは扱いにくい仕組みやトラブル対応の詳細を補足する記事です。

トラブル対応

Clashクライアントが開かないときの対処法:起動時クラッシュと強制終了の確認手順

起動に失敗する主な原因を発生頻度順に整理します。ポートの競合、設定ファイルの構文エラー、権限不足、コアファイルの異常、システムコンポーネントの不足について、確認方法と対応手順を説明します。

続きを読む →
上級ガイド

Clash設定ファイルの構造を段階的に解説:portからrulesまでYAMLを読み解く

設定全体を共通フィールド、DNS、proxies、proxy-groups、rulesに分けて解説し、フィールド同士の参照関係や、インデント、名前の不一致、ルール順序などのよくある問題を説明します。

続きを読む →
上級ガイド

TUNモードとシステムプロキシの違い:通信を取り込む階層と仕組みを比較

OSのネットワークスタックの観点から2つの方式を比較し、システムプロキシがアプリの対応に依存する理由と、TUNが仮想ネットワークアダプターでより広い通信を取り込む仕組みを説明します。

続きを読む →