Shadowrocketのルール設定方法:DOMAIN-SUFFIX・GEOIP・IP-CIDR・FINALのマッチング入門

DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINALのマッチ条件と、上から順に判定されるルールの優先順位、PROXY / DIRECT / REJECTの書き方を解説します。

この記事の要点

まず Home → Global Routing で Config を選び、現在の設定ファイルの [Rule] を確認します。ルールは上から順に判定され、最初に一致したルールのポリシーが適用されます。この記事は、設定ファイルを使っていて、ドメインの例外を追加したい方や振り分け結果を確認したい方に向けた内容です。読み終えたら目的に合ったルールタイプを選び、範囲の狭い例外を広いルールより前に置いて、3種類のリクエストで振り分けを確認できます。

ルールの構文:条件とポリシーを分けて記述

[Rule] セクションには、1行につき1つのルールを記述します。通常のルールはタイプ、マッチ条件、ポリシーの順に、英語のカンマで区切って指定します。FINAL はマッチ条件を指定せず、ポリシーを続けて記述します。ドメインルールにはホスト名またはマッチさせる文字列を指定し、https://、ポート、パスは含めません。以下のドメインとアドレスは記述例であり、接続可能かどうかを確認するためのものではありません。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example-test,REJECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
3種類
この記事で扱うドメインのマッチタイプ
/24
IPv4アドレスの先頭24ビットをネットワークプレフィックスとして指定
2項目
FINALはタイプとポリシーのみを記述

ポリシーを変更する前に、ルールが一致しているか確認

特定のサブドメインを直接接続にするには、まずリクエストのホスト名を確認し、その DOMAIN ルールを、該当する DOMAIN-SUFFIX より前に移動します。最初に FINAL を変更する必要はありません。先行ルールに一致したリクエストは末尾のルールまで進まないためです。

  • DIRECT:対象のリクエストを、選択中のプロキシを経由せずに直接接続します。
  • PROXY:対象のリクエストをプロキシ経由で転送します。テスト前に Home で現在選択中のプロキシを確認してください。このルールに一致しても、プロキシが利用可能であることや、接続先から応答があることを意味するわけではありません。
  • REJECT:一致したリクエストを拒否します。プロキシに処理を渡す動作でも、接続に失敗した後に別の経路へ切り替える動作でもありません。

ドメインのマッチング:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD

特定のホスト名だけを対象にする場合は DOMAIN、ルートドメインとサブドメインを対象にする場合は DOMAIN-SUFFIX を選びます。複数のドメインに含まれる同じ文字列をマッチさせる必要がある場合に限り、DOMAIN-KEYWORD を使います。サフィックスの判定ではドメインのラベル境界が考慮されますが、キーワードの判定では文字列がラベル全体と一致する必要はありません。

条件マッチする例マッチしない例
DOMAIN,docs.example.comdocs.example.comcdn.docs.example.com、example.com
DOMAIN-SUFFIX,example.comexample.com、api.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,example-testcdn-example-test.example.netexampletest.example.net

この表は各条件単体のマッチ結果を示しています。実際に適用されるポリシーはルールの順序によって変わります。例の docs.example.com は上の2つの条件に一致しますが、先に評価される完全一致ルールが適用されるため、DIRECT になります。サフィックスルールを前に移動すると、同じホストは PROXY になります。Shadowrocketは候補となるルールをすべて集めてから、最も具体的なものを自動選択するわけではありません。

アドレスのマッチング:IP-CIDR、GEOIP、no-resolve

IP-CIDR は接続先のIPv4アドレスが属するネットワーク範囲でマッチするため、アドレス範囲が分かっている接続先に適しています。GEOIP はIPデータベース上の地域分類に基づいて接続先のアドレスを判定します。GEOIP,CN,DIRECT はドメインが .cn で終わるかどうかや、デバイスの所在地を判定するルールではありません。ドメインの解決結果はネットワークや時間によって変わることがあります。特定サービスの振り分けを固定したい場合は、既知のドメインを使ったルールを優先してください。

  • 192.0.2.0/24 のマッチ範囲は 192.0.2.0 から 192.0.2.255 までです。たとえば接続先IPが 192.0.2.42 ならこのネットワークに一致し、192.0.3.42 は一致しません。前者のアドレスだけを対象にする場合は、192.0.2.42/32 と記述します。
  • ドメインのリクエストがアドレスルールの判定に進んだ時点で接続先IPが分からない場合、マッチ判定の前にドメイン解決が必要になることがあります。例の no-resolve は、この IP-CIDR ルールの判定のために名前解決を行わない指定です。接続先IPがすでに分かっていれば、そのアドレスを使って判定できます。後続ルールや実際の接続に必要なDNS解決まで禁止するものではありません。
  • IP-CIDR に指定したこのIPv4ネットワークは、IPv6には適用されません。同じホストへの接続結果がネットワークによって異なる場合は、接続で使われたアドレスファミリーと接続先IPを確認し、アドレスルールがマッチしていない可能性を調べてください。ポートが変わっても、このネットワークルールのマッチ範囲は変わりません。

