配置 2026年9月3日

Clashのrule-providersをGitHubで管理する高度な設定術

rule-providersを使って、ClashのカスタムルールをGitHubで管理・更新する方法を実例で紹介します。AIツールや開発サービスごとの振り分け、YAMLの設計、競合ルールの調べ方まで扱う実践的な設定ガイドです。

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

1. rule-providersを使う理由:購読設定と自作ルールを分離する

Clashで特定のドメインだけを別の策略グループへ送りたい場合、rules: にすべてのルールを直接書く方法は手軽です。しかし、AIツール、開発サービス、コードホスティング、社内サービスなどの対象が増えると、プロファイル本体が長くなり、購読更新のたびに自分の変更が失われるリスクも高まります。そこで役立つのが rule-providers です。ルールを外部のYAMLファイルとして管理し、ClashやMihomoの設定から必要なときに読み込ませることで、メイン設定と運用ルールを分離できます。

特にGitHubを保存先にすると、変更履歴、差分レビュー、Issueによる相談、複数端末への共有が可能になります。たとえば ai-tools.yaml、developer-services.yaml、direct-domains.yaml のように目的別にファイルを分ければ、「どのサービスをなぜPROXYへ送るのか」を後から確認しやすくなります。Clash VergeやClash Verge Revで購読プロファイルを更新しても、外部プロバイダーのURLが同じであれば、ルールの本体はGitHub側で継続して管理できます。

ただし、rule-providersは単なるURLの一覧ではありません。プロバイダーの形式、更新間隔、取得方式、ルールの参照名、ルール評価の順序が一致して初めて機能します。さらに、GitHubリポジトリを公開する場合は、アクセストークンや社内ホスト名、利用者を特定できる情報を絶対に含めないでください。公開リポジトリには、誰が見ても問題のないドメイン分類だけを置くのが基本です。

2. GitHubリポジトリの設計:小さく分けてレビュー可能にする

最初から巨大なルールファイルを作るより、サービスの目的と変更頻度に応じてファイルを分割する方が安全です。AI関連のドメインは新しいAPIや管理画面が追加されるたびに変わりやすく、開発サービスはCDNやリージョン別のホストが増えやすい一方、ローカルネットワークや社内ドメインは比較的安定しています。変更の性質が異なるものを別ファイルにすると、更新時の影響範囲を限定できます。

ファイル例 用途 見直すタイミング
ai-tools.yaml AIチャット、API、モデル管理サービス 新機能やSDKを追加したとき
developer-services.yaml GitHub、npm、コンテナレジストリ、開発CDN 開発環境やCIを変更したとき
direct-domains.yaml 社内、LAN、銀行、地域内サービス ネットワーク構成を変更したとき
streaming.yaml 動画や音楽サービスの分流 利用地域や出口を変えたとき

GitHub上では、READMEに「このファイルの対象」「想定する策略名」「追加したルールの根拠」「最終確認日」を記録しておくと、将来の自分やチームメンバーが迷いません。ドメインを追加する際は、サービス名だけで判断せず、Clashのログ、ブラウザのNetworkタブ、CLIの詳細ログを確認します。通信先が実際に観測できていない状態で DOMAIN-KEYWORD を追加すると、関係のないサービスまでPROXYへ送る可能性があります。

コミット単位も重要です。「AI Studioの認証ホストを追加」「npmのメタデータ取得先を追加」のように、一つの目的を一つのコミットにまとめます。大量のドメインを一度に追加すると、どの行が原因で速度低下やログイン失敗が起きたのか分からなくなります。Pull Requestを使える環境なら、追加理由と検証結果を本文に残し、レビュー後にマージする運用が効果的です。

3. provider定義の書き方:type・format・intervalを揃える

Mihomo系の設定では、外部ルールを rule-providers: に定義し、その後の rules: から RULE-SET で参照します。形式は環境やコアのバージョンによって差があるため、利用中のClash Verge RevやMihomoの仕様を確認してください。以下は、GitHub上にルールを置き、YAML形式で読み込む概念例です。

rule-providers:
  ai-tools:
    type: http
    behavior: domain
    format: yaml
    path: ./rules/ai-tools.yaml
    url: https://raw.githubusercontent.com/example-user/clash-rules/main/ai-tools.yaml
    interval: 86400

  developer-services:
    type: http
    behavior: domain
    format: yaml
    path: ./rules/developer-services.yaml
    url: https://raw.githubusercontent.com/example-user/clash-rules/main/developer-services.yaml
    interval: 86400

rules:
  - RULE-SET,ai-tools,PROXY
  - RULE-SET,developer-services,PROXY
  - GEOIP,JP,DIRECT
  - MATCH,DIRECT

type: http はHTTP経由でファイルを取得する指定、behavior: domain はドメイン系ルールを扱う指定です。format: yaml とリモートファイルの実際の形式が一致していないと、取得できてもルールとして解釈されません。path はダウンロード後のキャッシュ場所なので、端末上で書き込み可能なパスを使います。interval は更新間隔を秒で指定しますが、短くしすぎるとGitHubへの取得回数が増え、障害時の挙動も追いにくくなります。日次や数時間ごとなど、変更頻度に合わせて設定してください。

ルールファイル側は、たとえば次のように記述します。最初は完全一致やサフィックスを中心にし、必要性が確認できたものだけを追加します。

