Clash カーネル
設定を読み込み、プロキシ接続を確立し、ローカルポートを開いてルール照合を行う中核プログラムです。GUI クライアントは通常、操作層にすぎず、実際のトラフィック処理はカーネルが担います。起動に失敗した場合は、クライアント画面のログとカーネルの実行ログを分けて確認し、別々のプロセスを混同しないようにします。
REFERENCE BAY / TERM INDEX
Clash 用語と設定の関係
設定ファイル、クライアント画面、実行ログに登場する Clash の用語をまとめて解説します。カーネル、プロキシ経路、ルール、サブスクリプション、DNS、システム連携に分類し、導入やトラブル解決時の確認に役立てられます。
INDEX / 06 GROUPS
利用シーンから探す
まず問題が発生している段階から分類を選びます。設定エラーはサブスクリプションと設定、接続できるのに分岐が合わない場合はルールとプロキシグループ、アプリが連携されない場合はプロキシとトンネルまたはプラットフォーム連携を確認します。
BAY A / RUNTIME
カーネルとクライアント
ネットワークトラフィックを処理するカーネル、操作画面を担うクライアント、両者が共有する設定・データディレクトリを区別します。
mihomo
Clash Meta の後継として継続的に開発されているプロキシカーネルプロジェクトで、ルール分岐、TUN、DNS 拡張、多様なプロトコルに対応します。クライアントによっては設定画面で Meta カーネルまたは mihomo カーネルと表示されます。クライアントのバージョンと mihomo のバージョンは別々のリリース記録なので、機能を比較する際はそれぞれ確認が必要です。
GUI クライアント
プロキシカーネルを組み込み、サブスクリプションの取り込み、プロキシグループの切り替え、ログ確認、システムプロキシ制御などの操作画面を提供するデスクトップまたはモバイルアプリです。同じカーネルを使っていても、設定ディレクトリ、権限、システム連携方法はクライアントごとに異なる場合があります。乗り換え前に既存設定を直接取り込めるか確認してください。
設定ディレクトリ
YAML 設定、ルールセット、GeoIP データ、キャッシュ、ログを保存するローカルディレクトリです。GUI クライアントは設定ごとに個別のサブディレクトリを作ることも、更新時に一時ファイルを生成することもあります。トラブル解決では実行ログで実際の読み込み先を確認してから該当ファイルを変更し、未使用のコピーを編集しないようにします。
BAY B / TRAFFIC
プロキシとトンネル
トラフィックがカーネルへ入る経路、リモートノードへの接続方法、システムプロキシと TUN の処理範囲の違いを説明します。
ノード
リモートプロキシへの接続に使うサーバー設定の1件分で、通常はアドレス、ポート、プロトコル、認証パラメータを含みます。ノード名は表示用のラベルにすぎず、回線品質や実際の所在地を判断する根拠にはなりません。利用できない場合は接続ログを確認し、DNS 失敗、ハンドシェイク失敗、認証エラー、リモート側のタイムアウトを切り分けます。
遅延
クライアントがテスト対象へリクエストを送ってから結果を受け取るまでの時間で、通常はミリ秒で表示します。テスト結果は宛先、混雑状況、リモート側の負荷、測定方法に左右されます。低遅延でも高帯域とは限らず、実効速度はパケットロス、回線容量、対象サイトの応答にも依存します。
システムプロキシ
OS の HTTP、HTTPS、SOCKS プロキシ設定を Clash のローカル待受ポートへ向けます。ブラウザやシステムのネットワーク設定に従う多くのデスクトップアプリがこの経路を使いますが、独自ネットワークスタックを実装したプログラムは迂回することがあります。システムプロキシが有効なのにアプリが直接接続する場合は、まずアプリ側のプロキシ設定を確認します。
TUN モード
仮想ネットワークインターフェースでシステムの IP トラフィックを受け取り、カーネルが直接接続かプロキシかを判断します。システムプロキシ設定を読まないアプリも処理できる一方、DNS やルーティングの確認経路も変わります。有効化には適切な OS 権限が必要で、仮想アダプター、ルーティングテーブル、他のネットワークツールとの競合も確認してください。
BAY C / ROUTING
ルールとプロキシグループ
接続が照合条件からプロキシグループへ渡る仕組み、ルールの順序、外部ルールセット、地域データが結果へ与える影響を説明します。
ルール分岐
ドメイン、IP、プロセス、ルールセットで接続を照合し、指定したプロキシグループへ渡します。多くの設定は上から順にルールを確認し、最初に一致した項目を実行します。そのため、より具体的なルールは通常、広いルールより前に置きます。分岐ミスが起きた場合は、ログで一致したルールの種類と対象プロキシを確認してください。
プロキシグループ
複数のノードや他のプロキシグループを1つの論理的な出口にまとめ、手動選択、自動テスト、負荷分散、フェイルオーバーなどを行います。ルールがプロキシグループを参照すれば、ノード変更のたびにルールを修正する必要がありません。グループの入れ子が多いと切り分けが難しくなるため、最終出口を段階的に確認します。
ルールセット
用途別に管理するドメイン、IP サブネット、その他の照合条件の集合で、ローカルファイルやリモート URL から読み込めます。ルールセットによりメイン設定を簡潔に保ち、個別に更新できます。リモート取得に失敗してもキャッシュ版が使われる場合があるため、更新日時、ダウンロードログ、実際の一致結果を併せて確認します。
GeoIP
IP アドレスの地域情報に基づいて照合するデータおよびルールの種類で、名前解決済みの接続を処理する際によく使われます。リアルタイム位置情報サービスではなく、結果はローカルデータベースの内容に依存します。Clash の GeoIP を更新した後は、カーネルが新しいファイルを読み込んでいるか確認してください。古いデータでは新規割り当てアドレスが誤ったポリシーに入ることがあります。
MATCH ORDER
ルール順序の例
DOMAIN-SUFFIXまず具体的なドメイン範囲を処理PROCESS-NAME次にアプリのプロセスで分岐を補完GEOIP名前解決済みの地域 IP 範囲を処理MATCH前段で一致しなかった接続を処理
BAY D / PROFILE
サブスクリプションと設定
リモートサブスクリプション、現在の設定、YAML 形式、外部ノードプロバイダーを区別し、取り込みや解析の段階で起きる問題を特定します。
サブスクリプション
サービス提供者が公開し、定期的に更新できるリモート設定ソースです。Clash サブスクリプション URL の取り込みに成功しても、クライアントがアドレスを保存しただけの場合があります。ネットワーク通信、内容のダウンロード、設定解析が完了して初めてノードが画面に表示されます。失敗時はレスポンス状態、返却内容、解析ログを分けて確認します。
YAML
Clash 設定でよく使われるテキストシリアライズ形式で、インデントによってオブジェクトとリストの階層を表します。タブ文字、インデントの不一致、空白の不足、特殊文字の引用漏れは解析失敗の原因になります。手動編集では既存の階層を保ち、少量ずつ変更して設定チェックを再実行してください。
設定ファイル
待受ポート、プロキシノード、プロキシグループ、ルール、DNS、TUN パラメータを記述した YAML ドキュメントです。クライアントは複数の設定を保存できますが、実行時に読み込むのは現在有効な設定だけです。変更が反映されない場合は、保存、設定の再読み込み、画面に表示された現在の設定名を確認してください。
proxy-provider
外部ファイルまたはリモート URL からプロキシノードの一覧を読み込み、更新間隔、キャッシュパス、ヘルスチェックを設定できる仕組みです。ノードの提供元をメイン設定から分離でき、複数のソースを組み合わせる用途に適しています。プロバイダーの読み込みに失敗すると、参照するプロキシグループが空になる場合があるため、まずプロバイダーの状態を確認します。
BAY E / RESOLVER
DNS とネットワーク
ドメインの名前解決が Clash に入る経路、Fake-IP と Redir-Host の違い、DNS リークや分割 DNS の確認ポイントを説明します。
DNS リーク
接続トラフィックはプロキシ経由なのに、ドメイン検索だけがシステムの既定 DNS 経路へ送信される現象です。アクセス先のドメインが露出したり、解決結果とプロキシ出口の地域が一致しなかったりすることがあります。ブラウザテスト、OS の DNS 設定、TUN の状態、カーネルログを併せて確認してください。1回のウェブ結果だけでは原因を特定できません。
Fake-IP
カーネルがドメインに予約アドレスを返し、接続時にそのアドレスを元のドメインへ対応付けてルール照合を行う DNS 拡張方式です。ドメイン情報を保持しやすい一方、LAN 機器、ゲーム、特殊なアプリでは受け付けられないことがあります。互換性に問題がある場合は、特定ドメインを除外範囲に設定できます。
Redir-Host
実際の名前解決結果を直接返す DNS 拡張方式で、後続の接続は主に実 IP を使います。通常の DNS に近いネットワーク動作になる一方、接続時にドメイン情報が失われ、ドメインルールに嗅探などの補助機構が必要になる場合があります。モード変更後は古い DNS キャッシュを消去してからテストしてください。
nameserver-policy
ドメイン条件に応じて DNS サーバーを指定し、異なる DNS 経路へ振り分ける設定項目です。分割 DNS、LAN ドメイン、特定ルールセットなどに利用します。設定時はメインの nameserver、fallback、照合条件を併せて確認し、複数の設定が上書きされて意図しない結果にならないようにします。
DNS CHECK PATH
アプリの問い合わせ
システムの名前解決入口
Clash DNS
ドメイン別ポリシー
上流リゾルバー
BAY F / SYSTEM
プラットフォーム連携
バックグラウンドサービス、仮想ネットワークアダプター、プロセス識別、バイパス範囲を扱い、クライアント画面の外側にある OS のネットワーク動作を確認します。
システムサービス
OS のバックグラウンドサービスとしてカーネルや補助コンポーネントを起動する実行形態です。ユーザー画面を閉じた後もネットワーク処理を続けられます。サービスは独立したアカウント、権限、作業ディレクトリを使う場合があります。画面の状態と実際のプロキシ状態が一致しない場合は、サービスプロセス、起動パラメータ、読み込んでいる設定パスを確認します。
仮想ネットワークアダプター
TUN モードが作成または使用する論理ネットワークインターフェースで、Clash へルーティングされた IP トラフィックを受け取ります。システムのルート選択に関与しますが、物理的なネットワークポートではありません。作成に失敗した場合は、管理者権限、ドライバーの状態、残存ルート、VPN や仮想化ソフトのネットワークコンポーネントを確認してください。
プロセス照合
接続を開始したプログラム名や実行ファイルのパスに基づいてルールを選ぶ照合方式で、特定のアプリに専用ポリシーを割り当てる場合に適しています。OS のプロセス情報に依存するため、コンテナ、バックグラウンドサービス、一部のモバイル環境では制限されます。ルールが一致しない場合は、ログで実際に識別されたプロセス名を確認してください。
バイパスリスト
システムプロキシに渡さないドメイン、アドレス、サブネットを指定します。LAN 機器、開発用アドレス、システム内部サービスなどに使われます。範囲が狭すぎるとローカルリソースにアクセスできず、広すぎると本来プロキシすべきリクエストが直接接続されます。変更後は LAN アドレスと外部宛先を分けて確認してください。
FIELD NOTE / LOOKUP
ログから用語を逆引き
ログに設定解析エラーが出た場合は、YAML、設定ファイル、proxy-provider を確認します。ルールが一致して出口だけが誤る場合は、ルール分岐とプロキシグループを確認します。接続確立に失敗する場合は、ノードと遅延を確認します。一部のアプリだけがプロキシに入らない場合は、システムプロキシ、TUN、プロセス照合、バイパスリストを確認してください。
用語はトラブル解決の階層を確認するためのもので、ログの結論を直接置き換えるものではありません。毎回1つの変数だけを変更し、設定を再読み込みして問題を再現したうえで、変更前後のログを比較してください。