Shadowrocketのルール解説|DOMAIN-SUFFIX・GEOIP・IP-CIDR・FINALの違い

DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINALのマッチ対象と書き方を例とともに解説。ルールの適用順も紹介します。

この記事の概要

Home → Global RoutingでConfigを選ぶと、Shadowrocketは現在の設定ファイルにあるルールを上から順に照合し、最初に一致したルールのポリシーを適用します。ドメインルールはホスト名、アドレスルールは接続先IPを照合し、FINALはそれまでのルールに一致しなかった接続に適用されます。振り分け設定を整理したい方や、接続がDIRECTまたはPROXYになる理由を確認したい方に向けた解説です。

ルールの適用順:Configを確認し、最初に一致するルールを特定

Home → Global RoutingでConfigを選び、次にConfigページで現在使用中の設定ファイルを確認します。最初のConfigはルーティングモード、後者は設定ファイルを管理するページです。別のファイルを編集しても、現在の接続にはそのファイルの新しいルールは適用されません。また、ProxyとDirectは、この振り分け順を確認するためのモードではありません。

接続リクエスト接続先情報ルールを順に照合ポリシーを選択接続を開始

ルールは通常「タイプ、マッチ値、ポリシー」の形式で記述します。例:DOMAIN,api.example.com,DIRECT。DIRECTは直接接続、PROXYはプロキシ経由を意味します。設定がより具体的なルールを自動で優先するわけではありません。たとえDOMAINのほうがDOMAIN-SUFFIXより具体的でも、前にあるサフィックスルールが一致すれば、その後のルールは照合されません。

3種類
この記事で扱うドメインルール:完全一致・サフィックス・キーワード
256個
IPv4の/24サブネットに含まれるアドレス数
2項目
FINALに記述するのはルールタイプとポリシーのみ

ドメインルール:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD

3種類ともホスト名を照合し、URL全体は照合しません。たとえばhttps://api.example.com:443/v1/statusの場合、ドメイン欄に記述するのはapi.example.comです。https://、ポート番号443、パス/v1/statusは含めません。同じホストの異なるパスを別々に処理することは、この3種類のルールだけではできません。

ルールタイプマッチ値一致する例一致しない例
DOMAINapi.example.comapi.example.comimg.api.example.com
DOMAIN-SUFFIXexample.comexample.com、api.example.comnotexample.com
DOMAIN-KEYWORDexamplenotexample.netapi.example.net以外の無関係なホスト(例:api.demo.test)

特定のホストだけ例外にする場合はDOMAINを使います。ルートドメインとサブドメインをまとめて対象にする場合はDOMAIN-SUFFIXを使い、マッチ値に*.example.comと書く必要はありません。DOMAIN-KEYWORDは部分文字列で照合するため、キーワードがドットの間にある必要はありません。表のnotexample.netにもexampleが含まれるため一致します。ドメインが属するサイトがまったく別でも結果は変わりません。接続先のドメインが分かっている場合は、完全一致またはサフィックスルールを使うと対象範囲を制御しやすくなります。

アドレスルール:IP-CIDRはサブネット、GEOIPはIPの地域情報を照合

接続先がドメイン名で指定されている場合、アドレス系ルールで照合するには接続先IPが必要です。例としてIP-CIDR,192.0.2.0/24,DIRECT,no-resolveのno-resolveは、このルールとの照合のために追加のDNS問い合わせを行わない指定であり、設定全体のDNSを無効にするものではありません。接続先IPがすでにあれば、そのアドレスがサブネット内かを判定できます。ホスト名しかなく利用可能なIPアドレスもない場合、このルールがホスト名を名前解決して一致するとは限りません。

同じホスト名でも、異なるIPアドレスが返されることがあります。ドメインサフィックスルールの条件はアドレスが変わっても変わりませんが、GEOIPの結果は照合対象のIPとデータベース上の所属に左右されます。特定のホストに常に同じポリシーを適用したい場合は、対応するドメインルールを地域ルールより前に配置してください。

FINALのフォールバックと適用順の例