payload:
  - DOMAIN-SUFFIX,openai.com
  - DOMAIN-SUFFIX,anthropic.com
  - DOMAIN-SUFFIX,ai.google.dev
  - DOMAIN-SUFFIX,github.com
  - DOMAIN-SUFFIX,githubusercontent.com
  - DOMAIN-SUFFIX,npmjs.com

配布形式によっては payload: が必要ない場合もあるため、手元のコアが要求する形式を確認してください。公開されているサンプルをそのまま混ぜるのではなく、現在のバージョンで「プロバイダーを更新できたか」「ルール数が表示されるか」「対象通信が期待したグループへ入ったか」を順番に確認するのが安全です。

4. ルールの順序と競合を調べる方法

Clashのルールは通常、上から下へ評価され、最初に一致した行が採用されます。そのため、rule-providerを追加しただけでは十分ではありません。上にある広いルールが先に一致していれば、後ろに置いたプロバイダーのルールは実行されません。たとえば DOMAIN-SUFFIX,github.com,DIRECT が先にある状態で、後ろに RULE-SET,developer-services,PROXY を置いても、GitHub関連通信はDIRECTのままです。

競合を調べるときは、まず対象ドメインを一つに絞ります。Clash Verge Revの接続ログで実際のホスト名を確認し、該当接続をクリックして、適用されたルールと策略グループを記録します。ブラウザではページ本体だけでなく、認証、静的アセット、WebSocket、API、画像配信が別ホストになることがあります。AIツールの画面が開いてもAPI呼び出しだけ失敗する場合、UI用ドメインとAPI用ドメインが異なる可能性が高いです。

  1. Clash Verge RevでRuleモードが有効になっていることを確認する。
  2. 対象アプリを終了してから、ログをクリアする。
  3. 対象サービスを一度だけ開き、発生したドメインを記録する。
  4. ログ上のルール名が、想定したRULE-SETまたは直接ルールか確認する。
  5. 上位の広いルール、GEOIP、FINAL相当のルールを上から順に調べる。
  6. 修正後にプロバイダーを更新し、同じ操作を再実行する。

特に注意したいのは、プロバイダーの中に同じドメインを重複して入れることです。重複自体が必ず障害を起こすわけではありませんが、異なる策略を期待している場合は管理が難しくなります。AI用ファイルと開発用ファイルの境界をREADMEで定義し、同じドメインを複数の分類へ入れない方が、ログを読んだときの説明が簡単です。

また、MATCH,DIRECT を最後に置く構成と、MATCH,PROXY を最後に置く構成では、未分類通信の挙動が大きく変わります。未知のドメインを安全側に倒したい場合は、まずDIRECTで記録し、必要なものだけをプロバイダーへ追加する方法が扱いやすいでしょう。逆に業務要件で外向き通信を限定する場合は、組織のポリシーに従い、未分類通信をPROXYまたは遮断する設計を検討します。

5. 更新失敗を防ぐ運用と実践的なトラブルシューティング

GitHub上のYAMLを変更したら、Clash側でプロバイダー更新を実行します。更新日時だけが変わって内容が反映されない場合は、raw URLのブランチ名、ファイルパス、公開設定、HTTPレスポンスを確認してください。GitHubの通常のHTMLページURLを指定すると、YAMLではなくWebページを取得してしまいます。URLはリポジトリ画面の表示URLではなく、Raw形式の配布URLを使うのが基本です。

取得エラーの切り分けでは、まずブラウザや curl でURLが200を返すか確認します。次に、Clashのログでプロバイダー取得失敗、形式解析エラー、ファイル書き込みエラーを分けて見ます。200でも解析に失敗する場合は、YAMLのインデント、タブ文字、余分な引用符、未対応のルール形式が原因かもしれません。GitHub ActionsなどでYAML lintを実行し、Pull Request時に構文検査を自動化すると、壊れたルールを配布しにくくなります。

更新間隔を短くしても、すでに確立した接続の経路が自動的に変わるとは限りません。新しいルールを反映した後は、ブラウザの再読み込み、アプリの再起動、必要に応じた既存接続の終了を行います。DNSをfake-ipで運用している場合は、名前解決のキャッシュとルール評価対象が一致しているかも確認してください。ホスト名ではなくIPアドレスへ直接接続するアプリや、独自DNSを使うアプリでは、ドメインルールだけで期待どおりに制御できないことがあります。

CIやサーバーで同じルールを使う場合は、公開GitHubの可用性だけに依存しない設計も必要です。重要な業務通信なら、固定バージョンのコミットを参照する、社内ミラーを用意する、更新前のファイルをローカルに保持するなど、取得失敗時の代替策を決めておきます。GitHubリポジトリを変更するときは、ファイル名を頻繁に変えず、互換性を保ったまま内容を更新する方が、複数端末の設定を壊しにくくなります。

単一のGUIクライアントだけでルールを編集する方法は、個人の小規模な設定なら十分です。しかし、サービス追加のたびに画面操作を繰り返す方法や、巨大な一枚の設定ファイルへ直接追記する方法は、差分確認、ロールバック、端末間共有が難しくなります。それに対してClashのrule-providersとGitHubを組み合わせれば、AIツールと開発サービスを目的別に分け、変更履歴を残しながら同じルールを複数環境へ配布できます。設定の透明性と更新の再現性を重視するなら、まず小さなプロバイダー一つから始めて、ログで検証しながら段階的に広げるのが現実的です。

Clashクライアントをダウンロードして設定を始める →

さっそく使ってみましょう

rule-providersとGitHubで、Clashのルールを端末をまたいで整理・更新できます。