変更前にConfigで現在の設定を確認し、HomeでGlobal Routingをチェックします。この記事ではiPhone / iPadの画面を例に、接続を確立でき、通信の振り分け調整やルールが適用されない原因の確認が必要な方向けに解説します。設定をセクションごとに変更し、元の設定を残したまま、通信経路・名前解決・URLリダイレクトを個別に検証できます。
.confファイルとルーティングモードを確認
.confはセクションごとに記述する設定ファイルです。角括弧で囲まれた名前によって、後続の項目を読み込むセクションが決まります。[General]と[Host]は等号で値を指定し、[Rule]はカンマで項目を区切ります。[URL Rewrite]のリダイレクト例では、項目をスペースで区切ります。行を移動するだけでなく、移動先のセクションの書式も確認してください。
Configで、編集画面を開いているだけではなく、テストに使うファイルが選択されていることを確認します。コピーを保存したらHomeに戻り、通信の振り分けをテストする前にGlobal RoutingをConfigに設定します。ProxyとDirectは異なるグローバルルーティングの選択肢で、個別の[Rule]が適用されるかを確認する用途には適しません。SettingsのOn Demandは接続を自動で確立するタイミングを設定する機能で、この手順の代わりにはなりません。
まず適用結果を確認し、その後で通信経路を判断
同じページが開けても、通信が想定した経路を通ったとは限りません。対象が分かっている宛先に新しい接続を行い、アプリの接続ログでポリシーを確認します。ポリシーが正しいのにリクエストが失敗する場合は、名前解決の結果や該当する通信経路が利用可能かを確認してください。
General:全般的なDNS設定
[General]には、設定ファイル全体で共通して使う項目を記述します。たとえばdns-serverをsystemにすると、特定のDNSサーバーをこの行で指定するのではなく、システムのDNSを使います。Wi-Fiとモバイル通信を切り替えると、システムが使う名前解決環境が変わることがあります。変更前後を比較するときは、接続するネットワークを同じにしてください。
[General]
dns-server = system
- 既存の
[General]内で該当するキーを変更してください。1行のパラメーターを試すために同じ名前のセクションを追加したり、互いに競合するdns-serverを複数残したりしないでください。 - もともとアクセスできる同じドメインを使って、変更前後を比較します。テストのリクエストで新しい接続が実際に確立されたことも確認してください。以前の接続を再利用したりキャッシュを参照したりしている場合、ページを再読み込みしても名前解決がやり直されるとは限りません。
- 名前解決と通信経路は分けて判断します。宛先アドレスを取得できても、現在のポリシーでそのアドレスにアクセスできるとは限りません。反対に、既存の接続で通信を続けられても、新しいDNS問い合わせが成功するとは限りません。
Rule:個別ルールからFINALのフォールバックまで
[Rule]は記述された順に照合され、最初に一致したルールでポリシーが決まります。特定のドメインに対する例外は、それを包含するサフィックスルールより上に記述し、FINALは末尾に置きます。以下のドメインとアドレスは照合順序を説明するための例で、実際のサービスを示すものではありません。自分の設定でPROXYを使う前に、Homeで利用可能なプロキシサーバーがあることを確認してください。
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,DIRECT
アプリがリクエストのドメインを取得したとします。docs.example.comは最初の行に一致し、同じサフィックスを持つimg.example.comは2行目に一致します。先頭の2行を入れ替えると、docs.example.comは先にサフィックスルールに一致します。3行目は指定されたIPv4アドレス範囲に一致します。IPアドレスを直接指定してリクエストした場合、ドメインルールには一致しません。前の行のどれにも一致しないリクエストはFINALに適用されます。
ドメインで照合
DOMAINdocs.example.comのように、完全一致するドメインを照合します。DOMAIN-SUFFIXexample.comとそのサブドメインに一致し、notexample.comには一致しません。- よくある記述ミス
- ドメイン欄に
https://、ポート番号、パスは記述しません。
同じサフィックス内に例外がある場合は、完全なドメインをサフィックスルールより上に記述します。
IPアドレスの照合とフォールバック
IP-CIDR192.0.2.0/24のように、IPv4アドレスの範囲で照合します。GEOIP- 宛先IPアドレスの地理的な分類で照合します。例:
GEOIP,CN,DIRECT。 FINAL- 前のルールに一致しない場合のポリシーを指定します。例:
FINAL,DIRECT。
IP系のルールは宛先アドレスに基づいて判定され、ドメインのサフィックスやデバイスの所在地では判定されません。
ドメインルールを1つテストするためだけに、既存のFINALを置き換えないでください。未一致の通信すべての経路が変わり、結果の原因を特定しにくくなります。元のフォールバックは残し、明確な例外ルールを1つ追加して、一致するはずのドメインと一致しないはずのドメインで比較してください。
Host:ドメインを指定したIPアドレスに割り当てる
[Host]では、左側に名前解決するドメイン、右側に割り当てるアドレスを記述します。Shadowrocketがそのドメインを名前解決する際に、指定したアドレスへリクエストを向けるための設定です。[Rule]の代わりにはならず、DIRECTかPROXYかを選択する機能もありません。また、アドレスバーに入力したドメインを別のドメインに変更するものでもありません。
[Host]
staging.example.com = 192.0.2.10
192.0.2.10は文書用の例示アドレスであり、サービスへの接続確認には使えません。実際に検証する際は、自分が管理するテスト用ドメインと、現在のネットワークから到達できるサービスのアドレスに置き換えてください。ドメイン名でリクエストを行います。IPアドレスを直接入力すると、このドメインの割り当てを通らず、サーバーが別のサイトとしてリクエストを処理する場合もあります。
- リクエストがShadowrocketによって処理される名前解決経路を通っていることを確認してください。アプリのキャッシュ、既存の接続、またはリモート側で実行される名前解決によって、ローカルの割り当てがすぐに反映されない場合があります。
- 対象サービスが使用するポートで待ち受けていることを確認します。
http://のデフォルトは80、https://のデフォルトは443です。割り当ての行ではポート番号を変更しません。 - HTTPSを使う場合、サーバーは元のドメインに一致する証明書を引き続き提示する必要があります。指定したIPアドレスに接続した後で証明書エラーが発生した場合は、まずサーバー証明書とサイト設定を確認してください。証明書エラーを、割り当てルールが適用されなかった証拠と判断しないでください。
URL Rewrite:URLを照合してリダイレクトを返す
[URL Rewrite]の302形式は、認識可能なHTTPリクエストURLを対象とします。ルールに一致するとリダイレクトレスポンスが返され、リダイレクトに従うかどうかはリクエストを送信したクライアントが判断します。DNSの割り当てではなく、宛先IPアドレスをルール右側の値に書き換えるものでもありません。以下では平文HTTPを使い、完全一致する古いURLを1つだけ対象にします。
[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302
- 1つ目の項目は正規表現です。
\.はドットそのものに一致し、先頭の^と末尾の$でURL全体を指定します。これにより、別のホストや似たパスまでルールに含まれるのを防げます。 - 2つ目の項目はリダイレクト先です。この例では
/old/やクエリパラメーター付きの/old?ref=testは一致しません。/newも元のルールには一致しないため、この行による再リダイレクトは発生しません。 - 3つ目の項目はアクションの
302です。検証時は、元のリクエストに302が返るか、Locationが想定した宛先を示しているか、新しいリクエストが成功するかをそれぞれ確認してください。新しいURLでエラーが返っても、元のリダイレクトが発生していないとは限りません。
自分で管理するテストサイトを使って検証してください。クライアントがリクエスト送信前にHTTPをHTTPSへアップグレードする場合、http://で始まるこの正規表現には一致しません。HTTPSではパスとクエリパラメーターがTLSで保護されるため、ホスト名だけではパス単位の書き換えはできません。正規表現の変更や[Host]の追加で解決しようとしないでください。
設定が反映されないときは、ファイル・ポリシー・リクエストを順に確認
Configで変更したのに、リクエストが以前のポリシーに従うのはなぜ?
変更が保存され、現在そのファイルが使われていることを確認します。次に、HomeのGlobal RoutingがConfigになっているか確認してください。テストするアプリで接続を確立し直してから、そのリクエストの通信経路を確認します。変更前のログを判断材料にしないでください。
ルールでDIRECTを指定したのに、PROXY経由になるのはなぜ?
上の方に、先に記述されたサフィックスルールや対象を包含する別のルールがないか確認します。完全なドメインを対象とするDOMAINの例外を、包含するルールより前に移動し、例外のドメインと同じサフィックスを持つ別のドメインをそれぞれ検証してください。
Hostでテストサーバーを指定したのに、元のサイトが表示されるのはなぜ?
まず、テスト用ドメインでリクエストを送っていることを確認し、テストサーバーが新しいリクエストを受信したか調べます。受信していない場合は、既存の接続、キャッシュ、リモートでの名前解決を除外してください。受信しているのに元のサイトの内容が返る場合は、そのドメインに対応する正しいサイトがテストサーバーに設定されているか確認します。
302を追加したのに、ブラウザーがリダイレクトしないのはなぜ?
実際に送信されたURLと正規表現を照合し、特にスキーム、末尾のスラッシュ、クエリパラメーターを確認します。302を受信している場合は、元のマッチ条件を繰り返し変更するのではなく、Locationと新しいリクエストを確認してください。このルールを一時的に削除して再テストすると、設定によるリダイレクトとサーバー側で元から行われているリダイレクトを区別できます。