設定リファレンス / macOS

Clash用語解説

システムプロキシは、どのアプリが接続をカーネルに渡すかを決めます。ルール振り分けは、渡された接続の経路を決めます。設定項目、設定フィールド、ログ用語をカテゴリ別に確認できます。

カーネルとプロトコル

クライアントの画面、カーネル、リモート接続を区別しましょう。

mihomo

mihomoはClash.Metaプロジェクトを引き継ぐプロキシカーネルで、設定の読み込み、ローカル接続の待ち受け、ルール照合、外向き接続を担います。Clash Verge Revなどのクライアントは操作画面を提供し、実際のネットワーク処理はカーネルが実行します。設定の互換性を調べるときは、クライアントとカーネルのバージョンを分けて確認してください。画面に項目が表示されていても、実際の動作はカーネルの実装に依存します。

プロキシプロトコル

プロキシプロトコルは、ShadowsocksやTrojanなど、接続の確立、認証、データ転送の方式を定めます。ノードを設定する際は、プロトコルと各パラメーターをサーバー側に合わせる必要があります。サーバーアドレスとポートだけでは接続できません。ブラウザーからローカルプロキシへ接続する際のHTTPまたはSOCKS5と、カーネルがリモートノードへ接続する際のプロトコルは、別々の設定です。

プロキシノード

ノードは設定に記述するプロキシの接続先で、通常は名前、プロトコル、サーバーアドレス、ポート、接続パラメーターを含みます。プロキシグループには複数のノードのほか、DIRECTなどのポリシーも設定できます。同じ地域名が表示されていても、プロトコルや経路が異なる場合があります。ノードを切り替えたら、問題が起きていたアプリで接続を確認してください。

遅延

クライアントに表示されるノードの遅延は、通常、そのノード経由で指定されたテスト先に接続して測定した値です。単位はミリ秒です。テスト先、測定時刻、接続状態が変われば数値も変わります。遅延が小さくても帯域幅が大きいとは限りません。ファイルのダウンロードが遅い場合は、一度の測定値ではなく実際の転送速度を確認してください。

プロキシモード

まず通信がどのようにカーネルへ届くかを確認し、次にカーネルの処理方法を確認します。

システムプロキシ

システムプロキシを有効にすると、ClashクライアントがmacOSのネットワークプロキシ設定にローカルプロキシのアドレスとポートを書き込みます。その設定を参照して従うアプリだけが、対象のリクエストをカーネルに送ります。独自に接続するプログラムには適用されない場合があります。ブラウザーは使えるのにターミナルから接続できない場合は、まずコマンドラインツールがシステム設定を参照するか確認し、必要に応じて個別にプロキシを設定してください。

TUNモード

TUNモードは仮想ネットワークインターフェースとシステムルートを使い、対象の通信をプロキシカーネルに送ります。アプリがシステムプロキシを参照する必要はありません。有効化にはシステムの許可が必要な場合があり、通信の対象範囲はルート設定や除外項目にも左右されます。他のVPNや仮想ネットワークアダプターを同時に使っていて接続に問題が起きた場合は、ひとつずつ停止して比較し、ルートの競合をノードの障害と取り違えないようにしましょう。

接続モード

接続モードは、カーネルに渡された通信の処理方法だけを決めます。ルールモードでは設定順にルールを照合します。グローバルモードでは通常、グローバルグループで選択中のポリシーを使います。DIRECTモードでは受け取った通信を宛先へ直接接続します。グローバルに切り替えても、カーネルに渡されていないアプリが自動的にプロキシを使うわけではありません。DIRECTにしても、TUNが無効になったりシステムプロキシが解除されたりするわけではありません。

混合ポート

混合ポートはカーネルがローカルで待ち受けるポートです。mihomoの設定項目はmixed-portで、HTTPプロキシとSOCKS5のリクエストを同時に受け付けます。アプリ側では対応するプロキシの種類を指定する必要があり、ポート番号だけでは設定できません。ポート番号はクライアントの現在の設定を確認してください。チュートリアルの数値を使う前に、端末で実際に待ち受けているポートを確認しましょう。

ルールと振り分け

ログに表示された適用ルールから、接続の経路を確認しましょう。

ルール振り分け

ルールモードでは、カーネルが設定順にドメインや宛先IPなどの特徴を確認し、通常は最初に一致したルールを適用します。ルールでは接続をプロキシグループに渡すほか、DIRECTや拒否を指定できます。ルールを追加しても反映されない場合は、まず接続ログでどのルールが適用されたか確認し、新しいルールを範囲の広いルールより前に置く必要があるかを検討してください。

DOMAIN-SUFFIX

ドメインの末尾に基づいて照合するルールタイプです。DOMAIN-SUFFIX,example.com,DIRECTは、該当するドメインがわかる場合にexample.comとそのサブドメインであるwww.example.comに一致しますが、notexample.comには一致しません。完全一致するドメインだけを対象にする場合は、DOMAINを使います。

GeoIP

GeoIPは、宛先IPの割り当てデータに基づいて接続を判定します。サイトの言語、ドメインの末尾、Macの所在地では判断しません。宛先が最初はドメイン名で、カーネルがまだIPアドレスを把握していない場合、IPルールの確認時に名前解決が行われることがあります。同じサイトでも、地域ごとに異なるCDNノードが応答すると、宛先アドレスに応じて適用結果が変わる場合があります。

MATCH

MATCHは条件を指定せず一致するルールです。通常はルール一覧の最後に置き、それ以前のルールに一致しなかった接続を処理します。たとえばMATCH,DIRECTは、残りの接続を直接接続する設定です。具体的なドメインルールより前に置くと、接続が先にMATCHに一致するため、後続のドメインルールは適用されません。