個別のアドレスに対する例外は、広範囲に適用される GEOIP ルールより前に記述してください。先に GEOIP,CN,DIRECT を置くと、データベースで CN に分類された接続先には DIRECT が適用され、後続のネットワーク例外は判定されません。末尾の FINAL が対象にするのは、それまでのルールに一致しなかったリクエストだけです。先行ルールによる接続がタイムアウトしても、別の振り分けには切り替わりません。

Configで最初に一致するルールを確認

ルールを変更する前に、テスト対象ごとに想定するポリシーを決めておきます。特定の例外をテストする場合は、正常にアクセスできると確認済みの接続先を選んでください。文書用に予約されたアドレス範囲は、接続可能なサービスとして使わないでください。編集前に元の設定を保存し、ルールの順序と接続状態を同時に変更しないようにします。

  1. 設定を確認

    Configを開き、現在使用している設定ファイルを確認します。PROXY をテストする場合は、Homeで利用可能な既存のプロキシが選択されていることも確認してください。

  2. ルールを保存

    現在の設定ファイルの [Rule] セクションに完全一致の例外ルールを追加し、対象に適用される可能性のあるサフィックス、キーワード、アドレスルールより前に配置します。FINAL は末尾に残してください。

  3. Configに切り替え

    Home → Global Routing で Config を選択します。ProxyまたはDirectモードでの結果をルールの検証に使わないでください。Sceneを使っていた場合は、シーン選択の影響を除くため、明示的にConfigへ切り替えます。

  4. 新しいリクエストを送信

    完全一致の例外、同じサフィックスを持つ別のホスト、先行するどの条件にも一致しない接続先へ、それぞれリクエストを送ります。この記事の例では、想定されるポリシーは順に DIRECT、PROXY、FINAL で指定した PROXY です。3つ目の接続先が先に GEOIP に一致する場合は、フォールバックのテスト対象を別のものに変更してください。

  5. 結果を比較

    新しいリクエストに対応する接続ログを開き、実際のホスト名、ポリシー、表示されているマッチ情報を確認します。ページがキャッシュから表示されている場合や古い接続が再利用されている場合、新しいルールが反映されたかは判断できません。既存の接続を終了してから再テストしてください。

ルールが反映されない場合:ポリシー、DNS、接続エラーを切り分ける

同じホストに誤ったポリシーが適用される場合は、使用中の設定、Global Routing、ルールの順序を確認します。ポリシーは正しいのにリクエストに失敗する場合は、DNSまたは接続の問題を調べてください。以下はChromiumブラウザに表示されることがあるエラー原文であり、Shadowrocketのルール検証メッセージではありません。ブラウザのエラーだけから原因となったルールを特定することはできません。

エラー:ERR_NAME_NOT_RESOLVED

原因:ブラウザがリクエスト先ドメインの有効な名前解決結果を取得できませんでした。対処方法:まずリクエストのホスト名に誤字がないか確認し、次に現在の名前解決設定を確認してください。スペルやDNSを確認するために、先に FINAL のポリシーを変更する必要はありません。

エラー:ERR_CONNECTION_TIMED_OUT

原因:制限時間内に接続が確立されませんでした。接続先または現在の転送経路が応答していない可能性があります。対処方法:まず新しいリクエストに想定どおりのポリシーが適用されているか確認し、同じポリシーで到達可能と確認済みの接続先をテストします。これにより、特定の接続先だけのタイムアウトか、経路全体の問題かを切り分けられます。

2つの接続先がどちらも最終的に PROXY になる場合、ポリシー名だけではサフィックスルールに一致したのか、FINAL が適用されたのか判断できません。まず接続ログのマッチ情報を確認してください。ログに具体的なルールが表示されない場合は、テスト用の設定コピーで確認対象のルールだけを変更し、管理できるテスト用接続先に新しいリクエストを送って、変更前後のポリシーを比較してから元の設定に戻します。

Shadowrocketを無料ダウンロード