· コア詳解 · 読了時間:約8分

mihomoとオリジナルClashの違い|対応プロトコル・ルールセット・設定項目

オリジナルClashと比較し、mihomo(Clash Meta)で拡張されたプロトコル、rule-providers、DNS、TUNの設定項目と、旧設定の移行時に見直す点を解説します。

カーネルのバージョンと設定の互換性

Clash Metaはmihomoの旧称です。オリジナルClashと比較する際は、オープンソース版のカーネルと、別途公開されていたClash Premiumを区別する必要があります。ルールセットやTUNはmihomoで初めて追加された機能ではありません。Premiumにも関連機能はありましたが、その設定をオリジナルのオープンソース版で共通して使えるとは限らず、mihomoですべての項目が同じ動作をするとも限りません。

移行前に、クライアントが実際に起動しているカーネルを確認してください。クライアントとカーネルのバージョン番号は別物です。使用中のmihomo実行ファイルにアクセスできる場合は、mihomo -vでバージョンを確認できます。別途ダウンロードした同名のバイナリが、GUIクライアントで使われているとは限りません。

設定項目mihomoへの移行時の対応
mixed-port、modeまずは元の値を維持します。クライアントが待ち受けポートや動作モードを上書きする場合は、実際の起動時に適用された値を確認してください。
proxies、proxy-groups、rules一般的な構造はそのまま利用できます。ノードの種類、グループのメンバー名、ルールの振り分け先を一つずつ確認してください。
rule-providers、RULE-SET旧設定がPremium向けの場合は、読み込み方法、ルールの動作、実際のマッチ順を確認してください。
dns、tun項目ごとに移行して検証してください。DNSの上流、拡張モード、システムルートを同時に変更しないでください。

対応プロトコルの追加:ノードタイプとトランスポート項目を確認

mihomoでは、オリジナルClashより幅広いプロトコルをアウトバウンドで利用できます。たとえば、VLESSノードはtype: vless、Hysteria 2はtype: hysteria2、TUICはtype: tuicと記述します。旧設定のtype: vmessをtype: vlessに書き換えただけでは、プロトコルは変換されません。アウトバウンドの種類、認証情報、トランスポート設定をサーバー側に合わせる必要があります。

  • VLESSとREALITY:VLESSはノードのプロトコルであり、REALITYは独立したtypeではありません。REALITYを使うVLESSノードでは、servernameとreality-opts内のpublic-key、short-idを確認してください。flowは、サーバー側でVisionが要求されている場合にのみ設定します。
  • Hysteria 2とTUIC:どちらもQUICをベースにしています。サーバーのホスト名を名前解決できる、Webサイトにアクセスできる、またはサーバーのTCPポートに接続できるだけでは、同じポートへのUDP通信が可能とは判断できません。トラブル時は、プロトコル設定、認証情報、ネットワークがUDPに対応しているかを個別に確認してください。
  • サブスクリプションのインポート:完全なYAML設定と、ノードプロバイダー用のノード一覧を区別してください。サブスクリプションの更新が成功したということは、クライアントが内容を取得できたというだけです。新しいノードがプロキシグループに登録されていなければ、通常のリクエストは従来のアウトバウンドを通る可能性があります。

ルールセット:ファイル形式・動作・マッチ順

rule-providersでルールセットを登録し、rules内のRULE-SETで適用条件とマッチ時のアウトバウンドを指定します。ここではローカルファイルを使って移行方法を説明し、リモートルールセットのダウンロード失敗と設定ミスを切り分けます。

メイン設定でのルールセット参照

mode: rule
rule-providers:
  local-domains:
    type: file
    behavior: classical
    format: yaml
    path: ./rules/local-domains.yaml
rules:
  - RULE-SET,local-domains,DIRECT
  - MATCH,DIRECT

ルールセットファイル rules/local-domains.yaml

payload:
  - DOMAIN-SUFFIX,example.org

ここでは2つのルールをどちらもDIRECTに設定し、デフォルトのアウトバウンドを変えずにルールのマッチを確認します。ルールモードでは、通常、上から順に照合され、最初にマッチしたルールが適用されます。接続ログで検証する際は、example.orgが末尾のMATCHではなくRULE-SETにマッチしていることを確認してください。アウトバウンド名だけでは、どちらのルールにマッチしたか判別できません。実際の設定ではフォールバックルールを最後に置き、それより上にある広範なドメインルールやIPルールに先にマッチしないかも確認してください。

behavior: classicalでは、例にあるDOMAIN-SUFFIX,example.org形式を使用できます。behavior: domainではドメインのマッチ項目を読み込むため、ルールタイプの接頭辞を付けた形式は使いません。behavior: ipcidrではIPアドレス範囲を読み込みます。formatが指定するのはファイル形式であり、マッチ動作ではありません。拡張子を.mrsに変えても、YAMLがMRSに変換されるわけではありません。MRSを使う場合は実際に生成されたファイルを使用し、ルールの動作にはdomainまたはipcidrを指定してください。

