Clash config.yamlを項目ごとに解説:ポート、DNS、proxiesとrulesの書き方
設定ファイル全体を順に確認し、mixed-port、dns、proxies、proxy-groups、rule-providers、rulesの役割と基本的な書き方を解説します。
設定例:各項目の参照関係を確認
このサンプルは、インラインルールセットに対応したmihomo(旧Clash Meta)向けです。ドメインルールと明示的なプロキシ接続で振り分けを確認でき、サブスクリプションの更新やTUNには依存しません。Clashのオリジナル版でも同名の項目の一部は認識されますが、異なるコアで共通して使える設定とは限りません。特にルールセットの形式が対応しているか、事前に確認してください。
mixed-port: 7890
allow-lan: false
mode: rule
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
proxies:
- name: "ローカル SOCKS5"
type: socks5
server: 127.0.0.1
port: 1080
proxy-groups:
- name: "オフィス用出口"
type: select
proxies:
- DIRECT
- "ローカル SOCKS5"
rule-providers:
office-domains:
type: inline
behavior: domain
payload:
- "+.example.org"
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- RULE-SET,office-domains,オフィス用出口
- MATCH,DIRECT
リクエストがmixed-portから入ると、ルールモードではコアがrulesを上から順に確認します。office-domainsに一致すると「オフィス用出口」に振り分けられ、そのグループで現在選択されている出口が使われます。最終的にDIRECTを選んでいても、ルールはポリシーグループに一致します。振り分けが正しいかどうかは、一致したルールと実際の出口の両方を確認してください。
mixed-port:ローカルの接続ポートと上流ポートの違い
mixed-port: 7890を設定すると、コアは同じローカルポートでHTTPプロキシとSOCKS5プロキシの接続を受け付けます。アプリに設定するのは127.0.0.1:7890です。一方、proxies内の1080は、コアがサンプルノードを選んだ後に接続する上流ポートです。前者はアプリからコアへの接続、後者はコアから上流への接続であり、互いに置き換えることはできません。
allow-lan: falseは、パソコン本体で使う場合の設定です。待ち受けポートを設定しても、OSのプロキシ設定が自動で有効になるわけではありません。特定のアプリだけで動作を確認するなら、まずそのアプリからポートに明示的に接続してください。システムプロキシを使わないアプリも接続する必要がある場合は、TUNの利用を別途検討します。TUNは仮想ネットワークインターフェースを通じてルーティング設定に合致する通信を取り込み、アプリから7890に直接接続する方法とは入口が異なります。
ポートが使用中の場合の変更方法
ログにaddress already in useと表示されたら、まずコアのインスタンスを複数起動していないか確認してください。7891に変更する場合は、手動で設定したブラウザーのプロキシやターミナルの引数なども、あわせて7891に変更します。デスクトップクライアントが設定ファイルのポートを上書きすることもあるため、診断時は起動ログに表示された実際の待ち受けポートを確認してください。
dns:上流DNSとfake-ipの違い
dns.enable: trueでコアのDNS機能を有効にし、nameserverで通常の名前解決に使う上流DNSサーバーを指定します。この例では、IPアドレス223.5.5.5の従来型DNSサービスを使っています。実行前に、現在のネットワークから接続できることと、利用地域のDNS要件に適合することを確認してください。この項目を変更しただけでは、OSやブラウザーのすべてのDNSクエリがコアに送られるわけではありません。ブラウザー内蔵のセキュアDNS、アプリからの明示的なプロキシ接続、TUNによるDNSの取り込みは、それぞれ分けて確認してください。
enhanced-mode: fake-ipでは、条件に合うドメインのAレコード問い合わせに対し、コアが一時的なマッピング用IPアドレスを返します。198.18.0.0/16の範囲のアドレスが表示されても、そのサイトがこのネットワーク上で公開されているわけではありません。後続の接続を同じコアで受け付けて初めて、マッピングから元のドメインを特定できます。HTTPSにHTTPプロキシを使う場合、アプリは通常CONNECTリクエストで接続先のホスト名を直接指定するため、ドメインルールに一致させる前にfake-ipを確認する必要はありません。
fake-ip有効時にLAN内のサービスへ接続できない場合
まず対象のドメインがコアで名前解決されているか、次に同じアプリの接続もコアを経由しているかを確認してください。アプリがマッピング用IPアドレスを取得しても、コアを経由せずに接続している場合、nameserverだけ変更しても解決しないことがほとんどです。そのサービスに実IPアドレスが必要だと確認できた場合は、既存のdnsセクションにfake-ip-filterを追加し、たとえばprinter.home.arpaを個別に除外します。あわせて、上流DNSがこのプライベートな名前を解決できることも確認してください。フィルターで変わるのは返されるアドレスの形式であり、パブリックDNSにLAN内のレコードが追加されるわけではありません。
proxiesとproxy-groups:ノードとポリシーグループを別々に管理
トップレベルのproxiesでは、上流への接続に必要な情報を設定します。各ノードには名前、プロトコル、サーバー、ポートがあり、その他の項目はプロトコルによって異なります。この例ではtype: socks5を使用しています。別のプロトコルに変更する場合、typeだけを変えて従来の項目をそのまま使うことはできません。ノードをサブスクリプションから取得する場合は、サブスクリプションが完成した設定ファイルを生成するのか、それともクライアントがproxy-providersでノード一覧を読み込むのかを確認してください。
proxy-groupsでは、ルーティングで選択できる出口を定義します。グループ内のproxiesにはノード名を記載し、サーバーアドレスは重複して記述しません。DIRECTは組み込みの直接接続ポリシーです。「オフィス用出口」はselectを使うため、クライアントから手動で選択します。速度測定に応じてノードが自動で切り替わることはありません。名前付きのproxy-providersからノードを取得する場合、ポリシーグループではuseを使ってプロバイダーを参照できます。プロバイダー名をノード名と取り違えないようにしてください。
名前を変更する場合は、参照元から参照先の順に確認します。ノード「ローカル SOCKS5」の名前を変えたら、グループのメンバー一覧も変更します。グループ「オフィス用出口」の名前を変えたら、ルールの振り分け先も変更します。名前にスペースが1つ増えるだけでも別の名前として扱われます。定期更新されるサブスクリプションでは、クライアントのオーバーライド機能や設定のマージ機能を使い、ローカルの変更を保持するのがおすすめです。サブスクリプションのキャッシュを直接編集すると、次回の更新で変更が上書きされることがあります。
rule-providersとrules:ルールセットを定義してから出口を指定
rule-providersはルールセットを定義するもので、通信の出口は指定しません。この例のoffice-domainsはbehavior: domainを使い、+.example.orgでルートドメインとそのサブドメインを対象にします。ポリシーとの紐付けはRULE-SET,office-domains,オフィス用出口で行います。ルールセットを定義しただけでこの参照を記述しなければ、リクエストはそのルールセットで照合されません。
| behavior | エントリー例 | 用途 |
|---|---|---|
domain | +.example.org | 指定したドメインとそのサブドメインに一致します。 |
ipcidr | 192.0.2.0/24 | 接続先のIPアドレス範囲に一致します。ここではドキュメント用のアドレス範囲を使用しています。 |
classical | DOMAIN-SUFFIX,example.org | ルールタイプを維持します。エントリーにはポリシーグループ名を追加しません。 |
ルールセットをローカルファイルに分割する場合は、typeをfileに変更し、format: yamlとpath: ./rules/office.yamlを指定します。元のpayload全体は、そのYAMLファイルに移してください。相対パスはコアの作業ディレクトリを基準に解決されます。クライアント画面に表示されるサブスクリプションファイルと同じディレクトリにあるとは限りません。リモート更新を使う場合はtype: httpを指定し、urlと秒単位のintervalを設定します。コンテンツの形式とbehaviorも一致させてください。
ルールの優先順位は記述順で決まる
ルールモードでは、コアがrulesを上から確認し、最初に一致したポリシーを適用します。status.example.orgを常に直接接続させるには、DOMAIN,status.example.org,DIRECTを該当するRULE-SETより前に記述します。後ろに記述すると、より広い範囲に一致するルールセットが先に適用され、例外ルールは実行されません。MATCHは無条件で適用される最後のルールなので、必ず末尾に置きます。ポリシーを特定のグループに変更すると、それ以前のルールに一致しなかったすべてのリクエストに影響します。
設定を検証する:読み込み、接続経路、ルールの一致を順に確認
- 設定ファイルを読み込めるか確認します。インデントには半角スペースを使い、同じ階層のキーの位置をそろえます。
dnsなど既存のセクションを変更する場合は、同じセクション内に統合し、トップレベルに同名のキーを重ねて記述しないでください。mihomoのCLIを別途利用できる場合は、サンプルのあるディレクトリでmihomo -t -f ./config.yamlを実行します。検証に通っても、設定を読み込んで検証できたことを示すだけで、上流への接続が成功するとは限りません。 - リクエストが正しいコアに届いているか確認します。設定を読み込み、モードがルールになっていることを確認して、「オフィス用出口」に
DIRECTを選択します。下のコマンドは7890を明示的に使うため、OSのプロキシ設定やブラウザー拡張機能をテストに混在させずに済みます。ローカルポートへの接続がすぐに拒否された場合は、まずポートの待ち受け状態を確認してください。DNSから変更する必要はありません。 - 2つの接続先で一致したルールを確認します。クライアントの接続履歴を確認し、必要に応じてログからドメインを検索してください。
example.orgはoffice-domainsに一致し、「オフィス用出口」で直接接続が選択されます。example.comは最初のドメインサフィックスルールに直接一致するはずです。どちらのサイトも開けたとしても、ルールが正しいとは限りません。末尾のMATCH,DIRECTでもリクエストは直接接続できるためです。
curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 10 -I https://example.org/
curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 10 -I https://example.com/
上記のコマンドは一般的なUnixシェル向けです。WindowsのPowerShellではcurl.exeを実行し、空文字列の引数がプログラムに渡されることを確認してください。ここでの--noproxy ""は、環境変数に設定されている可能性のあるプロキシ除外リストをクリアします。--max-time 10は、1回のリクエスト全体の制限時間を10秒に設定します。
ポリシーグループには正しく一致するのに、「ローカル SOCKS5」に切り替えたときだけ失敗する場合は、1080でサービスが待ち受けているか、上流のプロトコルと認証情報が正しいかを確認してください。リクエストがフォールバックルールに流れる場合は、現在有効な設定、ドメイン名のままコアに届いているか、前方のルールに先に捕捉されていないかを確認します。一度に変更するのは1か所にして、同じドメインで再テストすれば、変更の効果を判断できます。