この記事の概要

すでに動作するShadowrocketの設定がある場合は、拒否したい対象がドメイン全体か、同じドメイン内の特定のURLパスかをまず確認します。前者は[Rule]でREJECTを指定し、後者は[URL Rewrite]で見えている完全なURLに一致させます。テストでは対象のリクエストと比較用のリクエストをそれぞれ1回送信し、ルールの適用結果を確認すると、ルールの動作、設定の未適用、誤ブロックを見分けられます。以下ではiPhone / iPadの画面操作を説明します。

ルール照合のどの段階でREJECTが適用されるか

REJECTは照合後に実行する処理であり、照合条件ではありません。DOMAIN-SUFFIX,telemetry.example.com,REJECTでは、1つ目のフィールドがルールの種類、2つ目が照合対象、3つ目が一致した接続を拒否する処理を指定します。リクエストがこのルールに一致するには、まずShadowrocketの処理対象となり、照合条件に必要な情報を取得できる必要があります。

アプリのリクエスト通信の取り込み宛先の識別ルール照合処理の実行

Configで実際に有効な設定を確認し、編集前にコピーを保存します。Homeに戻り、接続が有効になっていることを確認してから、Global RoutingでConfigを選択します。スイッチがオンでも、通信が設定どおりに振り分けられているとは限りません。ProxyとDirectはルールテストの基準として適していません。Sceneを使う場合、実際の動作はシーンの設定にも左右されます。トラブルシューティングでは、ネットワークやモードを同時に変更せず、まずConfigに固定してください。

3つのフィールド
ドメインルールの例:種類、照合値、処理
80
HTTPの標準ポート
443
HTTPSの標準ポート。ポート番号だけではURLパスは取得できない

DOMAIN-SUFFIXの書き方:ドメイン範囲を拒否する

不要なリクエスト専用のホストであれば、リクエストパスを読み取らずにドメイン単位で拒否できます。DOMAIN-SUFFIX,telemetry.example.com,REJECTは、telemetry.example.comとv2.telemetry.example.comなどのサブドメインに一致しますが、api.example.comには一致しません。ホスト名を1つだけ指定する場合はDOMAINを使います。安易にexample.comまで範囲を広げると、同じドメイン内のログイン、画像、API通信も拒否される可能性があります。

[Rule]
DOMAIN-SUFFIX,telemetry.example.com,REJECT
FINAL,DIRECT

上記は単独で試すための設定例です。ドメインは検証可能な対象に置き換えてください。現在使用中の設定に追加する場合は、新しい項目だけを既存の[Rule]に加え、元のFINALは残します。テストのために普段の最終処理をDIRECTに変更しないでください。同じリクエストに複数のルールが一致する場合、先に一致したルールの処理が適用されます。たとえば、広範囲を対象とするDOMAIN-SUFFIX,example.com,PROXYが先にあると、その後に書いたサブドメインの拒否ルールは、すでに一致したリクエストには適用されません。

ドメインとサブドメインを拒否

設定セクション
[Rule]
照合条件
DOMAIN-SUFFIX,telemetry.example.com
一致時の処理
REJECT
記述位置
同じ対象に一致する広範囲のルールより前

ホスト全体を拒否してよい場合に適しています。個々のパスは区別しません。

サブドメインの例外を残す

具体的な条件
DOMAIN,health.telemetry.example.com
例外時の処理
DIRECT(直接接続が適切と確認できた場合のみ使用)
記述位置
対応するDOMAIN-SUFFIX拒否ルールより前

具体的な例外を先に処理し、その後に広範囲のドメインサフィックスを処理します。例外には、そのホストに本来必要な通信処理を設定してください。

URL Rewriteの書き方:特定のパスだけを拒否する

同じホストで、ログイン、同期、計測用APIを提供している場合があります。/accountは残して/telemetryだけを拒否したい場合、先に[Rule]でホスト全体を拒否してから、URL Rewriteで特定のパスを許可することはできません。パス単位のブロックを個別に検証する際は、テスト対象のホスト全体を拒否する設定がないことを確認してください。

[URL Rewrite]
^https:\/\/api\.example\.com\/telemetry(?:[/?]|$) - reject