DNS移行:アクセス先のドメインとノードのドメインを区別する

アクセス先のドメインはアプリが接続する宛先、ノードのドメインはプロキシサーバー自体のアドレスです。前者をクライアントが名前解決できても、カーネルが後者を解決できるとは限りません。ノード設定のserverにドメイン名を指定している場合、mihomoではproxy-server-nameserverを使い、ノードの名前解決に使う上流DNSを指定できます。トラブル時は、ノードに接続する前でもその上流に到達できることを確認し、「ノードに接続しないとノード名を解決できない」という依存関係を避けてください。

  • nameserverは通常のDNS問い合わせに使う上流の一つです。nameserver-policyでは、指定したドメインに別の上流を割り当てられます。社内ドメインには、その内部ゾーンを解決できるDNSを指定してください。パブリックDNSを追加するだけでは解決できません。
  • enhanced-mode: fake-ipでは、条件に一致する問い合わせにマッピング用のIPアドレスを返します。実際の設定で198.18.0.1/16を使用している場合、この範囲の応答が返るのは通常の動作であり、接続先サーバーのグローバルIPアドレスではありません。
  • 社内ドメインに実IPアドレスが必要な場合は、fake-ip-filterとfake-ip-filter-modeを確認してください。ブラックリストモードでは、フィルター項目に一致するドメインにFake IPを返しません。フィルターで変わるのは応答方式だけであり、社内ドメインを解決できる上流が自動的に選ばれるわけではありません。

通常のDNS問い合わせは成功するのにアプリの通信が失敗する場合は、同じドメインを使い、アプリが実際に利用する名前解決経路とカーネルの接続ログを比較してください。ブラウザー独自の暗号化DNSは別の経路を使う場合があります。また、IPベースのルールによってドメインの名前解決が発生することがあります。該当するルールにno-resolveを指定すると、そのルールによるドメインのIP問い合わせを防げますが、DNS全体が無効になるわけではありません。

TUN移行:まずプロキシポートを検証し、その後システムルートを切り替える

システムプロキシは、アプリがプロキシ設定に従うことを前提とします。TUNは仮想ネットワークインターフェースとルートを使って通信を取り込みます。システムプロキシ経由でブラウザーが正常に動いても、TUNが端末全体、ゲーム、その他のシステムプロキシを参照しないアプリの通信を取り込めているとは限りません。移行時はまずTUNを無効にし、プロキシの待ち受けとノードを確認してから、TUNを個別に有効にして変化を比較してください。

  1. 実際の設定がmixed-port: 7890の場合、curl -I --proxy http://127.0.0.1:7890 https://example.org/を実行できます。curlが別名に設定されているWindows PowerShellでは、curl.exeを使ってください。応答を受け取った後は接続ログも確認し、リクエストが想定したポリシーを通ったか検証します。応答が返っても、プロキシノードが選択されたとは限りません。
  2. tun.enableを有効にしたら、カーネルに仮想ネットワークインターフェースの作成とルート変更の権限があるか確認してください。auto-routeはルートの自動追加を制御します。有線・無線LANや他のVPNを併用している場合は、自動判定された出口が正しいか確認してください。デフォルトの出口をノード障害と誤認しないようにしましょう。
  3. TUNを有効にした後にDNSだけが不安定になる場合は、dns-hijackの対象範囲を確認してください。any:53はUDP 53、tcp://any:53はTCP 53にマッチします。これらの設定では、HTTPS上の暗号化DNSを通常の53番ポートの問い合わせとして取り込むことはできません。

旧設定の移行・検証手順

動作する旧設定は残し、新しい設定は別の作業ディレクトリでテストしてください。以下のコマンドは、設定ファイルのある作業ディレクトリから実行します。GUIクライアントを使う場合は、サブスクリプションのマージや上書きが適用された後、実際にカーネルへ渡される設定も確認してください。

mihomo -v
mihomo -t -d . -f config.yaml

-tは設定ファイルのテスト用であり、実行時の検証に代わるものではありません。まず動作確認済みのノードでプロキシの入口を検証し、次に直接接続するリクエストとプロキシグループを経由するリクエストを1件ずつ確認します。最後にDNSとTUNを個別に検証してください。サブスクリプション更新後に問題が再発した場合は、更新前後の実際のルール順とグループメンバーを比較し、上書き設定が引き続き適用されているか確認します。

切り替え後に社内ネットワークにも接続できなくなった場合は、まずTUNを無効にし、以前のシステムプロキシと設定に戻してから、項目ごとに再検証してください。各項目の意味は設定リファレンスを、アプリのプロキシ設定・プロキシグループ・カーネルの関係は用語解説をご覧ください。

Clashをダウンロード