Clash / mihomo · 用語一覧

Clash用語集

クライアントの画面やYAMLの項目から用語を確認できます。ルールの振り分け結果が想定と異なる場合は、通信が引き継がれているか、どのルールに一致したか、指定されたプロキシグループでどの出口が選ばれたかを順に確認しましょう。

設定項目とYAMLの例を見る · インストールと設定の手順を見る

カーネルとプロトコル

mihomo

mihomoは、設定の解析やルールの照合、外向き接続の確立を担うプロキシカーネルです。クライアントの画面ではファイルのインポートや設定の切り替えを行いますが、実際に設定を適用するのはカーネルです。認識されない項目がある場合は、アプリのバージョンだけでなく、実際に動作しているカーネルのバージョンを確認してください。

プロキシノード

プロキシノードは、設定ファイルに定義された通信の出口です。通常、プロトコル、サーバーアドレス、ポート、プロトコル固有のパラメーターが含まれます。proxiesにはノードを直接記述できますが、プロキシグループは候補となる出口から接続先を選ぶ役割を担います。表示名は参照に使えますが、ノードの接続可否やプロトコルを判断する材料にはなりません。

プロキシプロトコル

プロキシプロトコルは、クライアントとサーバー間でデータをやり取りする方法を定めます。ノードのtypeによって他の項目の解釈が決まるため、プロトコルを変更するときは名前だけでなく、サーバーが対応するパラメーター一式を設定する必要があります。ローカルアプリがプロキシに接続する際のプロトコルと、カーネルがリモートノードに接続する際のプロトコルは異なる場合があります。

遅延

画面に表示されるミリ秒の値は、通常、指定されたURLへの接続テスト1回分の結果です。すべての接続先への往復時間を示すものではありません。テスト先やタイムアウトの設定、接続の再利用方法が異なると、数値をそのまま比較できない場合があります。ダウンロード速度や長時間の安定性は別途確認してください。1回のテストがタイムアウトしても、すべての通信に失敗するとは限りません。

設定ファイルの構成

サブスクリプション

サブスクリプションは、クライアントが設定を定期的に取得する配布元で、通常はリンクからインポートします。取得内容は完全な設定ファイルの場合も、ノード一覧だけの場合もあります。そのまま利用できるかどうかは、応答の形式とクライアントの対応状況によって異なります。サブスクリプションリンクには認証情報が含まれることがあるため、インポートの問題を調べる際もリンク全体を公開しないでください。

YAML

YAMLではインデントで階層を表し、キーと値、リストを組み合わせてデータを記述します。たとえば、dns:の下にインデントされたenable:はDNSの設定であり、トップレベルのスイッチではありません。インデントにはスペースを使います。構文が正しいことを確認したら、項目名、階層、値の型がカーネルの要件に合っているかも確認してください。

プロキシプロバイダー proxy-providers

proxy-providersは、プロバイダーごとにノードをまとめます。取得元にはリモートURLやローカルファイルを指定できます。プロキシグループからuseでプロバイダーを参照すれば、ノード一覧の更新時にグループ内の候補を一つずつ書き直す必要は通常ありません。プロバイダーの更新に成功してもグループにノードが表示されない場合は、参照名とフィルター条件を確認してください。

オーバーライド

オーバーライドを使うと、サブスクリプションの元データとは別にローカルの変更を保存できます。たとえばDNS項目を変更したり、サブスクリプションのルールより前に例外ルールを追加したりできます。同名項目の上書き、リストへの追加、先頭への挿入はそれぞれ異なる操作で、動作はクライアントによって異なります。サブスクリプションの更新後はマージ結果を確認し、変更内容が必要な階層と順序に反映されているか確かめてください。

プロキシグループとルール

プロキシグループ proxy-groups

プロキシグループは、候補となるノードや組み込みの出口、別のグループをまとめた名前を付け、ルールから参照できるようにします。selectはユーザーが手動で選択し、fallbackは候補の順に利用可能なものを選びます。ルールにグループ名が指定されていても、実際の通信経路を判断するには、そのグループで現在選択されている出口を確認する必要があります。

遅延テスト url-test

url-testは指定したURLで候補となる出口をテストし、遅延に基づいて接続先を選択します。intervalはテスト間隔を設定し、toleranceは遅延のわずかな差による頻繁な切り替えを抑えます。測定するのはテスト先への応答時間であり、他のサイトにも選ばれた出口が速いことを保証するものではありません。

