Shadowrocketのルール設定方法|特定のサイトだけプロキシ経由にする

DOMAIN-SUFFIXやDOMAIN-KEYWORDで対象サイトをPROXYに振り分け、FINALをDIRECTに設定する方法を解説。ルールの順序とマッチ結果の確認方法も紹介します。

この記事の概要

この記事は、Shadowrocketに自分で用意した接続設定を追加済みで、一部のサイトだけをプロキシ経由にしたい方向けです。Home → Global RoutingでConfigを選び、現在の設定ファイルの[Rule]にルールを順番に追加して、最後をFINAL,DIRECTにします。設定後は、接続ログで対象ドメイン、適用されたルール、実際のポリシーを一つずつ確認してください。Webページが開くかどうかだけでは、意図どおりに振り分けられたか判断できません。

1. Global RoutingでConfigを選ぶ

「接続スイッチがオン」と「ルールに従って振り分けられている」は別の状態です。接続スイッチはクライアントが対象トラフィックを処理するかを決め、Global Routingは処理時のルーティング方法を決めます。「指定サイトはプロキシ経由、それ以外は直接接続」にするには、まずHome → Global RoutingでConfigを選び、Config画面で編集対象の設定ファイルが有効になっていることを確認します。

この記事では、利用者自身が契約するサービスとサブスクリプションがあり、Homeに利用可能な接続が登録済みであることを前提としています。ルールで決められるのはトラフィックの経路であり、接続情報を作成したり、停止中のリモートサービスを復旧したりすることはできません。ノードやサブスクリプションの提供・販売・推奨は行っていません。

モードルーティングの意味この記事での使い方
Config現在の設定ファイルにあるルールに従って接続を振り分ける指定サイトの振り分けを確認する
Proxy接続をグローバルプロキシとして処理するFINAL,DIRECTによる振り分けの確認には使えない
Direct接続をグローバル直結として処理するドメインのプロキシルールの確認には使えない
Scene設定済みのシーンに応じてルーティングする問題の切り分けでは、まずConfigに戻してシーン切り替えの影響を抑える

2. 最小限のルール:ドメインを先に、FINALを最後に

以下は構成を示すための最小限の[Rule]例であり、設定ファイル全体ではありません。example.comとexample.netは例示用のドメインです。実際の対象サイトのドメインに置き換えてください。既存の設定に追加する際は、接続設定など必要な項目を残し、ファイル全体を上書きしないでください。

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

DOMAIN-SUFFIX,example.com,PROXYはexample.com自体と、www.example.comやstatic.example.comなどのサブドメインにマッチします。任意の文字列を含むかどうかで判定するルールではないため、別のドメインに似た文字列が含まれていてもマッチしません。DOMAIN,api.example.net,PROXYは完全一致したホスト名だけに適用され、example.netのほかのサブドメインには適用されません。

最後のFINAL,DIRECTは、それまでのルールにマッチしなかった接続を処理します。この設定では「指定したドメインはPROXY、それ以外はDIRECT」となります。DIRECTは端末自体のネットワーク接続に依存するため、必ず接続できるという意味ではありません。

3フィールド
DOMAIN-SUFFIX:種類、マッチする値、ポリシー
2フィールド
FINAL:種類、フォールバックポリシー
フォールバックルール1件
簡略化したルール一覧の末尾にFINAL,DIRECTを残す

ポイント:まず1つのドメインで確認

最初はDOMAIN-SUFFIXの対象を1つだけ追加し、マッチを確認してから少しずつ増やしてください。一度に大量のルールを追加すると、どのルールが接続先を変えたのか特定しにくくなります。

3. DOMAIN-SUFFIXとDOMAIN-KEYWORDの使い分け

