Clash config.yamlの構成を解説|ポート・DNS・proxies・rulesの役割
Clashの設定ファイルを上から順に解説。ポート、動作モード、DNS、proxies、proxy-groups、rule-providers、rulesの役割と、よくある記述ミスを確認できます。
ポートと動作モード:まず通信の入口を確認
設定が反映されているか確認するには、まずアプリがどの入口に接続しているかを調べ、次にコアが通信をどう振り分けるかを確認します。ここでは mihomo を例に説明します。旧バージョンの Clash と mihomo では、対応する項目が異なります。また、クライアントのバージョンとコアのバージョンは別です。単体で起動している場合は mihomo -v でコアのバージョンを確認できます。GUIクライアントでは、画面に表示されるコア情報を確認してください。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
mixed-port は HTTP と SOCKS の両方のプロキシ接続を受け付けます。この例をアプリに設定する場合、プロキシアドレスに 127.0.0.1、ポートに 7890 を指定し、プロトコルはアプリの対応状況に合わせて選択します。port と socks-port を別々に設定している場合は、それぞれ HTTP と SOCKS に対応します。DNSの待ち受けポートやコントロールインターフェースのポートを、アプリのプロキシ欄に入力しないでください。7890は例示用の値で、すべてのクライアント共通の固定ポートではありません。
mode: ruleはrulesに従って振り分けます。ドメインルールをテストする前に、動作モードが Rule になっていることを確認してください。mode: globalはグローバル用のポリシーグループで現在選択されている項目を使い、通常のルール一覧には従いません。mode: directはコアに入った接続を直接接続します。システムプロキシを無効にすることや、コアを終了することと同じではありません。
システムプロキシが有効かどうか、アプリがシステムプロキシに従うかどうかは、設定ファイルとは別の問題です。TUNは仮想ネットワークインターフェースを使い、ルーティング条件に合う通信を取り込みます。設定は独立したトップレベルの tun セクションに記述します。mixed-port を変更してもTUNは有効になりません。また、TUNを有効にした場合、ブラウザーでウェブサイトを開けることだけでは、特定のアプリの通信経路を判断できません。
DNS:待ち受けアドレス・上流DNS・Fake-IPを区別する
dns はトップレベルのマッピングです。enable でコアのDNS機能を有効にし、listen でDNSクエリを受け付けるアドレスを指定します。nameserver には名前解決に使う上流DNSを列挙します。以下ではローカルでのテストにループバックアドレスの 1053 を使い、例示用の待ち受け先をLAN内に公開しないようにしています。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
fake-ip-filter:
- localhost
- '*.lan'
デフォルトのフィルターモードでは、fake-ip-filter に一致するドメインにはFake-IPを返しません。ただし、上流DNSで必ず名前解決できるという意味でも、接続が直接接続になるという意味でもありません。Fake-IPは、接続とドメイン名を対応付けるためにコアが使うアドレスマッピングです。プロキシを経由するかどうかは、動作モードとルールによって決まります。ワイルドカード '*.lan' は、先頭のアスタリスクをYAMLのエイリアス構文として解釈されないよう、引用符で囲んでください。
nslookup -port=1053 example.com 127.0.0.1 を実行すると、待ち受けポートを個別に確認できます。この例では、フィルター対象でないAレコードのクエリに対し、設定したアドレス範囲内のFake-IPが返ります。これはクエリがコアに届き、応答が返ったことを確認するものであり、システムDNSが切り替わったことや、接続先のウェブサイトにアクセスできることを証明するものではありません。手動のクエリは成功するのにアプリの挙動が異なる場合は、アプリ内蔵の暗号化DNS、システムキャッシュ、TUN使用時のDNSハイジャック設定を確認してください。
proxiesとproxy-groups:ノード定義とポリシー選択を分ける
トップレベルの proxies は、アウトバウンドノードの一覧です。各項目には通常、name、type、server、port が含まれ、その他のパラメーターはプロトコルによって異なります。ノードの port はリモートサーバーのポートを指し、ローカルの mixed-port とは関係ありません。サブスクリプションURLをノードの server に入力しないでください。クライアントがサブスクリプションを完全な設定ファイルに変換する場合があります。一方、mihomo の proxy-providers は、設定に基づいてノード一覧を読み込むための機能です。
トップレベルの proxy-groups でポリシーグループを定義します。グループ内の proxies は候補名の一覧であり、ノードオブジェクトの一覧ではありません。ノードプロバイダーから候補を読み込む場合は、グループ内の use にプロバイダー名を指定します。まずは組み込みアウトバウンドだけを含むグループで参照関係を確認すれば、ノードの認証情報を入力する必要はありません。
proxy-groups:
- name: Lab-Select
type: select
proxies:
- DIRECT
- REJECT
select グループは、現在選択されている項目を使います。ルールが Lab-Select に一致したとき、現在の選択が DIRECT なら直接接続し、REJECT なら接続を拒否します。テスト前に、クライアント上でグループ内の選択肢を確認してください。画面上の選択が前回の状態に戻っている場合があります。ノードをグループに追加するときは、ノードの name を完全一致でコピーし、大文字・小文字、空白、句読点を確認します。ポリシーグループの名前を変更した場合は、そのグループを参照するルールも合わせて変更してください。
rule-providers:ルールセットの定義だけでは振り分けは有効にならない
rule-providers はマッチ条件を提供するもので、アウトバウンドノードは提供しません。ここでルールセットを宣言すると、名前と内容が対応付けられますが、命中時に使うアウトバウンドを指定する RULE-SET を rules に記述する必要があります。まずインラインのルールセットで確認すれば、ダウンロードやキャッシュの問題を切り分けられます。
rule-providers:
lab-domains:
type: inline
behavior: domain
payload:
- '+.example.org'
behavior: domainは+.example.orgのようなドメイン項目を読み込みます。項目の末尾にポリシーグループを指定する必要はありません。behavior: ipcidrは192.0.2.0/24のようなアドレス範囲を読み込みます。IP-CIDR,のプレフィックスは付けません。behavior: classicalはDOMAIN-SUFFIX,example.orgのようなタイプ付きの条件を読み込みます。最終的なアウトバウンドは、外側のRULE-SETに指定します。
HTTPプロバイダーを使う場合は、type: http、url、ローカルキャッシュの path、更新間隔の interval を別途設定します。interval: 86400 は24時間を表し、単位は秒です。format はリソースの実際の形式に合わせてください。ログインページを返すURLをルールファイルとして扱ったり、拡張子を変えるだけでテキストをMRS形式にしたりすることはできません。GUIクライアントでは、コアの作業ディレクトリが元のサブスクリプションファイルの保存先と異なる場合があります。キャッシュを探すときは、まず作業ディレクトリを確認し、相対パスを照合してください。
rules:具体性ではなくリストの順にマッチする
以下のリストを前述の設定に追加します。rules、rule-providers、proxy-groups、dns はすべてトップレベルのキーで、互いにインデントしません。コアはルールを上から順に確認し、最初に一致したルールのポリシーを使います。条件がより具体的だからといって、ドメインルールが自動的に先頭へ移動することはありません。
rules:
- DOMAIN,example.org,DIRECT
- RULE-SET,lab-domains,Lab-Select
- MATCH,DIRECT
接続先のドメイン名をコアが参照できる場合、example.org は1行目に一致し、www.example.org はルールセットに一致して Lab-Select に振り分けられます。ルールセットの行をドメイン完全一致ルールより前に移動すると、ルートドメインもルールセットに振り分けられます。MATCH を先に記述すると、それ以降のルールは評価されません。テスト時は Lab-Select で REJECT を選び、サブドメインへのリクエストが接続ログで想定したルールに一致するか確認してください。例示したサイトで実際にウェブページが表示されるかどうかを判断基準にしないでください。
設定エラーと振り分けの不具合:解析・読み込み・接続の順に切り分ける
- まずYAMLの構文と参照先を確認します。 インデントにはスペースを使い、同じ階層のキーを揃えてください。リスト項目にはハイフン、マッピング項目にはキーと値の形式を使います。ルールを追加するためにトップレベルの
rulesを新たに作らず、既存のリストに追記してください。単体で実行している場合は、設定ディレクトリでmihomo -t -f config.yamlを実行して設定をテストできます。クライアントが別の作業ディレクトリを使う場合は、実際のディレクトリと設定ファイルを指定してテストしてください。最初に出たエラーを確認し、まず構造を直してから名前を修正します。 - 実際に読み込まれている設定をテストしているか確認します。 GUIクライアントは、サブスクリプション、上書き設定、ローカル設定を統合してからコアに渡すことがあります。元のファイルでテストに成功しても、実行中の設定に同じルールが含まれているとは限りません。現在有効な設定と、クライアントで確認できる統合後の内容を調べ、再読み込み後に動作モード、ポート、ポリシーグループの選択を確認してください。
- 入口を確認してからアウトバウンドを追跡します。 この記事のポート例では、
curl --proxy http://127.0.0.1:7890 https://example.org/で接続をテストできます。プロキシポートに接続できない場合は、まず待ち受けが開始しているか、ポートが他のプロセスに使われていないかを確認してください。接続ログに記録されている場合は、接続先ドメイン、マッチしたルール、最終的なアウトバウンドを確認します。正しいルールに一致しているのにリクエストが失敗する場合は、上流DNS、選択中のアウトバウンド、接続先サービスを調べてください。
一度に変更する項目は1つだけにします。まず DIRECT、REJECT、判別しやすい2つのドメイン条件でルールを確認し、その後、サブスクリプションのノードやリモートルールセットに段階的に戻します。こうすれば、問題がローカルの入口、設定の統合、ルールデータ、特定のアウトバウンドのどこにあるかを切り分けられます。