1. rule-providersで自作ルールを分離する理由
ClashのルールをGitHubで管理したいと考えたとき、まず整理したいのは、接続先を判定するルール本体と、そのルールを読み込むプロファイルの役割です。プロファイルの rules: にすべてを書き足す方法は手軽ですが、ルールが増えるほど差分を追いにくくなり、購読プロファイルの更新時にローカル変更を失うリスクも高まります。そこで、ドメインや IP のリストを別ファイルに分け、Clash 側から参照する仕組みが rule-providers です。
rule-providerを使うと、メインの YAML には「どのプロバイダーを読み込むか」と「どの策略グループへ送るか」を残し、個々のルールは GitHub 上のファイルへ分離できます。たとえば開発用サービス、動画配信、社内向けドメインを別々に管理すれば、変更対象が明確になり、GitHub のコミット差分やレビューで変更理由も確認できます。複数端末で同じリストを使いたい場合にも、プロファイル全体を複製せずルールだけ共有できるのが利点です。
ただし、rule-providers はすべての「Clash」と名の付くコアで同じように使えるわけではありません。現在の Mihomo 系クライアントでは一般的な機能ですが、古いコアや別実装では対応する項目、フォーマット、更新動作が異なる場合があります。Clash Verge Rev などの画面上の名前だけで判断せず、実際に利用中のコアとバージョンを確認してください。また、購読プロファイルを直接編集するのではなく、クライアントのローカルオーバーライドやマージ機能で設定を維持できるかも先に確かめます。
2. GitHubにルールを置き、YAMLから参照する
最初に GitHub でリポジトリを作り、ルール用のファイルを配置します。公開リポジトリなら、一般に Raw コンテンツの URL を url に指定して取得できます。ブランチ名を含む URL は更新を反映しやすい一方、誰かがブランチ上の内容を書き換えると全端末へ同じ変更が配布されます。検証環境で確認してから本番へ反映する運用や、特定コミットを参照する運用にすると、意図しない差分が入ったときの影響を抑えやすくなります。
次の例では、ドメイン形式のルールを GitHub から取得する構成を示します。URL、ファイル名、策略グループ名は利用環境に合わせて変更してください。PROXY は実際に存在する策略グループ名に置き換えます。
rule-providers:
dev-services:
type: http
behavior: domain
format: yaml
url: "https://raw.githubusercontent.com/example-user/clash-rules/main/dev-services.yaml"
path: ./ruleset/dev-services.yaml
interval: 86400
rules:
- RULE-SET,dev-services,PROXY
- MATCH,DIRECT
ここで type: http は HTTP 経由で配布ファイルを取得する指定、behavior はルールの種類、format はファイル形式です。path は取得した内容をローカルに保存する場所、interval は更新確認の間隔を秒数で指定します。端末やクライアントによって相対パスの扱いが異なることがあるため、設定例をそのまま貼るのではなく、コアのログでファイルの保存先と読み込み結果を確かめてください。
ドメイン形式のファイルは、たとえば次のように payload の下へドメインを記述します。ドメイン形式では、一般に DOMAIN や DOMAIN-SUFFIX といったルール種別を各行に付けず、ドメイン名そのものを列挙します。IP CIDR の一覧なら behavior: ipcidr、複数種類のルールを含める場合は behavior: classical を検討し、プロバイダー側の形式と一致させます。
payload:
- '+.github.com'
- '+.githubusercontent.com'
- 'api.example.com'
公開リポジトリを使う場合でも、設定ファイルに認証トークン、個人用 URL、社内の非公開ホスト名などを含めないでください。private リポジトリは、コアが認証なしで Raw ファイルを取得できるとは限りません。認証情報を YAML に直書きして公開すると、ルール配布以前にアカウントやネットワーク情報の漏えいにつながります。アクセス制限が必要なら、利用中のコアが対応する配布方式を公式ドキュメントで確認し、秘密情報をリポジトリへ保存しない構成を選びましょう。
3. 優先順位と更新を運用しやすくする
rule-providerを定義しただけではルールは適用されません。メインプロファイルの rules: に RULE-SET,プロバイダー名,策略グループ の行を追加して初めて、読み込んだルールをどの経路へ送るかが決まります。重要なのは、通常のルールと同じく上から順に評価され、先に一致したルールが優先されることです。広い条件を上に置くと、後ろにある例外ルールや別プロバイダーが評価されない場合があります。
たとえば、社内ドメインを必ず DIRECT にする必要があるなら、社内向けの明示ルールを広いプロバイダー参照より前に置きます。逆に、最初に包括的なルールセットを置いてしまうと、後方の例外が意図どおりに働かないことがあります。複数のプロバイダーを使う場合は、名前を用途ごとに分け、各セットの目的と適用先をコメントや README に記録してください。「対象サービス」「例外」「変更日」「確認した端末」を残しておくと、後からルールを削除する判断もしやすくなります。
- 小さく分ける:開発サービス、ストリーミング、社内例外など、変更理由が異なる単位でファイルを分割します。
- 広すぎる条件を避ける:ログで確認したドメインを優先し、無関係な通信まで巻き込みやすいキーワード条件を安易に追加しません。
- 更新間隔を決める:頻繁な変更がない静的リストは、短い間隔でポーリングする必要はありません。更新頻度と配布元への負荷の両方を考慮します。
- 変更をレビューする:GitHub の Pull Request やコミット差分を使い、追加・削除された項目と理由を確認してから共有します。
自分だけで使う場合でも、編集前のファイルを Git でコミットしておけば、設定ミスのあとに正常な状態へ戻せます。チームで共有するときは、既存ルールを一度に大量削除せず、変更を小さな単位に分けてテストすると原因を追いやすくなります。更新間隔を短くしても、公開 URL にアクセスできない、配信元が一時的に応答しない、TLS 接続に失敗するといった問題は解決しません。自動更新を有効にした後も、取得失敗時に最後に正常に読み込んだ内容がどう扱われるかをコアの挙動で確認してください。
4. 反映されないときの確認手順
設定を保存したのに通信先が想定した策略グループへ進まない場合、いきなりルールを増やすのではなく、読み込みから順番に確認します。まず、現在有効なプロファイルが編集した YAML かを見ます。次に、コアのログに YAML の解析エラー、プロバイダー取得エラー、ファイル読み込みエラーが出ていないか確認します。購読更新で別プロファイルへ切り替わっていたり、アプリ側のオーバーライドが適用されていなかったりすると、記述した設定自体が実効設定に入っていないことがあります。
- 取得先を確認する:ブラウザーなどから Raw URL を開き、認証画面や 404 ではなく、想定したルールファイルが返ることを確認します。
- YAMLの形を確認する:インデント、コロン、引用符、
payloadの位置を見直し、behaviorとルールの内容が一致しているか確認します。 - プロバイダー名を照合する:
rule-providersで定義した名前と、RULE-SETから参照する名前の大文字・小文字や綴りを一致させます。 - ルールの位置を確認する:先行するルールに一致していないか、対象のドメインより広い条件が上にないかをログで調べます。
- 実際の判定を見る:Clash の接続ログで対象ホスト、選択されたルール、策略グループを確認し、想定と異なる箇所を切り分けます。
プロバイダーが取得済みでもルールが一致しない場合は、ファイル形式の誤りがよくある原因です。behavior: domain のファイルに DOMAIN-SUFFIX,example.com のような classical 形式の行を混在させると、期待した判定にならない可能性があります。逆に behavior: classical を使う場合は、各ルール行の種別と形式がコアの仕様に合っているかを確認します。また、ドメインリストは DNS 解決後の IP だけを見ている設定とは一致しないことがあるため、ログに表示されるホスト名と、アプリが実際に接続している名前を照らし合わせてください。
GitHub の更新が反映されないときは、URL のブランチ名やファイルパス、キャッシュされたローカルファイル、更新間隔を確認します。取得に成功したように見えても、参照先のブランチで内容が変わっていない場合や、アプリがまだ古い設定を有効にしている場合があります。手動更新やプロファイル再読み込みを行った後、ログの取得時刻とルール判定の両方を確認すると、配布側と Clash 側のどちらで止まっているかを分けやすくなります。
ルールをプロファイルへ直接書き足す方法は最初の一歩として簡単ですが、複数端末で差分を共有したり、変更の経緯を追ったりする段階では、手作業のコピーがミスや設定のずれを生みやすくなります。rule-providers と GitHub を組み合わせれば、ルールを小さく分けてレビューし、端末側の策略グループはそのまま保ちながら更新できます。まずは影響範囲の小さいドメインセットから試し、ログで動作を確認してから運用範囲を広げましょう。Clash クライアントごとの導入や設定方法を確認したい場合は、チュートリアルを見るか、利用環境に合うクライアントをダウンロードページで確認してください。
rule-providersを使い始めましょう
GitHubでルールを管理し、Clashの設定に合わせて安全に運用するためのクライアントを選べます。