ルール振り分け

mode: ruleでは、カーネルがrulesの記述順に接続を照合し、通常は最初に一致したルールに従って後続のポリシーを決定します。DOMAIN-SUFFIXは指定したドメインとそのサブドメインに一致します。特定のサブドメインを別の方法で処理する場合は、対象範囲の広いルールより前に、より具体的なルールを配置してください。

GeoIP

GEOIPはIPデータセットを使って、国や地域のコードなど、宛先アドレスのカテゴリを判定します。ドメインの末尾を調べる機能ではなく、判定結果からサービスの運営元を特定することもできません。接続先がドメイン名の場合、ルールの判定に先立ってアドレスの解決が必要になることがあります。no-resolveを指定すると、このルールのためだけに名前解決するのを避けられます。

最終ルール MATCH

MATCHは、前のルールで処理されなかった接続に一致します。よく使われる記述例はMATCH,DIRECTです。通常はルール一覧の末尾に置きます。前の方に置くと、それに一致した接続は後続のルールで処理されません。通信が意図せず最終ルールに振り分けられた場合は、先行するルールとログに記録された宛先ドメイン名またはIPアドレスを確認してください。

DNSとネットワーク

Fake-IP

dns.enhanced-mode: fake-ipを設定すると、条件に一致するDNSリクエストに対してカーネルが合成アドレスを返し、ドメイン名との対応関係を保存します。後続の接続を引き継ぐ際、この情報をもとにドメイン名を復元してルールを照合できます。実際のアドレスを必要とするLAN内のサービスやアプリは、必要に応じてfake-ip-filterで除外してください。

DNSリーク

DNSリークとは、DNSクエリが想定外の経路で処理される状態です。たとえばWeb接続はプロキシ経由でも、DNSクエリはローカルネットワークのDNSサーバーで処理されることがあります。リークにあたるかどうかは、検査ページに表示される国や地域ではなく、あらかじめ決めたDNSの経路によって判断します。問題を調べる際は、ブラウザーのセキュアDNS、OSのリゾルバー、カーネルが使用する上流DNSをそれぞれ確認してください。

TUNモード

tun.enable: trueはTUNを有効にする設定です。仮想ネットワークインターフェースとルーティングを使って通信を引き継ぎます。システムプロキシに従わないアプリの通信も扱えますが、対象範囲はOSの権限、ルート設定、除外項目によって制限されます。有効にした後も、対象の通信とDNSクエリが想定どおりに処理されているか、それぞれ確認してください。

混合ポート mixed-port

mixed-portは、1つの待ち受けポートでHTTPプロキシとSOCKSプロキシのリクエストを受け付けます。7890はよく使われる設定例で、すべてのクライアントの初期値ではありません。アプリには実際に待ち受けているポートを指定してください。他のデバイスから接続する場合は、allow-lan、待ち受けアドレス、ファイアウォールの設定も確認が必要です。

クライアントとプラットフォーム

GUIクライアント GUI

GUIクライアントには、設定のインポート、ポリシーの選択、ログの確認などを行う画面があります。カーネルを内蔵するものと、独立したカーネルプロセスを管理するものがあります。同種のカーネルを使うクライアントでも、オーバーライドの書式、メニューの場所、OSとの連携機能は異なる場合があります。クライアントを選ぶ際は、まず対応プラットフォームを確認し、必要な機能を比較してください。

システムプロキシ

システムプロキシは、それに従うアプリにプロキシのアドレスとポートを通知する設定で、通信を引き継ぐためのルートを追加する機能ではありません。システムプロキシを参照しないアプリは、直接接続するか、アプリ内で個別に指定したプロキシを使用することがあります。クライアントを終了してもシステムプロキシがローカルポートを指したままで、そのポートが待ち受けを停止していると、設定に従うアプリがインターネットに接続できなくなることがあります。

プロセッサアーキテクチャ

x64、amd64、x86_64は、通常、同じ64ビットx86アーキテクチャを指します。arm64とaarch64も、通常は64ビットARMを指します。ダウンロード前に、OS、アーキテクチャ、インストーラーの形式をあわせて確認してください。同じクライアントに複数のビルドがある場合は、OSに適合するネイティブビルドを選びましょう。