設定ガイド / Configuration
クライアントの画面は操作を担当し、コアは接続処理を担当します。まず通信がクライアントに取り込まれているかを確認し、次にどのルールに一致したかを調べましょう。2つを分けて確認すると、モードを何度も切り替えるより原因を特定しやすくなります。
初めて使うときは、設定ファイルから準備します。クライアントをインストールしただけではプロキシ接続を利用できず、通常はサブスクリプションURLを別途用意する必要があります。追加したら、設定が選択されているか、プロキシグループが存在するかを確認し、アプリの用途に応じてシステムプロキシやTUNを有効にします。以下の設定例は項目どうしの関係を説明するもので、プロキシサーバーは含まれておらず、利用可能なサブスクリプションの代わりにはなりません。
ルールモードでは、設定ファイルに記載された順に接続を照合し、最初に一致したルールで接続先が決まります。ドメインのサフィックス、宛先アドレス、最後に適用するルールにはそれぞれ用途があり、具体的なルールを広範囲なルールより先に置きます。クライアントの「プロキシ」または「設定」でルールモードを選び、「接続」で適用されたルールを確認してください。グローバルモードと異なり、ルールモードでは直接接続とプロキシ接続を併用でき、すべてのリクエストを同じ接続先に通す必要はありません。例ではすべて直接接続を指定しており、構文のみを示しています。ポリシー名を置き換える前に、設定ファイルに該当するプロキシグループがあることを確認してください。
対象：Clashのルール構文に対応するデスクトップ・モバイルクライアント。
Clash# 具体的なドメインのルールを先に、フォールバックルールを後に記述
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- GEOIP,CN,DIRECT
- MATCH,DIRECT
# DIRECT：直接接続
# REJECT：接続を拒否
# GEOIPを使うには、対応する地理データが必要TUNモードは仮想ネットワークアダプターとルーティング設定を使って通信を取り込み、システムプロキシを参照しないアプリにも適しています。デスクトップでは通常、サービスのインストールまたは管理者権限の付与が必要です。その後「設定」でTUNを有効にします。モバイルでは、一般にシステムのVPN許可を受けて通信を取り込みます。TUNとルールモードは二者択一ではありません。前者は通信をコアに取り込む方法、後者は取り込んだ通信の接続先を決めます。ほかのVPN、仮想ネットワークアダプター、企業ネットワークのポリシーを使っている場合は、先に現在の設定を記録してください。問題が起きたら、スイッチの状態だけで判断せず、ルーティングとDNSを確認しましょう。
対象：TUNと必要な権限に対応するクライアント。使用できる項目は実際のコアにより異なります。
# mihomo TUN設定例
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
# DNSのリダイレクトには、コア側のDNS設定も必要
# 有効にする前に、ほかのVPNや仮想ネットワークアダプターを確認
# クライアントの画面設定でこれらの項目が上書きされる場合がありますサブスクリプションの設定全体には、プロキシ、プロキシグループ、ルールをまとめて含められます。一方、プロキシプロバイダーは既存の設定にプロキシ項目を提供します。初回の追加では通常、「設定」からリモートサブスクリプションを新規作成します。保存後にその設定を選択し、更新が成功したか確認してください。定期更新ではリモートの内容を再取得します。ダウンロードしたファイルを直接編集すると、次回の更新で上書きされることがあるため、継続的な変更にはクライアントの上書き・マージ機能を使いましょう。右側の例はローカルプロバイダーの構文で、ファイル間の関係を示しています。ファイルパスはコアの作業ディレクトリからの相対パスであり、任意のシステムディレクトリを指すものではありません。
対象：リモート設定の管理方法はクライアントにより異なります。プロバイダーの例はmihomo向けです。
# ローカルファイルにはproxiesリストが必要
proxy-providers:
local:
type: file
path: ./providers/local.yaml
proxy-groups:
- name: 手動選択
type: select
use:
- local
# 公開スクリーンショットやログにサブスクリプションURLを載せないClash、Clash Premium、mihomoでは、設定できる機能やメンテナンス状況が異なります。画面上の名称が似ていても、同じ項目に対応しているとは限りません。mihomoはClash Metaの設定体系を引き継いでおり、現在多くのクライアントで接続処理に使われています。コアを切り替えられるクライアントは一部で、ほかはコアが固定で組み込まれているため、同じ手順を適用できません。未知の項目や未対応のプロトコルがある場合は、まずログでクライアントが使用中のコアを確認し、設定ドキュメントと照らし合わせてください。実行ファイルだけを入れ替えるとクライアントのインターフェースと互換性がなくなる可能性があるため、製品が提供する更新方法を優先してください。
対象：コアの選択と設定の移行。すべてのクライアントでコアを切り替えられるわけではありません。
| 名称 | 確認するポイント |
|---|---|
| Clash | 元の設定体系と基本的なルール構文 |
| Clash Premium | 過去の設定で使われていた独自の拡張項目 |
| mihomo | Clash Metaの後継プロジェクト。現在のドキュメントで項目の対応状況を確認 |
互換性のある設定ファイルは複数のプラットフォームで再利用できますが、待ち受けポート、ファイルパス、システム権限は個別に確認が必要です。デスクトップではまずシステムプロキシを確認し、必要に応じてTUNを有効にします。モバイルでは先にVPNの許可を完了してください。移行時に古い端末の絶対パスをそのままコピーしたり、すべてのクライアントが同じ形式のサブスクリプションを読み込めると思い込んだりしないでください。移行先の製品が受け付ける形式を確認してから追加・選択し、プロキシグループを確認します。最初の接続を確認した後に、起動時の自動実行やバックグラウンド動作を設定すると、設定ファイルの問題とシステム上の制限を切り分けやすくなります。
対象：5つのプラットフォーム間での設定移行。詳しいインストール手順は全プラットフォームガイドをご覧ください。
| プラットフォーム | システム設定の確認場所 |
|---|---|
| Windows | 設定 → ネットワークとインターネット → プロキシ |
| macOS | システム設定 → ネットワーク → 現在のネットワーク → 詳細 → プロキシ |
| Android | システム設定のVPNとバッテリー管理 |
| iOS | 設定 → 一般 → VPNとデバイス管理 |
| Linux | デスクトップのプロキシ設定、サービス権限、ターミナルの環境変数 |
ダウンロード / Platforms
まずOSとプロセッサーのアーキテクチャを確認し、画面構成、設定の対応状況、必要な権限を比べましょう。ダウンロードセンターにはインストーラーとシステム要件をまとめています。このページのプラットフォーム別リンクから各カテゴリへ直接移動できます。
Clash Plus、Clash Verge Rev、FlClashなどのデスクトップクライアントから選べます。新規に導入する場合は、現在もメンテナンスされている製品を優先しましょう。Clash for Windowsはアーカイブ情報として掲載しています。既存の設定は移行できますが、古いクライアントの拡張スクリプト、サービス設定、絶対パスをそのまま引き継ぐのは避けてください。
インストール後、まず設定を追加してシステムプロキシを有効にします。ブラウザーではアクセスできるのにターミナルからアクセスできない場合は、すぐにクライアントを再インストールせず、ターミナルの環境変数を確認してください。TUNが必要なアプリでは、サービス権限と仮想ネットワークアダプターも個別に確認します。
ダウンロードへ →Apple SiliconとIntelでは対応するインストーラーが異なります。「このMacについて」でチップ情報を確認してください。Clash Plus、Clash Verge Rev、FlClashはデスクトップ用の操作画面を備えています。ClashX Metaはメンテナンスが終了しているため、移行前に元の設定を複製しておきましょう。
初回起動時は、システムのセキュリティ警告とネットワーク権限を確認してください。システムプロキシは通常、現在のネットワークサービスに適用されます。有線・無線ネットワークを切り替えた後は再確認が必要です。TUNにはクライアントに応じたサービスや権限が必要で、ブラウザーの設定変更だけでは利用できません。
ダウンロードへ →Clash Plus、Clash Meta for Android、FlClash、Surfboardを比較できます。製品によって対応する設定形式は異なります。サブスクリプションに対応していても、すべてのClash設定項目を使えるとは限りません。インストーラーのアーキテクチャは端末に合わせて選び、不明な場合はダウンロードページの選び方を確認してください。
初回接続時は、システムのVPN許可を確認してください。画面ロック後に接続が切れる場合は、バッテリー最適化とバックグラウンド動作の制限を確認します。ほかのVPNも使っている場合は、システムで現在有効になっているサービスを確認してから、設定ファイルに問題があるか判断してください。
ダウンロードへ →App StoreからClash Plusを入手できます。製品情報はclashplus.ioをご覧ください。設定を追加する前に、クライアントが対応する形式を確認してください。リンクとローカルファイルの読み込み方法は製品の画面で確認し、拡張子だけで内容の互換性を判断しないようにしましょう。
設定を保存したらVPNの権限を許可し、接続先のポリシーを選んで接続します。Wi-Fiとモバイル通信ではアクセス権限が異なる場合があるため、それぞれ確認してください。問題を調べる際は、まず設定が選択されていることを確認してから接続状態を見ましょう。特定のサイトだけの問題を、クライアント全体の不具合と判断しないようにしてください。
ダウンロードへ →デスクトップ環境ではClash Verge RevまたはFlClashを選べます。サーバーやルーターなどでは、mihomoコアを直接実行する方法も検討できます。ディストリビューションのパッケージ形式とプロセッサーのアーキテクチャを確認してください。デスクトップ用インストーラーが、すべての端末で使えるわけではありません。
ターミナルのプログラムは、通常デスクトップのシステムプロキシを自動では参照しません。プログラムの仕様に応じてプロキシ環境変数を設定するか、必要な権限を設定したTUNを使います。リモート管理時は、デフォルトルートやDNSを変更する前に、復旧可能な接続経路を確保してください。設定が途切れると、管理セッションが切断されるおそれがあります。
ダウンロードへ →オープンソース情報 / Source
Clashはエコシステムの名称であり、すべてのプラットフォームで共通して使える単一のインストーラーではありません。ドキュメントを読むときは、クライアント名、使用中のコア、設定ファイルの入手元をあわせて確認してください。特定の製品の操作手順を、共通の入口として扱わないようにしましょう。
デスクトップとモバイルのOSに対応しています。インストール方法、システム権限、バックグラウンド動作の制限はそれぞれ異なるため、接続の動作は実際の端末で確認してください。
mihomoプロジェクトはソースコードとライセンス文を公開しています。このライセンスはコアプロジェクトについて定めたもので、各クライアントやストアで配布される製品のライセンスを示すものではありません。
プロキシ、プロキシグループ、ルールは1つのメイン設定にまとめることも、外部のルールセットやプロバイダーを参照することもできます。インデントと項目の対応状況も重要です。
初期のClashクライアントでは、YAMLでプロキシと振り分けルールを記述する方法が広まりました。元のプロジェクトのメンテナンス状況が変化した後も、コミュニティ製クライアントや後継コアの開発は続いています。そのため、古いガイドにあるボタン名、ダウンロード先、拡張項目が現在の環境に合わないことがあります。移行時は設定の基本構成を引き継ぎつつ、コアが対応する項目を再確認してください。特にDNS、TUN、外部リソースのパスに注意が必要です。過去の設定を読み込めても、それは解析に成功したことを示すだけで、元の環境とすべて同じ動作になるとは限りません。
クライアントは通常、設定のダウンロード、ポリシーの選択、トレイメニュー、システムサービスを担当し、コアはポートの待ち受け、ルールの照合、接続処理を担当します。画面のスイッチによって起動前に設定ファイルが生成されたり、実行中に制御インターフェース経由で設定が変更されたりすることがあります。そのため、サブスクリプションのファイルを編集した後、画面の表示と実際の値が一時的に異なる場合があります。トラブル時は、選択中の設定、実行ログ、接続の詳細を先に確認し、上書き設定が有効か調べてください。サブスクリプション、画面上のポート、システムプロキシを同時に変更すると、どの変更が結果に影響したのか分かりにくくなります。
クライアント、コア、サブスクリプション、ルールの更新は、それぞれ別の操作です。クライアントを更新しても期限切れのサブスクリプションが自動修復されるわけではなく、サブスクリプションを再取得しても古いコアが新しい項目に対応するわけではありません。メンテナンスの前にローカルの上書き設定とカスタムルールを保存し、製品のリリースノートを確認してから、一度に1つの層だけを更新してください。更新後は同じアプリと接続先で再テストし、結果の違いを記録します。元に戻す必要がある場合、設定のバックアップがあればスイッチの状態を記憶に頼って復元せずに済みます。サブスクリプションURLにはアクセス情報が含まれる場合があるため、公開の場やスクリーンショットに載せないでください。
オープンソースのリポジトリでは、項目の定義、ライセンス、既知の問題を確認できますが、あらゆるクライアントのインストーラーをダウンロードするための代替先ではありません。mihomoのリポジトリにはコアの変更が記録されています。画面のボタンが反応しない、サービスのインストールに失敗するといった問題は、まず対象のクライアントを特定してください。不具合を報告する際は、OS、アーキテクチャ、再現手順、個人情報を除いたログを添えて、サブスクリプションURL、プロキシの認証情報、外部コントローラーのキーは削除します。特定のアプリだけが通信できない場合は、接続失敗とだけ書かず、システムプロキシやTUNで通信を取り込んでいるかも説明してください。
git clone https://github.com/MetaCubeX/mihomo.gitこのコマンドでコアのソースコードを取得できます。実行前にGitをインストールしてください。
まず現在の設定を正常に読み込めることを確認し、次に対象アプリの通信がクライアントに取り込まれているかを調べ、最後にルールと接続先のポリシーを確認します。システムプロキシが有効なのに接続記録が表示されない場合は、アプリがシステムプロキシを参照しているかを先に確認してください。記録はあるのに接続先へ到達できない場合は、一致したルール、ドメインの名前解決、選択中の接続先を調べます。遅延テストの結果は、テスト対象と方法に左右されます。ウェブページ、ターミナル、ほかのアプリがすべて正常に使えることの証明にはなりません。問題を段階ごとに調べることで、権限・設定・ネットワークの問題を混同せずに済みます。
操作の全体像を確認するには、サブスクリプションの追加と初回接続ガイドから始めてください。設定の読み込みや接続で問題が起きた場合は、よくある質問とトラブルシューティングをご覧ください。インストール、システム権限、プラットフォーム固有の設定は全プラットフォームガイドにまとめています。端末ごとに順番に確認できます。
設定・トラブル解決の記事 / Articles
iPhoneでの設定の追加、サブスクリプションの解析エラー、混合ポートや通信モードの基本を、具体的な疑問に沿って解説します。該当する手順を確認してから、クライアント上で設定を確かめてください。
iOSでClash設定に対応するクライアントをApp Storeから入手する方法と、リンク・ファイル・QRコードを使ったサブスクリプションの追加方法を解説。VPNの許可やバックグラウンド動作の設定も紹介します。
記事を読む →サブスクリプションURLの期限切れ、応答形式の不一致、YAMLのインデントミス、コアの項目未対応を、外側から順に切り分けます。ログに表示されるエラーの意味も解説します。
記事を読む →初心者がつまずきやすい10の疑問にまとめて回答します。クライアントとコアの関係、ルールモードとグローバルモードの違い、7890ポートの役割、サブスクリプションの更新頻度など、設定場所もあわせて紹介します。
記事を読む →