HTTPSのパスやクエリパラメーターは暗号化された通信に含まれています。ドメイン単位で通信を振り分けられても、パス単位で照合できるとは限りません。パスルールを適用するには、Shadowrocketが対象のHTTPリクエストを処理し、その内容を確認できる必要があります。HTTPSでは通常、適切なMITM設定と証明書の信頼設定が必要です。検査する権限のあるテスト用ドメインだけで有効にし、対象ホストに範囲を限定してください。アプリが検査用証明書を受け入れない場合はテストを中止し、復号するドメインの範囲を広げないでください。

ルールの一致を確認し、誤ブロックを特定する

  1. まず基準となる状態を確認します。ルールを追加する前に、管理でき、通常アクセスできるテストサービスへリクエストを1回送信し、実際のドメイン、パス、期待する結果を記録します。基準状態ですでにタイムアウト、名前解決失敗、エラーが発生する場合は、先にその問題を解決してください。エラーページだけではREJECTに一致した証拠になりません。
  2. 変更は一度に1項目だけにします。保存後、同じ設定が引き続き有効か確認し、HomeのGlobal RoutingがConfigになっていることも確認します。ドメインのテストでは対象ホストと、対象のサフィックスに含まれないホストを使います。パスのテストでは同じホストの/telemetryと/telemetry-statusを使い、前者だけが拒否されることを確かめます。
  3. アプリからリクエストを再送信します。テスト対象のアプリを終了して再起動するか、テストサービスから新しいリクエストを送信し、キャッシュされたページや既存の接続を新しいリクエストと取り違えないようにします。接続ログを確認できる場合は、時刻、宛先、一致した処理を照合してください。パスのテストでは、リダイレクト後のURLではなく、アプリが想定したURLを実際に送信したことも確認します。
  4. 設定を戻して再テストします。通常のAPIまで失敗する場合は、追加した項目を削除するか保存したコピーに戻し、対象と比較用のリクエストをもう一度送信します。設定を戻すと復旧する場合は、ドメインの範囲またはパスの条件を絞ってください。戻しても復旧しない場合は、DNS、サーバーの状態、ネットワーク接続を確認します。

ブロックできない通信:よくある質問

REJECTを追加したのに、ページ上のコンテンツが残るのはなぜですか?

ページを再度開いたときに新しい接続が発生したか確認してください。コンテンツがローカルキャッシュにある場合や、ページ本体のレスポンスに含まれている場合、個別に拒否できる対象リクエストはありません。キャッシュされていないリクエストを使って実際のホストを確認してください。ページ本体を配信するドメイン全体を拒否して、ページ内の要素だけを消そうとしないでください。

ホスト名のルールが正しいのに、接続ログにIPアドレスしか表示されないのはなぜですか?

アプリがIPアドレスへ直接接続していないか確認してください。Shadowrocketが照合可能なドメインを取得できなければ、DOMAIN-SUFFIXでホスト名を推測することはできません。アドレスが固定され、割り当て先が明確で、ほかのサービスに影響しないと確認できた場合に限り、IP-CIDRでの照合を検討してください。共有IPアドレスをドメインルールの代わりに使うのは避けてください。

ルールに書いたパスと同じなのに、一致しないのはなぜですか?

実際のURLのホスト名とポートの表記、リダイレクト先を確認し、さらに使用中の設定でそのプロトコルが検査対象になっているか確認します。HTTPSからパスを取得できていない場合、正規表現を変更しても解決しません。アプリの接続方式を想定どおりに検査できない場合は、ドメイン単位で判断し、同一ホスト内のパスを区別できないことを受け入れてください。

あるネットワークではブロックできるのに、別のネットワークでは再び表示されるのはなぜですか?

まず接続状態とHomeのGlobal Routingをそれぞれ確認します。次に、Settings → On Demandでネットワークごとに異なる接続条件が設定されていないか確認してください。ルールがあっても、Shadowrocketの処理対象になっていない通信は自動的に検査されません。同じネットワーク、同じ設定で現象を再現してから、ネットワークを切り替えた場合と比較してください。

REJECTで処理できるのは、クライアントに届き、条件に一致する新しいリクエストです。すでにダウンロードされたコンテンツを削除するものではなく、端末全体のアクセスを制御する機能でもありません。確認できた結果は「この設定で対象のリクエストが拒否され、比較用のリクエストには引き続きアクセスできた」と表現し、「アプリやページ内の同種コンテンツをすべてブロックした」と断定しないでください。