docs / glossary.md

Clash用語集:プロトコル・ルーティング・クライアント機能の用語解説

設定ファイルのフィールド名、クライアント画面上のスイッチ、エラーログに出てくるキーワード——それらの意味はすべてここで確認できる。25の用語を5分類で整理し、各項目に関連する設定項目を明記。チュートリアルやトラブル対応で見慣れない言葉に出会ったら、このページで検索すればよい。

protocols/

プロトコル

Shadowsocks プロトコル

対称鍵暗号を用いた軽量プロトコル。クライアントとサーバーは暗号方式とパスワードを合わせるだけで通信できる。シンプルかつ高効率で暗号化オーバーヘッドが小さいことを目標に設計されている。サブスクリプションのノードで type: ss とあればこのプロトコルで、暗号方式は aes-256-gcmchacha20-ietf-poly1305 が一般的。

VMess プロトコル

V2Rayエコシステムのネイティブプロトコル。UUIDで本人認証を行い、ハンドシェイクは時刻同期に依存する——自機とサーバーの時刻差が約90秒を超えると接続できなくなる。WebSocketやTLSと組み合わせて使われることが多く、設定項目は type: vmess

VLESS プロトコル

VMessを簡略化した後継プロトコル。プロトコル内蔵の暗号化を廃止し、セキュリティは外側のTLSやREALITYに完全に委ねることで、パケットオーバーヘッドを小さくしている。オリジナルのClashコアは対応しておらず、mihomoコアが必要。主要なGUIクライアントは標準搭載済み。

Trojan プロトコル

プロキシ通信を標準的なHTTPSに偽装するプロトコル。サーバー側は有効なTLS証明書を持ち443番ポートで待機する必要があり、通信特徴上は通常のウェブサイト閲覧に近い。クライアント側の設定は短く、アドレス・ポート・パスワードのみ。設定項目は type: trojan

Hysteria2 プロトコル

QUICベースのプロトコル。UDPでデータを伝送し、積極的な輻輳制御を内蔵しているため、パケットロスや遅延が大きい回線でTCP系プロトコルより明らかに高いスループットを発揮する。mihomoコアが必要で、ネットワークがUDPを制限している場合は逆に体感が悪化する。

core-config/

コアと設定

mihomo コアと設定

Clash Metaコアの現在の名称。オリジナルのClashコアが開発停止した後を継ぐコミュニティプロジェクト。Clash Plus、Clash Verge Rev、FlClashなど主要クライアントはいずれもこれを基盤エンジンとし、ポート監視・設定解析・ルールマッチング・通信転送を担う。VLESSやHysteria2などオリジナルコアにない対応プロトコルもサポートする。

YAML設定ファイル コアと設定

コアが読み込む config.yaml。インデントで階層関係を表し、主なセクションは mixed-portdnsproxiesproxy-groupsrules。インデントはスペースのみ使用可能で、Tabが混じると解析エラーになる。これは手動編集で最もよく起きるエラーの原因。

mixed-port コアと設定

混合リスニングポート:同一ポートでHTTPとSOCKS5の両方のプロキシリクエストを受け付け、2つのポートを別々に設定する手間を省く。デフォルト値は7890が一般的。起動時に bind: address already in use と出る場合、そのポートが他のプロセスに使用されていることを示すので、ポート番号を変更するか占有プロセスを終了すればよい。

TUNモード コアと設定

コアが仮想ネットワークカードを作成し、ネットワーク層で自機の全アウトバウンド通信を引き受ける。アプリがプロキシ設定を読み込むかどうかに依存しない。システムプロキシを無視するCLIツールやゲームクライアントなどは、TUNモードでしか対応できない。有効化には管理者権限またはroot権限が必要で、一部のクライアントでは先にシステムサービスのインストールが求められる。

Fake-IP コアと設定

DNSの動作モードの一種:コアはドメイン名の問い合わせに対し即座に 198.18.0.0/16 予約セグメント内の仮アドレスを返し、実際の解決はルールマッチング後に行う。利点は解決待ちを省略でき、ドメイン名単位で精密にルーティングできること。副作用として、実IPに依存するローカルネットワークのアプリは fake-ip-filter に記述して除外する必要がある。

external-controller コアと設定

コアが外部に公開するRESTful制御インターフェースで、デフォルトで 127.0.0.1:9090 を監視する。Webパネルはこれを通じてノード一覧の取得、プロキシグループの切替、接続やログの確認を行う。secret フィールドでアクセスパスワードを設定し、ローカルネットワーク内の他デバイスからの無断呼び出しを防げる。

routing/

ルーティングとルール

ルーティング(ルールマッチング) ルーティングとルール

コアは新しい接続ごとに rules リストを上から順に照合し、最初に一致した時点で停止する。その規則が直接接続、あるプロキシグループ、拒否のいずれにするかを決定する。そのためルールの順序は極めて重要で、精密なルールを前に置き、MATCH の兜底ルールは必ず最後の行に置く。

プロキシグループ ルーティングとルール

proxy-groups セクションで定義されるノードの集合で、ルールの転送先は通常個々のノードではなくプロキシグループを指す。よく使われる種類は、手動選択の select、遅延最小を自動選択する url-test、順番にフェイルオーバーする fallback。クライアントのプロキシページで切り替えられるグループがまさにこれ。

