配置 2026年10月17日

Mihomoのrule-providers活用術:GitHubで独自ルールを管理・自動更新

独自ルールをメイン設定から分離し、MihomoでGitHub上のYAMLを定期取得する手順を紹介。rule-providersの主要項目、ルール順序、Gitでの変更管理と読み込みエラーの確認方法まで扱います。

Dockerプロキシ GitHub加速 高度な設定 YAML

1. rule-providersで独自ルールを分離する理由

ルールが数十行を超えてくると、メイン設定の rules: にサービスごとの例外を追加し続けるのは難しくなります。購読プロファイルを更新したときに手動変更が消えたり、どのルールが何のためにあるのか分からなくなったりするためです。Mihomoのrule-providersを使うと、ルールを別ファイルとして管理し、メイン設定から参照できます。GitHubに置いたYAMLを定期取得する構成なら、ルールの追加・修正をGitの差分で確認しながら、複数端末へ同じ内容を配布できます。

ここで押さえたいのは、rule-providerが通信先のプロキシ設定そのものではなく、ルール集合を読み込む仕組みだという点です。取得したルールはメイン設定の rules: に書いた RULE-SET から呼び出し、最後に指定した策略グループへ振り分けます。providerのYAMLが正しくても、参照名の誤りやルール順序の問題があれば期待どおりには動きません。設定を分けるだけでなく、「どの条件をどのグループへ送るか」をひと目で追えるように設計することが大切です。

本稿では、GitHubの公開リポジトリにルールファイルを置き、Mihomoが一定間隔で取得する基本構成を扱います。GitHubのブランチやファイル名を変えるとURLも変わるため、初回は小さなルール集合で動作を確認し、問題がなければ用途別に分割してください。すでにクライアントの購読設定やオーバーライドを利用している場合は、編集内容が有効プロファイルに反映される場所も先に確認します。

2. 主な項目とルールファイルの作り方

providerの定義はメイン設定の rule-providers: に置きます。type は取得方法、behavior はルールの解釈方法、format はファイル形式、url は取得元、path は端末内の保存先、interval は再取得間隔を指定します。次の例では、GitHubリポジトリのブランチにあるYAMLを1日ごとに確認します。

rule-providers:
  example-domains:
    type: http
    behavior: domain
    format: yaml
    url: "https://raw.githubusercontent.com/your-name/clash-rules/main/example-domains.yaml"
    path: ./ruleset/example-domains.yaml
    interval: 86400

rules:
  - RULE-SET,example-domains,PROXY
  - MATCH,DIRECT

your-name とリポジトリ名、ブランチ名、ファイル名は実際の値に置き換えてください。path はMihomoが取得データを保存するローカルパスです。相対パスの基準や書き込み可能な場所は、起動方法とクライアントによって異なる場合があるため、設定ファイルの位置と実行ユーザーの権限を確認します。GitHubのURLはブラウザで開けるだけではなく、RawファイルのURLになっている必要があります。

behavior: domain はドメイン単位のルール集合に向き、ファイルには通常 payload: の下へドメインを並べます。サブドメインも対象にする場合は、Mihomoがサポートするドメイン表記を使い、どこまで一致させるかを明確にしてください。

payload:
  - "+.example.com"
  - "service.example.net"

一方、behavior: classical は、完全一致やキーワード、IPなどを含む従来形式のルールをまとめたい場合に便利です。この場合はファイル内にルール行を記述します。domain用のファイルと書式を混在させると、取得できても読み込み時に失敗したり、意図した判定にならなかったりするため、各providerで形式を統一してください。IP範囲を扱うなら、用途に応じて behavior: ipcidr を選びます。

payload:
  - DOMAIN-SUFFIX,example.com
  - DOMAIN,api.example.net