サブスクリプションと設定ファイル

設定の取得元、ファイル形式、ルールから参照できるポリシーを区別しましょう。

サブスクリプション

サブスクリプションは、クライアントがリモートURLから設定やノード一覧を取得・更新する仕組みです。ブラウザーでURLを開けても、クライアントにインポートできるとは限りません。ログインページが返されたり、クライアント非対応の形式だったりする場合があります。更新に失敗したら、URLが有効か、取得内容が現在のクライアントに対応しているかを確認してください。エラーを共有する際は、サブスクリプションURL全体を公開しないでください。

YAML

YAMLはテキスト形式のデータ記述言語で、Clash関連の設定ではポート、プロキシグループ、ルール一覧などの記述に使われます。インデントで階層を表すため、タブではなくスペースを一貫して使ってください。リスト項目は通常、ハイフンで始まります。YAMLとして解析できても、すべての項目がカーネルに対応しているとは限りません。エラーが出た場合は項目名と値も確認しましょう。

プロキシグループ

プロキシグループは設定のproxy-groupsで定義します。ルールから固定のポリシー名を参照できるため、特定のノードを直接指定せずに済みます。手動選択型のグループではユーザーがメンバーを選び、自動テスト型では測定方式に基づいてメンバーが選ばれます。ポリシーを変更する際は、接続がどのグループに一致したかを先に確認してください。別のグループでノードを切り替えても、その接続のポリシーは変わりません。

ルールセット

ルールセットは、ドメインやアドレスなどの条件を独立したソースにまとめ、個別に更新できるようにします。mihomoの設定ではrule-providersでルールセットの参照元を定義し、ルール一覧からRULE-SETで呼び出します。一致した接続に適用するポリシーは、参照するルール行で指定します。ルールセットを更新しても、その行の優先順位は変わりません。

macOSのシステムネットワーク

設定が端末全体、現在のネットワークサービス、特定のアプリのどれに属するか確認しましょう。

ループバックアドレス

127.0.0.1はよく使われるIPv4のループバックアドレスで、接続元の端末自身を指します。macOSのプロキシ設定にこのアドレスを入力すると、アプリはMac上で待ち受けるポートに接続します。リモートノードのサーバーを指すわけではありません。同じアドレスをスマートフォンのプロキシ設定に入力すると、スマートフォン自身を指します。Mac上のカーネルが指定ポートで待ち受けていなければ、Macからも接続できません。

ネットワークサービス

macOSではネットワークサービスを使ってWi-FiやEthernetなどの接続を管理し、サービスごとにプロキシやDNSを設定できます。システムプロキシを確認するときは、「システム設定 → ネットワーク」で現在使用中のサービスを開き、プロキシ設定を確認してください。有線LANやドッキングステーションに切り替えた場合、以前のWi-Fi設定だけを見てプロキシが有効だと判断しないようにしましょう。

プロキシ除外リスト

システムネットワーク設定の除外リストでは、その設定に従うアプリがシステムプロキシを使わずに接続するホストやドメインを指定します。たとえばlocalhostのようなローカルサービスが対象です。除外はアプリがリクエストをローカルプロキシに送る前に行われるため、カーネルが接続を受け取った後にDIRECTを適用する処理とは異なります。TUN有効時のルート除外設定として扱わないでください。

プロキシ環境変数

一部のコマンドラインツールは、https_proxy、all_proxy、no_proxyを参照してプロキシを使うか判断します。対応状況は各ツールのドキュメントで確認してください。ターミナルのセッションで設定した環境変数は、そのセッションから起動した子プロセスに渡されますが、システム設定は自動では変更されません。ターミナルとブラウザーの動作が異なる場合は、それぞれのプロキシ設定元を確認しましょう。

DNSと名前解決

問い合わせ先と、接続の出口を分けて考えましょう。

DNS名前解決

DNS名前解決では、ドメインに対応するアドレスなどのレコードを問い合わせます。名前解決に成功しても、そのアドレスに接続できるとは限らず、どのプロキシルールが使われるかもわかりません。調査では「アドレスが返ってこない」場合と「アドレスはあるが接続できない」場合を分けてください。前者は名前解決の経路、後者は接続ログ、適用ポリシー、ノードの状態を確認します。

Fake-IP

カーネルはDNS応答で合成アドレスを返し、そのアドレスと元のドメインの対応をローカルに記録できます。後続の接続がカーネルに渡ると、ドメイン名を復元してルール照合に使えるため、合成アドレスが表示されても名前解決の障害とは限りません。実アドレスを必要とするLAN内サービスがある場合は、このモードとの競合を確認してから、ドメインごとにfake-ip-filterを設定することを検討してください。

DNSリーク

指定した経路で処理するはずのDNS問い合わせが別のDNSサーバーに送られると、DNSリークが発生する可能性があります。Webの通信がプロキシ経由でも、ドメインの問い合わせが同じ経路を通るとは限りません。クライアントのDNS設定、システムで現在使用中のDNSサーバー、ブラウザー独自のセキュアDNS設定を確認してください。テスト結果は、想定している名前解決のポリシーと照らし合わせましょう。

DNS振り分け

DNS振り分けは、ドメインや指定条件に応じて上流DNSサーバーを選ぶ仕組みです。たとえば、内部サービスのドメインを、そのドメインを解決できる組織内DNSサーバーに問い合わせる設定ができます。mihomoではnameserver-policyを使い、条件に一致したドメインの問い合わせ先を指定できます。これは「どのDNSサーバーに問い合わせるか」を決めるもので、「接続時にどの経路を使うか」とは別です。それぞれの段階で条件を確認してください。