通信の振り分けを変えるなら [Rule]、ホスト名に対応するIPアドレスを変えるなら [Host]、URLパスを書き換えるなら [URL Rewrite]、設定全体の解析など共通動作を調整するなら [General] を編集します。この記事では、iPhone / iPad の Home と Config を使って確認手順を説明します。Mac、Windows、Android、Linuxで設定ファイルを読む場合は、セクション名とルールの構文を参考にしてください。画面のタップ手順は異なります。
01. 現在のConfigとGlobal Routingを確認
.confはセクションに分かれたプレーンテキスト形式の設定ファイルです。角括弧で囲まれた見出しは、以降の行が属するセクションを示します。同じホスト名でも、[Rule]では照合条件、[Host]ではIPアドレスとの対応付けになります。以下は各セクションを確認するための個別例です。現在の設定全体を置き換えるためのものではありません。
- Configを開き、現在選択中のファイル名を控えて、元のファイルは残しておきます。複製を保存してから編集してください。既存のファイルに該当するセクション名がある場合は、そのセクションに行を追加します。例を貼り付けるために見出しを重複して書く必要はありません。
- Configで編集した複製が選択されていることを確認し、Homeに戻ってGlobal Routingを
Configに設定します。[Rule]をテストするときは、ProxyやDirectのままにしないでください。現在のリクエストを使って、ルールごとの振り分け結果を確認できなくなります。 - 接続を有効にしたまま、同じテスト先で変更前後の結果を比較します。一度に変更する条件は1つに絞ってください。DNS、ルール、書き換えを同時に変更すると、ページが正常に表示されても、どの変更が効果をもたらしたのか判断できません。
02. [General]:全般設定とDNSの基本
[General]では、多くの場合キー = 値の形式を使います。設定全体に共通する動作を指定するもので、特定サイトの通信先を選ぶセクションではありません。名前解決の問題を調べるときは、まず現在のdns-serverの値を記録し、変更が必要か判断してください。1つのホスト名を直すために、セクション全体を置き換えるのは避けましょう。
[General]
dns-server = system
systemはシステムDNSを使う指定で、この行で特定のDNSリゾルバーを固定するものではありません。Wi-Fiとモバイル通信を切り替えると、システムが使うDNS環境も変わることがあります。結果を比較するときは、ネットワークを固定して同じホスト名を確認してください。名前解決でIPアドレスが得られても、接続先のポートに到達できるとは限らず、サーバーが接続を受け付けるとも限りません。
dns-serverを変更した後、複数のホスト名で同時に名前解決の問題が起きた場合は、元の値に戻し、同じネットワークで再確認してください。- 自分で管理しているホスト名のうち1つだけが古いIPアドレスに解決される場合は、まず
[Host]にそのホスト名の対応付けが残っていないか確認してください。1つのホスト名だけを見て、DNS全体の障害と判断しないようにしましょう。 - ホスト名の名前解決はできても通信先が違う場合は、
[Rule]とGlobal Routingを確認してください。ルールの順序の問題は、DNSリゾルバーを変更しても解決しません。
03. [Rule]:最初に一致したルール、IP条件、FINAL
一般的なルールでは、照合タイプ、条件、ポリシーを半角カンマで区切ります。Shadowrocketは上から順に確認し、最初に一致したルールを適用します。より具体的なルールが後にあっても、照合は続行されません。FINALには個別の照合条件がなく、それまでのルールに一致しなかったリクエストを処理します。ルールセクションの末尾に置いてください。
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
行ごとに想定される通信先を確認
ホスト名の照合
DOMAINapi.example.comは先頭行に完全一致し、PROXYが適用されます。DOMAIN-SUFFIXwww.example.comはサフィックスルールに一致し、DIRECTが適用されます。- 順序を変えた場合
- サフィックスルールを先頭に移すと、
api.example.comも先にその行に一致し、DIRECTで接続されます。
同じサフィックスに例外のホスト名がある場合は、完全一致ルールを幅広いルールより前に置きます。
IPアドレスの照合とフォールバック
IP-CIDR- 取得できた接続先IPアドレスをサブネットと照合します。接続先IPアドレスが
192.0.2.10のリクエストは、例のサブネットに一致します。 no-resolve- このルールに一致させるために、ホスト名を自動で名前解決することはありません。DNSを全体的に無効にする設定ではありません。
FINAL- 前のルールに一致しなかった場合に限り
PROXYを適用します。実際にプロキシ経由の通信を検証するには、利用可能なサービスが必要です。
例のサブネットは説明用に予約されたアドレスです。照合の考え方を確認するためのもので、インターネットへの接続テストには使えません。
特定のホスト名だけ通信先が違う場合は、最初に一致するルールを確認
ルールセクションの先頭から、そのホスト名に一致する完全一致ルールまたはサフィックスルールを探します。幅広いルールが例外より前にある場合は、例外だけを上に移動し、同じホスト名で確認してください。FINALを変更すると、他のどのルールにも一致しなかったリクエストの通信先まで変わります。
GEOIPも接続先IPアドレスを基準に判定します。たとえばGEOIP,CN,DIRECTは、地理情報IPデータでCNに分類された接続先に一致します。ウェブページの言語やホスト名のサフィックスは参照しません。特定のホスト名の例外を優先する場合は、対象になり得るIP関連ルールより前に配置してください。
04. [Host]:ホスト名のIPアドレスを固定(URLは変更しない)
[Host]では、指定したホスト名にローカルの対応付けを設定できます。以下では説明用に予約されたアドレスを使って構文を示します。左辺にはホスト名だけを書き、プロトコル、ポート、パスは含めません。右辺には接続先IPアドレスを指定します。これは[Rule]でそのホスト名にDIRECTを指定することとは異なります。
[Host]
lab.example.com = 192.0.2.10
- 検証するには、例のホスト名とIPアドレスを、自分で管理するテスト用ホスト名と到達可能なサーバーのアドレスに置き換えます。ブラウザーのアドレス欄だけでなく、サーバーのアクセスログを確認し、リクエストが想定したサーバーに届いたかを確認してください。対応付けが機能していても、アドレス欄には元のホスト名が表示されます。
- 利用中のプロキシサービスがある場合は、接続先ホスト名をローカルで名前解決するのか、リモート側で名前解決するのかも区別してください。ローカルの対応付けを調べるときは、自分で制御できる直接接続のテスト先を使います。リモート側の名前解決結果を、ローカルの対応付けが機能していない証拠と取り違えないようにしましょう。
- サーバーにリクエストが届いているのに証明書エラーが返る場合は、証明書がURLに記載された元のホスト名をカバーしているか確認してください。名前解決先を変更しても、HTTPSの検証対象となるホスト名は変わりません。また、サーバーの別のポートがURLで指定したポートに変わることもありません。
05. [URL Rewrite]:URLに一致させてリダイレクトを返す
[URL Rewrite]は、クライアントが完全なURLを認識できるリクエストを対象にします。例は左から、正規表現、転送先URL、リダイレクトの種類です。平文HTTPの/oldリクエストを、同じホストの/newへ一時的にリダイレクトします。DNSの対応付けには使わず、DIRECTやPROXYをリライト先に指定することもできません。
[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
\.はピリオドそのものに一致し、^と$はURL全体の範囲を指定します。/old/と/old?from=testは一致しません。転送先の/newが同じルールに再度一致することもありません。- 検証には、自分で管理し、平文HTTPを受け付けるテストサイトを使います。
/oldと/old/への最初のレスポンスを比較してください。前者には302と/newを示すLocationが返る想定です。後者はこのルールではリダイレクトされません。ブラウザーの最終URLだけを見ると、リダイレクト後の結果を最初のレスポンスと誤認することがあります。 - ブラウザーが
http://をhttps://に自動で切り替えると、リクエストは例の正規表現に一致しません。HTTPSではパスが暗号化されるため、ホスト名だけからパスが/oldかどうかを判定できません。このHTTPの例を使って、HTTPSのパス書き換えの可否を判断しないでください。
06. 変更が反映されないときの確認手順
複製を保存したのに、古いルールが適用されるのはなぜ?
まずConfigで現在選択中のファイル名を確認し、次にHomeでGlobal RoutingがConfigになっているか確認します。同じ接続先に新しいリクエストを送ってください。接続が再利用されている場合は、元のリクエストを終了してから再テストします。それでも想定どおりにならない場合は、ルールセクションの先頭から、その接続先に一致する最初のルールを確認してください。
Hostを変更したのに、アドレス欄が変わらないのはなぜ?
[Host]で変更するのは名前解決先であり、URLではありません。接続先サーバーで、新しいリクエストが届いているか確認してください。アドレス欄の/oldを/newに変えたい場合は、リダイレクトを検証します。パスを[Host]のキーに追加しないでください。
変更後に以前は開けたサイトへ接続できない場合、まず何を戻す?
Configで編集前の元ファイルを再選択し、同じネットワークとテスト先で比較します。元ファイルで接続できるなら、複製から最後に加えた変更を戻し、1つずつ確認してください。元ファイルでも接続できない場合は、まずHomeの接続状態と現在のネットワークを確認します。FINALを変更したり、DNS設定を重ねて追加したりしないでください。