interval は秒数で指定します。毎回の起動時に必ず最新版が必要という意味ではなく、更新頻度とGitHubへのアクセス頻度を考えて設定します。頻繁に変わらない個人用リストなら、数時間から1日程度の間隔から始める方法があります。短い間隔にしても、ネットワーク障害や取得元の応答状況によって更新が遅れることはあるため、即時反映が必要な変更を定期取得だけに頼らないでください。

3. GitHubで安全に変更し、自動更新する

GitHub上では、ルールファイルを用途別に分け、何を含むリストなのかファイル名と説明で分かるようにします。たとえば広告用、社内サービス用、開発ツール用を別々のproviderにすれば、誤判定が起きたときに対象を絞り込みやすくなります。逆に、細分化しすぎると設定と確認箇所が増えます。まずは変更理由や更新頻度が異なる単位で分け、似たルールを重複登録しないようにしましょう。

更新時は、いきなり有効なブランチへ直接書き込むのではなく、変更内容をブランチやPull Requestで確認する運用が安全です。差分では、追加した条件だけでなく削除した条件も見ます。たとえば DOMAIN-SUFFIX,example.com を追加すると、そのドメイン配下の広い範囲が対象になる可能性があります。単一ホストだけを振り分けたいのにサフィックスを選んでいないか、既存の例外ルールを広げていないかをレビューしてください。

公開ブランチのURLを参照する構成では、ブランチにコミットした変更が次回取得時に反映されます。ただし、クライアント側の更新間隔、取得失敗時のキャッシュ、GitHub側の配信キャッシュなどにより、変更が見えるまで時間差が出ることがあります。変更直後に通信先が変わらない場合は、まずGitHubのRaw URLで新しい内容が公開されているか、次にMihomoのprovider更新状態が成功しているかを順に確認します。

Gitのコミット履歴は変更の追跡に役立ちますが、機密情報を置いてよい場所ではありません。社内専用のホスト一覧や内部IPを公開リポジトリへ誤って登録しないようにし、トークンや認証情報はルールファイルにもコミットメッセージにも含めないでください。プライベートリポジトリを使う場合、MihomoのHTTP取得で認証が必要になる構成は、クライアントやバージョンによって扱いが異なります。認証情報をURLへ直接埋め込む方法は漏えいにつながるため避け、利用環境で安全に取得できる方法を確認してください。

4. ルール順序と策略グループの確認

Mihomoは、基本的に rules: の上から条件を評価し、最初に一致したルールを適用します。そのためproviderの位置は重要です。広い条件を持つ RULE-SET が例外ルールより上にあると、例外が評価される前に通信が振り分けられてしまいます。たとえば社内ドメインを DIRECT にしたいなら、社内用の明示ルールを広いproviderより上に置くか、provider内の内容と順序を見直してください。

次の例は、特定ホストを先に DIRECT にし、それ以外の登録済みドメインを PROXY グループへ送る考え方です。策略グループ名は、実際の設定に存在する名前へ置き換えます。PROXY が設定内にない場合、YAMLの文法が正しくても起動時にエラーになることがあります。

rules:
  - DOMAIN,internal.example.com,DIRECT
  - RULE-SET,example-domains,PROXY
  - GEOIP,JP,DIRECT
  - MATCH,DIRECT

MATCH のような全件に一致するルールは、通常は後ろに置きます。これより後ろに書いたproviderや例外ルールは評価されないためです。また、provider自体が正しく読み込まれていても、別の上位ルールが先に一致すれば、そのproviderには到達しません。クライアントの接続画面やログで対象通信のドメイン、マッチしたルール、選ばれた策略グループを確認し、設定上の想定と実際の判定を照らし合わせましょう。

購読プロファイルを使う場合、編集したYAMLが次回の購読更新で上書きされないかにも注意が必要です。アプリが提供するオーバーライド機能やローカルプロファイルなど、更新後も保持される場所に設定するのが基本です。ただし、設定のマージ方法はクライアントごとに異なります。画面上で保存済みに見えても、アクティブなプロファイルが別なら実際の通信には反映されません。変更後は有効プロファイルとMihomoの起動ログを確認してください。

