Shadowrocketの使い方|特定サイトだけをプロキシ経由にするDOMAIN-SUFFIXルール

DOMAIN-SUFFIXとDOMAIN-KEYWORDをFINAL,DIRECTと組み合わせ、指定したサイトだけをPROXY経由にする方法を解説。ルールの評価順、Configでの編集手順、動作確認の方法も紹介します。

この記事の要点

Homeで利用可能な自分のサーバーを追加済みで、一部のドメインだけをそのサーバー経由にしたい場合は、Configで対象ドメインにPROXYルールを設定し、それ以外のリクエストをFINAL,DIRECTで処理します。例示用ドメインを使い、DIRECTの例外設定、既存ルールの影響を避ける方法、2種類のリクエストでの確認手順を説明します。

まず一致範囲を確認:ホスト名、ドメインのサフィックス、キーワード

ルールが判定するのはリクエスト先であり、ブラウザーのアドレスバーに表示されるURL全体ではありません。たとえば https://docs.example.com/guide?lang=zh の場合、ドメインルールには docs.example.com を指定します。https://、パス、クエリパラメーター、ポート番号は含めません。同じページでも、画像やログイン用API、ファイルのダウンロードで別のホストにリクエストすることがあり、その場合はリクエストごとに判定されます。

ホスト名1つ
DOMAINで完全一致(例:local.example.com)
ドメインサフィックス1つ
DOMAIN-SUFFIXは該当ドメインとサブドメインに一致
フォールバック1つ
FINAL,DIRECTは先行ルールに一致しなかったリクエストを処理

DOMAIN-SUFFIX,example.com,PROXYはexample.comとdocs.example.comに適用されますが、末尾の文字列が同じというだけでnotexample.comには一致しません。docs.example.comだけをプロキシ経由にし、下位のサブドメインは含めたくない場合は、DOMAIN,docs.example.com,PROXYを使います。DOMAIN-KEYWORDはホスト名に含まれる文字列に一致するため、複数の異なるドメインに適用される可能性があります。対象が既知の少数サイトなら、ドメインサフィックスを1つずつ指定する方法がおすすめです。

ルールの書き方:DIRECTの例外はプロキシ対象のサフィックスより前に置く

以下の設定例では、example.com全体をプロキシ経由にしつつ、ホスト名local.example.comはDIRECTにします。キーワードの行は、同じ文字列を含むホスト名のグループに一致させる例です。そのような要件がなければ、この行は削除してください。例示用ドメインとルールの一致結果は書き方の説明を目的としており、実際にウェブサイトが提供されていることを示すものではありません。

[Rule]
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,docs-preview,PROXY
FINAL,DIRECT
対象ホスト順序を確認ポリシーを判定接続先

ルールは上から順に評価され、一致するとその行のポリシーが適用され、より具体的なルールは検索されません。そのため、local.example.comは1行目でDIRECTになります。これをDOMAIN-SUFFIXの下に移すと、先にサフィックスルールに一致してPROXY経由になります。1行目で除外できるのはこのホスト名だけです。下位のサブドメインも除外する場合は、その行のDOMAINをDOMAIN-SUFFIXに変更してください。

FINAL,DIRECTは、それより前に一致したプロキシルールを上書きしません。既存の設定にルールセット、IP-CIDR、GEOIPが含まれ、その中に別の宛先をPROXYに振り分けるルールがあれば、最後の行がDIRECTでも、その宛先はプロキシ経由になることがあります。指定したサイトだけをプロキシ経由にするには、最後の行だけでなく、[Rule]内でPROXYに振り分ける可能性のあるルールをすべて確認してください。

Configでルールを編集して有効にする

  1. 元の設定を残す。 Configで現在使用中の設定を確認し、まずコピーを保存してからローカル設定を編集します。元ファイルがリモートURLから更新される場合は、更新時に変更が上書きされないよう、カスタムルールはローカルコピーに追加してください。振り分けだけを調整する場合、DNSやサーバー設定を同時に変更する必要はありません。変更が複数あると、問題の原因を特定しにくくなります。
  2. 既存のルールセクションに追加する。 [Rule]を見つけ、例のルール行をそのセクションに追加します。セクション名を重複して追加しないでください。対象ドメインとDIRECTの例外を自分の環境に合わせて変更し、フォールバックが1つだけで、FINAL,DIRECTがルールセクションの最後にあることを確認します。残す必要のある既存ルールについては、テスト対象のドメインに先に一致しないか、1つずつ確認してください。
  3. 編集したファイルが使用中であることを確認する。 保存後、Configでその設定を選択し、Home → Global Routing → Configに進みます。編集したファイルと実際に使用するファイルが同じであることを確認してください。Global RoutingのProxyやDirectは、ここで使うルールモードではありません。Sceneが選択されている場合は、検証中にシーン条件が影響しないよう、先にConfigへ切り替えてください。
  4. 新しいリクエストで確認する。 Homeで利用可能なサーバーが選択され、接続が有効になっていることを確認します。変更前からウェブページやアプリで通信中の場合は、既存のセッションを終了してからテストページを開き直してください。検証では一度に変更するルールを1つにし、対象ホストと実際の接続先を記録しておくと、元に戻すときに役立ちます。

