Clashエコシステム · 設定ガイド

Clash プロキシクライアント

OSに合ったクライアントを選び、mihomoコアとYAML設定を確認。サブスクの追加からルール分岐の検証まで解説します。

コアのソースコードは公開日本語の設定ガイド

クライアントの設定機能

サブスク全体はクライアントに読み込ませ、プロキシプロバイダーはコアに設定を読み込ませます。

サブスクとプロキシプロバイダー

設定一覧に互換性のあるサブスクURLを貼り付け、ダウンロードと解析が終わったら、現在の設定として選択します。手動入力と異なり、リモートサブスクは更新でき、ノード名の変更が既存の選択に影響する場合もあります。プロキシプロバイダーだけを使う場合は、proxy-providersで読み込み、プロキシグループから参照します。どちらもYAMLを返すURLでも、相互に置き換えられるとは限りません。更新に成功してもノードが表示されない場合は、まず取得した内容の種類を確認し、次にプロキシグループが正しいプロバイダーを参照しているか確認してください。

providers.yaml
proxy-providers:  office:    type: file    path: ./providers/office.yamlproxy-groups:  - name: PROXY    type: select    use: [office]

YAML設定リファレンスを見る →

プラットフォーム別にインストーラーを選択

まずOSで絞り込み、CPUアーキテクチャ、インストール方法、メンテナンス状況を確認してください。旧クライアントから移行する場合は、サブスクまたは設定ファイルを読み込む方法を優先し、新しいクライアントのアプリデータフォルダーを直接上書きしないでください。

Windows

システム情報でデバイスのアーキテクチャを確認します。初めて使う場合は、まずシステムプロキシを有効にし、ブラウザーの接続がログに記録されるか確認してください。システムプロキシを参照しないアプリも接続する場合は、クライアントのTUN対応状況と必要な権限を確認します。古い設定を移行する前に元のアプリを終了し、複数のクライアントが同時にプロキシ設定を書き換えたり、待ち受けポートを取り合ったりしないようにしてください。

ダウンロードページへ

macOS

「このMacについて」でApple SiliconかIntelかを確認し、対応するインストーラーを選びます。プロキシを初めて有効にした後は、システム設定のネットワークで、現在のネットワークサービスに設定が適用されているか確認してください。クライアント終了後もアプリがローカルのプロキシポートに接続しようとする場合は、サブスクを何度も読み込み直すのではなく、システムプロキシ設定が元に戻っているか確認します。

ダウンロードページへ

Android

システムが対応するABIに合ったインストーラーを選びます。CPUが特定の命令セットに対応していても、現在のシステムにそのパッケージをインストールできるとは限りません。初回接続時は、システムの案内に従ってVPNを許可してください。画面ロック後に接続が切れる場合は、通知領域の状態を記録し、アプリのバックグラウンド実行制限や、別のVPNサービスが接続を引き継いでいないか確認します。

ダウンロードページへ

iOS

App StoreでクライアントとOSの互換性要件を確認します。設定を読み込んでVPN構成の追加を許可したら、クライアントに戻り、選択中の設定とプロキシグループを確認してください。ステータスバーにVPN接続中と表示されても目的のアプリが使えない場合は、まずブラウザーで同じ接続先を確認し、次にアプリの接続ログを確認して、トンネルの起動とリクエストの転送を切り分けます。

ダウンロードページへ

Linux

デスクトップ環境では、ディストリビューションに合ったパッケージ形式を選べます。たとえばDebian系にはDEB、対応するディストリビューションにはRPMを使用します。デスクトップ環境のないデバイスでは、コアを単独で実行できますが、設定ディレクトリ、サービスの権限、ログを自分で管理する必要があります。起動後は、システム設定、環境変数、その他の接続方法を通じて、アプリからコアにリクエストが届いていることも確認してください。

ダウンロードページへ

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

初回接続は3ステップ

  1. 設定を読み込んで有効化

    サブスクまたは設定の画面で、提供元から入手した互換性のあるURLを追加します。ローカルのYAMLファイルを選ぶこともできます。ファイルが一覧に表示されたら、現在の設定として選択してください。読み込みに失敗する場合は、取得した内容が設定本文ではなく、ログインページやサービスの案内ページになっていないか確認します。スクリーンショット、ログ、問い合わせにはサブスクURLを載せないでください。

  2. ルールモードを選び、通信を接続

    ルールモードを選び、プロキシグループで使用する出口を確認します。デスクトップではまずシステムプロキシを使い、モバイルでは案内に従ってVPNを許可してください。まず一つの接続方式で動作を確認し、TUNが必要かどうかはその後に判断します。コアが実行中でも、アプリの通信がコアを経由しているとは限りません。両方の状態を個別に確認してください。

  3. 接続ログでルール分岐を確認

    直結する想定の接続先と、プロキシ経由の想定の接続先を一つずつ選び、順にアクセスして接続ログを確認します。対象ドメイン、適用されたルール、最終的な出口を照合してください。ログがない場合は、まずプロキシへの接続設定を確認します。ログがあり出口が違う場合は、ルールの順序を確認してください。適用ルールと出口がどちらも想定どおりの場合に限り、リモート側への接続を調べます。

詳しい使い方を見る →

オープンソースのコアとメンテナンス元

オリジナル版Clashと後継プロジェクト

オリジナル版Clashの設定は、プロキシノード、プロキシグループ、ルールを中心に構成されています。その後、異なるプロジェクトがこの形式を引き継いだり拡張したりしていますが、名前が似ていても配布元やメンテナンス期間が共通とは限りません。古いガイドでは画面上の項目が変わっている場合があります。読む際は、コアの設定項目、クライアントの操作、サブスク提供元の変換ルールのどれを扱っているか確認してください。

画面・コア・サブスクの役割

クライアントは設定管理、システムとの連携、接続状況の表示を担当します。コアは設定の解析、ルール照合、接続の確立を担い、サブスク提供元は配信内容を管理します。同じサブスクでも、クライアントによって結果が異なることがあります。たとえば、一方のクライアントだけがDNSや待ち受け設定を追加している場合があります。問題を調べるときは、サブスクの原文と最終的に適用された設定をそれぞれ保存し、画面上のスイッチだけでなく内容の差分を比較してください。

mihomoと設定項目の互換性

mihomoはClash Metaコアの開発を引き継ぎ、プロキシプロトコル、ルールセット、ネットワークスタックの設定項目を拡張しています。オリジナル版の設定でよく使われる基本項目は移行時の出発点になりますが、同名の項目でも値の範囲や関連する条件は移行先のコアに合わせて確認してください。設定の解析に失敗した場合は、エラーメッセージから最初の該当項目を特定し、設定リファレンスを確認します。用語が分からない場合は、用語集を参照してください。

リリース履歴とアップデート前の備え

クライアントとコアの変更履歴は分けて確認してください。アップデート前に、動作している設定と必要なローカル上書きを保存します。更新後は、まず設定が読み込めることを確認し、次にシステムプロキシ、名前解決の経路、ルールの適用状況を確認してください。再現可能な問題を報告する際は、使用したプラットフォーム、接続方式、最小限の再現用設定を記載し、個人のドメイン名、サブスクのパラメーター、ノードの認証情報は削除します。まず実際に起きたことを説明し、その後に期待する結果を記載すると、問題の切り分けに役立ちます。

mihomoのソースコードを取得

コアはGPL-3.0で公開されています。以下のコマンドはソースコードを取得するためのもので、デスクトップクライアントのインストールには使いません。GUIクライアントをインストールする場合は、インストーラーのページに戻り、OSに合ったものを選んでください。

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

クライアント情報

すべての記事を見る →