Shadowrocket カスタムルールの書き方と優先順位|上から順に照合し、FINALでフォールバック

ルールは上から順に照合され、最初に一致した時点で判定が終了します。PROXY・DIRECT・REJECTの違いと、FINALを末尾に置く理由を解説します。

この記事の概要

この記事は、すでに自分の接続情報を登録し、Shadowrocketで通信の振り分けを調整したい方を対象としています。まずHome → Global RoutingがConfigになっていることを確認し、ルールの順序、ドメインやIPの条件、FINALの位置を把握しましょう。最後に個別のリクエストで実際のマッチ結果を確認します。例に使うドメインとアドレスは構文説明用であり、接続情報としては利用できません。

Configによるルール振り分けを確認する

ルールをファイルに記述しただけでは、現在の接続に適用されるとは限りません。Homeでは接続とサービスの選択、Configでは設定ファイル、Settingsではアプリの設定を管理します。確認の際は、現在有効な設定ファイルとGlobal Routingの動作モードをそれぞれ確認してください。ファイルに追加した行があるかどうかだけでは判断できません。

Global RoutingのProxy、Direct、Config、Sceneは、接続全体の動作モードです。一方、ルール行の大文字表記PROXY、DIRECT、REJECTは、マッチしたときに適用するポリシーです。両者は異なる階層の設定です。この記事ではConfigモードで有効になっている設定のRuleリストと、その順序を扱います。

Global Routing確認する項目この記事のルールとの関係
ConfigConfigで現在有効なファイルを確認する設定内のルールに従って通信を振り分けます。この記事での検証に使う動作モードです。
Proxy選択中のプロキシサービスが利用可能か確認するプロキシモードで接続を処理します。Configのルール全体の順序を検証する用途には使えません。
Directデバイスの現在のネットワークから対象に直接アクセスできるか確認するDirectモードで接続を処理します。ルール内のPROXYが適用されるかの検証には使えません。
Scene現在有効なSceneとその設定を確認するSceneの名前だけで結果を推測せず、Sceneで実際に適用される動作を確認してから設定ルールを調べます。

Settings → On Demandは、オンデマンド接続の条件を設定する項目です。ドメインルールの順序を入れ替える機能ではありません。テスト中は接続状態を安定させ、ネットワーク切り替えによる接続の変化をルールが適用されない原因と誤認しないようにしてください。

マッチ優先順位:最初に一致したルールを適用

Ruleリストは「ドメインがIPより優先」「長いルールが自動的に優先」といった順序ではありません。マッチ条件を判定できるリクエストは上から順に照合され、最初に一致したルールのポリシーが適用されます。後続の通常ルールで上書きされることはありません。そのため、具体的な例外ルールは通常、範囲の広い条件より前に置きます。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

リクエストのドメインがapi.example.comの場合、1行目のドメインルールに一致し、DIRECTになります。www.example.comへのアクセスでは1行目に一致せず、2行目のサフィックスルールに一致してPROXYになります。example.netへのアクセスは、それまでのルールに一致しない場合にのみFINALに進みます。

3種類のポリシー
この記事で扱うPROXY、DIRECT、REJECT
4種類のキーワード
DOMAIN-SUFFIX、GEOIP、IP-CIDR、FINALを確認
末尾に1行
シンプルな設定ではFINALを1行だけ残し、フォールバックにする

上の例で2行目を1行目より前に移動すると、api.example.comも先にサフィックスルールに一致し、後ろにある完全一致のドメインルールは機能しなくなります。これは「ルールを書いたのに効かない」よくある原因です。構文の誤りではなく、上位の条件が先にリクエストを処理しています。

ルールの書き方:ドメイン、アドレス範囲、地域条件

通常のルールは「タイプ、マッチ対象、ポリシー」の順に記述し、半角カンマで区切って1行に1件書きます。全角カンマは使わず、複数のドメインを空白で区切って1つのマッチ対象欄に入れないでください。FINALは例外で、ドメインやアドレスの条件を持たず、ポリシーを直接指定します。

ドメインとフォールバック

DOMAIN
api.example.com,DIRECT
DOMAIN-SUFFIX
example.com,PROXY
FINAL
PROXY

上記はキーワードと後続フィールドの対応関係です。ファイルに記述する際は半角カンマで区切ります。

IP条件と名前解決

IP-CIDR
192.0.2.0/24,DIRECT,no-resolve
GEOIP
CN,DIRECT
no-resolve
このIPルールのためにドメインの名前解決を要求しない

192.0.2.0/24は文書用の例示アドレス範囲であり、実際にDIRECT接続すべきサービスのネットワークを示すものではありません。

ドメインルールの照合には、判定に必要なドメイン情報を取得できる必要があります。ドメインリクエストで名前解決が行われるかどうかは、ルールのオプションやDNS設定にも左右されます。no-resolveを付けると、このIPルールが名前解決を要求するのを避けられます。ただし、すべてのドメインリクエストがそのアドレス範囲に一致するとは限りません。アクセス方法によって結果が異なる場合は、記録に残る実際の宛先がドメインかIPかを確認してください。

PROXY、DIRECT、REJECTとFINALの組み合わせ

PROXYはプロキシポリシーに接続を渡します。実際の接続先は、現在選択されているサービスや設定で参照されているポリシーによって異なります。DIRECTは宛先へ直接接続し、REJECTはリクエストを拒否します。いずれも接続を自動で修復する機能ではありません。PROXYにしてもサービス設定の誤りは直らず、DIRECTにしても現在のネットワークからすべての宛先に到達できるとは限りません。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