5. 設定を検証し、読み込みエラーを切り分ける

変更を公開する前に、まずYAMLのインデント、コロン、引用符、キー名を確認します。YAMLでは空白の深さが構造を決めるため、タブとスペースを混在させないでください。続いて、利用中のMihomoコアで設定テストを行います。たとえばコマンドラインで設定ファイルを指定できる環境では、mihomo -t -f config.yaml のような検証を実施し、実際の起動ログも確認します。アプリ内でコアを管理している場合は、そのアプリが選択しているMihomoのバージョンと設定検証機能を使ってください。

エラーが出たときは、症状ごとに確認箇所を分けると効率的です。rule-providers のキー名や behavior の値に関するエラーなら、YAMLの構造とコアが対応する設定形式を確認します。URL取得の失敗なら、Raw URL、リポジトリの公開範囲、ブランチ名、ネットワーク接続を確認します。ファイルの取得は成功するのにproviderを読み込めない場合は、payload: の有無、ルール行の形式、空ファイルや不正な文字を調べます。

読み込みに成功したのに通信が期待どおりにならない場合は、ルール内容より先に、該当通信がどの設定を通っているかを見ます。アプリのログに対象ドメインが出ているか、どのルールが一致したか、策略グループが想定どおりかを確認します。ドメインがログに見当たらないときは、システムプロキシやTUNの範囲、アプリ独自のプロキシ設定、DNS解決の経路など、ルール評価より手前の問題も考えられます。ログを共有する場合は、利用者名、内部ホスト、認証情報などを伏せてください。

更新が反映されないときは、GitHub上のファイル更新、Mihomoのprovider取得結果、ローカルのキャッシュパス、更新間隔の順で確認します。調査のためにキャッシュファイルを削除する場合は、先に設定のバックアップを取り、対象のproviderだけを扱ってください。コアの再起動や全プロファイルの作り直しを最初に行うと、元の状態が分からなくなり、原因の特定が難しくなります。まず一つのproviderを手動更新し、ログの変化と対象ルールの判定を確認するのが実務的です。

GUI中心のツールでは、細かなルールを複数の画面やローカル設定に分けて管理するのが手間になることがあります。一方、Mihomoのrule-providersなら、GitHub上の差分をレビューし、取得元・更新間隔・適用順をテキストで共有できます。画面操作だけで管理する方式に比べ、変更理由と履歴を追いやすいことが大きな利点です。独自ルールをチームや複数端末で一貫して保守したい場合は、まず小さな公開リストから試し、設定とログを確認しながら運用を広げてください。

ダウンロードへ

ルール運用を始めましょう

Mihomoに対応したクライアントを選び、設定の読み込みとルール判定を確認できます。

6. よくある質問

更新間隔を短くすれば、変更はすぐ反映されますか?

必ずしもすぐには反映されません。Mihomoが次回取得を行うまで待つ必要があり、ネットワーク状態や取得元の配信状況によって遅れることもあります。緊急の変更では、providerの手動更新やコアの状態確認を行い、GitHub上のRawファイルと取得ログの両方を確認してください。

domain形式とclassical形式はどう使い分けますか?

ドメインの一致条件を中心に管理するなら domain、複数種類のルールを一つの集合にまとめるなら classical が候補になります。形式ごとにファイル内の記法が異なるため、providerの behavior と内容を一致させてください。IP範囲を管理する場合は、用途に応じて ipcidr も検討します。

プライベートリポジトリのファイルも取得できますか?

認証の要否や取得方法は、Mihomoコアとクライアントの構成に依存します。公開リポジトリと同じRaw URLを指定するだけでは、非公開ファイルを取得できない場合があります。トークンをURLに直接書くと設定ファイルやログから漏れるおそれがあるため、利用環境が提供する安全な認証方法を確認し、難しい場合は機密情報を含まない公開リストに分ける方法も検討してください。