対象サイトが少数で明確な場合は、DOMAINまたはDOMAIN-SUFFIXを優先します。特定の文字列を含む複数のドメインを対象にする必要があり、マッチ範囲が広がることを理解したうえで使う場合に限り、DOMAIN-KEYWORDを検討してください。ルールが照合するのは接続先のホスト名であり、ページ全体のURLやページ内の文字列ではありません。

ルールの書式マッチ範囲用途
DOMAIN,login.example.com,PROXYlogin.example.comのみ特定のログインホストだけを変更する
DOMAIN-SUFFIX,example.com,PROXYexample.comとそのサブドメイン同じ親ドメイン配下のサイトやサービス
DOMAIN-KEYWORD,example,PROXYホスト名にexampleを含むドメインキーワードでのマッチが必要で、誤マッチの範囲も確認済みの場合

たとえばDOMAIN-KEYWORD,example,PROXYでは、example-unrelated.testにもマッチする可能性があります。対象がexample.comだけなら、この書き方では範囲が広すぎます。キーワードルールの影響を例外ルールで打ち消すのではなく、DOMAIN-SUFFIXを使ってください。

4. ルールを順番に編集して現在の設定を有効にする

ルールは通常、上から順に照合され、最初にマッチしたルールで接続のポリシーが決まります。より具体的な例外は、範囲の広いルールより前に置きます。「指定サイトだけをプロキシ経由にする」には、既存の設定にプロキシへ振り分けるルールがほかにないかも確認してください。最後の行をDIRECTに変えるだけでは、それらのルールは無効になりません。

  1. コピーを保存する

    Configを開き、まず現在の設定ファイルを複製するか、ファイルに書き出します。現在有効な設定を記録しておけば、編集に失敗しても元の設定に戻せます。

  2. ポリシーを確認する

    Homeで利用可能な接続があることを確認し、設定ファイル内のPROXYまたは独自のポリシーグループに有効な接続先が設定されているか確認します。ドメインルールを接続先やサブスクリプションの入力欄に記入しないでください。

  3. ルールを編集する

    Configでコピーした設定ファイルの編集画面を開き、[Rule]のルール部分を探します。具体的なドメインの例外を先に、範囲の広いルールを後に配置し、末尾にはFINAL,DIRECTを残します。

  4. 設定を有効にする

    保存したらConfigでコピーを選択し、現在の設定として有効にします。Home → Global Routing → Configに戻り、ProxyやDirectのままになっていないことを確認してください。

  5. 接続を再確立する

    通信中の作業に支障がないことを確認してから接続スイッチを一度オフにし、再度オンにします。その後、Webページへのリクエストを新たに送信してください。変更前から確立している長時間接続で、新しいルールの適用を判断しないようにします。

次の例では、download.example.comは直接接続、example.comのほかのサブドメインはプロキシ経由、それ以外は直接接続になります。DOMAIN-SUFFIXを先頭に置くと、download.example.comが先にプロキシルールにマッチし、後続の個別例外は適用されません。

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

既存のGEOIP、IP-CIDR、リモートルールセット、その他の広範囲なルールも確認します。たとえばIP-CIDR,192.168.0.0/16,DIRECT,no-resolveはIPv4ネットワーク範囲でマッチし、GEOIP,CN,DIRECTはIP地理情報データベースで判定します。どちらもドメインサフィックスのルールではありません。no-resolveは、このIPルールのためにドメイン名の解決を行わないという意味で、クライアント全体のDNSを無効にするものではありません。

5. Webページが開くかだけでなく、接続ログで確認する

少なくとも、期待する結果になるテストと、その逆の結果になるテストを1つずつ行います。前者では追加した対象サイトにアクセスし、ドメインのプロキシルールにマッチすることを確認します。後者では、ルールに追加されておらず、ほかのルールにも該当しないサイトにアクセスし、FINALにマッチしてDIRECTになることを確認します。ページが開くだけでは、意図どおりに振り分けられた証拠にはなりません。

