· ルールと振り分け · 約8分

Shadowrocketのルール構文入門:DOMAIN・DOMAIN-SUFFIX・DOMAIN-KEYWORD・GEOIP・IP-CIDR・FINALのマッチ範囲

6種類の基本ルールキーワードのマッチ対象と評価順、PROXY / DIRECT / REJECTとの組み合わせを、example.comの例で解説します。

この記事の概要

Global RoutingでConfigを選択している場合、最初に一致したルールがその接続に適用されます。初めてルールを編集する方や、追加したルールが反映されない方に向けて、ドメイン・アドレス・フォールバックルールの違いと、リクエストが一致する行の見分け方、変更後の確認方法を説明します。

ルールの順序:最初に一致したルールからFINALまで

ルールの具体性より、まず設定ファイル内の位置を確認します。Shadowrocketは現在の設定に記載された順に照合し、一致した行のポリシーを適用します。DOMAINを使ったからといって、DOMAIN-SUFFIXより自動的に優先されるわけではありません。特定のホストだけ例外にする場合は、そのホストを含む広範囲のルールより前に例外を置きます。

接続先ホスト現在の設定順に照合ポリシーを適用

ルールがポリシーを選ぶ対象は個々の接続であり、アプリ全体ではありません。同じページの読み込みでも、ページ本体・静的リソース・ログイン先への接続がそれぞれ異なるルールに一致することがあります。問題を調べるときは、アドレスバーのホスト名だけでなく、失敗したリクエストの接続先ホスト名を確認してください。

ドメインルール:ホスト名・ドメインサフィックス・キーワード

ドメインルールのマッチ値には、ホスト名またはキーワードだけを指定します。たとえばhttps://www.example.com:443/docsのホスト名はwww.example.comです。https://、ポート番号の443、パスの/docsはルール値に含めません。以下の例は、接続先ホスト名を取得できることを前提としています。

ルールとマッチ値一致する例一致しない例
DOMAIN,example.comexample.comwww.example.com
DOMAIN-SUFFIX,example.comexample.com、www.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,exampleexample.net、notexample.comwww.test.invalid

特定のホストだけを指定するにはDOMAINを使います。ルートドメインと各階層のサブドメインを対象にするにはDOMAIN-SUFFIXを使います。サフィックスの照合ではドメインラベルの境界が考慮されるため、単に文字列がexample.comで終わるかどうかを判定するわけではありません。DOMAIN-KEYWORDはホスト名に含まれる文字列を検索し、ラベル全体の一致は求めません。対象が既知のドメインだけなら、キーワード指定では意図しない別ドメインにも一致するおそれがあります。

アドレスルール:IP-CIDRのネットワーク範囲とGEOIPの地域判定

IP-CIDRは接続先のIPv4アドレスが指定したネットワーク範囲に含まれるかを判定します。GEOIPは接続先IPアドレスの地理情報データベース上の所属地域で判定します。地域コードはドメインの末尾、ウェブサイトの登録地、デバイスの所在地を示すものではありません。

特定のホストに常に同じポリシーを適用したい場合、過去に名前解決されたIPアドレスでドメインルールを置き換えないでください。明示的なドメインルールをアドレスルールより前に置けば、ホスト名が分かっている時点で例外を先に処理でき、アドレスルールの判定を待つ必要がありません。

設定例:特定ホストの例外を先に適用する

以下はルールの順序を確認するための例であり、完全な設定ではありません。指定したホストを先に拒否し、同じドメインの残りのリクエストをプロキシ経由にした後、キーワードとIPアドレスの条件を処理します。既存の設定に追加する場合は、必要なルールだけを既存の[Rule]セクションに入れ、末尾にFINALを1つ残してください。

[Rule]
DOMAIN,api.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,DIRECT
  1. api.example.comは最初の3行すべてのドメイン条件に一致しますが、最初の行が先に適用されるため、結果はREJECTです。サフィックスルールを先頭に移すと、結果はPROXYになります。
  2. www.example.comは1行目には一致せず、2行目のサフィックスルールに一致するため、結果はPROXYです。接続先IPアドレスがCNに分類されても、後続のGEOIPルールが適用済みのポリシーを上書きすることはありません。
  3. example.netは最初の2行のドメイン条件に一致せず、3行目のキーワードルールに一致してDIRECTになります。キーワードルールをサフィックスルールより前に誤って置くと、www.example.comも先にDIRECTになります。
  4. 接続先アドレスが192.0.2.7なら、4行目に一致します。最初の5行に一致しなかった接続はFINAL,DIRECTで処理されます。いずれの行でもDIRECTになる可能性があるため、ポリシー名だけではどの行に一致したか判断できません。

