config.yaml / 項目リファレンス
Clash設定ファイルのリファレンス
サブスクリプションの初回追加、モード選択、接続確認は導入ガイドから始めましょう。接続までの手順はチュートリアルで、このハンドブックでは接続後の設定の読み方や項目の変更方法、変更結果の確認方法を説明します。
例はMihomoを基準にしています。クライアント画面の機能名とYAMLのキー名が一致するとは限らず、古いコアでは同じオプションを認識しない場合もあります。単独で読み込めると明記した例を除き、各スニペットは該当項目だけを示しています。既存の設定ファイルの適切な位置に追加してください。
config.yaml / 01
YAMLの構造と設定ファイルの入口
トップレベルのキー・マッピング・リスト
設定ファイルのトップレベルには、キーと値が並びます。同じ階層にある mixed-port、mode、rules はそれぞれ別の設定を表し、通常は記述順を変えても意味は変わりません。一方、rules の下は順序が意味を持つルールリストです。先頭と末尾のルールを安易に入れ替えてはいけません。まず対象がマッピングなのかリストなのかを見分け、コピーした数行をどこに追加するか判断しましょう。dns: true のように設定一式を単なるスイッチに置き換えると、YAMLとして解析できても、コアが想定する構造にはなりません。
通常、階層が1つ深くなるごとに半角スペースを2つ使い、タブは使いません。次のファイルは単独で読み込めます。混合ポートを1つだけ待ち受け、受信したリクエストをすべて直接接続するため、上流ノードは不要です。読み込む前に、同じポートを別のインスタンスが使用していないか確認してください。アプリが接続されているかの確認には使えますが、リモートノードの検証には使えません。DNS設定を追加する場合は、トップレベルに dns を追加します。最後のルールの下にインデントしてはいけません。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
- MATCH,DIRECT
ハイフンで始まる項目は、それぞれリストの要素です。ノードリストの1要素は複数行にわたることがあり、1行目に名前、その下に種類、サーバー、ポートを同じ位置にそろえて記述します。ルールリストの1要素は、通常1行の文字列です。特に間違えやすいのが、プロキシグループ内の proxies です。ここに記述するのは候補の名前であり、サーバーアドレスを含むノード定義ではありません。同じキーでも階層が異なればデータの形も異なり、互いに置き換えることはできません。
スカラー値の型とキーの重複
ポートは整数、スイッチは真偽値、名前やサーバーは文字列で指定します。数字の並びを名前として扱う場合は引用符で囲み、参照する側でも文字列として扱います。通常の文字列に、空白に続くコロンやコメント開始と解釈される可能性のあるシャープ記号が含まれる場合も、値全体を引用符で囲みましょう。ルール文字列は通常、引用符を必要としません。エディターが句読点を別の構造として解析してしまう場合は、カンマで区切った各項目ではなく、ルール全体を引用符で囲みます。
同じファイル内に同名のトップレベルキーを複数記述しないでください。すでに rules があるファイルの末尾にもう一度 rules を貼り付けても、既存リストに要素が追加されるわけではありません。重複キーとしてエラーになるパーサーもあれば、片方だけを残すものもあります。この問題を調べるときは、まず該当キーが2回登場していないか確認し、数行さかのぼって実際の階層を特定します。エディターがインデントの異常を指摘していても、原因は直前の行のコロン抜けや、さらに前のリストが正しく閉じられていないこともあります。
元のサブスクリプション設定から実行設定まで
GUIクライアントでは、インポートした設定、上書き設定、実行設定がそれぞれ別のファイルであることがよくあります。インポートした設定はサブスクリプションの更新で再生成される場合があり、上書き設定にはローカルでの変更が保存され、実行設定がコアに読み込まれます。項目が反映されたか確認するには、まず現在選択中のプロファイルを確かめ、クライアントに実行設定のプレビューやエクスポート機能があるか確認してください。最初にダウンロードしたファイルを開いただけでは、サブスクリプションから何が届いたかはわかっても、現在システムがその設定を使用している証拠にはなりません。
Mihomoを単独で実行している場合は、コアの作業環境で候補ファイルを確認できます。相対パス、外部ルールファイル、作業ディレクトリは、実際の実行環境にできるだけ合わせてください。リモートプロバイダーを含む設定では、確認時にも依存ファイルやネットワークが必要になる場合があります。以下のコマンドでGUIクライアントのプロファイルが切り替わることはなく、ポートをバインドできることや外部ネットワークに必ず接続できることも証明できません。まず前述の最小設定で構文エラーを除外し、次に実際の候補ファイルを使って参照先を確認してから、実行環境に読み込ませてください。
mihomo -t -f ./config.yaml
127.0.0.1 / 02
待受ポート・動作モード・コントローラー
ローカルの待受ポートと上流ポートを区別する
ブラウザーやターミナルが接続するのは、たとえば 127.0.0.1:7890 のようなローカルの待受アドレスです。一方、コアが接続するのはノード定義にあるサーバーアドレスとポートです。たまたま同じポート番号を使う場合はありますが、両者に連動性はありません。ローカルの待受ポートを変更したら、システムプロキシやアプリのプロキシ設定も変更します。ノードのポートを変更しても、通常はローカルアプリ側を変更する必要はありません。「接続を拒否されました」と表示されたら、まずログのアドレスがローカルかノード側かを確認してから、調べる項目を決めましょう。
| 項目 | 用途 | 確認箇所 |
|---|---|---|
mixed-port | 1つのポートでHTTPとSOCKSのプロキシ接続を受け付ける | システムプロキシやSOCKS対応アプリを、それぞれ対応するプロトコルで接続できる |
port | HTTPプロキシ専用の待受ポート | アプリに設定するHTTPプロキシアドレス |
socks-port | SOCKSプロキシ専用の待受ポート | アプリに設定するSOCKSプロキシアドレス |
allow-lan | LAN内のデバイスからプロキシの待受ポートへの接続を許可するか | 待受アドレス、システムファイアウォール、実際の接続元 |
external-controller | コアの外部コントローラー | クライアントのダッシュボードやローカル管理ツール向け。アプリのプロキシ接続先ではありません |
ローカルでのみ使う場合は、allow-lan: false のままにしてください。ループバックアドレスは接続元の端末を指すため、スマートフォンで 127.0.0.1 を指定してもパソコンには接続できません。信頼できるLAN内で共有する必要がある場合に限り、allow-lan、bind-address、ファイアウォールを確認してください。必要なデバイスだけに公開し、待受ポートをインターネットに公開しないようにします。パソコン上のブラウザーが接続されているか調べるだけなら、LANアクセスを有効にする必要はありません。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
個別ルールの前にモードを確認
rule モードではルールリストに従って接続先を選びます。global モードではグローバルポリシーの現在の選択先を使いますが、必ずリモートノードを使うわけではありません。direct モードではコアに入った通信を直接接続しますが、待受を停止したりシステムプロキシを解除したりするわけではありません。一時的にモードを切り替えたら、接続を再実行してください。既存の長時間接続は、新しいモードですぐに再確立されるとは限りません。チャット、同期、ダウンロードなどをバックグラウンドで常時実行している場合は、接続詳細で古い接続か新しい接続かを確認します。
GUIクライアントは管理インターフェース経由で、実行中のモードを変更できます。そのため、ファイルに mode: rule と書かれていても、直前に画面で選択したグローバルモードが解除されたとは限りません。ルールが適用されない原因を調べるときは、まず画面上の現在のモードと選択中のプロファイルを確認し、それからルールを確認します。3つのモードを比較する方法はルール・グローバル・直接接続モードの違いを参照してください。モード切り替えだけで恒久的に解決したと考えないようにしましょう。
まずプロキシ接続を確認し、次に管理インターフェースを調べる
システムプロキシはOSやクライアントが設定しますが、その設定を参照するアプリだけが利用します。ターミナルではコマンドごとにプロキシを指定する必要がある場合があり、ブラウザーによっては拡張機能や独自設定が優先されます。まず下のコマンドを実行し、同じ時刻の接続記録から接続先を探してみましょう。応答があれば、そのリクエストが指定したプロキシを経由して完了したことはわかりますが、ターミナルのすべてのコマンドがプロキシを使うとは限りません。ローカル接続拒否のエラーが出た場合は、ポートとプロセスを調べてから、ブラウザーとターミナルを分けて調べる方法で原因を絞り込みます。
curl -I --proxy http://127.0.0.1:7890 https://example.com/
管理インターフェースは別の接続経路です。GUIクライアントがコアを管理している場合、設定を試すために管理用アドレスや認証情報を不用意に変更しないでください。コアを単独で起動し、外部から操作する必要がある場合は、ループバックアドレスへのバインドを優先し、管理ツールの要件に従ってローカル認証を設定します。ポート競合が起きたら、プロキシポートと管理ポートを分けて確認してください。一方を変更したら、対応する呼び出し元の設定も更新します。一時的にログレベルを上げると原因を調べやすくなりますが、確認後は通常のレベルに戻してください。設定の一部を共有する前に、プライベートアドレス、サブスクリプションURL、認証情報を削除しましょう。
proxies / 03
プロキシノードの設定項目と外部ノードの参照元
名前・プロトコル・接続先アドレス・ポート
proxies には、コアで利用する出向き先ノードを定義します。name はプロキシグループやルールから参照する名前、type は使用するプロトコル、server と port はプロトコルサーバーの接続先です。サーバー項目にはホスト名またはアドレスだけを指定し、プロトコルの接頭辞、パス、余分なポート部分は含めません。名前は短く一意にし、DIRECT や REJECT などの組み込みターゲット名も使わないでください。
以下はSOCKS5の出向き先ノードの例です。同じ端末で独立したSOCKS5サービスが実際に 1080 を待ち受け、認証なしのローカル接続を許可している場合に限り、転送テストに使えます。このアドレスは公開ノードではありません。また、前章のClash自身の混合ポートに置き換えると、同じコアに出向き通信を戻してしまうおそれがあります。このスニペットを最小設定に追加した後、テスト用のルールまたはプロキシグループからノードを参照してください。定義しただけでは MATCH,DIRECT の接続先は変わりません。
proxies:
- name: ローカル上流
type: socks5
server: 127.0.0.1
port: 1080
udp: false
プロトコルを変更するときは、種類だけでなくパラメーター一式の変更が必要になる場合があります。TLS対応ノードを例にすると、サーバーアドレスは接続先を示し、サーバー名はハンドシェイクや証明書の検証に使われることがあります。この2つは同じとは限りません。追加のトランスポート方式もサーバー側の設定と一致させる必要があります。ポートが443だからといって、TLSや特定のトランスポート設定を追加してよいわけではありません。項目名がわからない場合は、使用中のコアが対応するプロトコルの説明と、サーバー側から提供された設定を確認し、別のプロトコルの認証項目をそのまま流用しないでください。
ノードリストとプロキシグループの依存関係
ノード名を変更したら、グループ内の候補リスト、そのノードを直接指定するルール、クライアントに保存された手動選択を確認してください。新しい名前が古い名前と空白1つだけ違っていても、参照先が自動で引き継がれることはありません。異なる参照元に同じ名前のノードがあると、ログで現在のノードを取り違えやすくなります。参照元側で名前を区別するか、使用中のコアが正式に対応しているプロバイダーの名前上書き機能を使い、最終的に生成された候補リストを確認する方法が確実です。
ノード数が多い場合や個別に更新したい場合は、proxy-providers で参照元に名前を付け、グループから use で読み込めます。以下はファイル型プロバイダーの例で、指定した相対パスを読み込めるMihomoの作業ディレクトリが必要です。対象ファイルは事前に用意してください。内容には前の例のような proxies の完全なマッピングを記述できます。ノードは外部ファイルで管理し、メイン設定に同名ノードを再定義する必要はありません。プロバイダー名はノード名とは異なるため、参照元の名前をルールの接続先として直接指定することはできません。
proxy-providers:
office-socks:
type: file
path: ./providers/office-socks.yaml
proxy-groups:
- name: オフィス用出口
type: select
use:
- office-socks
proxies:
- DIRECT
設定読み込みエラーと接続エラーを分けて調べる
プロバイダーがグループに表示されない場合は、まず参照名、ファイルパス、読み込みログを確認します。ファイルが存在するのに読み込めない場合は、プロバイダーの種類とファイルの内容が一致していないことがよくあります。たとえば、サブスクリプションのWebページ、通常のノード共有テキスト、エラーレスポンスをYAMLファイルとして読み込もうとしているケースです。ノードが表示され選択できるなら、問題は接続段階にあります。サーバードメインを名前解決できるか、接続先ポートに到達できるかを確認し、次にハンドシェイクや認証の失敗を調べます。最後にWebリクエストとテストリクエストの違いを比較してください。
同じノードでWebページを開けても、すべてのアプリが使う通信方式に対応しているとは限りません。udp: true を指定しても、上流にUDP機能が追加されるわけではありません。転送の可否はプロトコル、サーバー、クライアントの接続方式によって決まります。ゲームや音声通話に問題がある一方で通常のWebページは開ける場合は、まず対象の通信が本当にコアに届いているか、実際にどの種類の通信かを確認してから、ルールが選んだ出口を調べます。別のクライアントで比較する場合は、クライアント一覧からClash Plusや他のプラットフォーム向けの選択肢を確認し、OSと必要な機能に合わせて選んでください。
proxy-groups / 04
プロキシグループ・候補メンバー・接続先のテスト方式
プロキシグループはルールと出口の間をつなぐ
プロキシグループ自体はサーバーを定義しません。ルールからグループに通信を渡し、そのグループでノード、直接接続、または別のグループを選びます。これにより、各ルールで使用中のサーバーを個別に管理する必要がなくなります。たとえば、業務用ドメインを「オフィス用出口」に割り当てておけば、一時的に直接接続したいときはグループ内の選択先を変えるだけです。同じグループを使う他のアドレスにも変更が反映されます。1つのドメインだけ変更したい場合は、まずグループ全体を切り替えるのではなく、そのドメイン専用の詳細なルールが必要か確認してください。
select は手動選択です。以下のスニペットを使うには、メイン設定に前章の「ローカル上流」が定義されている必要があります。ローカルのルーティングを確認する場合は、まず DIRECT を選んでリクエストの実際の経路を記録し、次に上流を選んで同じリクエストを行います。ノードが候補に表示されていても、選択済みとは限りません。クライアントが以前の選択を記憶している場合もあるため、YAMLリストの先頭項目が現在の出口だと決めつけないでください。
proxy-groups:
- name: オフィス用出口
type: select
proxies:
- DIRECT
- ローカル上流
速度テスト・フェイルオーバー・負荷分散
url-test は各候補から指定したテスト先への応答を測定し、自動で出口を選択します。fallback は順番に並んだ候補から利用可能なものを選ぶことを重視します。第一候補の経路が遠く、切断されたときだけ予備経路を使いたい場合は、単発の遅延測定で切り替えるのではなく、フェイルオーバーの仕組みを理解したうえで選びましょう。load-balance は候補間で接続を振り分けるための設定です。1回のダウンロードを複数経路に分割する機能ではなく、ログインセッションの接続元に左右されるサービスにも、確認せずに適用しないでください。
以下では直接接続とローカル上流を使って自動テストを説明します。特定の出口を必ず使う必要がある通信では、テスト結果を見栄えよくするために直接接続を自動候補に加えないでください。interval は秒単位のテスト間隔です。このグループでの tolerance は一定の遅延差を許容し、小さな変化で候補が頻繁に切り替わるのを抑えます。テスト先は安定していて各候補からアクセスでき、実際の用途をできるだけ反映するものを選んでください。例示したサイトに接続できても、同じ出口から業務用ドメインに接続できるとは限りません。
proxy-groups:
- name: 接続テスト
type: url-test
proxies:
- ローカル上流
- DIRECT
url: https://example.com/
interval: 300
tolerance: 50
自動グループがいつも同じ経路を選ぶ場合は、他の候補の測定値が遅いのか、テストがタイムアウトしているのか、生成後のグループに候補が含まれていないのかを確認してください。テストリクエストが接続先のレート制限を受けたり、候補経路から想定外のページが返されたりする場合もあります。特にモバイル端末では、最初から間隔を数秒に短縮しないでください。テストの負荷が増えても、原因がわかるとは限りません。異常な候補を1つだけテストし、接続ログ、現在の選択先、実際の通信を比較しましょう。この3つが示す内容はそれぞれ異なります。
グループのネストと選択状態
メイングループに自動選択グループを含めると、「用途を手動で選び、経路は自動で選択する」構成にできます。ただし、参照先が自分自身に戻る循環は避けてください。たとえば「オフィス用出口」の候補に「接続テスト」を加える場合、「接続テスト」側の候補に「オフィス用出口」を含めてはいけません。ログを確認するときは、ルールの接続先から外側のグループ、内側のグループをたどり、最後に実際のノードを確認します。グループが何層にも重なっている場合は、現在の選択を説明できる範囲まで整理した方が、さらに階層を増やすより管理しやすくなります。
Mihomoの profile.store-selected はプロキシグループの選択状態を保存する設定です。復元結果はクライアントのプロファイル識別子、キャッシュディレクトリ、グループ名やノード名にも左右されます。以下はトップレベルに追加するスニペットで、キー名は単数形です。サブスクリプションの更新で元のノードが削除または改名された場合、保存していても存在しなくなった候補は復元できません。プロファイルを切り替えた後は、保存された選択先が現在も候補に含まれているか確認してください。何度も切り替えて覚えているか試す必要はありません。
profile:
store-selected: true
DIRECT / 05
ルールの構文・評価順序・デフォルトの接続先
最初に一致したルールから確認する
ルールモードでは、ルールを上から順に確認します。一致したルールが見つかると、指定された接続先に処理が渡され、より詳細なルールを自動で探し続けることはありません。ドメインの例外は、対象を含むドメインサフィックスのルールより前に置きます。特定のIPアドレスの例外も、対象を含むネットワーク範囲のルールより前に置いてください。「特定のサイトがいつも誤った経路を使う」ように見える場合は、同じリクエストに最初に一致したルールを確認しましょう。ファイル内にそのドメインが書かれているか検索するだけでは不十分です。
ここでは、プロキシグループ「オフィス用出口」が定義済みとします。DOMAIN は完全なドメイン名に一致し、DOMAIN-SUFFIX はそのドメインとサブドメインに一致するため、最初のルールで www.example.com をサフィックスルールより先に振り分けています。IP-CIDR はIPv4のネットワーク範囲を判定します。以下では、よく使われるプライベートアドレス3範囲とローカルループバック範囲を直接接続にしています。最後の MATCH はフォールバックで、それより前のルールに一致しない場合だけ使われます。例では直接接続を指定していますが、実際のデフォルト接続先は利用環境に合わせて決めてください。
rules:
- DOMAIN,www.example.com,DIRECT
- DOMAIN-SUFFIX,example.com,オフィス用出口
- IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT
no-resolve はクライアント全体のDNSを無効にする設定ではありません。このIPルールの条件判定のために、追加のドメイン名前解決を行わないようにするものです。接続先IPがすでにわかっている場合は、引き続きIPで判定できます。そのため、最終的にプライベートIPへ解決される社内ドメインでも、このルールには一致しないことがあります。直接接続するドメインがわかっている場合は、該当する完全一致ルールや適切なドメインサフィックスのルールを前に追加しましょう。プライベートIP範囲のルールが、どの接続方法でも同じ結果になると期待しないでください。
アドレス・ドメイン・実際に観測された宛先
ルールが判定する宛先は、アプリからコアに何が渡されたかによって異なります。あるアプリはドメイン名をプロキシに渡しますが、別のアプリは先に名前解決を済ませてIPアドレスだけを渡す場合があります。ブラウザーのアドレスバーにドメインが表示されていても、ルールがそのドメイン名を受け取ったとは限りません。また、IPv4用のネットワークルールではIPv6の宛先をカバーできません。IPv4とIPv6の両方を使う環境では、接続詳細でアドレスファミリーごとの実際の宛先を確認し、必要に応じてルールを追加してください。切り分け方法を、片方のアドレスファミリーを無効にすることだけに頼らないようにしましょう。
1つのページから複数の接続先にリクエストが送られるのが一般的です。メインページが直接接続されても、フォント、画像、ログイン、APIリクエストまで直接接続されるとは限りません。変更を確認するときは、宛先を明確にしたリクエストを1つだけ行い、ルールログと照合して古い接続を整理します。クライアントに一致したルールとグループの経路が表示される場合は、「宛先、マッチしたルール、グループ、実際の出口」の順に記録してください。これにより、ルールの誤判定、グループ内の選択ミス、正しい経路で接続しているのに接続先サービスが応答しない問題を区別できます。
長いドメインリストをプロバイダーに分ける
複数のドメインで同じ出口を使う場合は、rule-providers でリストを管理し、メインルールにはリストの挿入位置と接続先だけを記述できます。以下のローカルファイルでは domain 形式を使い、ドメインを1行ずつ記述します。カンマ区切りの完全なルールは書きません。メイン設定では RULE-SET でリストを照合します。リストが条件を定義し、接続先はメイン設定側で指定します。ルールの種類と照合内容を含む完全なルールを移す場合は、コアが対応する classical 形式に整えてください。接続先まで含むルール行をそのままコピーすることはできません。
rule-providers:
office-domains:
type: file
behavior: domain
format: yaml
path: ./rules/office-domains.yaml
rules:
- RULE-SET,office-domains,オフィス用出口
- MATCH,DIRECT
# ./rules/office-domains.yaml
payload:
- 'example.com'
- 'www.example.com'
リストをファイルに分けるかどうかより、配置場所の方が重要です。例外を先に直接接続する必要がある場合は、それを含む RULE-SET より前に置きます。フォールバックルールの後ろに配置すると、一致する機会がありません。REJECT を使う場合も、アクセス不要と確認できている特定のドメインを使って動作を比較してください。拒否ルールに一致した場合、画面上ではネットワーク障害と似た状態に見えることがあります。プロキシモードを何度も切り替えるより、接続記録を確認した方が原因を特定できます。
dns / 06
DNSの上流サーバー・合成アドレス・TUN接続
まず、どの機能が名前解決しているか確認する
コアの dns 設定が制御するのは、コア自身の名前解決処理です。上流を設定しても、OS、ブラウザー、すべてのアプリが問い合わせをコアに渡すとは限りません。ブラウザーが独自の暗号化DNSを使ったり、アプリが接続をプロキシに渡す前に名前解決を済ませたり、OSに以前のキャッシュが残っていたりすることがあります。「コアには上流を設定したのに別の結果が返る」場合は、システムのリゾルバーへの直接問い合わせ、コアのDNS待受への問い合わせ、プロキシによるアプリのドメイン処理のどれをテストしているか、まず確認してください。
以下ではループバックアドレスの標準外ポートで待ち受け、問い合わせ経路を区別します。有効にしたら、dig がインストールされた環境からポートを指定して問い合わせできます。例では公開DNSサービスを上流に使うため、現在のネットワークから到達できる必要があります。組織内のプライベートドメインには、通常、組織から提供されたリゾルバーが必要です。問い合わせに1回応答があっても、この経路で応答を受け取れたことしかわかりません。ブラウザーがそのDNSを使用していることや、すべてのアプリに必要な結果が返ることまでは証明できません。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: redir-host
nameserver:
- 223.5.5.5
dig @127.0.0.1 -p 1053 example.com A
アプリのドメインとノードのドメインを分けて確認する
nameserver は通常の問い合わせに使う上流サーバーの一覧です。特定のドメイン群を別の上流で処理する場合、Mihomoでは nameserver-policy でドメインごとに上流を指定できます。まず、指定する上流が対象ドメインに正しく応答できることを確認し、必要な範囲に絞ったルールを追加してください。組織内ドメインの問い合わせをパブリックDNSに送れば、結果が返らなくても不思議ではありません。同じ種類のパブリック上流を繰り返し追加するのではなく、直接接続時にシステムがどのリゾルバーを使っているか確認しましょう。
上流サーバー自体にドメイン名を使う場合は、そのサーバー名を最初に解決する方法も必要です。default-nameserver はDNSサーバー名の解決に使い、proxy-server-nameserver はプロキシノードのサーバー名の解決に使います。ノード接続の前提となる名前解決と通常の問い合わせを分けるのに役立ちます。調査時は、依存関係が循環していないか特に注意してください。リゾルバーに接続するにはノードが必要なのに、ノードのアドレスを調べるにはそのリゾルバーが必要、という状態です。まず単独で機能する名前解決経路を復旧し、その後、ルールに応じてDNSの出口を選ぶ設定を1つずつ戻します。
合成アドレスはサーバーの実アドレスではない
fake-ip モードでは、コアがドメイン名に合成アドレスを返し、その後、該当する接続がコアに届いた時点で対応付けから元のドメインを特定できます。ログに 198.18.0.0/16 のアドレスが表示されても、公開Webサイトがその範囲に移転したわけではありません。以下は独立した置き換え用の設定です。前の dns ブロックの後ろに追加して、キーを重複させないでください。実際の名前解決結果が必要で、互換性の問題も確認できた社内ドメインには、必要に応じて fake-ip-filter を使います。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- '+.lan'
nameserver:
- 223.5.5.5
名前解決モードを切り替えた後も、アプリが古いキャッシュを保持していると、以前の合成アドレスへの接続を試みる場合があります。影響を受けるアプリから新たに問い合わせを行い、DNS応答と接続ログを照合してください。同じ環境で該当範囲をテストや内部ルーティングに使っている場合は、アドレスが競合していないか確認します。名前解決の失敗、応答はあるがコアに届かない状態、接続が届いているのに出口を誤る状態は、それぞれ別の問題です。上流、ルール、ポートを一度に変更する必要はありません。
TUNは通信を取り込み、ルーティングルールの代わりにはならない
TUNは仮想インターフェース経由で通信を取り込み、アプリにプロキシポートを手入力する方式とは異なります。有効にする前に、クライアントにインターフェース作成とルート設定の権限があることを確認し、同じ通信を処理する他の接続ツールを一度無効にして基準状態と比較してください。以下では自動ルーティングを有効にし、条件に合う従来型DNSクエリをコアに渡します。アプリ独自の暗号化DNSリクエストが自動で通常のDNSクエリに変わるわけではありません。クライアントがTUNの設定を管理している場合は、生成済みの実行設定を確認し、設定を二重に記述しないでください。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
スイッチを有効にしても目的の接続が見つからない場合は、インターフェースが作成されたか、システムルートがそこを向いているか、プラットフォーム側でアプリの通信が対象外にされていないかを確認します。ログに接続がすでに表示されているなら、ルールまたはDNSの問題を調べてください。仮想ネットワークインターフェースを何度も切り替える必要はありません。ローカル印刷、共有、社内接続に問題が起きた場合は、まずTUNを無効にして作業環境を復旧し、接続経路の取り込みと名前解決のどちらが変化したのか、対象を1つに絞って確認します。
config.yaml / 07
サブスクリプションの上書き・項目のマージ・復旧方法
更新されるソースとローカルの変更を分ける
サブスクリプションは、更新されるノードやルールを提供します。ローカルの上書き設定は、ポート、よく使う例外、端末に適したDNS設定などを管理します。更新のたびに置き換わる元ファイルを、毎回手作業で同じように編集する方法はおすすめしません。クライアントが上書きに対応している場合は、すべてのプロファイルに適用されるのか、特定のプロファイルだけに適用されるのかを確認してから、保持したい項目を設定します。対応機能がない場合は、ローカルプロファイルにコピーして試す方法があります。変更は保持されますが、次回のサブスクリプション内容は自動で反映されません。
クライアントごとに同じ上書き構文を使うとは限りません。編集画面によってはMihomoのYAML全体を受け付けるもの、クライアント独自のマージ指示を受け付けるもの、画面から限られた項目だけ変更できるものがあります。「マージ」という機能名でも、スカラー値は置き換えか維持か、マッピングはキーごとに統合されるか、リストは全体が置き換わるかを個別に確認してください。コアが認識しない拡張キーが表示されたら、ノード自体が使えないと考える前に、上書きファイルをコア設定として直接選んでいないか確認しましょう。
スカラー値・マッピング・順序付きリストを個別に比較する
ポートはスカラー値のため、候補設定に最終値は1つだけです。dns はマッピングで、一部のツールはその中の1つのキーだけを置き換えますが、別のツールはブロック全体を置き換えます。たとえば元の設定に nameserver があり、enable だけを上書きした後に実行設定から上流サーバーが消えた場合、今回のマージでは子キーが維持されていないことがわかります。複雑なマッピングを持つプロファイルでは、まず現在有効な値をエクスポートし、ツールの実際の動作を踏まえてマッピング全体を指定する必要があるか判断してください。
ルールもプロキシグループもリストですが、比較するポイントは異なります。ルールは順序で優先度が決まり、プロキシグループは名前や候補への参照にも依存します。元のプロファイルに「オフィス用出口」が定義され、以下の1つ目のルールがあるとします。www.example.com だけを直接接続にするには、2つ目のルール表が最終形です。どちらも通常のコア用YAMLであり、すべてのクライアントで使える上書き指示ではありません。単純に追加して MATCH の後ろに例外を置くと、ファイル自体は読み込めても例外ルールは適用されません。
rules:
- DOMAIN-SUFFIX,example.com,オフィス用出口
- MATCH,DIRECT
rules:
- DOMAIN,www.example.com,DIRECT
- DOMAIN-SUFFIX,example.com,オフィス用出口
- MATCH,DIRECT
更新後に同名のプロキシグループが2つ表示されても、先頭のグループだけを残して終わりにしないでください。まずリストを誤って連結していないかを確認し、次に各グループの候補がどこから来ているかを調べます。グループを名前で置き換えるべき場合もあれば、候補だけを変更すればよい場合もあります。同様に、ノードプロバイダーのパスを上書き用ディレクトリから実行用ディレクトリに移すと、相対パスの解決先が変わる場合があります。相対パスは、コアが実際に使う作業ディレクトリを基準に確認してください。
名前解決・通信の取り込み・ルール照合の順に確認する
変更前に、動作確認済みの設定をスナップショットとして保存し、現在のプロファイルとモードを記録しておきます。変更後は、生成されたファイルに対象項目があるか確認し、読み込み時の解析エラーやポート使用中の警告を調べてください。起動できたら、同じ接続方法で「直接接続すべき宛先」と「プロキシグループに渡す宛先」を1つずつ試し、一致したルールと出口を確認します。両方の結果が想定どおりなら、サブスクリプションを手動で更新して同じ確認を行い、変更が更新後も維持されることを確かめます。
新しい設定を読み込んだ直後にクラッシュしたり、システムがネットワークに接続できなくなったりした場合は、最後に適用した上書きを取り消して、動作確認済みのプロファイルに戻してください。さらに、システムプロキシやTUNが終了済みのコアを参照し続けていないか確認します。復旧したら、最小限の変更を1つだけ再度試し、意味のある最初のエラーを記録してください。ポート、DNS、ルールリスト全体を一度に置き換えるのではなく、どの階層に問題があるかを順番に確認しましょう。ログから原因を特定する場合は、起動時にクラッシュする場合の対処法とよくあるトラブルの対処方法も参照してください。