Shadowrocketをインストール済みで、既存のConfigにルールを追加したい方に向けた解説です。ドメインルールと宛先IPルールを区別し、例外ルールを広範囲のルールより前に配置したうえで、接続ログからマッチしたルールと最終的なポリシーを確認します。本文中のドメイン名やIPアドレスは構文説明用の例なので、サブスクリプションを読み込まなくても内容を確認できます。
ルールの順序:上から確認し、最初にマッチしたルールを適用
HomeでGlobal RoutingをConfigに設定すると、Shadowrocketの接続には現在のConfigのルールが適用されます。設定テキストの[Rule]セクションには、通常1行につき1つのルールを記述します。形式はタイプ,マッチ条件,ポリシーです。例外はFINALで、マッチ条件を指定せずFINAL,ポリシーと記述します。
精密なDOMAINルールが自動的に先へ移動することはありません。DOMAIN-SUFFIXが先にマッチすると、その下にある特定ドメイン向けの例外ルールは適用されません。同様に、FINALを途中に置くと、そこまでにマッチしなかった接続はフォールバックポリシーで処理され、それ以降のルールはマッチする機会を失います。
PROXY:プロキシ経由で接続します。ルールにマッチしても、プロキシが利用できるとは限りません。選択中の接続先が通信可能か確認してください。サブスクリプションが必要な場合は、ご利用のサービス提供元から入手してください。DIRECT:プロキシを経由せずに宛先へ接続します。宛先にアクセスできるかどうかは、端末が接続しているネットワークによって異なります。Homeの接続スイッチをオフにする設定ではありません。REJECT:この接続を拒否します。ブラウザーには一般的な接続エラーだけが表示される場合があります。拒否ルールに実際にマッチしたかどうかは、接続ログで確認してください。
ドメインルール:完全一致・サフィックス・文字列を含む
ドメインルールが確認するのはホスト名で、URL全体ではありません。たとえばhttps://docs.example.com:443/guideの場合、ルールに指定するのはdocs.example.comです。https://、ポート番号443、パス/guideは含めません。同じホスト上の異なるページパスに別々のポリシーを適用することは、以下の3種類のドメインルールではできません。
| タイプとマッチ条件 | マッチする例 | マッチしない例 |
|---|---|---|
DOMAIN,example.com | example.com | docs.example.com:ホスト名が異なります。 |
DOMAIN-SUFFIX,example.com | example.com、docs.example.com | notexample.com:ラベルの境界がありません。 |
DOMAIN-KEYWORD,example | example.com、notexample.net | sample.net:指定した文字列が含まれていません。 |
DOMAIN-SUFFIXにはexample.comを指定します。*.example.comと書く必要はありません。特定のホスト1つだけに適用する場合はDOMAINを、親ドメインとサブドメインの両方に同じポリシーを適用する場合はDOMAIN-SUFFIXを使います。DOMAIN-KEYWORDは想定以上に広くマッチしやすいため、特に短い文字列の指定には注意が必要です。ドメインのラベル全体との一致や、ドメイン先頭での出現は条件になりません。
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,REJECT
FINAL,DIRECT
上の例では、docs.example.comは1行目のルールにマッチしてDIRECTで接続し、www.example.comはサフィックスルールにマッチしてPROXYを使います。notexample.netはキーワードルールで拒否されます。このキーワードルールは誤マッチの範囲を示すための例で、通常の設定にそのまま使うことはおすすめしません。最初の2つのルールを入れ替えると、docs.example.comは先にサフィックスルールへマッチします。特定のホスト向けの例外を先に記述するのはこのためです。
IPルール:IP-CIDR、GEOIP、フォールバック
ドメインルールにマッチしない場合は、宛先アドレスを使って接続ポリシーを判定できます。IP-CIDRは宛先のIPv4アドレスが指定したネットワーク範囲に含まれるかを確認します。GEOIPは宛先IPを地理情報データベースの分類に照らして判定します。ドメインのサフィックスや、端末の所在地を判定するものではありません。特定のドメインに例外を適用する場合は、広範囲にマッチするIPルールより前にドメインルールを置いてください。
[Rule]
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
192.0.2.0/24は先頭24ビットが固定され、192.0.2.0から192.0.2.255までにマッチします。これはドキュメント用の例示ネットワークで、接続確認の対象ではありません。IPv4アドレスを1つだけ指定する場合は/32を使います。no-resolveは、このネットワークルールのために追加のドメイン名前解決を行わない指定です。宛先がIPアドレスの接続には引き続きマッチします。宛先がドメイン名だけで判定に使えるアドレスがない場合、能動的な名前解決によって情報を補うことはありません。グローバルなDNS設定ではありません。GEOIP,CN,DIRECTは、アドレスデータベースでCNに分類された宛先をDIRECTで接続します。同じドメインでも、ネットワークや時間によって異なるIPアドレスが返される場合があります。常に安定して適用したいドメイン例外の代わりに、このルールを使わないでください。FINAL,PROXYは、それ以前のルールにマッチしなかった接続だけを処理します。すでにマッチしたルールを上書きするものではありません。2つの例は異なるフォールバックポリシーを説明するためのものです。既存のConfigを編集する場合は、元のFINALを残し、例を追加するためだけに新しいルールを増やさないでください。
最初のルールを追加して動作を確認する
初めて編集するときは、範囲が明確なルールを1つだけ追加してください。DNS、プロキシ接続先、フォールバックポリシーを同時に変更しないでください。以下ではDOMAIN,example.com,DIRECTを例に手順を説明します。現在のネットワークからサイトに直接接続できない場合は、直接接続できることを確認済みのホストをテストに使用してください。
現在のConfigをバックアップ
Configで現在使用中のファイルを確認し、先にコピーを保存します。ファイルがリモートから更新される場合は、次回の更新で変更が上書きされないよう、自分用のローカルコピーを編集してください。
完全一致ルールを追加
Configを開き、編集するConfigの詳細画面からRulesに進み、
DOMAINを追加します。マッチ条件にexample.com、ポリシーにDIRECTを指定してください。テキストエディターで編集する場合は、対応するルール行を[Rule]に追加します。ルールの位置とモードを確認
追加したルールは、マッチする可能性のあるサフィックスルール、キーワードルール、
FINALより前に配置します。保存後、編集したファイルが使用中であることを確認してください。その後、Home → Global RoutingでConfigを選択し、接続スイッチをオンにします。新しい接続で動作を確認
テスト中のページを閉じてから、リクエストをもう一度実行します。ブラウザーの既存の接続が再利用されるのを防ぐためです。Dataで今回のリクエストに対応するログを開き、ホスト名と時刻を手がかりに、ポリシーが
DIRECTになっていることを確認します。ページのリダイレクトや、別ホストからのリソース読み込みがある場合は、それぞれのログも確認してください。
動作しないときの確認:DNS・宛先ポート・ルールのマッチ
ページが開かないからといって、ルールが適用されていないとは限りません。まずDataで、失敗した接続の宛先とポリシーを確認してください。ルールにマッチした記録があるのにページを開けない場合は、ブラウザーのエラーを確認します。以下はChromiumのエラーメッセージで、Shadowrocketのルール名ではありません。
エラー:ERR_NAME_NOT_RESOLVED
原因:ブラウザーが宛先ホストの有効な名前解決結果を取得できていません。ホスト名の入力ミスや、使用中のDNSで名前解決できないことが原因として考えられます。対処:アドレスバーに表示された実際のホスト名を確認し、同じネットワークで名前解決できることが分かっているドメインを試してください。まず名前解決が正常か確認し、DNSの問題を切り分けるためにFINALを移動するのは避けてください。
エラー:ERR_CONNECTION_REFUSED
原因:接続が拒否されています。たとえば、HTTPSの宛先が想定されるTCP 443ポートで接続を受け付けていない場合があります。対処:まず実際に適用されたポリシーがREJECTか確認し、次にURLのプロトコルとポートを確認します。自分で管理するサービスをテストしている場合は、該当ポートでサービスが待ち受けていることを確認してください。
よくある質問:ルールにマッチしないときの確認項目
DIRECTを追加したのに、ログではPROXYになるのはなぜですか?
Home → Global RoutingでConfigが選択されていることを確認し、Configに戻って、編集したファイルが有効になっているか確認してください。次に[Rule]の先頭から順に確認し、サフィックスルールやキーワードルールが先にマッチしていないか調べます。該当するルールがあれば、その前に完全一致の例外ルールを移動してください。
同じWebページで複数のポリシーが使われるのはなぜですか?
ページ本文、画像、スクリプトが別々のホストから読み込まれたり、リダイレクトが発生したりすることがあります。Dataでリクエストの時刻と各接続の宛先ホストを照合してください。タブのタイトルだけで判断しないでください。別のリソースホストにも同じポリシーを適用する場合は、そのホストの完全一致ルールを追加し、安易にキーワード指定へ広げないでください。
Connectivity Testに成功したのに、サイトが開かないのはなぜですか?
Connectivity Testで確認できるのはテスト対象への接続です。現在のWebページに意図したポリシーが適用されていることや、ページ内のすべてのリソースへ接続できることを保証するものではありません。対象ページを開き直し、Dataでそのサイトのログを確認してください。実際のポリシーがDIRECTの場合は、まずローカルネットワークからサイトへの接続を確認します。PROXYの場合は、選択中の接続先を確認してください。
Global RoutingのSceneはConfigの代わりに使えますか?
単一ルールの動作確認では、まずConfigに固定してください。ProxyとDirectはグローバルなルーティングモードで、個々のルールを確認するためのものではありません。Sceneではシーン設定に応じてルーティング方式が選択されるため、シーンが変わると結果も変わることがあります。まずConfigで同じ宛先へのマッチ状況を確認し、その後、通常使うSceneに戻して再確認してください。
Shadowrocketのダウンロードと使い方ガイド
iPhone / iPad版はApp Storeで$2.99の買い切りです。対応システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン / Intel)、Windows、Android、Linux版は無料です。インストーラーは当サイトのダウンロードページから入手できます。