mihomoの設定とトラブル対処に役立つ用語

Clashの用語集

config.yamlのフィールド名から、ログに記録された接続先を確認できます。

見慣れない設定項目はまず定義を確認しましょう。接続に問題がある場合は、通信の取り込み、名前解決、ルール照合、接続先の順に調べます。カードの見出しから各用語の詳細に直接移動できます。

カーネルとプロトコル

画面、カーネル、リモート側を切り分けておくと、エラーの調査先がわかります。

mihomo
mihomoはClashエコシステムのプロキシカーネルです。設定を読み込み、接続を受け付け、ルールに照合して、接続先を選択します。GUIクライアントは設定の取り込みや機能の切り替えを担い、接続を実際に処理するのはカーネルです。「未対応のフィールド」というエラーが出た場合は、画面のバージョンだけでなく、クライアントが実際に読み込んでいるカーネルのバージョンを確認してください。
プロキシプロトコル
プロキシプロトコルは、クライアントがリモートサーバーと接続し、認証やデータ転送を行う方法を定めたものです。ノードの設定では、まずtypeを確認し、そのプロトコルで必要なフィールドを調べます。ローカルアプリがHTTPプロキシで接続していても、カーネルがリモートサーバーへの接続にHTTPプロキシプロトコルを使うとは限りません。
混合ポート(mixed-port)
混合ポートを使うと、カーネルは同じローカルポートでHTTPとSOCKSのプロキシ接続を受け付けます。たとえば7890に設定すると、ローカルアプリは127.0.0.1:7890を指定し、対応するプロキシタイプを選べます。これはアプリが接続するポートであり、サブスクリプションURLやリモートサーバーのポートではありません。
UDP転送
UDP転送は、プロキシ経由でUDPデータグラムを転送する機能です。音声通話や一部のゲームで使われます。接続の入口でUDPを受け付け、選択した接続先とリモート側もUDPに対応している必要があります。Webページが開けても、その接続が通っていることしかわかりません。通話の問題を調べるときは、アプリのUDP通信がどこを経由しているかを個別に確認してください。

設定ファイルの構成

元のファイルと実際に適用される設定を区別しましょう。全体の構成は設定項目リファレンスをご覧ください。

YAML
YAMLはmihomoの設定に使われるデータ形式です。インデントで階層を表し、ハイフンでリスト項目を示します。インデントにはタブではなくスペースを使い、同じ階層の項目は位置をそろえます。解析エラーが特定の行を示していても、直前の行のコロンやインデントも確認してください。構造の不整合が次の行で検出されることがあります。
メイン設定(config.yaml)
メイン設定は、カーネルの起動時や再読み込み時に読み込まれる設定です。一般的なファイル名はconfig.yamlです。基本設定、プロキシ定義、プロキシグループ、ルールのほか、外部リソースを参照する設定も含められます。GUIクライアントはインポート後に別の実行用設定を保存することがあるため、手元にある同名ファイルを編集しても、カーネルが読み込む設定に反映されるとは限りません。
プロキシ定義(proxies)
proxiesは、メイン設定内でプロキシノードを1件ずつ定義するリストです。各項目にはnameを付け、プロトコルに応じてサーバーやポートなどを設定します。プロキシグループからは名前を指定して参照できます。ノード名を変更してグループから見つからなくなった場合は、まず参照先も変更したか確認してから、ネットワークを調べましょう。
オーバーライドとマージ
オーバーライドとマージでは、元の設定をもとに、実際に適用される別の設定を生成します。単一の値を変更する場合と、リスト項目を追加する場合では扱いが異なります。クライアントによって、リスト全体を置き換える場合もあれば、先頭や末尾への追加に対応する場合もあります。ルールを追加したら、適用後のリストを確認し、既存ルールが残っていることと、新しいルールが最終ルールより前にあることを確かめてください。

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

ルールは接続をどこに渡すかを決め、プロキシグループは実際にどの接続先を使うかを決めます。

ルール振り分け
ルールモードでは、条件に応じて接続先を選択します。通常のルールは上から順に確認され、一致すると以降のルールは処理されません。特定のドメインに適用するルールは、それを上書きする広い範囲のルールより前に置きます。独自ルールを調べるときは、まずmode: ruleを確認し、接続の詳細画面で実際に一致したルールを確認してください。
プロキシグループ(proxy-groups)
プロキシグループは、複数の接続先候補をひとつの名前にまとめ、ルールから参照できるようにします。グループにはノード、別のプロキシグループ、組み込みの接続先を指定できます。選択方法はグループのタイプによって異なります。ルールがグループに一致しただけでは接続先は確定しないため、実際の接続先を確認するときは、グループ内で現在選択されている項目も調べてください。
ドメインサフィックスルール(DOMAIN-SUFFIX)
ドメインサフィックスルールは、指定したドメインとそのサブドメインの両方に一致します。たとえばDOMAIN-SUFFIX,example.com,DIRECTは、example.comとapi.example.comに一致しますが、notexample.comには一致しません。完全一致するドメインをひとつだけ指定する場合は、DOMAINを使います。
GeoIP
GeoIPは、IPアドレス範囲のデータに基づいて地域を判定するルールタイプです。GEOIP,CN,DIRECTは、接続先IPアドレスがデータ上でCNに分類されているかを調べます。ドメインが.cnで終わるかどうかを判定するものではありません。同じドメインでも異なるIPアドレスに解決されることがあり、それに伴ってルールの一致結果が変わる場合があります。
最終ルール(MATCH)
MATCHには照合条件がなく、ルールリストの最後まで一致しなかった接続を処理します。MATCH,DIRECTは、それまでのルールに一致しなければ直接接続する指定です。最後の項目をプロキシグループにすることもできます。通常のルールをMATCHの後ろに追加しても、最終ルールが先に処理するため、接続には適用されません。
自動速度テストグループ(url-test)
url-testグループは指定したURLにプローブを送り、その結果に基づいて接続先を選択します。よく使うフィールドはurl、interval、toleranceです。許容値を設定すると、わずかな遅延の変動による切り替えを抑えられます。テスト用URLへの応答が速くても、利用するサービスへの接続が速いとは限らず、ダウンロード速度が上がるとも限りません。