対象ドメインと比較用ドメインで振り分けを確認

PROXY経由にする対象を1つ、DIRECTに指定する例外を1つ用意し、さらにルールに含まれていない通常のホストを1つ選びます。実際のアクセスログに記録された対象ホスト、一致したルール、出力ポリシーを基準にしてください。ページが開けても、どの経路を通ったかの証明にはなりません。ブラウザーがキャッシュを再利用した場合、新しいリクエスト自体が発生していないこともあります。

例のルールに基づくリクエスト先の判定
リクエスト先ホスト一致するルール(予想)適用ポリシー(予想)
docs.example.comDOMAIN-SUFFIXPROXY
local.example.comDOMAINDIRECT
docs-preview.example.netDOMAIN-KEYWORDPROXY
example.orgFINALDIRECT

出口IPを調べるサイトを単独で開いても、そのサイト自体の通信経路がわかるだけです。この設定で、調査サイトがプロキシルールに一致しない場合、DIRECTの出口が表示されるのは想定どおりです。それだけで対象サイトもDIRECTだとは判断できません。対象リクエストがPROXYに一致しているのに開けない場合は、サーバーへの接続失敗か、対象サイトへのリクエスト失敗かを切り分けてください。エラーをなくすためにフォールバックをPROXYへ変更しないでください。

エラー:ERR_CONNECTION_TIMED_OUT

原因:ブラウザーが接続を待っている間にタイムアウトしました。このエラーだけでは、ポリシーの選択ミスか、選択した経路に到達できないのかを判別できません。対処:まず該当リクエストの接続先ログを確認します。すでにPROXY経由なら、Homeに戻って選択中のサーバーでConnectivity Testを実行し、サーバーに接続できることを確認してから対象ホストを再試行してください。

エラー:ERR_NAME_NOT_RESOLVED

原因:ブラウザーがアクセス先のホスト名を解決できませんでした。アドレスの入力ミスや、現在の名前解決経路で結果を取得できない場合によく発生します。対処:アドレスバーとログに記録された実際のホスト名を照合し、アクセス可能な実在のドメインであることを確認してから、そのホストの名前解決状況を調べてください。ドメインルールを追加しても、存在しないドメインの名前解決情報は作成されません。

特定サイトの振り分けに関するよくある質問

トップページは開くのに、ログインや画像の読み込みに失敗するのはなぜ?

失敗した操作をもう一度実行し、該当リクエストのホスト名と一致したポリシーを確認します。ログイン用APIや画像が別のドメインから配信されており、そのホストもプロキシ経由にする必要があると確認できた場合は、DOMAINルールを個別に追加し、FINALより前に置いてください。ログイン用APIを1つ追加するためだけに、共有のリソースドメイン全体をプロキシ対象にしないでください。

同じドメイン内の特定のディレクトリだけをプロキシ経由にできますか?

ここで説明するドメインルールでは、ディレクトリごとに振り分けることはできません。example.com/docsとexample.com/accountのホスト名はどちらもexample.comです。/docsをDOMAIN-SUFFIXの一致値に加えても、パスには一致しません。サービスにドキュメント専用のサブドメインがある場合は、DOMAINでそのホスト名に完全一致させてください。

FINAL,DIRECTを設定したのに、ほかのサイトもプロキシ経由になるのはなぜ?

まず、Home → Global RoutingでConfigが選択されているか確認し、次にConfigで実際に有効になっている設定を確認します。本来DIRECTになるはずのリクエストを使い、最初に一致したルールを特定してください。先行するルールセットや範囲の広すぎるDOMAIN-KEYWORDに一致している場合は、そのルールの対象を絞るか、ローカルコピーから削除し、同じホストで再テストします。

Shadowrocket をダウンロード