Clash Wiki / 設定用語集
Clash用語ガイド
mihomoカーネルからTUN、Fake-IP、プロキシグループ、サブスクリプション更新まで、設定の流れに沿って基本概念を解説します。各用語の役割、関連設定、トラブル時に混同しやすい境界を確認できます。
5つの設定テーマ
27の基本用語
モバイルとデスクトップに対応
カテゴリから探す
設定の段階から用語を探す
まず問題が起きている段階から入り、各項目にある関連用語をたどって確認します。カーネルが処理を実行し、モードが取り込み範囲を決め、ルールが出口を選び、DNSがドメイン情報を保ち、クライアントが導入と操作を担います。
Core / Protocol
カーネルとプロトコル
このカテゴリでは、設定を実行する主体、ファイルの解析方法、リモート接続の通信方式を確認します。設定を読み込めない、項目が未対応、カーネルの起動に失敗するといった場合は、まずここを確認してください。
- Clash
- ルールマッチング、プロキシグループ、プロキシプロトコルで通信を振り分けるクライアントと、そのエコシステムを指す名称です。一般にClashと言うと、クライアント画面、設定形式、または互換カーネル全般を意味することがあります。問題を切り分ける際は、具体的なクライアント名と実際のカーネルを先に確認してください。
- mihomo
- Clash Metaから発展したプロキシカーネルで、接続の確立、ルールマッチング、DNS、TUN、ポリシー制御を担います。クライアント画面からは通常、設定ファイルや制御インターフェースを通じて管理します。設定を利用できるかどうかは、統合されたカーネルのバージョンと公開機能によって決まります。
- プロキシプロトコル
- クライアントとリモートサーバーが接続する際の通信規約で、設定にはサーバー、ポート、認証、転送パラメータが含まれます。プロトコル名は接続方法を示すだけで、回線品質を直接表しません。パラメータがサーバー側と一致しないと、ノードを読み込めても有効な接続を確立できません。
- YAML
- Clash設定ファイルでよく使われるデータ形式です。インデントでオブジェクトの階層を、ハイフンでリスト項目を表します。タブ、ずれたスペース、コロンの欠落、重複キーは読み込み失敗の原因になります。長い設定を編集する際はインデントを統一し、文字列内の特殊記号にも注意してください。
- Rule Provider
- ルール集合をローカルファイルやリモートURLへ分割する仕組みで、日本語ではルールセットやルールプロバイダーと呼ばれることがあります。メイン設定では取得元、更新間隔、動作タイプを指定し、対応するルールから参照します。大量のドメインやアドレス集合の管理に適し、ルールだけを個別に更新できます。
Traffic Capture
プロキシモード
プロキシモードには、通信をどのようにカーネルへ取り込むか、取り込んだ後にルールを実行するかという2つの意味があります。システムプロキシとTUNが取り込み範囲を決め、ルール、グローバル、直接接続の各モードが後続処理を決めます。
- ルールモード
- ルールリストを上から順に照合し、通信を指定したプロキシグループ、プロキシ、または直接接続へ送ります。サイトやアプリごとに経路を分けられるため、日常利用で最も一般的なモードです。意図しないポリシーに一致する場合は、前方のルールが先に取り込んでいないか確認してください。
- グローバルモード
- 通常のルール分岐を無視し、取り込んだ通信をすべてグローバルポリシーへ渡します。一時的なノードのテストや、アクセス障害がルールによるものか判断する際に便利です。取り込み範囲が自動で広がるわけではないため、カーネルに入っていないアプリは処理されません。
- 直接接続モード
- カーネルが取り込んだ通信をプロキシノード経由にせず、宛先へ直接接続します。直接接続でアクセスが回復するなら、問題はノードやプロキシ経路にある可能性があります。それでも失敗する場合は、ローカルネットワークとDNSを確認してください。直接接続にしてもクライアントを停止した状態とは異なり、取り込みや名前解決の経路が動作している場合があります。
- システムプロキシ
- OSのHTTPまたはSOCKSプロキシアドレスをClashのローカルリスニングポートへ向けます。ブラウザーなどシステム設定に従うプログラムは自動的にこの入口を使いますが、一部のゲーム、コマンドラインプログラム、独自ネットワークスタックは無視することがあります。その場合はアプリごとのプロキシ設定、またはTUNの利用を検討します。
- TUNモード
- 仮想ネットワークインターフェースでIP通信を取り込み、システムプロキシを参照しないプログラムにも適用できます。モバイルではVPNの常時接続として動作し、デスクトップではサービス、ネットワーク拡張、管理者権限が必要になる場合があります。有効化後は、ルーティング、DNSの取り込み、ほかのVPNツールとの競合も確認してください。
Rules / Policy
ルールとポリシー
ルールは通信をどのポリシーへ渡すかを決め、プロキシグループはどのノードや動作を実行するかを決めます。分離して設計すれば、ルールを変えずにノードを更新したり、サブスクリプションを作り直さずにルールを調整したりできます。
- ルール分岐
- ドメイン、IP、ポート、プロセスなどの条件に基づき、通信をプロキシ、直接接続、拒否のいずれかへ振り分けます。ルールは通常、記述順に照合され、一致すると後続の検索は行われません。具体的な条件は、汎用集合や最終フォールバックより前に置き、先に上書きされないようにします。
- プロキシグループ
- 複数のノードやほかのポリシーを、選択、テスト、障害時の切り替えに使える論理的な入口へまとめます。ルールは通常、個別ノードではなくプロキシグループ名を参照します。そのため、サブスクリプションのノードを入れ替えてもルール構造を維持できます。
- select
- ユーザーが現在の出口を手動で選ぶプロキシグループの種類で、接続経路を明確に管理したい場合に適しています。クライアントは通常選択を記憶しますが、設定の再インポート、グループ名の変更、ノードの消失後に初期値へ戻ることがあります。更新後は重要なポリシーが想定したノードを指しているか確認してください。
- url-test
- 指定したテストURLで候補ノードを定期的に確認し、結果に基づいて接続経路を自動選択するプロキシグループの種類です。テスト対象への応答だけを示すため、すべてのサイトの速度を表すものではありません。間隔を短くしすぎると、バックグラウンド通信やモバイル端末の電池消費が増えます。
- fallback
- 候補の順序とヘルスチェック結果に基づいて利用可能なノードを選ぶプロキシグループの種類です。接続の可用性を優先し、現在のノードが使えなくなると後続の候補へ切り替えます。url-testとは異なり、応答時間が最も短いノードを継続的に選ぶことが主目的ではありません。
- GeoIP
- GeoIPデータベースで宛先IPを分類し、その結果に基づいてルールを照合します。ドメイン接続では通常、先にアドレスを取得する必要があるため、名前解決の経路が結果に影響します。データベースには更新周期があり、GeoIPの結果だけでサーバーの実際の所在地を断定することはできません。
- GeoSite
- ドメインを分類した集合に基づいて照合するデータ形式で、地域、サービス、用途別のルール整理によく使われます。対象はドメインの分類であり、IPの地理的位置を判定するものではありません。複数のドメインや外部リソースを使うサイトでは、複数カテゴリの併用が必要になる場合があります。
DNS / Network
DNSとネットワーク
DNSはドメインをアドレスへ変換するだけでなく、ルールが元のドメインを取得できるか、問い合わせがどのネットワーク経路を通るか、最終的にどのアドレスへ接続するかにも影響します。接続済みなのにページが開かない場合は、まずこのカテゴリを確認してください。
- DNS
- ドメインをネットワークアドレスへ変換する基盤サービスです。Clashは問い合わせを取り込み、上流リゾルバーを選び、ドメイン情報をルールシステムへ渡せます。解決失敗、到達できないアドレスの返却、想定外の経路での問い合わせは、ページが長時間読み込まれる原因になります。
- DNSリーク
- ドメイン問い合わせが想定したClashの名前解決経路を迂回し、別のネットワークインターフェースやリゾルバーで処理される現象です。ドメイン解決とプロキシ接続の経路が一致しなくなる場合があります。調査では、システムDNS、ブラウザーの暗号化DNS、TUNの取り込み、フォールバックDNS設定を同時に確認してください。
- Fake-IP
- ローカルDNSモジュールが先にアプリへマッピングアドレスを返し、その後カーネルが元のドメインを復元してルールマッチングを行う拡張モードです。接続段階でドメイン情報を保ちやすく、解決後に照合する際の曖昧さも減らせます。LAN機器、接続確認、一部の特殊アプリではFake-IPフィルターリストへの追加が必要になる場合があります。
- redir-host
- 実際のDNS解決を先に行い、その後ドメインと実アドレスに基づいて通信を処理する互換モードです。従来のネットワーク解決に近く、LANや特殊アプリでも理解されやすい場合があります。Fake-IPとは、ドメイン情報を保持するタイミングとルールの一致経路が異なります。
- nameserver
- ClashのDNSモジュールで通常のドメイン問い合わせを処理する上流リゾルバーの一覧です。従来型DNSや、カーネルが対応する暗号化DNSアドレスを指定できます。上流を選ぶ際は、到達経路、解決結果、プロキシ経由が必要かどうかを同時に考慮します。
Client Control
クライアント機能
クライアントはサブスクリプションの受信、ノードの表示、システム設定の変更、カーネルへの制御命令の送信を担います。画面上で接続済みと表示されても、ローカルでの取り込みが有効になったことを示すだけです。実際のアクセスには、名前解決、ルール、ポリシー、ノードの4段階が関わります。
- サブスクリプション
- リモートURLを通じて、ノード、プロキシグループ、または完全な設定をクライアントへ配布する方式です。更新すると上流の内容を再読み込みするため、ノードの追加・削除や名前の変更もローカルへ反映されます。手動変更が残るかは、クライアントが上書き、マージ、個別のローカル設定層に対応しているかによります。
- ノード
- 設定内でプロキシグループから呼び出せる個別のプロキシ接続項目です。通常はサーバーアドレス、ポート、プロトコル、認証パラメータを含みます。ノード名は識別用のラベルにすぎず、利用可能性を単独で示しません。読み込みに成功してもサーバーへ到達できるとは限らないため、実際の接続やヘルスチェックで確認します。
- 遅延
- クライアントがテスト対象へリクエストを送り、応答を受けるまでの時間です。現在のネットワーク経路を確認する目安になりますが、テストURL、回線負荷、ローカルネットワーク、測定方法によって変わります。低遅延だからといってダウンロード速度が速いとは限らず、安定性や対象サイトへの到達性の判断に代わるものでもありません。
- mixed-port
- HTTPとSOCKSのプロキシ接続を同時に受け付けるローカルリスニングポートです。アプリは対応するプロキシ方式に応じて同じポートへ接続でき、ローカル設定を簡略化できます。クライアントがリスニングを開始できない場合は、ほかのプロキシツールやバックグラウンドプロセスによるポート占有を確認してください。
- External Controller
- mihomoがクライアント画面や外部管理パネルへ提供する管理インターフェースです。接続情報の取得、ポリシーの切り替え、設定の再読み込みができます。通常は本機アドレスだけで待ち受ければ十分です。LANからのアクセスを許可する場合は、アクセス制御を設定し、インターフェースの到達範囲を制限してください。