ShadowrocketのルールはConfigに記載された順に判定され、最初に一致したルールのポリシーが適用されます。FINALは、ほかのルールに一致しなかった接続を処理します。自分で用意したサービスとサブスクリプションがあり、Configを編集したい方向けに、iPhone / iPadの画面を例としてルールの書式や順序、保存・有効化・確認方法を説明します。Mac、Windows、Android、Linuxでもルールの基本的な考え方は共通です。編集画面は各プラットフォームでご確認ください。
1. Global RoutingがConfigになっているか確認する
カスタムルールは、保存しただけでは接続処理に反映されない場合があります。まずHomeでGlobal Routingを確認し、Configのルールに従って通信を振り分ける場合はConfigを選択してください。Proxyは全通信をプロキシ経由にするモード、Directは全通信を直接接続するモードです。どちらの結果も、個別のConfigルールが一致したかどうかの判断には使えません。Sceneは接続モードを切り替える機能で、個別ルールのポリシーとは異なります。
Homeで選択するサーバーと、Configで有効にする設定は役割が異なります。前者はプロキシ接続に必要な接続情報を提供し、後者は通信の振り分け方を定義します。ルールにPROXYと書いても、利用可能なサーバーが作成されたり、アドレス・ポート・パスワードが補われたりするわけではありません。サブスクリプションURLは利用中のサービス提供元から取得してください。
2. 上から順に判定し、最初の一致で処理する
ルール一覧は、すべての一致結果をまとめてから選ぶ仕組みではありません。また、「より具体的な」ルールが自動で上に並ぶこともありません。ルール判定の対象となる接続は、一覧の上から順に確認されます。ルールに一致した時点で指定のポリシーが適用され、後続ルールで上書きされることはありません。例外ルールは広範囲なルールより前に、FINALは最後に配置してください。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
この順序では、api.example.comはDOMAINに先に一致し、DIRECTが適用されます。www.example.comは1つ目のルールには一致せず、2つ目に一致するためPROXYが適用されます。DOMAIN-SUFFIXを先頭に移動すると、api.example.comも先に後方一致のルールに該当し、下にある完全一致の例外は適用されません。
DOMAIN:指定した完全一致のドメインに適用されます。特定のホストだけを例外にする場合に便利です。DOMAIN-SUFFIX:指定したドメインとそのサブドメインに適用されます。example.comとstatic.example.comは対象ですが、notexample.comは対象外です。FINAL:一致対象のフィールドを指定せず、それまでのルールに一致しなかったすべての接続を処理します。
3. ルールのフィールドとPROXY / DIRECT / REJECT
テキスト形式の設定では、ルールを[Rule]セクションに記述します。基本の形式は「ルールタイプ,一致対象,処理ポリシー」で、区切りには半角カンマを使います。FINALは例外で、FINAL,PROXYのように記述します。一致対象を空欄にした3フィールド形式にはしないでください。GUIの編集画面では各フィールドが分かれて表示されるため、1行全体をドメイン欄に入力する必要はありません。
ドメインルールと最後のルール
- DOMAIN
- api.example.com,DIRECT
- DOMAIN-SUFFIX
- example.com,PROXY
- FINAL
- PROXY
完全一致の例外を先に、広範囲の後方一致を後に置き、最後にFINALを配置します。
3種類の処理ポリシー
- PROXY
- プロキシ経由で接続
- DIRECT
- プロキシサーバーを経由せず、接続先へ直接接続
- REJECT
- 一致した接続を拒否
ポリシーは接続の処理方法を示すもので、プロトコル名ではありません。サーバーの接続情報を代替するものでもありません。
PROXYで実際にどこへ接続されるかは、現在のサーバーとConfig内のポリシー設定をあわせて確認してください。カスタムポリシーグループを使う場合は、グループ名をConfig内の定義と一致させる必要があります。DIRECTはシステムのVPNをオフにするという意味ではなく、その接続を直接処理するという意味です。REJECTは明確に遮断したい接続に使いますが、最初から広範囲のドメインサフィックスに適用するのは避けましょう。ログイン、画像、認証のリクエストまで失敗する可能性があります。
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
このルールセットでは、blocked.example.comは先に拒否されます。後に同じサフィックスをPROXY経由にするルールがあっても、結果は変わりません。例示ドメインは書式の説明用であり、利用可能な接続先やテストサービスを示すものではありません。
4. IP-CIDR、GEOIP、DNS判定の範囲
ドメインルールは名前を、IP-CIDRは接続先アドレスが指定したネットワーク範囲に属するかを判定します。GEOIPはIPの地理情報データベースによる分類に基づきます。3つは互いに置き換えられるものではありません。ドメイン名でアクセスする場合、後続のIPルールではDNS解決が関係することがあります。クライアントがドメイン情報を取得できない場合、接続先IPだけから元のホスト名をすべて特定することはできません。
| ルール例 | 判定基準 | 注意点 |
|---|---|---|
DOMAIN-SUFFIX,example.com,PROXY | 接続先ドメインのサフィックス | https://やURLのパスは入力しません。 |
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve | IPv4ネットワーク範囲 | 192.168.0.0から192.168.255.255までが対象です。 |
GEOIP,CN,DIRECT | 接続先IPのデータベース上の分類 | 接続先IPのデータベース記録を使い、ドメイン名の文字列やアカウントの地域では判定しません。 |
FINAL,PROXY | それ以前のルールに一致しない場合 | ルールセクションの末尾に配置します。 |
no-resolveは、このIPルールに一致させる目的でドメインのDNS解決を能動的に行わないことを示します。アプリ全体でDNSを無効にする意味ではなく、このルールへの一致を保証するものでもありません。接続先が192.168.1.20なら、上記のネットワーク範囲を判定できます。一方、利用可能なIPアドレスがまだないドメイン接続では、no-resolve付きのルールを必ず適用されるドメインルールとして扱うことはできません。
- 特定のドメインの動作を固定したい場合は、明確なDOMAINまたはDOMAIN-SUFFIXの例外を優先して設定します。
- LANに接続する場合は、実際のアドレス範囲に合わせてIP-CIDRを設定してください。すべてのアドレスをDIRECTにしないでください。
- GEOIPの分類は、データベースや接続先の解決結果によって変わることがあります。一度一致したからといって、そのWebサイトの分類が今後も変わらないとは限りません。
- IPv6の接続先にはIP-CIDR6など、対応するIPv6ルールを使用します。IPv4のネットワーク範囲はIPv6アドレスには適用されません。
5. Configにルールを保存して有効化し、動作を確認する
編集する前に、現在のConfigのコピーを保存してください。特にリモートURLから取得した設定は注意が必要です。サーバーサブスクリプションの更新とリモートConfigの更新は別の操作です。前者は主にサーバー情報を更新し、後者はルール内容を置き換える可能性があります。「更新成功」と表示されても、手動の変更が残っているとは限りません。現在有効なConfigを開いて確認してください。
- Configを確認する。Configを開き、現在使用中の設定を見つけてコピーを保存します。元ファイルのほかのセクションをそのまま消去しないでください。
- 編集画面を開く。対象のConfigの編集画面を開き、ルール一覧に項目を追加するか、テキスト編集で
[Rule]セクションを探します。必要なルールだけを貼り付け、同じ名前のセクションを重複して追加しないようにしてください。 - 順序を確認する。完全一致のドメイン例外や、明確なLANルールは、該当する広範囲のルールより前に配置します。対象の通信が、さらに上にあるルールにすでに該当していないか確認してください。
- 保存して有効化する。編集内容を保存し、Configで対象の設定が現在の設定として選択されていることを確認します。Homeに戻り、Global RoutingをConfigに設定して、接続が有効になっていることを確認してください。
- 新しい接続でテストする。対象のページを閉じてから再度開き、必要に応じて接続をやり直します。既存の長時間接続では、新しいルールの判定結果を確認できません。
- ログを確認する。アプリ内の接続ログで、接続先ドメイン、IP、適用されたルールとポリシーを確認します。テストに問題があれば、まず保存したコピーに戻し、変更範囲を絞ってください。
6. FINALはPROXYとDIRECTのどちらにするか
FINALの設定に、Configの目的を問わない唯一の正解はありません。FINAL,PROXYは、ほかのルールに分類されなかった接続をプロキシ経由にします。FINAL,DIRECTは、それ以外の接続を直接接続し、明示的に一致した接続だけを別のポリシーで処理します。どちらも前段のルールから漏れた通信に大きく影響するため、「ルールに記載していない接続をどう扱うか」を明確にしてから選んでください。
- 末尾をPROXYにする:直接接続する対象は前に記述します。プロキシ接続が利用できない場合、未分類の接続も失敗することがあります。それだけでFINALの書式が間違っているとは限りません。
- 末尾をDIRECTにする:プロキシ経由にする対象は前のルールで指定する必要があります。Webページのメインドメインとリソースのサブドメインが異なる場合は、実際のリクエストをそれぞれ確認してください。
- FINALを早い位置に置かない:それ以前のルールに一致しなかったすべての接続がFINALに処理されるため、その後に記述した通常のルールは判定に使われません。
最初のトラブルシューティングでFINAL,REJECTを汎用テンプレートとして使うのはおすすめしません。ルールから漏れた接続がすべて拒否されます。動作が確認できているフォールバックを残し、明確な接続先1つだけにREJECTを設定して、接続ログで影響範囲を確認する方が安全です。
7. カスタムルールに関するよくある質問
ルールを設定したのに、すべてプロキシ経由になるのはなぜですか?
まずHomeでGlobal RoutingがProxyになっていないか確認します。ルールで通信を振り分ける場合はConfigに切り替えてください。次に、Configで有効になっているファイルが編集したものか確認し、対象の接続を新しく開始して、上位の広範囲なルールに一致していないか調べます。
DOMAIN-SUFFIXにURLの先頭部分やポートを含める必要はありますか?
必要ありません。対象フィールドにはexample.comと入力し、URLの先頭部分、パス、:443は入力しません。DOMAIN-SUFFIXはドメインのサフィックスを判定するため、同じドメインの80番と443番を区別できず、Webページのパスによる振り分けにも対応していません。
DIRECTに変更してページが表示されれば、ルールが正しいといえますか?
今回のアクセスで接続できたことしか確認できません。接続ログで適用されたルールとポリシーを確認し、ページ内のリソースも再テストしてください。キャッシュ、既存の接続、異なるサブドメインが結果に影響するため、ページが表示されたかどうかだけで判断しないでください。
更新後にカスタムルールが消えた場合はどうすればよいですか?
まずConfigで現在のファイルと保存したコピーを確認し、リモートConfigを更新したか、別のファイルに切り替わっていないかを調べます。コピーを復元して再度有効にした後、カスタムルールをローカルのコピーで管理するか検討してください。手動編集を復元するために、リモートファイルを何度も更新しないでください。
PROXYルールに一致しているのに接続がタイムアウトします。ルールを変更する必要がありますか?
まず、動作確認済みのルールは変更せずに残します。Homeに戻り、選択中のサーバーとConnectivity Testを確認し、サービス提供元から案内されたアドレス、ポート、プロトコルの設定も照合してください。ルールは接続先を決めるものであり、サーバーに到達できない、認証に失敗する、転送パラメーターが一致しないといった問題は解決しません。