設定元から通信の制御まで、項目ごとに確認できます。タブをクリックすると自動切り替えが停止します。
サブスクリプションURLから設定ファイルを取得します。クライアントをインストールしただけでは、利用可能なプロキシは自動で用意されません。「サブスクリプション」または「設定」を開き、サービス提供元から受け取ったURL全体を貼り付けて「インポート」を選択します。ダウンロード後、その設定を現在の設定として選び、「プロキシ」画面でプロキシグループが表示されていることを確認してください。更新で取得し直されるのは設定元の内容であり、サービスの停止が自動修復されるわけではありません。ルールを調整する場合は、更新時に変更が上書きされないよう、設定ファイルを直接編集せずクライアントのオーバーライド機能を使いましょう。URLに含まれるトークンは認証情報です。画面を共有したり問い合わせたりする際は、必ず隠してください。
# クライアント設定の例
サブスクリプション → 新規作成 → リモートURL
インポート完了 → 現在の設定として選択
自動更新 → 提供元の推奨設定に合わせるルールモードでは上から順に照合し、最初に一致したルールで接続先が決まります。特定のサイトにはドメインサフィックスルール、複数の対象の管理にはルールセットが適しています。末尾のMATCHは、ほかのルールに一致しなかった接続を処理します。ルールで参照するプロキシグループ名は設定内の名前と完全に一致させてください。一致しない場合、設定を読み込めないことがあります。変更後は設定を再読み込みし、「接続」画面で一致したルールと接続先を確認します。グローバルモードでは通常のルール選択を経由しないため、ドメインルールの動作確認には適しません。アプリごとにプロキシを単純にオン・オフする方法と異なり、ルール分岐では接続先ごとに異なる経路を指定できます。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,自動選択
# 自動選択は proxy-groups で定義する必要がありますプロキシグループを使うと、複数の接続先をまとめてルールから参照できます。selectは手動選択、url-testは接続テストの結果に基づく選択、fallbackは並び順に従った接続先の切り替えに使います。自動選択は通信を束ねて高速化する機能ではなく、すべてのサイトで同じ結果になるとも限りません。intervalは切り替えの速さとテスト通信の量を考慮して設定します。toleranceに対応するグループでは、小さな速度変動による切り替えを抑えられます。まずグループ内の接続先が存在することを確認し、ログでテスト結果を見ましょう。サイトに接続できない場合は、グループの種類を何度も変えるのではなく、ルール分岐とDNSを確認してください。
proxy-groups:
- name: 自動選択
type: url-test
proxies:
- サンプルのプロキシ
url: https://www.gstatic.com/generate_204
interval: 300
tolerance: 50システムプロキシが使われるのは、システムのプロキシ設定を参照するアプリが中心です。ターミナルや一部のプログラムでは反映されません。TUNモードは仮想ネットワークインターフェース経由で通信を制御するため、そうしたアプリの接続にも利用できますが、必要な権限やルーティング設定が求められます。有効にする前に通常のプロキシ接続が使えることを確認し、クライアントのサービスモードと権限も確認してください。VPN、仮想ネットワークアダプター、通信フィルターなどを併用している場合は、ルーティングの競合を一つずつ切り分けます。有効にしたら同じ接続先で再テストし、接続履歴も確認しましょう。通信できなくなった場合は、まずTUNをオフにして元の状態に戻してください。DNS、ルーティング、ルールを一度に変更するのは避けましょう。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
# 設定例です。全体設定とシステム権限に合わせてくださいクライアントはサブスクリプション管理、トレイメニュー、システムプロキシ、権限の操作を担い、コアは設定を解析して接続を処理します。同じ系統のコアを使っていても、クライアントによってメニュー名、オーバーライド方法、サービスのインストール手順は異なります。選ぶ際は、まずOS、プロセッサーアーキテクチャ、メンテナンス状況を確認し、そのうえで画面の使いやすさを比べてください。名前が似ているからといって、インストールパッケージを使い回すのは避けましょう。別の端末へ移行する場合、サブスクリプションの設定元は引き継げますが、ローカルポート、ファイルパス、TUN設定は確認し直す必要があります。モバイル端末ではVPN権限やバックグラウンド制限の影響も受けます。デスクトップ設定に含まれるローカルスクリプトやパスは、そのまま流用できません。
インストールパッケージの選び方：
OS → プロセッサーアーキテクチャ → システム要件
移行後の確認：
現在の設定 / プロキシモード / ローカルポート / システム権限まずOSとプロセッサーアーキテクチャを確認し、ダウンロードページでクライアントとインストールパッケージを選びましょう。
同じサブスクリプションを、設定形式に対応した複数のクライアントで利用できます。ただし、インストールパッケージは異なるOSでは使えません。デスクトップでは端末のアーキテクチャとシステム要件を、モバイルではシステムの権限と設定形式を確認してください。下のリンクから各OSのダウンロードページを開けます。対応クライアント、メンテナンス状況、インストール方法はダウンロードページにまとめています。トップページに個別のファイルを重複掲載せず、クライアント選びとファイル選びを分けています。
トレイからの管理、自動起動、システムプロキシを使うデスクトップ環境に適しています。まずClash Plusを検討するか、Clash Verge Revなどの機能やシステム要件と比較してください。
インストール前に「設定 → システム → システム情報」でOSの種類を確認してください。初回起動後は設定をインポートしてからシステムプロキシを有効にします。システムプロキシを使わないアプリの通信も制御したい場合は、ガイドに従ってサービスをインストールし、TUNを試してください。OSの警告でインストールが止められた場合は、配布元と警告内容を確認し、セキュリティ機能全体を無効にしないでください。
ダウンロードページへApple SiliconまたはIntelに対応するインストールパッケージを選び、メニューバーでの操作、サブスクリプション管理、サービスの権限設定を比較してください。Clash PlusやClash Verge Revなどのダウンロードリンクは、ダウンロードページにまとめています。
「このMacについて」でチップの種類を確認できます。インストール後はアプリを「アプリケーション」に移動し、画面の案内に従ってネットワークやサービスの権限を許可してください。システムプロキシとTUNは異なる通信制御方法です。初めて使う場合は、両方を同時に有効にする必要はありません。以前の設定を移行する際は、ローカルのパスやポートを確認し、別の端末の環境設定まで持ち込まないようにしましょう。
ダウンロードページへシステムのVPN機能を通じてアプリの通信を制御できます。ダウンロードページにはClash Plus、Clash Meta for Android、FlClash、Surfboardへのリンクがあります。設定の互換性は各クライアントの対応状況をご確認ください。
まず端末のアーキテクチャを確認してください。不明な場合はシステム情報またはダウンロードページの説明を参照します。サブスクリプションをインポートして現在の設定を選び、開始をタップしてVPN接続の要求を許可します。バックグラウンドに移った後で接続が切れる場合は、バッテリー最適化とバックグラウンド実行の制限を確認してください。ほかのVPN接続を使っている場合は、いったん停止してから現在のクライアントをテストし、サブスクリプションの問題と取り違えないようにしましょう。
ダウンロードページへClash PlusはApp Storeからインストールできます。公式サイトはclashplus.ioです。まずダウンロードページからストアの詳細を開き、端末の対応要件を確認してから、アプリ内の設定画面でサブスクリプションをインポートしてください。
初回接続時にVPN構成の追加を許可する必要があります。接続後は利用したいアプリに戻り、実際にアクセスできるか確認してください。VPNのアイコンが表示されても、トンネルが有効になったことを示すだけで、すべてのルールや接続先が使えるとは限りません。ほかのネットワークツールを使っている場合は、現在有効なVPN構成を確認してください。サブスクリプション形式のエラーが出た場合は、提供元がアプリに対応しているか確認しましょう。デスクトップ専用の設定を汎用ファイルとして使わないでください。
ダウンロードページへデスクトップではClash Verge RevとFlClashを比較し、ディストリビューションに対応するパッケージを選びましょう。サーバー、ルーター、バイパスルーターで使う場合は、デスクトップ向けのインストール手順ではなく、mihomoコアの導入資料を参照してください。
インストール前にディストリビューション、プロセッサーアーキテクチャ、デスクトップ環境を確認してください。デスクトップ環境のシステムプロキシは、すべてのターミナルプログラムに自動で適用されるわけではありません。コマンドラインアプリではプロキシ環境変数を個別に設定するか、ルーティングへの影響を理解したうえでTUNを利用してください。コアを直接実行する場合は、設定ディレクトリ、サービス権限、起動管理も必要です。リモートでネットワークを変更する前に、現在の接続を維持し、サービスを停止して戻す手段を用意してください。
ダウンロードページへプロジェクト、クライアント、設定の提供元を区別すると、更新やトラブルの対象を特定しやすくなります。
Clashは当初、ルールベースのプロキシコアとして開発され、その後、デスクトップやモバイル向けのクライアントが複数登場しました。元のプロジェクトのメンテナンス終了後も、コミュニティでは設定形式との互換性を保ちながら、さまざまな実装が開発されています。Clash Metaはその過程で広く使われた名称で、mihomoは現在の関連コアプロジェクト名です。古いガイドを検索すると複数の名称が出てくることがあります。内容が使えるかどうかは、記事のタイトルだけでなく、実際に使っているコアに照らして判断してください。
Clashダウンロードセンターでは、クライアントへのリンク、日本語ガイド、トラブル対処情報をまとめています。異なるプロジェクトのメンテナーを同一チームとして扱うものではありません。名前が似たクライアントでも、リリース時期や機能が共通とは限りません。ダウンロード前に各プロジェクトのシステム要件を確認してください。過去のガイドを読む際は、まず共通する概念を把握し、メニュー、設定項目、権限の手順が現在の画面にも当てはまるか確認しましょう。
mihomoのソースコード、リリースノート、課題の議論は公開リポジトリで確認できます。特定の設定項目がサポートされているか、動作変更の理由を調べる際は、伝聞よりもプロジェクトのドキュメントや該当リリースの説明が参考になります。公開コードはコミュニティによる実装の確認や修正にも役立ちますが、各GUIクライアントには独自の設定管理機能があります。トラブルを報告する際は、クライアント名、使用中のコア、問題が起きた具体的な操作も記録し、画面上の問題をコアのプロジェクトに誤って報告しないようにしましょう。
以下のコマンドはmihomoのソースコードを取得するもので、実装の確認や開発への参加に適しています。通常の利用であれば、GUIクライアントを選ぶだけでよく、リポジトリをクローンする必要はありません。クローンしただけでは実行可能なプログラムはインストールされません。ビルド方法、依存関係、実行方法はプロジェクトの説明に従ってください。
コアはプロトコル、ルール、DNS、接続を処理し、クライアントはサブスクリプションのインポート、モード切り替え、システム連携を提供します。サブスクリプションの提供元は、実際の設定と接続先の情報を配信します。それぞれ更新元も担当範囲も異なります。URLをインポートできない場合は提供元とネットワークを、設定を解析できない場合は形式と項目を確認してください。特定のアプリだけプロキシを経由しない場合は、まず通信の制御方法を確認します。問題を段階ごとに切り分けるほうが、クライアントを何度も再インストールするより原因を見つけやすくなります。
設定内のプロキシ名やプロキシグループ名は参照先の名前であり、固定の機能ボタンではありません。サブスクリプションを変更すると、グループ名やルールも変わることがあります。古い名前を参照するオーバーライドを残すと、設定の読み込みに失敗したり、ルールの接続先が誤ったりする原因になります。移行前に現在使える設定を保存し、移行後は現在の設定、モード、既定のプロキシグループを順に確認してから、目的の接続先をテストしてください。
クライアント、コア、サブスクリプションの更新はそれぞれ別のものです。クライアントの更新でメニューやサービスのインストール方法が変わることがあり、コアの更新では設定項目の追加や処理の変更が行われる場合があります。サブスクリプションの更新では提供元の設定内容が置き換わります。問題が発生したら、直前にどの部分を変更したかを記録し、すべてのコンポーネントを同時に更新しないでください。説明を確認してから更新を実行し、差分を比較できるよう既存の設定とオーバーライドを保存しておきましょう。
接続確認は、再現しやすい対象から順に行います。まず端末のネットワーク、次に設定の読み込み、最後に接続履歴のルールと接続先を確認してください。TUNを有効にして問題が起きた場合は、いったんオフにして再テストします。クライアントを終了しても接続できない場合は、システムプロキシの設定が残っていないか確認してください。ログを共有する際は、サブスクリプションURL、認証情報、個人を特定できるネットワーク情報を削除し、必要なエラー前後の情報だけ残してください。
公開リポジトリ：MetaCubeX / mihomo ↗
git clone https://github.com/MetaCubeX/mihomo.gitルールの書き方、アプリのプロキシ設定、プロキシグループの選び方を、目的に合わせて詳しく解説します。
ルールの照合順序を解説し、日本国内の接続を直接接続、海外への接続をプロキシ経由にする一般的な設定例と、rule-providersを使ったルールセットの参照・更新方法を紹介します。
記事を読む →ブラウザー拡張機能によるプロキシ設定の上書きと、ターミナルがシステムプロキシを参照しない問題は、よくある原因です。確認手順、環境変数の設定例、TUNモードによる代替方法をそれぞれ解説します。
記事を読む →3種類の自動プロキシグループについて、接続先の選び方や測定間隔interval、toleranceの意味を解説し、利用シーンごとの設定例を比較します。
記事を読む →