ネットワークの取り込み方式

パケットがカーネルに取り込まれているか、ドメインの名前解決をどこに任せているかは、分けて確認しましょう。

システムプロキシ
システムプロキシは、アプリが参照するようOSが提供するプロキシ設定です。システム全体の通信が取り込まれるわけではありません。この設定を参照するアプリはローカルのプロキシポートに接続しますが、独自の設定を使うアプリはシステムプロキシを経由しないことがあります。ブラウザーでは接続できるのにターミナルから接続できない場合は、コマンドラインツールがどのプロキシ設定を参照しているか確認してください。
TUNモード
TUNモードでは、仮想ネットワークインターフェースでルーティングされたIPパケットを受け取り、カーネルで処理します。アプリ側でHTTPやSOCKSプロキシに対応する必要はありませんが、取り込み範囲はルーティング、権限、除外設定によって変わります。有効にしても接続一覧に記録がない場合は、仮想ネットワークインターフェースとルートが実際に適用されているか確認してください。
Fake-IP
Fake-IPはDNSの処理方式のひとつです。カーネルはアプリに一時的なIPアドレスを返し、そのアドレスとドメインの対応関係を記録します。そのアドレスへの接続を受け取ると、カーネルは対応するドメインを特定してルール照合に使えます。実際の名前解決結果を必要とするサービスでは、対象ドメインをfake-ip-filterに追加すべきか確認してください。
DNSハイジャック(dns-hijack)
mihomoのTUN設定におけるdns-hijackは、条件に一致したDNSクエリをカーネルのDNSモジュールに渡す設定です。上流DNSサーバーのアドレスを指定する項目ではなく、アプリがHTTPS経由で送信するDNSクエリを自動的に取り込むものでもありません。変更後は、クエリが受信されているか、受信後にどの上流DNSサーバーへ渡されているかを、それぞれ確認してください。
DNS漏れ
DNS漏れとは、指定した経路を通るはずのDNSクエリが、想定外の出口から送信されることです。Webページがプロキシ経由で開けても、その前の名前解決が同じ経路を通ったとは限りません。調査時はOSとアプリ内のDNS設定を個別に確認し、カーネルのログと照らし合わせて、想定したDNSサーバーを経由しているか確かめてください。
DNS振り分け(nameserver-policy)
DNS振り分けでは、クエリのドメインに応じて上流DNSサーバーを選択します。たとえば、社内ドメインは解決できる社内DNSサーバーに送り、それ以外は通常の上流DNSサーバーを使うよう設定できます。この設定で決まるのはDNSクエリへの応答先です。解決したアドレスへの接続を直接接続にするかプロキシ経由にするかは、別途ルールで決まります。

サブスクリプションとノード

取得できること、解析できること、接続できることは、それぞれ別の確認項目です。

サブスクリプション
サブスクリプションは、クライアントが設定やノード一覧を定期的に取得するためのもので、通常はURLで提供されます。完全な設定にはルールやプロキシグループが含まれる場合があります。一方、ノード一覧だけの場合は、既存の設定に取り込んで使うことがあります。インポート前に、クライアントがどの形式に対応しているか確認してください。トラブル相談用のスクリーンショットを共有するときは、サブスクリプションURLを写さないよう注意しましょう。
ノード
ノードは、カーネルが接続の中継先として選択できるリモートプロキシの項目です。名前は主に画面表示や設定からの参照に使われます。接続にはサーバーアドレス、ポート、プロトコルの各パラメーターが必要です。一覧に名前が表示されていても、項目が読み込まれたことしかわかりません。実際に使えるかどうかは、リモートへの接続状況と認証結果を確認してください。
ノードの遅延
クライアントに表示されるノードの遅延は、通常、そのノード経由でテスト用URLにアクセスした際の応答時間です。ノードのアドレスに単純な疎通確認を行った時間ではなく、ダウンロード速度に直接換算できる値でもありません。比較する際は、同じテスト用URLと接続ネットワークを使ってください。一度タイムアウトした場合は、その回の測定が時間内に完了しなかったことを示します。
サブスクリプションの更新
サブスクリプションの更新とは、リモートの内容を再取得し、クライアントが解析したうえでデータを置き換えたり更新したりする処理です。リクエストがタイムアウトした場合は、まずサブスクリプションURLへのネットワーク接続を確認します。返された内容をインポートできない場合は、レスポンスの形式を確認してください。更新が成功してもプロキシグループに古い項目が表示されるときは、現在有効な設定がそのサブスクリプションを参照しているか確認しましょう。