FINALにはドメイン、サブネット、地域コードを指定しません。たとえばFINAL,PROXYは、それ以前のルールに一致しなかった接続をプロキシ経由にします。[Rule]の末尾に配置してください。以下は適用順を確認するためのルール例で、完全な設定ではありません。PROXY経由の接続をテストする場合は、設定済みで利用可能なプロキシを使ってください。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,demo-example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
  1. 接続先ホスト名がapi.example.comの場合、1行目が選択され、DIRECTになります。先頭の2つのルールを入れ替えると、同じホスト名はサフィックスルールに先に一致し、PROXY経由になります。
  2. 接続先ホスト名がdemo-example.example.comの場合、サフィックスとキーワードの両方に一致しますが、サフィックスルールが先にあるためPROXY経由になります。キーワードルールが、すでに選択されたポリシーを上書きすることはありません。
  3. 接続先が192.0.2.18として直接指定されている場合、最初の3つのドメイン条件には一致せず、サブネットルールが選択されてDIRECTになります。192.0.3.18に変更した場合、このサブネットに一致しないことを示すだけです。後続のGEOIPも確認せずに、FINALが適用されるとは判断できません。
  4. ドメイン、IPアドレス範囲、地域のいずれの条件にも一致しなかった場合に限り、最後の行にある PROXY が適用されます。この出力先への接続に失敗しても、FINAL が別のポリシーを選ぶことはありません。処理するのは「ルールに一致しない接続」であり、「接続に失敗した接続」ではありません。

ルールが適用されない・接続できない場合の確認

まず、ポリシーの選択が誤っているのか、正しいポリシーが選ばれた後に接続が失敗しているのかを切り分けます。接続可能なテスト用ホストを指定し、そのホストにDOMAINルールを追加して、より広い範囲のルールより前に配置します。保存後、接続を再試行してください。ウェブページは画像やスクリプトを別のホストから読み込むことが多いため、ページ全体が開くかどうかだけで、すべてのリクエストに適用されたポリシーを判断することはできません。

ブラウザーに表示されるエラー

以下はブラウザーに表示される可能性があるエラーの原文であり、Shadowrocketのルール照合結果ではありません。

エラー:ERR_NAME_NOT_RESOLVED

原因:ブラウザーがリクエスト先のホスト名をIPアドレスに解決できませんでした。対処:ホスト名の入力とDNSによる名前解決を確認してから、接続先IPに依存するルールの調整が必要か判断してください。

エラー:ERR_CONNECTION_TIMED_OUT

原因:制限時間内に接続が確立されませんでした。このエラーだけでは、どのルールに一致したかは分かりません。対処:現在の設定でルールの順序と想定ポリシーを確認します。PROXY経由の想定であれば、Homeで現在使用中のプロキシに対してConnectivity Testを実行してください。

よくある質問

DOMAINを追加したのに、なぜPROXY経由になる?

Home → Global RoutingでConfigが選択されていることを確認し、編集中のファイルが現在使用中のものか確かめます。次に、前の行に一致済みのDOMAIN-SUFFIXまたはDOMAIN-KEYWORDがないか確認してください。該当するルールがあれば、完全一致の例外ルールをその前に移動し、接続を再試行します。

同じドメインにアクセスしているのに、GEOIPの結果が変わるのはなぜ?

2回の接続で実際に使われた接続先IPを比較してください。ドメインが同じでも、接続に使われるアドレスまで同じとは限りません。ドメインごとにポリシーを固定する場合は、後続のGEOIPに頼らず、前のほうにDOMAINルールを配置します。

FINALを変更する前に、どのルールを確認すればよい?

既知のドメインルールに一致しないテスト用の接続先を使い、IP-CIDRまたはGEOIPに一致するかも確認します。それ以前の条件がすべて不一致の場合に限り、FINALの変更がその接続に影響します。結果を比較しやすいよう、検証では一度に1項目だけ変更してください。

Shadowrocketのダウンロードと初期設定

iPhone・iPad版はApp Storeから入手でき、価格は2.99ドルの買い切りです。システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン・Intel)、Windows、Android、Linux版は無料で、当サイトのダウンロードページから入手できます。

Shadowrocketをダウンロード