テスト対象ログで確認する内容問題がある場合に最初に確認すること
リストに追加した親ドメイン対象ホスト名、DOMAIN-SUFFIXのマッチ、プロキシポリシー現在の設定が有効か、ルールの位置が正しいか
同じ親ドメインのサブドメイン同じサフィックスルールでサブドメインもマッチするか前にある個別ルールに先にマッチしていないか
リストにないサイトFINALにマッチし、DIRECTになっているかキーワードルールやリモートルールセットが広範囲にマッチしていないか
ページに付随するリクエスト画像、ログイン、APIで使われる実際のドメイン別の親ドメインを見落としていないか、リダイレクトが発生していないか

Shadowrocketの接続ログで、新しく開始したリクエストを見つけて詳細を確認します。まず接続先のドメインまたはIPを確認し、次にマッチしたルールとポリシーを確認します。ポリシーグループを経由している場合は、最終的に選択された接続も確認してください。ログにIPしか表示されなくても、すぐにDOMAIN-SUFFIXの書式ミスと判断しないでください。アプリがIPアドレスに直接接続しているか、クライアントがドメインマッチに利用できる情報を取得しているかも確認します。

  1. 今回のテストを始める時刻を記録し、対象ページをいったん閉じてから開き直すと、古いリクエストの影響を抑えられます。
  2. 対象ページに一度アクセスし、対応する新しいログを探します。バックグラウンドアプリのリクエストをテスト対象と取り違えないようにしてください。
  3. トップページは開くのにログインや画像の読み込みに失敗する場合は、時刻を手がかりに付随するドメインを確認し、必要だと確認できたドメインだけを追加します。
  4. 次に、リストにないサイトもテストして、フォールバックが実際にDIRECTになっているか確認します。

6. 特定サイトの振り分けでよくある質問

ルールを書いたのに、すべてのサイトがプロキシ経由になるのはなぜですか?

まずHome → Global RoutingがProxyのままになっていないか確認します。Configに切り替えたら、現在の設定の前方に範囲の広いプロキシルールやリモートルールセットがないか確認してください。FINAL,DIRECTが処理するのは、それまでのルールにマッチしなかった接続だけです。すでに前のルールにマッチした結果は変更しません。

同じサイトの特定のページだけをプロキシ経由にできますか?

DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORDはいずれもURLのパスで接続を振り分けません。2つのページがどちらもwww.example.com上にある場合、ドメインルールに/videoを追加してページ単位で分けることはできません。サービスが別のサブドメインを使っているか確認してください。ホスト名が異なる場合に限り、対応するドメインルールで振り分けられます。

トップページは開くのに、画像やログインが失敗する場合は?

ページを再読み込みして接続ログを確認し、失敗したリクエストの実際のホスト名を特定します。ログイン時に別の親ドメインへ移動する場合や、画像が独立したコンテンツ配信ドメインから読み込まれる場合があります。プロキシが必要だと確認できたドメインをFINALより前に追加し、接続を再確立して確認します。名前が似ているという理由だけで、範囲の広いキーワードを追加しないでください。

サブスクリプションの更新でルールが上書きされますか?

接続サブスクリプションの更新と、リモートConfigの更新を区別してください。前者は主に接続項目を更新し、後者は設定ファイル内のルールを置き換えることがあります。ローカルコピーを保存し、更新後にConfigを開いて、現在有効な項目と[Rule]を確認してください。ポリシーグループが接続名を参照している場合は、更新後も名前が一致しているか確認します。

ルールがPROXYにマッチしてもサイトが開かない場合は?

実際に選択された接続、接続テストの結果、エラーログを続けて確認します。ルールにマッチしたということはルーティング先が選択されたという意味で、リモート接続が利用可能だとは限りません。ポリシーグループを使っている場合は、グループ内に接続先がない、または利用できない項目が選ばれていないか確認します。ほかのサイトが開く場合は、対象サイトに付随するドメインとDNSの解決結果も確認してください。

Shadowrocketをダウンロード