Clash設定ファイルガイド
YAMLの構造、共通設定、DNS、プロキシ、グループ、ルール、上書きとマージ。
初めてのインストール、サブスクリプションの追加、接続確認には、まず使い方ガイドをご覧ください。このページでは、読み込み後の設定を項目ごとに確認できます。各項目がどの階層に属するか、変更がどの通信経路に影響するか、実行結果から設定をどう見直すかを解説します。例では主にMihomoが対応する項目を取り上げています。すべての旧ClashコアやGUIクライアントで同じ書き方が使えるとは限りません。ポート、モード、スイッチには例としての値を記載しています。実際の値はサンプルを共通の初期値とみなさず、現在有効な設定で確認してください。
YAMLの構造:入口・出口・参照関係
トップレベルキーと階層構造
mixed-port、mode、dns、proxies、proxy-groups、rulesは、それぞれ用途の異なるトップレベルキーです。ポートはアプリからコアへリクエストを渡す入口、プロキシは利用可能な接続先、プロキシグループは接続先の管理、ルールはリクエストの転送先(グループ、個別のプロキシ、組み込みアクション)を指定します。DNS設定はドメイン名の名前解決経路を制御します。トップレベルの各ブロックを記述する順序は、通常ルールの評価順に影響しません。一方、リスト内の順序は設定の意味を左右する場合があります。特にルール一覧をアルファベット順に並べ替えないでください。
ファイルを読むときは、まずインデント、次にハイフンを確認します。コロンの左側がキー、右側が値です。dns:の下に2スペース下げて書かれたenableは、その子キーです。ドキュメントのdns.enableは項目の場所を示す表記であり、通常はドットを含むトップレベルキーとしてそのまま書くものではありません。リスト項目はハイフンとスペースで始まります。プロキシやグループは複数のキーからなるマッピング、ルール一覧は通常1行につき1つの文字列です。見た目の階層が似ていても、解析後の型が同じとは限りません。ルール項目の先頭のハイフンを省くと、リストではなく文字列として扱われることがあります。
単独で検証できる最小構成から始める
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxy-groups:
- name: Local
type: select
proxies:
- DIRECT
- REJECT
rules:
- DOMAIN-SUFFIX,example.com,Local
- MATCH,DIRECT
このファイルは組み込みアクションだけを使うため、外部ノードやサブスクリプションは不要です。ローカルのテスト設定として保存して読み込みます。プロキシグループでまずDIRECT、次にREJECTを選び、同じプロキシ入口からexample.comへの接続を毎回新しく作成します。ルールの転送先は常にLocalとなり、最終的なアクションは選択に応じて変わるはずです。それ以外のアドレスは末尾のMATCHで直接接続されます。ここで確認するのは、入口・ルール・グループの参照関係です。公開サイトが常に応答することだけを判断基準にせず、接続ログやルールのマッチ結果を確認してください。ブラウザーに残った古いページよりも参考になります。
サブスクリプションを調べるときは、まず参照関係を整理します。アプリがローカルの入口に接続し、コアがルールを評価して転送先を決定します。転送先はノードや別のグループを参照する場合があります。ノードサーバーのアドレスをシステムプロキシのアドレスと混同したり、グループ名をプロトコルの種類と取り違えたりしないでください。たとえばLocalをLocal-Testに変更した場合、ルールの3番目の項目も変更が必要です。GUIに表示される設定ファイル名を変えても、YAML内の参照先は自動で置き換わりません。
解析に成功しても、通信経路が正しいとは限らない
インデントにはスペースを使い、タブは使わないでください。同じマッピング内に同名のキーを重複して記述しないでください。ローダーによってはエラーになったり、後の定義だけが残ったりします。配列とマッピングは元の型を維持し、真偽値にはtrueまたはfalse、ポートには整数を使います。文字列にする値が数字や真偽値に見える場合、またはYAMLの構文と誤認される可能性がある記号を含む場合は、引用符で型を明示します。#は位置によってコメントの開始と解釈されるため、値を誤って変更しないよう、補足は別の行に記述してください。
保存後は3段階で確認します。まずYAMLとして解析できること、次にコアが読み込めること、最後にリクエストが実際に通る経路です。一般的なYAML検証ツールでインデントの問題は見つけられても、存在しないグループ名までは検出できない場合があります。コアが読み込めても、クライアントが編集したファイルを使っているとは限りません。最初の2段階に問題がなく、通信に変化がない場合は、設定が選択されているか、再読み込みしたか、パネルの実行モードがファイルの値を上書きしていないか確認してください。動作する最小構成を保存し、以後は一度に1種類ずつ変更します。問題が起きても、原因となった変更を特定しやすくなります。
共通設定:mixed-port、待ち受け範囲、実行モード
まずアプリがどの入口から接続するか確認する
mixed-port: 7890は、同じローカルポートでHTTPとSOCKSの両方のプロキシ接続を受け付けます。portはHTTP専用、socks-portはSOCKS専用のポートです。混合ポートを有効にするために、3つの項目すべてを設定する必要はありません。アプリの設定欄がサーバーとポートに分かれている場合、ローカルで使うなら通常はサブスクリプションのサーバーアドレスではなく、ループバックアドレスと有効なポートを入力します。HTTPとSOCKSのどちらを選ぶかは、アプリが実際に使うプロトコルに合わせてください。ポート番号だけを正しく入力しても、プロトコルの選択ミスは解決しません。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
| 項目 | 役割 | 変更後の確認ポイント |
|---|---|---|
mixed-port | HTTPとSOCKSを共用する入口。 | システムプロキシやアプリのポートが古い値を参照していないか。 |
allow-lan | ほかのデバイスからのプロキシ接続を許可するか。 | 実際の待ち受けアドレス、アクセス範囲、ファイアウォール。 |
mode | ルール、グローバル、直接接続の各モードを切り替える。 | 画面に表示された現在値と、新しい接続の経路。 |
log-level | コアのログ出力レベルを調整する。 | 今回の再読み込みや接続の記録があるか。 |
ポートを変更する前に、現在のポートをどのプロセスが使用しているか確認してください。コアのログにアドレスが使用中と表示される場合、別のクライアントがバックグラウンドで動作しているか、クライアントがコアを2つ起動している可能性があります。適当な空きポートをシステムプロキシに指定するだけでは解決しません。まずコアが正常に待ち受けていることを確認し、システムプロキシとアプリの設定も同じポートに合わせます。反対に、コアが正常に待ち受けているのにブラウザーが直接接続する場合は、ブラウザーがプロキシを使っているか、独自の例外リストがないか、対象アドレスがシステムで直接接続に設定されていないかを確認してください。システムプロキシは、その設定に従うアプリの入口になるだけで、すべてのアプリの通信を自動で取り込むものではありません。
待ち受け範囲と通信の取り込み方法は別の設定
allow-lan: falseは、このデバイスだけで使う場合に適しています。信頼できる同一ネットワークのデバイスから接続する必要がある場合に限り、LANアクセスを有効にし、コアが対応する待ち受けアドレス、認証、ホストのファイアウォールで範囲を制限してください。クライアントのコントロールインターフェースとプロキシの入口は別のものです。プロキシを公開するために管理インターフェースをLANに公開する必要はありません。別のデバイスからこのホストのループバックアドレスには接続できません。テスト時は接続先ホストのLANアドレスを確認し、ネットワークでデバイス間通信が遮断されていないか調べてください。テストが終わったら、一時的に開放した入口を閉じてください。
TUNは別の通信取り込み経路です。アプリに入力するHTTPプロキシではなく、仮想ネットワークアダプター、ルーティング、プラットフォームの権限が関係します。利用できるかどうかは、プラットフォーム、コア、フロントエンドの実装によって異なります。システムプロキシ経由では正常で、TUN経由で問題が起きる場合は、まず仮想アダプターが作成されたか、既存のVPNやルート設定と競合していないかを確認し、次にDNSの取り込み状況を調べます。ポート、ルート、DNSを同時に変更すると、復旧してもどの変更が有効だったのか特定できません。
modeはコアに入った通信の経路を決める
ruleはルールに従って振り分けます。globalはグローバルポリシーで選択した出口を使い、directはコアに入った接続を直接接続します。グローバルモードにしても、コアに接続されていないアプリに入口が作られるわけではありません。直接接続モードも、システムプロキシを無効にするものではありません。比較のためにグローバルモードを試すときは、グローバルグループでテストしたい出口が選ばれているか確認し、同じ宛先への新しい接続を比較してからルールモードに戻してください。詳しくはルール・グローバル・直接接続モードの比較をご覧ください。
プラットフォーム別のクライアントでは、ポート、ログレベル、モードなどを独自に保存し、起動時に実行設定へ書き戻すことがあります。YAMLを手動で編集しても値が元に戻る場合は、すぐに再インストールせず、GUI側の設定が反映されていないか確認してください。現在のクライアントに変更したい項目がない場合は、ダウンロードページでプラットフォーム別の選択肢を確認できます。対応するインストーラーがあるプラットフォームではClash Plusもご覧ください。Linuxは各プラットフォームのダウンロード一覧をご確認ください。クライアントを切り替える前に動作する設定を保存し、同じ入口を複数のインスタンスで同時に制御しないようにしてください。
DNS設定:拡張モード、上流DNS、実際の名前解決経路
dns.enableとenhanced-mode
dns.enable: trueは設定ファイル内のDNSモジュールを有効にし、enhanced-mode: fake-ipは拡張モードを指定します。モジュールを有効にしても、システムや各アプリのDNS問い合わせが必ずそこを通るとは限りません。システムプロキシ、TUN、アプリ独自の暗号化DNS、LAN経由の転送では、異なる経路を使う場合があります。想定外の名前解決が起きているか判断するには、まず対象のデバイス、アプリ、通信の取り込み方法を明確にし、問い合わせがどのDNSサーバーに送られたかを確認してください。外部DNSサーバー名が表示されただけでは、端末から直接問い合わせたのか、リモート側で解決したのか判断できません。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- 'localhost'
- '+.lan'
nameserver:
- system
ここでは、systemをサポートするMihomoで、システムのリゾルバーを上流DNSの例として使っています。独立したパブリックDNSは指定していません。システムのリゾルバーが別のコンポーネントによって転送されている場合は、同じ問い合わせがコアに戻ってループしないか、先に確認してください。この例ではDNSの待ち受けアドレスも追加設定していません。コアを明示的なDNSサーバーとして使う場合は、待ち受け設定とファイアウォールの範囲を個別に確認してください。enable: trueだけを見て、特定のアドレスで外部から利用できる状態だと判断しないでください。
fake-ipモードでは、コアがドメイン名に対して対応付け用の仮想アドレスを返し、その後の接続がコアに入ると対応表から接続先を復元できます。テストでそのアドレス範囲が見えても、Webサイトの実際のアドレスがその値になったわけではありません。アプリが仮想アドレスを保持したまま後続の接続をコアが取り込めなかった場合や、コアの再起動で対応表が失われた場合、名前解決は成功しても接続に失敗することがあります。比較テストでは接続を作り直し、アプリやOSに古い結果が残っていないかも確認してください。redir-hostは実際の名前解決結果を返す方式です。モードの切り替えは、あらゆるDNS障害に有効な解決策ではありません。
通常の問い合わせ、例外、ノードの名前解決を区別する
nameserverは通常の上流DNS一覧です。nameserver-policyでは特定のドメインに別の名前解決経路を指定できます。proxy-server-nameserverに対応するコアでは、プロキシサーバーのドメイン名を解決するDNSも個別に設定できます。ノードサーバーをドメイン名で指定している場合、この区別は重要です。ノードの接続に使うプロキシがまだ起動していないのに、その同じプロキシ経由でノード名を解決しようとすると、依存関係が循環します。変更する前に、ドメイン名を使う上流DNS、その上流への初回接続方法、ノードサーバー自体を解決するDNSを整理してください。すべての種類の問い合わせを機械的に同じ経路へ向けないようにします。
fake-ip-filterが制御するのは仮想アドレスの返し方であり、アクセス権限やプロキシの振り分けルールではありません。LAN内サービスのドメイン名を例外に加えると、アプリが実際のアドレスを必要とする問題を解決できる場合があります。ただし、その実アドレスに接続できるかは、上流DNSが名前を解決できるか、端末に対応するルートがあるか、ルールが最終的にどの出口を選ぶかによります。まずサービスの名前がネットワーク内で解決できることを確認し、例外の範囲を絞ってください。すべてのドメインに広範な例外を追加すると、拡張モード全体の動作が変わり、どのアプリに特別な処理が必要なのか判断しづらくなります。
DNSリークをどう確認するか
まず期待する動作を定義します。たとえば、社内ドメインは指定した社内DNSで解決し、特定のアプリの外部向け問い合わせは現在のネットワークのデフォルト経路に流さない、といった条件です。次に同じアプリでテストを繰り返し、コアが対象ドメインの問い合わせを受け取ったか、設定どおりの上流DNSを使ったか、アプリ独自のセキュアDNSが有効になっていないかを確認します。ブラウザーのテストページで分かるのはブラウザーが送った問い合わせだけで、システム全体の状態を示すものではありません。ターミナルのツールもDNSサーバーを直接指定すると、実際のアプリの経路を迂回することがあります。比較時はプロキシモード、TUNの状態、問い合わせ結果を記録し、異なる環境の結果を混同しないでください。
プロキシノードの設定:プロトコル、アドレス、通信パラメーター
nameは参照名、serverは接続先アドレス
proxiesはノードを直接記述するリストです。ノードのnameはグループやルールから参照する名前、typeは残りの項目をコアがどのプロトコルとして解釈するか、serverとportはプロキシサーバーが実際に待ち受ける場所を指定します。GUIでアイコンや別名、メモを表示できても、接続には有効な設定の項目が使われます。サーバー側のポートとローカルのmixed-portは別の通信経路に属し、数字が同じでも連動しません。設定内で名前が重複しないようにし、既存のグループ名や組み込みアクションと同じ名前は避けてください。
proxies:
- name: Local-SOCKS
type: socks5
server: 127.0.0.1
port: 1080
proxy-groups:
- name: Route
type: select
proxies:
- Local-SOCKS
- DIRECT
rules:
- MATCH,Route
この断片は最小構成に追加して、すでに動作しているローカルのSOCKS5サーバーを参照するためのものです。サーバー自体を起動する設定ではありません。ループバックアドレスの1080番ポートを独立したプログラムが待ち受けていなければ、Local-SOCKSを選択すると接続に失敗します。そのアドレスを同じコアインスタンスのプロキシ入口に向けると、自己参照になります。DIRECTを選択して、プロキシの上流が原因かどうか比較してください。この例を使う場合も、アプリのリクエストは別途設定したコアのローカル入口へ渡す必要があります。ノードの上流アドレスとこの入口を混同しないでください。
プロトコル固有のオプションは互換性がない
ノードごとに認証項目や通信パラメーターは異なります。HTTPやSOCKS5ではユーザー認証を設定できますが、ほかの方式ではプロトコル固有のID、暗号化設定、ハンドシェイク用パラメーターが必要な場合があります。値にはサーバーまたはサブスクリプションから提供された設定をそのまま使ってください。別方式のノードの項目をまとめてコピーしたり、typeだけを別のプロトコルに変更したりしても、コアとサーバーのハンドシェイクは一致しません。インポートツールで設定を変換する場合は、整数、真偽値、ネストされたマッピング、文字列が元の型のまま保たれているかも確認してください。
TLSを使うノードでは、接続先アドレスと証明書の識別情報も関係します。アドレスは接続先のサーバーを示し、サーバー名などの項目はTLSハンドシェイクに使われる場合があります。さらに、前段のサービスがトランスポート層以外のホスト名やリクエストパスを基に転送する場合もあります。これらが同じ値になることはありますが、同じ項目ではありません。証明書エラーが出たら、まずシステム時刻、ノードが要求するサーバー名、実際に提示された証明書を確認してください。証明書検証を無効にする方法を恒久的な解決策にしないでください。接続後にサーバーから拒否された場合は、パス、認証情報、サーバーが現在のプロトコルに対応しているかを調べます。
インポート時の問題と接続時の問題を分けて調べる
ノードが画面にまったく表示されない場合は、まず設定が読み込まれたか、サブスクリプションの更新に成功したか、グループがそのソースを参照しているか、フィルター条件で除外されていないかを確認します。ノードが表示されても使えない場合は、サーバーのドメイン名解決、接続先ポートへの到達性、プロトコルのハンドシェイク、実際の通信を分けて調べてください。画面のテスト結果は特定のリクエストを一度観察したもので、認証失敗、接続先への到達不可、特定の通信方式が非対応といった問題の原因を単独で説明するものではありません。ノード読み込み前後のログを確認するほうが、多数のノードを次々に切り替えるよりも最初の異常を見つけやすくなります。
サブスクリプションはproxy-providers経由でノードを提供する場合もあります。その場合、トップレベルのproxiesにすべてのノードが並ぶとは限りません。グループは通常useでソースを参照します。ソース名とノード名は別々の参照階層です。サブスクリプション更新後にノードが消えた場合は、ソースが読み込まれていないのか、フィルターに一致しないのか、上流で名前が変更されたのかを確認してください。更新前後のグループ構成の差を記録し、認証情報を含む設定全体を公開の場所に投稿しないでください。すべてのノードが同時に使えない場合は、ノードのタイムアウト確認リストを参考に、サブスクリプション、時刻、入口、システムのネットワークなど共通要因を先に切り分けます。
プロキシグループの設定:select、url-test、fallback
グループの役割を決めてからタイプを選ぶ
proxy-groupsはプロキシグループの一覧です。selectはユーザーが選択する方式で、手動比較や出口の固定に適しています。url-testは指定したURLのテスト結果を使ってメンバーを選びます。fallbackはメンバーの順序を優先順位として扱い、利用可能な候補のうち先頭のものを選びます。自動選択グループは複数の接続を束ねて、1つの接続を高速化するものではありません。特定の出口を優先し、失敗時に予備へ切り替えたい場合は、遅延テストの値を調整して優先順位を再現するよりもfallbackを使うほうが簡潔です。
proxy-groups:
- name: Manual
type: select
proxies:
- DIRECT
- REJECT
- name: Probe
type: url-test
proxies:
- DIRECT
url: 'https://example.com/'
interval: 300
tolerance: 50
- name: Preferred
type: fallback
proxies:
- Manual
- DIRECT
url: 'https://example.com/'
interval: 300
rules:
- DOMAIN-SUFFIX,example.com,Preferred
- MATCH,Manual
この例は、外部のサブスクリプションに依存しないようにしています。Probeはメンバーが1つだけなので、テスト設定の確認用です。実際のノード比較には使えません。Preferredはグループの参照とメンバーの順序を示しています。実際に使うときは、存在を確認済みのノードを組み込みアクションと置き換えてください。テストURLには、定期的なアクセスが許可され、どの候補からも到達できる軽量な宛先を選びます。例のinterval: 300はテスト間隔を秒単位で指定し、tolerance: 50は自動遅延比較で小さな変動による頻繁な切り替えを抑えるため、ミリ秒単位の許容差を設定します。保存後はコアがグループをどう処理しているか確認してください。画面に一度表示された数値だけで切り替えのタイミングを判断しないでください。
テスト結果は数値だけでなく条件も確認する
テストで確認するのは、設定された宛先までの経路です。名前解決、接続、ハンドシェイク、応答の各段階は、実際の通信先と同じとは限りません。軽量なテストにはすばやく応答する出口でも、長時間のダウンロードでは転送量が制限されることがあります。テスト用ドメインがその経路で到達できず、自動選択から外れる場合もあります。比較するときは、まず同じ宛先で再テストし、次に実際の通信で比較してください。測定の限界については遅延テストの数値と実際の通信速度をご覧ください。
テスト用URLを設定したグループと、プロキシソース側のヘルスチェックでは、設定や実行タイミングが異なる場合があります。ソースにヘルス状態が表示されていても、それを参照するグループがまったく同じ条件でメンバーを選ぶとは限りません。調査時は、画面に表示されているのがノードの手動テスト、グループのテスト、ソースのヘルスチェックのどれかを確認し、それぞれのURLと間隔を見直してください。テスト頻度を上げすぎるとネットワークへのリクエストが増え、モバイル端末では起動回数が増えることもあります。トラブル対応では一時的に手動テストを使い、長期的なテスト頻度の引き上げで接続問題を解決しようとしないでください。
参照関係と選択状態の保存を確認する
プロキシグループ内のproxiesはメンバー名を表し、トップレベルでノードを定義する同名の項目とは役割が異なります。メンバーには組み込みアクション、ノード名、参照可能なグループを指定できます。useにはプロキシソース名を列挙します。グループ同士が循環参照しないようにしてください。グループが空に見える場合は、ソースが読み込まれているか、フィルターでメンバーが除外されていないか、フロントエンドが現在の設定を表示しているかを確認します。複数階層のグループにすると手動選択と自動選択を分けられますが、階層が深すぎると画面に上位グループ名しか表示されないことがあります。接続を確認するときは、最終的な出口まで順にたどってください。
再読み込み後も前回選んだメンバーが選択されていても、YAMLの順序が反映されていないとは限りません。フロントエンドやコアで選択状態が保存されている場合があります。順序や自動切り替えを確認するときは、現在手動で選択されている値を記録し、既存の接続ではなく新しい接続で検証してください。グループの選択を変更しても、すでに確立された長時間接続はすぐに別経路へ移らないことがあります。グループ名、参照関係、利用可能性に問題がないのに経路が誤っている場合は、ルールがそのグループに一致しているか確認してください。それより前のルールが別のポリシーへ転送していれば、現在のグループの順序を変えても結果は変わりません。
ルールの構文:最初の一致から最終アクションまで
上から順に評価し、一致の厳密さで自動並べ替えはされない
rulesはルールのリストです。一般的な項目は、タイプ、照合する値、転送先で構成されます。タイプによっては追加のパラメーターを指定できます。DOMAINは特定のドメイン名、DOMAIN-SUFFIXは指定したドメインとそのサブドメイン、IP-CIDRはIPアドレス範囲に一致し、GEOIPは対応する地理データを使います。MATCHには照合値が不要で、通常は最後に配置します。コアは上から順に評価し、最初に条件を満たした項目を使います。広範囲のルールを例外より前に置くと、後ろにある例外がより具体的でも評価されません。
rules:
- DOMAIN,blocked.example.com,REJECT
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT
この部分を最小構成と置き換えると、ドメイン名を確認できる場合、新しいblocked.example.comへのリクエストは最初のルールに一致します。同じサフィックスのほかのリクエストは2つ目に一致します。末尾の直接接続ルールは、外部ノードのない環境でも検証しやすいように残しています。本番設定でも常に直接接続を初期設定にするべき、という意味ではありません。転送先を独自のポリシーに変更する場合は、同じ設定内に対応するノードまたはグループを用意してください。例のIP範囲はよく使われるプライベートアドレスの一部だけを対象としており、ローカルアドレスやプライベートネットワーク全体を網羅するものではありません。
| タイプ | 判定基準 | 見落としやすい条件 |
|---|---|---|
DOMAIN | 完全一致するドメイン名。 | リクエストのドメイン名がコアに渡されない場合がある。 |
DOMAIN-SUFFIX | ドメイン名のサフィックス。 | より限定的な例外を先に置くのが基本。 |
IP-CIDR | 接続先のIPアドレス範囲。 | 名前解決が関係する場合がある。アドレスファミリーを区別する。 |
GEOIP | 接続先IPに対応する地理データ。 | ドメイン名のサフィックスから地域を判定するものではない。 |
MATCH | それ以前のルールに一致しなかったリクエスト。 | 前に置きすぎると後続の項目が評価されない。 |
ドメイン名と接続先アドレスが常にそろうとは限らない
ルールが有効なのは、コアに取り込まれ、必要な情報が得られる通信に限られます。アプリがアドレスへ直接接続する場合、コアはそのアドレスに対応する元のドメイン名を把握できないことがあります。システムプロキシを使うアプリでも、ホスト名をプロキシに渡す場合と、先に名前解決してからアドレスを渡す場合があります。ドメイン名のスニッフィングを有効にしている環境でも、ドメイン名を復元できるかはプロトコルや実際に確認できるデータによります。ドメインルールに一致しない場合は、サフィックスの範囲をむやみに広げず、まず接続ログのホスト名やアドレスを確認して、アドレスルールが必要か判断してください。
no-resolveを使うと、該当するIPルールの照合時に追加の名前解決を発生させずに済みます。利用可能な接続先アドレスがすでにあれば、そのアドレスで判定できます。DNSを全体で無効にするスイッチではなく、名前解決されていないドメイン名をIP範囲に一致させるものでもありません。ドメイン名が未解決で比較できるアドレスもない場合、このルールはスキップされ、後続の項目が評価されることがあります。GEOIPを使う場合は、コアが利用可能な地理データを持っていることと、接続先が想定する分類に含まれることを確認してください。サイトは複数のアドレスを持つ場合や、異なるネットワーク経由で提供される場合があります。サイトの所在地についての推測だけでなく、実際のマッチ結果を確認してください。
ルールセットは依存関係のある設定として扱う
rule-providersは外部のルールセットを提供し、RULE-SETはメインのルール一覧から対応する名前を参照します。データ形式とルールの分類は、使用するコアおよびルールセットの内容に合っている必要があります。ファイル拡張子だけで判断しないでください。読み込み後はソースが正常に読み込まれたことと、メイン一覧での参照位置を確認します。同じルールセットでも、例外の前に置くか後に置くかで結果が変わる場合があります。ソースを更新するとルールの対象範囲も変わることがあるため、ドメインを調べるときは画面に表示された2つの日付を比べるだけでなく、一致したルールとソースを記録してください。
Webページでは通常、複数の接続が発生します。メインページ、ログイン、画像、APIで別々のドメインを使う場合があり、メインのドメインがあるポリシーに一致しても、すべての通信が同じ出口を通るとは限りません。ページの一部が読み込めない場合は、具体的に失敗したリクエストを特定し、ルールモードで同じドメインへの新しい接続を確認します。一致したルール、ポリシー名、最終的な出口を調べてください。問題のルールが現在の設定に見当たらない場合は、まずクライアントが使っているマージ後の設定を確認します。既存の接続、キャッシュ、モード切り替えによって、設定ファイルと異なるように見える場合もあります。
上書きとマージ:サブスクリプションの原文から実行設定まで
サブスクリプション、上書き、実行用コピーを区別する
サブスクリプションの原文は上流からの入力、上書きはローカルで管理する変更、実行用コピーはクライアントの設定を適用してマージし、コアに渡す結果です。「変更したのに元に戻る」場合、永続化される上書きではなく、サブスクリプション更新で置き換わるキャッシュや実行用コピーを編集していることがあります。作業前に、画面の編集箇所がどの階層に属するか確認し、変更前に動作していたローカルコピーを保存してください。現在のクライアントにマージ結果の書き出し機能がない場合は、少なくとも有効な設定、上書きの入口、適用範囲、読み込みログを記録し、プレビューを実際の実行状態と混同しないようにします。
スカラー、マッピング、リストはそれぞれ異なる考え方で扱います。スカラーは別の文字列に変更するなど、値の置き換えが一般的です。マッピングはキーごとにマージされる場合と、全体が置き換わる場合があります。たとえばdns.enableだけをネストして定義したとき、既存の上流DNSが残るかどうかはマージ処理によって異なります。リストでは置き換え、先頭への挿入、末尾への追加を区別してください。どれも「項目を1つ追加」するように見えても、最初に一致したルールを使うシステムでは結果が異なります。prepend-rulesのような上書きキーは、使用中のクライアントがその構文に対応している場合に限って使います。すべてのコアが認識する一般的なトップレベル項目ではありません。
マージ結果で順序を確認し、マージ処理を推測しない
サブスクリプションに2つのルールがあり、完全一致の例外を追加したい場合を考えます。以下は入力と期待する出力の例で、すべてのクライアントで同じ上書き形式が使えるとは想定していません。エディターがルールの先頭への追加に対応している場合は、例外を1つ追加して結果を確認します。配列全体の置き換えしかできない場合は、期待するルール一覧をすべて指定します。その場合、今後のサブスクリプション更新でも一覧を保守する必要があります。どちらの方法でも、最後のフォールバックは残してください。
# サブスクリプションのルール
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECT
# マージ後に期待するルール
rules:
- DOMAIN,blocked.example.com,REJECT
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECT
エディターが例外を末尾に追加すると、フォールバックに先に一致して例外が使われません。サフィックスルールの後、フォールバックの前に追加した場合も、サフィックスルールが先に一致します。グループ定義も上書きする場合は、マージ処理が名前で個別の要素を更新するのか、グループ一覧全体を置き換えるのか確認してください。後者の場合、同名のグループを1つだけ送っても「1つのグループを更新」するのではなく、ほかのグループがすべて消える可能性があります。その一方で、元のルールが削除されたグループを参照し続けることもあります。大きなローカル変更を管理する前に、まず項目を1つだけ試し、マージ前後の差を確認してください。
元に戻せる手順で検証・復旧する
ルール、DNS、入口の変更を分けて保存すると、どの階層が原因か特定しやすくなります。まず上書きなしで動作することを確認し、変更を1つだけ有効にして、コアが再読み込みされたか確認します。そのうえで、影響を受ける接続と、変わらないはずの接続を比較してください。続いてサブスクリプションを手動で更新し、結果を見比べます。グループ名が上流で変更された、ソースが存在しない、DNSの子キー全体が置き換わった、フロントエンドがポートを自動で書き戻した、といった点に注意してください。こうした問題は保存直後には現れず、サブスクリプションの更新やクライアントの再起動後に起きることがあります。
起動に失敗する場合は、直近の上書きを無効にし、動作確認済みの設定を再読み込みしてください。原因を追う手がかりとして、最初の明確なエラーを残します。コアは起動するものの接続に問題がある場合は、現在のモード、アプリの入口、一致したルールを比較し、複数のコンポーネントが同時にネットワーク設定を書き換えていないか確認してください。クライアントを終了する場合は、まずクライアントが設定したシステムプロキシを元に戻し、現在のネットワークでアプリが想定どおり直接接続できるか確認します。初回の読み込みや有効化の詳しい手順は使い方ガイドをご覧ください。コアとフロントエンドの違いが分からない場合は、用語集もご確認ください。
上書きを変更したのに、パネルに元の値が表示されるのはなぜですか?
まず、パネルに表示されているのがサブスクリプションの原文、クライアント独自の設定、コアの現在の実行値のどれか確認してください。次に、上書きが有効で現在の設定に適用されていること、マージでエラーが発生していないこと、クライアントを再読み込みしたことを確認します。
問題の原因が上書きかサブスクリプションかを確認するには?
同じクライアント、同じネットワークで一時的に上書きを無効にし、元のサブスクリプションを再読み込みして新しい接続を作成します。問題が解消した場合は、上書きを1つずつ有効にして結果を比較します。異常が続く場合は、サブスクリプションの更新、入口、コアのログを先に確認してください。