GeoIP ルーティングとルール

IPの地理的位置を判定するデータベースで、GEOIP ルールと組み合わせて宛先地域ごとにルーティングする。GEOIP,CN,DIRECT はほぼすべての設定にある行で、宛先IPが中国本土であれば直接接続にする。データベースはコアやクライアントに伴って定期更新され、古いままだと地域判定を誤ることがある。

GEOSITE ルーティングとルール

サイトの用途別に整理されたドメイン分類ライブラリで、GEOSITE,category-ads-all,REJECT の1行だけで広告ドメインを丸ごとカバーでき、個別に列挙する必要がない。GeoIPとの違いは、GEOSITEがドメイン名の段階でマッチし、GeoIPはIP解決後にマッチする点で、前者が優先的に一致する。

RULE-SET ルーティングとルール

rule-providers を通じて参照する外部ルールセット:ルール内容は別ファイルとしてリモートに置かれ、メイン設定には RULE-SET,名称,策略 という参照行を1行だけ書く。ルールセットは interval に従って定期的に自動更新でき、大規模なカスタムルールを管理する際に推奨される方式。

networking/

ネットワーク基礎

DNS漏洩 ネットワーク基礎

プロキシは有効になっているが、ドメイン名の問い合わせが依然として現地ISPのDNSに直接送られてしまう現象。結果は二つ:アクセス意図がローカルネットワークに露出すること、そして解決結果が汚染されて接続失敗を招くこと。dns セクションで enhanced-mode: fake-ip を有効にし、暗号化アップストリームを設定するのが一般的な対処法。

UDP転送 ネットワーク基礎

プロキシ経路がUDPパケットを転送できる能力。ウェブブラウジングは基本的にTCPのみだが、オンラインゲーム・音声通話・ビデオ会議は大きくUDPに依存する。ノードやプロトコルがUDPに対応していないと、これらのアプリで接続できない、または一方向で無音になる現象が起きる。ノード設定内の udp: true が対応の表明。

SNI ネットワーク基礎

TLSハンドシェイク時に宛先ドメイン名を平文で伝える拡張フィールド。サーバーはこれを基にどの証明書を返すかを決め、中間装置もこれで通信の宛先を識別できる。Trojan系プロトコルの偽装効果はSNIと直接関係し、ノード設定内の sniservername フィールドに記入するのがこれ。

ループバックアドレス ネットワーク基礎

127.0.0.1(すなわちlocalhost)は自機自身を指し、データはネットワークカードの外に出ない。システムプロキシ設定に 127.0.0.1:7890 と入力すると、ブラウザの通信を自機の7890番ポートで待機するClashクライアントに渡し、その後の宛先はクライアントが決定するという意味になる。これは自機のみに有効で、ローカルネットワーク内の他デバイスは自機のLAN IPを使う必要がある。

client-features/

クライアント機能

サブスクリプション クライアント機能

サービス提供者が発行する1本のURLで、アクセスすると完全なノード一覧(通常はYAML設定全体、またはエンコードされたノードリスト)が返される。クライアントに取り込んだ後は手動または定期取得で更新でき、ノードの変更が自動同期される。更新に失敗した場合は、まずブラウザでサブスクリプションリンクを直接開き、返ってくるのが設定内容かエラーページかを確認する。

ノード クライアント機能

設定ファイルの proxies セクション内にある1件のサーバー記録で、アドレス・ポート・プロトコル種別・認証情報を含み、実際の通信転送の出口となる。クライアントのプロキシページで選択できる各項目がまさに1つのノード。ノードは通常プロキシグループに組み込まれ、どの場面で使うかはルールが決める。

システムプロキシ クライアント機能

クライアントがOSにHTTP/SOCKSプロキシアドレスを登録するスイッチで、有効化するとブラウザなど「システム設定に従う」アプリが自動的にプロキシを経由する。適用範囲は限定的で、システム設定を読まないプログラム(多くのCLIツールや一部のゲーム)には影響しない。こうした通信はTUNモードで引き受ける必要がある。

遅延テスト クライアント機能

クライアントがノード経由でテストアドレス(一般的に http://www.gstatic.com/generate_204)にHTTPリクエストを送り、所要時間を計測する機能。数値は単純なping値ではなく完全な経路の品質を反映する。timeoutと表示されればそのノードは現在使用不可であることを示し、url-test プロキシグループはこの結果に基づき遅延最小のノードを自動選択する。

ログと接続 クライアント機能

クライアントの2つの調査入口:ログページはコアの動作記録をリアルタイムに出力し(レベルは log-level で制御)、接続ページは各アクティブ接続の宛先・マッチしたルール・出口ノードを一覧表示する。ルーティングが期待通りでない場合、まず接続ページで宛先ドメインが実際にどのルールにマッチしたかを確認するのが、闇雲に設定を変更するより遥かに速い。

次に確認すること

用語集が解決するのは「この言葉の意味」だけ。具体的な操作手順は入門ガイド、5プラットフォームの完全な導入設定は完全ドキュメント、エラー対応はよくある質問を参照。クライアントのインストールパッケージはプラットフォーム別にクライアント取得ページで整理している。

クライアントをダウンロード