クライアントは操作画面を、コアは接続処理を担います。目的に応じて設定項目を確認し、まず必要最小限の設定を行ってから、段階的に機能を追加しましょう。
ルールモードでは、宛先ごとに異なるポリシーを適用できます。コアはルールを上から順に確認し、該当した時点で対応するプロキシグループまたは直接接続を使います。そのため、具体的なドメインのルールは汎用ルールより前に置き、最後にMATCHで残りの接続を処理します。ローカルサービスとリモートのリソースを使い分けたい場合は、グローバルモードよりルールモードが適しています。変更する前にポリシー名が定義済みか確認し、接続画面で一致したルールを調べましょう。Webページが開くかどうかだけで振り分け結果を判断しないでください。
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY例のPROXYはポリシー名です。プロキシグループで別途定義してください。GeoIPの判定にはローカルの地理情報データベースが必要で、すべてのドメインルールを置き換えるものではありません。
プロキシグループを使うと、ルール側の参照先を固定できるため、ノードが変わってもルールを一つずつ修正する必要がありません。selectは手動で接続先を選ぶ場合、url-testは測定結果に応じて候補を選ぶ場合、fallbackは順番に利用可能な接続先を選ぶ場合に適しています。ルールにノード名を直接指定するより、グループ化したほうがサブスクリプション更新や日常的な切り替えが簡単です。使用前にグループ内のメンバーが実際に存在することを確認し、適切な測定間隔を設定してください。頻繁に切り替える必要がなければ、手動選択のほうが接続動作を把握しやすくなります。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECTこれは直接接続だけを含む構成例で、プロキシノードが設定済みであることを示すものではありません。サブスクリプションを読み込んだ後、設定にある実際のノードまたはプロキシプロバイダーをメンバーに追加してください。
システムプロキシが適用されるのは、主にOSのプロキシ設定を参照するアプリです。一部のプログラムやUDP通信には、別の接続方法が必要です。TUNは仮想ネットワークインターフェースとルーティング設定を使って対象の通信をコアに取り込み、既存のルールに従って接続先を決めます。グローバルモードとは異なる層の機能なので、TUNを有効にした状態でもルール分岐を利用できます。初めて有効にする前に、サービスの権限や、他のVPN・仮想ネットワークアダプター・LANアクセスへの影響を確認してください。競合した場合は、まずTUNを無効にして比較し、DNSやルールを同時に変更しないようにしましょう。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: trueこの例は、該当する設定項目に対応したmihomo環境を対象としています。GUIクライアントが設定項目を自動生成する場合があるため、実際の利用ではクライアントの設定機能を優先してください。
DNS設定は問い合わせ先を決めるだけでなく、コアが接続とドメインを関連付けられるかどうかにも影響します。Fake-IPは問い合わせに予約済みアドレスを返し、後続の接続時に元のドメインを復元することで、ドメインルールを適用しやすくします。実際のIPアドレスを直接返す名前解決とは仕組みが異なります。LAN内の機器、ゲーム、特定のアプリで問題が起きた場合は、DNS機能をすべて無効にする前に、対象ドメインをフィルター設定してください。アプリ独自の暗号化DNSが想定した経路を迂回することもあります。調査時はブラウザー、OS、クライアントの設定を確認しましょう。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "localhost"ここではマッピングに関する項目のみを示しています。実際の設定では、ネットワーク環境に合った上流DNSサーバーも指定してください。Fake-IPのアドレスはリモートサーバーのアドレスではありません。
サブスクリプションURLはリモート設定を取得するためのもので、クライアント自体がネットワークサービスを提供するわけではありません。読み込む前にURLの提供元と設定形式を確認し、読み込み後はプロキシグループ、ルール、最終更新時刻を確認してください。サブスクリプションから生成されたファイルを直接編集すると、次回の更新時に変更が上書きされることがあります。ポート、DNS、自作ルールなどを継続して使う場合は、クライアントが対応する上書き設定やマージ設定に記述してください。静的ファイルのコピーに比べ、リモートサブスクリプションはノードの変更を同期しやすい一方、更新エラーやサービスの有効状態にも注意が必要です。
# 学習用URLです。利用可能なサブスクリプションではありません
https://example.com/sub?token=xxxx
# 操作手順
URLを読み込む → 設定を更新する → 現在の設定に指定する → プロキシグループを確認するサブスクリプションURLにはアクセス情報が含まれることがあります。スクリーンショットやトラブルシューティング用ログを共有する前に、URL全体を隠してください。サブスクリプション変換には、信頼できる環境または自分で管理する環境を利用しましょう。
同じエコシステムのクライアント間では、YAML設定の考え方を一部共有できますが、システムプロキシ、権限、バックグラウンド実行の仕組みはOSやクライアントによって異なります。デスクトップ版は通常、トレイメニューやサービスモードで接続を管理します。モバイル版はOSのVPNインターフェースを使い、バッテリー設定やバックグラウンド制限の影響を受けます。移行時は、移行先クライアントが対応するコアと設定項目を確認してから、サブスクリプションを読み込み、プロキシグループを選択し、OSとの連携を再設定してください。古いディレクトリを丸ごとコピーするより、項目ごとに移行したほうが、パスやネットワークインターフェース名、古いキャッシュに起因する問題を切り分けやすくなります。
再利用できるもの：サブスクリプションの提供元、ドメインルール、プロキシグループの設計
再確認が必要なもの：ローカルポート、権限、ネットワークインターフェース、設定ファイルのパス
再設定が必要なもの：システムプロキシ、バックグラウンド動作、システム起動時の自動実行インストーラーはOSとプロセッサーアーキテクチャに合わせて選んでください。対応する配布ページは下記から確認できます。設定の互換性は、選択したクライアントが実際にサポートする機能を基準にしてください。
初回接続の準備では、スタートガイドに沿ってサブスクリプションとシステムプロキシを設定してください。設定全体の手順やメンテナンス方法については、利用ガイドをご覧ください。
トップページではOS別の一覧を掲載し、対応クライアント、インストーラー、システム要件はダウンロードページにまとめています。まず端末のアーキテクチャを確認し、クライアントごとのOS連携方法を比較してください。
トレイ操作、システムプロキシ、システム起動時の自動実行を使いたいデスクトップユーザーに適しています。ダウンロードページではClash PlusやClash Verge Revなどを紹介しています。選ぶ前にシステム設定でプロセッサーとOSの種類を確認してください。PCのブランド名だけでインストーラーのアーキテクチャを判断しないようにしましょう。
初回インストール後は設定を読み込んでから、システムプロキシを有効にしてください。システムプロキシに対応していないアプリの通信も取り込む必要がある場合に限り、サービスモードやTUNの権限を確認しましょう。以前のクライアントから移行するときは、サブスクリプションの提供元とカスタムルールを残し、新しいクライアントの設定ディレクトリ全体を上書きしないでください。
ダウンロードへ Windows クライアントメニューバーからプロキシを管理し、サブスクリプションを切り替え、接続状況を確認したいユーザーに適しています。Apple SiliconとIntelではインストーラーが異なります。「このMacについて」でチップの種類を確認してください。現在のOS要件に対応し、継続的にメンテナンスされているクライアントを選びましょう。
インストール後は案内に従って必要な権限を許可し、システムのネットワークプロキシ設定とクライアントの表示が一致しているか確認してください。スリープ復帰後やWi-Fiの切り替え後、別のVPNへの接続後に問題が起きた場合は、サブスクリプション全体を再読み込みする前に、現在のネットワークインターフェースとプロキシの状態を確認しましょう。
ダウンロードへ macOS クライアントOSのVPNインターフェースを使ってモバイル端末の通信を管理したいユーザーに適しています。ダウンロード時にはARM64、ARM、汎用インストーラーを区別し、クライアントの要件を確認してください。インストール後、端末内の通信を取り込むにはOSのVPN権限が必要です。
画面ロック後に接続が切れる場合は、バッテリー最適化、バックグラウンド実行、メーカー独自の自動起動設定を確認してからログを調べてください。バックグラウンド制限を一度にすべて解除しないようにしましょう。アプリごとのプロキシを使う場合は、対象アプリが通信の取り込み範囲に含まれているか、端末上で別のVPNサービスが動作していないかも確認してください。
ダウンロードへ Android クライアントダウンロードページではClash PlusのApp Storeリンクと公式サイトclashplus.ioを案内しています。インストール後、サブスクリプション形式がクライアントで認識されることを確認し、OSの案内に従ってVPN構成を追加してから、利用するプロキシポリシーを選択してください。
モバイル回線とWi-Fiを切り替えた後は、クライアントの状態を確認するだけでなく、実際に使うアプリでも接続を検証してください。VPNアイコンだけを見てリモート接続が正常だと判断しないようにしましょう。サブスクリプションの有効期限、プロキシグループの選択、ルールの一致状況は、それぞれ個別に確認する必要があります。
ダウンロードへ iOS クライアントデスクトップ環境では、まずClash Verge RevとFlClashを比較し、ディストリビューションに合ったパッケージ形式を選んでください。インストール後は、デスクトップ環境のプロキシ対応、トレイの動作、必要な権限を確認します。コマンドラインのプログラムはデスクトップのシステムプロキシを参照しない場合があるため、プログラムのドキュメントに従って環境変数を設定するか、別の通信取り込み方法を利用してください。
サーバーやルーターで使う場合は、mihomoコアの配布先も確認できます。ただし、起動オプション、設定ファイルのパス、サービスの起動・停止は自分で管理する必要があります。コントロールインターフェースとプロキシの待受アドレスは必要な範囲に制限してください。LAN接続を許可する前にファイアウォールとアクセス範囲を確認し、信頼できないネットワークにローカルサービスを公開しないようにしましょう。
公開されているソースコード、プロジェクトのドキュメント、リリース履歴を判断材料にしてください。名前の似たクライアントでも、メンテナンス状況、機能、設定の動作が同じとは限りません。
Clashエコシステムには、プロキシコア、GUIクライアント、設定ツールなど、異なる種類のプロジェクトがあります。オリジナルのClashや一部の旧クライアントがメンテナンスを終了した後も、コミュニティのフォークは開発を続けています。Clash Metaという名称も、古いガイドや設定解説でよく見かけます。mihomoは現在のエコシステムで広く使われているコアプロジェクトです。古い資料を読む際は、ファイル名にClashが含まれるかだけでなく、どの時期の、どのコアについて説明しているかを確認してください。
コアはプロトコル処理、ルール照合、DNS、接続転送を担います。GUIクライアントはサブスクリプションの読み込み、トレイメニュー、システムプロキシ、権限管理、ログ表示を担当します。Clash Verge Revなどはコアの機能を操作しやすいデスクトップ画面で利用できるようにしますが、画面上のスイッチとコアの設定項目が常に一対一で対応するとは限りません。同じサブスクリプションでも、クライアントごとのデフォルト上書き設定やOSへの通信の取り込み方によって結果が変わる場合があります。
プロジェクトのリポジトリでは、設定項目、リリースノート、既知の問題、修正に関する議論を確認できます。問題が解決済みかどうかを判断する際は、問題の内容、変更履歴、実際のリリースパッケージを照らし合わせてください。リポジトリの注目度だけで判断しないようにしましょう。当サイトでは、裏付けのないダウンロード数や評価をおすすめの根拠にしていません。端末との互換性、継続的なメンテナンス状況、必要な機能を基準に選んでください。
mihomoのリポジトリでは、ライセンスとしてGPL-3.0を採用していると明記されています。GUIクライアント、付属リソース、サードパーティの依存関係については、それぞれのプロジェクトのライセンス表示を確認してください。オープンソースコードは閲覧や調査に利用できますが、インストーラー、サブスクリプションサービス、サードパーティ設定はそれぞれ別の提供元に由来します。見知らぬ設定を読み込む前に、リモートルール、スクリプト、コントロールインターフェースなどが用途に合っているか確認し、サブスクリプションURLの認証情報を保護してください。
クライアント、コア、サブスクリプション、GeoIPなどのルール用データは、それぞれ別に更新します。クライアントの更新は主に画面やOS連携に影響し、サブスクリプションの更新はリモートで提供されるノードやルールを変更します。一つを更新しても、ほかの内容まで同期されたとは限りません。互換性に関わる変更がある場合は、まずリリースノートを確認し、復元できる旧設定を残してください。
カスタムルールと上書き設定ファイルは分けてバックアップし、変更の目的を記録しましょう。更新後は影響を受ける機能だけを確認してください。コア、DNS、ルール分岐を一度に変更すると、接続が復旧しても原因を特定しにくくなります。安定して使うには、説明できる設定を保つことが、パラメーターを次々と追加するより重要です。
使い始める際は、設定が有効になっていること、プロキシグループが選択されていること、OSへの通信の取り込みが有効になっていることを順に確認します。次に対象アプリへアクセスし、接続画面で対象ドメイン、一致したルール、実際に適用されたポリシーを確認してください。ルールに問題があるか切り分けるために、グローバルモードを一時的に使う方法はありますが、すべてのプログラムの通信がクライアントに取り込まれることを保証するものではありません。システムプロキシとTUNは通信の取り込み方法を決め、プロキシモードは取り込んだ通信の処理方法を決めます。
Webページは開けるのにストアアプリで問題が起きる場合は、UWPのループバック関連の説明を確認してください。特定のドメインだけ開けない場合は、DNSの経路を重点的に調べましょう。症状別の手順はよくある質問、詳しい学習順序は利用ガイドをご覧ください。復旧したら一時的なテスト設定を元に戻し、グローバルモードや過剰なログが残らないようにしましょう。
基本的な接続ができたら、症状に応じて詳しい記事を確認してください。OSの制約、クライアントの設定、コアの動作を分けて解説し、異なる層を行き来する試行錯誤を減らします。
コア、GUIフロントエンド、モバイルの3つの観点から、オリジナルのコア、Metaフォーク、mihomoの変遷と、主要クライアントがどのコアを採用しているかを解説します。
記事を読む →UWPアプリが既定でローカルのループバックアドレスにアクセスできない理由を説明し、GUIツールとコマンドラインによる2つの免除方法、設定の取り消し方と動作確認の手順を紹介します。
記事を読む →モバイル端末の電池消耗が増える主な原因を特定し、メーカー独自のバックグラウンド制限、バッテリー最適化の除外設定、VPNサービスの常時実行のバランスを解説。順に確認できる設定項目も紹介します。
記事を読む →