設定の取得元から接続先まで、問題に応じて確認できます。
クライアントの設定画面でサブスクリプションURLを貼り付けて読み込み、成功したら使用する設定として選択します。リモート設定の更新ではYAMLを再取得します。プロキシプロバイダーとルールプロバイダーは、それぞれ設定した間隔で更新できます。この3種類の更新は別々に考える必要があります。ローカルファイルはオフラインでのバックアップに便利ですが、通常はリモートの変更が自動反映されません。ダウンロードした設定を直接編集すると、次回の更新で上書きされることがあります。変更を維持するには、クライアントのオーバーライドまたはマージ機能を使いましょう。更新に失敗した場合は、まずURLが有効か確認し、リクエストログとサブスクリプション取得時のネットワーク経路を調べてください。
サブスクリプションの読み込み手順を見る →# 設定ファイルのプロキシプロバイダー設定例
# interval の単位は秒
proxy-providers:
remote:
type: http
url: "https://example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 86400ルールモードでは、設定リストを上から順に照合し、最初に一致したルールのポリシーを適用します。そのため、特定のドメイン向けルールは広範囲に一致するルールより前に、フォールバックルールは末尾に配置します。ルールの振り分け先には、DIRECT、REJECT、定義済みのプロキシグループなどを指定します。任意の文字列は指定できません。グローバルモードと異なり、ルールモードではアプリごとに異なる経路へ振り分けられますが、動作はドメインの識別方法、名前解決の方式、ルールリソースの状態に左右されます。変更後は新しい接続を作成し、接続画面でマッチしたルールを確認してください。Webページが開くかどうかだけで判断するのは避けましょう。サブスクリプションに含まれるルールとローカルのオーバーライドを統合した最終的な順序も確認してください。
ルールとオーバーライドの解説を見る →mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- DOMAIN-SUFFIX,example.org,REJECT
- MATCH,DIRECTルールモードはルールリストに従って通信を振り分けます。グローバルモードでは、コアに届いた接続をグローバルポリシーで処理し、ダイレクトモードでは接続先へ直接アクセスします。これらが決めるのは、接続がコアに入った後の処理方法です。アプリがクライアントを使うかどうかを決めるものではありません。システムプロキシはシステムのプロキシ設定に従うアプリに作用し、TUNは仮想ネットワークインターフェースを通じてより多くの通信を取り込みます。Webページが開かない場合は、まずアプリのリクエストが接続画面に表示されるか確認し、その後でモードとプロキシグループを調べましょう。グローバルモードに何度切り替えても、コアに届いていないリクエストは解決できません。確認後は普段使うルールモードに戻し、一時的な調査設定をそのままにしないようにしてください。
プロキシモードと通信の取り込み方法の違い →# 3つのモードから1つを選んで設定
mode: rule
# システムプロキシとTUNはクライアント内の独立した設定
# グローバルモードは mode: global に対応
# ダイレクトモードは mode: direct に対応ゲームやコマンドラインツール、バックグラウンドサービスの中には、システムプロキシを参照しないものがあります。TUNは仮想ネットワークインターフェースとルーティング設定を使い、こうした通信をコアに取り込めます。有効にする前に、クライアントに必要な権限があること、別のVPNが同時にデフォルトルートを変更していないことを確認してください。自動ルート設定とDNSの取り込みは相互に関係するため、スイッチをオンにしただけですべてのプロトコルが正常に動くとは限りません。アプリにプロキシポートを手動設定する方法よりもTUNは適用範囲が広い一方、ネットワークインターフェース、LANのルーティング、セキュリティソフトの影響を受けやすくなります。まず通常のWeb接続を確認し、その後TUNを有効にして項目ごとにテストしてください。競合が発生したら、通信の取り込みを停止してネットワークを復旧し、ログから原因を特定しましょう。
TUNの設定とトラブル対処の手順を見る →# mihomo の設定例。該当するシステム権限が必要
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53DNSはドメイン名をIPアドレスに変換します。名前解決の経路は、コアがドメインを正しく識別してルールに照合できるかにも影響します。Fake-IPは予約済みアドレスを使ってドメインとの対応付けを行うもので、新しいネットワーク出口を提供する機能ではありません。通信の取り込み方法と組み合わせて使う必要があります。実IPアドレスを返す方式に比べ、Fake-IPはドメインとの関連付けを維持しやすい一方、LAN内のサービスや一部のアプリでは除外設定が必要です。名前解決に問題がある場合は、まずDNSリクエストがコアに届いているか、上流DNSサーバーに接続できるかを確認し、その後でアプリのキャッシュやOSの暗号化DNS設定を調べてください。上流サーバーの変更、モードの切り替え、除外リストの編集を同時に行うと、どの変更が効果をもたらしたのか判断しにくくなります。
DNS設定の解説を見る →dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost"まずOSで絞り込み、次にCPUアーキテクチャとパッケージ形式を確認してください。クライアントは画面表示、OS連携、設定管理を担い、コアはプロトコルの処理とルールの適用を担います。画面が似ていても、対応する設定項目が同じとは限りません。移行前にサブスクリプションの取得元とオーバーライドファイルを保存し、現在使っている設定をそのまま上書きしないようにしましょう。
デスクトップでサブスクリプション、システムプロキシ、スタートアップを管理するのに適しています。Clash PlusやClash Verge Revなどの画面とコアの対応状況を比較し、OSの要件に合うものをインストールしてください。
初回起動時に設定を読み込み、ブラウザーの通信を確認します。必要な場合に限り、サービスの権限やTUNを設定してください。旧クライアントを残す場合は、2つのプログラムが同時にシステムプロキシを設定したり、同じポートを使用したりしないように注意しましょう。
ダウンロードするダウンロード前にApple Silicon搭載機かIntel搭載機かを確認してください。システムプロキシ、メニューバーからの操作、バックグラウンドサービスの実装はクライアントによって異なります。デバイスのアーキテクチャに合うインストーラーを選びましょう。
クライアントを切り替えたら、システムのネットワークプロキシ設定を確認してください。以前の設定が削除されているとは限りません。ターミナルなど他のアプリの通信も取り込みたい場合は、そのアプリのプロキシ環境またはTUNの状態を個別に確認しましょう。
ダウンロードするCPUアーキテクチャに合ったインストーラーを選び、クライアントが使うVPNの通信取り込み方式も確認してください。初回接続時はOSの案内に従って許可し、設定を読み込んだだけでなく、使用する設定として選択されていることも確認しましょう。
バックグラウンド更新は、バッテリー最適化、バックグラウンド通信の権限、プロセスの状態に影響されます。サブスクリプションが定期更新されない場合は、まずアプリを前面に表示して手動更新を試し、次にOSがバックグラウンド実行を制限していないか確認してください。
ダウンロードするClash PlusのApp Storeページと公式情報を確認できます。モバイルOSのネットワーク拡張機能はクライアントが管理します。サブスクリプションの読み込み方法、更新オプション、設定の互換性については、アプリ内の案内を確認してください。
読み込み後に使用する設定を選び、OSの案内に従ってVPN接続を許可してください。ネットワークを切り替えた後に接続できない場合は、まずネットワーク拡張の接続状態と設定リソースの更新結果を確認し、その後で振り分け設定を調整しましょう。
ダウンロードするデスクトップ環境ではClash Verge RevやFlClashを比較し、ディストリビューションに合ったDEB、RPMなどのパッケージを選びましょう。GUIのないサーバーやルーターでは、通常コアを直接配置し、サービスと権限を別途設定します。
インストールが完了しても、プログラムが起動できることしか確認できていません。依存関係、ポートの待ち受け、システムプロキシとの連携も確認してください。サービスとして起動する場合は、作業ディレクトリ、設定ファイルのパス、リソースファイルへの書き込み権限を確認しましょう。
ダウンロードするプラットフォームアイコン：Windows、Apple、AndroidにはSimple Iconsのベクターを使用。Linux TuxにはFont Awesome、CC BY 4.0のベクターを使用。
クライアントのインストール、設定の読み込み、通信の取り込みはそれぞれ別の工程です。次の順に確認すると、サブスクリプション取得の問題とアプリの接続問題を切り分けられます。最初からすべての詳細設定を変更する必要はありません。
設定またはサブスクリプションの画面を開き、設定提供元から受け取ったURLを貼り付けます。ローカルのYAMLファイルしかない場合は、ファイルから読み込んでください。解析が完了したら設定を選択し、構文エラーや未対応の項目がないか確認します。読み込みに成功しても有効化されたとは限りません。使用中の設定の表示とログで、読み込み結果を確認しましょう。
設定に含まれるプロキシグループの構成はそのままにし、まずルールモードを使います。デスクトップではシステムプロキシから始め、スマートフォンでは案内に従ってVPN接続を許可してください。システムプロキシを使わないアプリには、TUNまたはアプリ独自のプロキシ設定を検討します。一度に変更するのは1項目にし、変更前の状態を記録しておけば、問題発生時に元へ戻せます。
対象のWebページまたはアプリを再度開き、接続画面でリクエストがコアに届いているか、マッチしたルールとポリシーは何かを確認します。次にサブスクリプションを手動更新し、取得経路に問題がないことを確かめてから、クライアントが対応する自動更新を有効にしてください。画面上の分単位の設定と、設定ファイル内の秒単位の項目は別々に確認し、リソースを頻繁に更新しすぎないようにしましょう。
初代Clashは、このエコシステムで広く使われるYAML設定とルール記述方式の基礎を築きました。Clash Metaはそこからプロトコル、ルール、ネットワークスタックの機能を拡張し、後にmihomoという名称で開発が続いています。古い名称が解説に残っていることもありますが、設定項目が使えるかどうかはクライアント名だけで判断せず、実際に動作しているコアのドキュメントを確認してください。
GUIクライアントは通常、コアとプラットフォーム機能を組み合わせています。コアはリクエストを処理し、クライアントはサブスクリプション、システムプロキシ、ログ、権限を管理します。同じ設定でもクライアントによって読み込み時の挙動は異なり、実行用の設定を生成または統合するものもあります。トラブル対処では、クライアント名、コアの種類、最終的に適用された設定項目をあわせて記録してください。
Clashリソース網は、ダウンロード先、操作手順、用語の関係を整理しており、各クライアントの開発チームを代表するものではありません。機能変更やOSの制限については、上流プロジェクトの案内も確認してください。ダウンロード一覧ではOSとパッケージ形式の選び方を、ガイドでは設定項目と一般的な操作の関係を解説しています。エコシステム内のすべてのアプリを同一のソフトウェアとして扱うことはありません。
クライアントの更新では、画面、OS連携、内蔵コアが変わることがあります。コアの更新はプロトコル処理や設定の互換性に影響し、サブスクリプションの更新では設定やリソースを再取得します。プログラムを更新してもサブスクリプションの有効期限は延長されず、サブスクリプションを更新しても古いコアに新しいプロトコル機能が追加されるわけではありません。問題に対処する際は、まずどの層で発生しているかを特定し、適切な操作を選びましょう。
更新前にローカルのオーバーライドと動作確認済みの設定をバックアップし、設定変更に関する更新内容を確認してください。更新後は起動ログを確認してから、DNS、ルールのマッチ、アプリの接続をテストします。問題が起きたら、元の設定と比較できるようにし、その場しのぎの変更を重ねないようにしましょう。ルールリソースを変更する場合も取得元を記録し、最終設定しか残らず内容を説明できなくなる事態を避けてください。
初代コア、Meta、mihomoの関係を詳しく知りたい場合は、コアの変遷と機能の比較をご覧ください。ルーターやサーバーに導入する際は、実行環境のネットワークと権限に関する説明もあわせて確認してください。
ソースコード、リリースノート、問題の議論はMetaCubeX/mihomoで確認できます。リポジトリをクローンしても、閲覧や開発への参加ができるだけで、クライアントのインストールが完了するわけではありません。GUIが必要な場合は、OSに合ったインストーラーを選んでください。
git clone https://github.com/MetaCubeX/mihomo.git基本操作を終えたら、問題に合った解説を確認してください。速度の問題では比較テスト、ルーターへの導入では通信の入口、新規利用時の接続トラブルではシステムプロキシ、モード、ポートから確認します。問題ごとに必要な情報は異なるため、同じ設定を繰り返し試すのは避けましょう。
ノード、回線、ローカル設定の3段階に分けて速度低下の原因を調べます。速度比較、回線の切り替え、ルールとDNSの確認、システムプロキシとTUNの再確認について、手順と判断方法を解説します。
記事を読む →メインルーターとサブルーターでmihomoコアを動かす方法を紹介します。アーキテクチャの選択、透過プロキシとTUNの使い分け、DNSの取り込み、LAN機器のゲートウェイ設定の要点を解説します。
記事を読む →初心者がつまずきやすい10の疑問をまとめて解説します。クライアントの選び方、システムプロキシとTUNの違い、ルールモードの意味、ポートの競合、Webページが開かない場合など、すぐに試せる対処法を紹介します。
記事を読む →サブスクリプションを更新できない場合：まずURLから設定を取得できるか確認し、取得リクエストのログを調べます。サブスクリプション更新のトラブル対処を参考に、アクセスエラー、解析エラー、リソース更新エラーを切り分けてください。
DNSとFake-IP：まず名前解決リクエストの送信元を確認し、通信の取り込み方法や除外リストを変更するか判断してください。仕組みがわからない場合は、設定を変更する前にFake-IPの用語解説を確認しましょう。