このコード片はRuleセクションのみを示したもので、完全な設定ではありません。既存ファイルに[Rule]がある場合は、必要なルールを既存のセクションに追加し、同じ名前のセクションを機械的に貼り付けないでください。例では、完全一致のドメインを範囲の広いサフィックス条件より前に置き、その後にアドレス条件と地域条件を並べ、最後にFINALを残しています。実際の順序は利用者自身のアクセス要件に合わせてください。例を汎用的なポリシーとしてそのまま使わないでください。

FINALによる2種類のフォールバック

FINAL,PROXY
  • 前方にDIRECTまたはREJECTにしたい対象を明示する
  • 一致しなかったリクエストは、残りすべてプロキシポリシーに渡す
  • 選択中のプロキシサービスとプロトコル設定が利用可能か確認する
FINAL,DIRECT
  • 前方にPROXYまたはREJECTにしたい対象を明示する
  • 一致しなかったリクエストは、デバイスの現在のネットワークから直接接続する
  • 新しい対象をルールに追加しない限り、自動的にプロキシポリシーにはなりません。

2つの書き方の違いは、一致しなかった通信の行き先です。どちらか一方を選び、通常のマッチルールの後ろにFINALを置いてください。

FINAL自体に条件はありません。リストの途中に置くと、その行まで進んだリクエストのポリシーが確定し、後続の通常ルールでは処理されません。FINALが複数ある場合は、まず末尾に置く明確なフォールバックを1つだけ残し、ほかのルールの確認を続けてください。

変更と検証:一度に変える条件は1つだけ

以下ではHome、Config、Settingsの画面構成を基準に説明します。編集操作の位置はプラットフォームによって異なる場合があるため、現在の画面に表示されるファイル操作を確認してください。検証前に元ファイルのコピーを保存し、テスト対象、想定ポリシー、実際の結果を記録します。一度に複数の条件を変えると、原因を特定しにくくなります。

  1. バックアップを保存する

    Configを開き、現在使用中の設定ファイルを見つけてから、ファイル操作でコピーを保存するか、バックアップをエクスポートします。リモート設定は、実験内容が後の更新で上書きされないよう、別のローカルテスト用コピーを保存しておくとよいでしょう。

  2. ルールを編集する

    Configで対象ファイルの編集機能を開き、[Rule]を探します。具体的なドメインルールを範囲の広いサフィックスルールより前に移動し、半角カンマ、ポリシーの表記、末尾のFINALを確認して保存します。

  3. 有効化を確認する

    Configで、保存したファイルが有効になっていることを確認してから、Home → Global RoutingでConfigを選択します。コピーを編集しただけで有効化していない場合、現在使用中の設定は変わりません。

  4. 接続し直す

    テスト対象アプリと宛先との既存接続を終了します。必要であればShadowrocketの接続スイッチをいったんオフにしてから再度オンにし、新しいリクエストを送信してください。既存接続では、接続開始時のポリシーが引き続き使われることがあります。接続を再利用するページを更新しただけでは判断できません。

  5. 接続記録を確認する

    アプリで確認できる接続記録やログを開き、テスト時刻を手がかりに対象のドメインまたはIPを探して、実際のポリシーと表示されるマッチ情報を確認します。リクエストがリダイレクトされる場合は、リダイレクト前後のドメインをそれぞれ確認してください。

検証では「指定した宛先への新しい接続に、想定したポリシーが適用されたか」を確認します。ウェブページが開いたかどうかだけでは判断できません。新しい接続にPROXYと表示されてもハンドシェイクに失敗する場合は、すでに利用しているサービスの接続パラメーターを確認します。新しい接続がDIRECTと表示され、上位の広いルールに一致している場合は、まずルールの順序を調整してください。2つのケースでは調査する箇所が異なります。

ルールが適用されないときの確認項目

DIRECTを追加したのに、なぜPROXYになる?

まずHome → Global RoutingがConfigになっていることを確認し、次にConfigで有効なファイルを確認します。その後、対象ドメインを検索し、上位に範囲の広いDOMAIN-SUFFIXや、先に置かれたFINALがないか調べます。具体的な例外ルールを広いルールより前に移動して保存し、新しい接続で再テストしてください。

同じサイトなのに、リクエストによって別のポリシーになるのはなぜ?

接続記録で完全なドメイン名を確認してください。トップページ、画像、ログインAPIで異なるドメインが使われている場合があります。example.comに一致するルールが、別のexample.netまで自動的に対象にすることはありません。実際のリクエストに応じて必要な条件を追加してください。ブラウザーのアドレスバーだけで全通信を判断しないでください。

IP-CIDRがドメインへのリクエストに一致しないのはなぜ?

記録に表示される宛先アドレスが対象の範囲内か、IPv6が使われていないか、ルールにno-resolveが付いているかを確認してください。ドメインの名前解決で複数のアドレスが返る場合があります。別のタイミングで得た単一のアドレスをもとに、現在の接続を判断しないでください。宛先が常にドメインとして記録される場合は、まず完全一致のDOMAINルールで検証できます。

更新後にカスタムルールが消えたのはなぜ?

まず、更新したのがHomeに登録した既存サービスのサブスクリプションか、Configのリモート設定かを切り分けます。前者はRuleファイルとは別の項目です。後者はファイルの内容が再取得されることがあります。現在のファイルの取得元と有効状態を確認し、ローカルバックアップを復元したうえで、独立した設定を継続して管理するか、リモート設定の更新方法を使うか決めてください。

Shadowrocket をダウンロード