ルールの適用と結果の確認

テストに使う設定とルーティングモードを確認してから、新しい接続を開始します。以下ではiPhone / iPadの画面を例に手順を説明します。ルールを保存しただけでテスト完了とは限りません。現在選択中の設定、再利用されている接続、プロキシサーバーの状態も確認結果に影響します。

  1. 設定を確認する

    画面下部のConfigを開き、現在選択されている設定ファイルを確認します。編集前に元に戻せるコピーを保存し、1回のテストで複数の既存ルールを変更しないようにしてください。

  2. 変更を保存する

    確認したいルールを同じ設定の[Rule]セクションに置きます。項目間に半角カンマが使われているか、例外ルールが広範囲のルールより前にあるかを確認して保存します。

  3. ルーティングを確認する

    Homeに戻り、Global Routingを開いてConfigを選択します。Proxy、Direct、または用途に応じたSceneが選択されていた場合は、まずConfigに切り替えてから、この記事のルール順で確認してください。

  4. 新しい接続をテストする

    Homeで接続が有効になっていることを確認します。テストするアプリが使用中の接続を終了し、自分でアクセスできると分かっているホストに新しいリクエストを送信してください。Dataで該当時間帯の接続記録を開き、接続先ホスト、適用ルール、使用されたポリシーを確認します。ページが開けたことだけを、PROXYに一致した証拠にしないでください。

接続できない場合:まずDNSとサーバーを確認

ブラウザーのエラーから分かるのは、接続がどの段階で失敗したかであり、特定のルールに一致したことを単独で証明するものではありません。まず該当リクエストの記録を確認してください。記録が見つからない場合は、テストアプリが接続を再確立したか、Shadowrocketの接続が有効のままかを確認します。

ブラウザーのエラーと確認方法

エラー:ERR_NAME_NOT_RESOLVED

原因:ブラウザーが接続先ホスト名の有効な名前解決結果を取得できませんでした。

対処:まずホスト名の入力ミスがないか確認し、次にConfigで現在の設定のDNSを確認します。名前解決の問題を解決するためにFINALを変更しないでください。

エラー:ERR_CONNECTION_RESET

原因:接続がリセットされています。このエラーだけでは、送信経路と接続先のどちらで切断されたのか判断できません。

対処:まずDataで適用されたポリシーを確認します。PROXYに一致している場合は、Homeに戻って現在のサーバーでConnectivity Testを実行し、同じホストに再接続してください。

よくある質問:ルールを変更しても反映されない場合

状況別の確認方法

DOMAINを追加したのに、なぜ元のポリシーが使われますか?

まずHome → Global RoutingでConfigが選択されていることを確認します。次に現在のルールセクションで、追加した行より前に一致するDOMAIN-SUFFIX、DOMAIN-KEYWORDなどのルールがないか確認してください。該当するルールより前に例外を移動し、新しい接続で試します。

サブドメイン1つだけを直接接続するには、サフィックスルール全体を変更する必要がありますか?

既存のサフィックスルールはそのままにし、その前にDOMAIN,files.example.com,DIRECTを1行追加します。このルールが対象にするのはfiles.example.comだけです。ページを再読み込みするとき、他のホストへのリクエストにはそれぞれ一致したルールが適用されます。

IPアドレスでは接続できるのに、ドメインルールを確認できないのはなぜですか?

IPアドレスを直接入力すると接続先は元のホスト名ではなくなるため、その結果からDOMAINに一致するかは確認できません。元のホスト名でテストし、接続記録を確認してください。ブラウザーで名前解決エラーが表示される場合は、まずDNSを調べてからドメインルールを再確認します。

前の行のDIRECTではなく、FINALが適用されたことを確認するには?

DIRECTというポリシー名だけで判断せず、Dataでその接続に適用されたルールを確認してください。記録で先行するドメインまたはアドレスルールへの一致が確認できた場合は、テスト対象を変更します。前の条件すべてに一致しなかった場合にのみ、FINALに到達します。

Shadowrocket をダウンロード