公式マニュアル / CONFIG REFERENCE

Shadowrocketの設定項目とルール振り分けガイド

初めて設定する場合は、まずクイックスタートを参考に、手元にあるサブスクリプションまたはサーバー情報を追加し、接続できることを確認してください。このページは設定を調べるためのリファレンスです。項目名がわかっている場合はセクションごとに確認し、接続はできても想定どおりに振り分けられない場合は、ポリシーと照合順序を確認してから該当ルールを調べます。対応デバイスと入手方法はダウンロードガイドをご覧ください。

01 / FILE STRUCTURE

設定ファイルの構成と適用範囲

設定ファイルはクライアントがリクエストをどう処理するかを定め、サーバー情報はプロキシ接続先を定めます。この2つは別々に変更できます。Homeで既存のサーバーを切り替えても、Configで使うルールファイルは変わりません。別のルールファイルを保存しても、サーバーの認証情報は置き換わりません。編集を始める前に、現在どのサーバーへ接続しているか、Global RoutingがConfigの場合にどのファイルが実際に使われるかを確認してください。ファイル一覧に見覚えのある名前があるだけで、そのファイルが適用中だと判断しないでください。

セクション名から4種類の設定を見分ける

設定セクション役割確認するケース
[General]DNS設定などの共通パラメータ関連のない複数のドメインで同じ問題が起きる
[Rule]条件に応じてリクエストのポリシーを選択特定の接続先が想定外の経路を通る
[Host]特定のホスト名にアドレスや名前解決方法を指定一部のホスト名で想定外のアドレスが返る
[URL Rewrite]表示されるURLに一致するリクエストを書き換える古いURLへのアクセスが別の場所に移動する

角括弧内の名前がセクションの境界です。行を追加する前に、近くの説明だけでなく、上にある直近のセクション名を確認してください。DOMAINで始まる行は[Rule]に、ホスト名をアドレスに割り当てる等号付きの行は[Host]に記述します。たとえばファイル末尾にルールを貼り付けても、末尾が[Host]セクション内なら、記述が正しくてもルールとして機能しません。同名のセクションがすでにある場合は、そのセクションに項目を追加してください。末尾に同名のセクションを作って、前の内容を上書きしようとしないでください。

最小限の設定ファイルの構成を読む

[General]
dns-server = system

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

この例はDNSパラメータとルールの書き方を示すもので、すべてのファイルに4つのセクションが必要という意味ではありません。共通パラメータはキーと値で記述し、ルールは半角カンマで種類・照合値・ポリシーを区切ります。例では、アセット用ホストにDIRECTを適用し、同じドメイン内のほかの一致リクエストにはPROXYを適用します。一致しないリクエストはDIRECTにフォールバックします。これは読み方の例であり、すべてのネットワークに適した初期設定ではありません。既存ファイルをこの内容で置き換えると、ローカルアクセスの例外、サービスグループ、最終ルールの動作が一度に変わるおそれがあります。

編集中は、現在使用中のファイルをベースにしてください。まず、内容を確認でき、必要に応じて再選択できるコピーを保存し、一度に変更する箇所は1つにします。ウェブページからコードをコピーしたら、角括弧、等号、カンマが半角文字のままか確認してください。URL全体をそのままドメインルールに入力してはいけません。また、ルール行の末尾に説明文を加えないでください。既存のリモートソースが設定を管理している場合は、更新によってローカル編集が置き換わるかを先に確認します。独立したコピーで試せば、リモートの変更と手作業の変更を分けて判断できます。

変更するのが設定か接続情報かを確認する

既存サブスクリプションのサーバー一覧が空、認証に失敗する、または別のルールに切り替えても同じサーバーに接続できない場合は、まずサーバー情報と基本接続を確認してください。[Rule]にサブスクリプションURLを書いたり、プロキシルールを機能させるために[Host]へサーバーのアドレスを入力したりしないでください。逆に、接続でき、同じサーバーからほかの接続先へアクセスできるのに、特定のドメインだけポリシーが想定と異なる場合は、該当セクションとルール順序を確認します。クライアントの買い切り料金は回線プランの料金ではありません。この記事は、利用者が自分のサブスクリプションまたはサーバー情報を用意していることを前提としており、ノードやサブスクリプションの提供・販売・推奨は行いません。

保存後にConfigへ戻り、適用中のファイルを確認してから、Global Routingで選択中のモードを確認します。同じ名前のファイルが表示される場合は、テストごとに区別できる名前のコピーを使い、別々のテストを同じ名前に記録しないようにしてください。設定を引き継ぐ際は、変更したセクション、変更したい接続先、変更せずに維持したい接続先を伝えます。「設定を変えたら開けた」だけでは変更が有効だったか判断できません。ネットワークの切り替えや、以前の接続が終了したことが原因で復旧した可能性もあります。

変更前のファイルと設定を記録してから、新しいファイルが適用されているか確認してください。設定ファイルの保存、選択、実際の使用は、それぞれ別に確認が必要な状態です。

ファイルの書き方を比較したい場合は、設定ファイルの各セクションの説明もご覧ください。設定を確認する際は、機密情報を伏せたセクション単位の抜粋を使ってください。サーバーの認証情報、リモート設定のURL、サブスクリプション情報、実際の内部ホスト名が含まれるファイルは自分のデバイス上に保管し、公開テキスト比較サービスで処理しないでください。

02 / GENERAL

General:共通パラメータとDNS設定

関連のない複数のドメインで同時に名前解決に失敗する場合は、プロキシルールを追加する前に[General]と現在のネットワークを確認してください。名前解決の結果はアドレスで、ルールの結果はポリシーです。両者は別の判断です。アドレスが取得できても、そのアドレスへ接続できるとは限りません。プロキシポリシーが選択されても、接続先のホスト名が正しく解決されたとは限りません。名前解決、ポリシー、実際の接続を個別に確認して、どの層を変更する必要があるか判断してください。

dns-serverで名前解決の基準を確認する

[General]
dns-server = system

例のsystemは、システムが提供するリゾルバーをそのまま使い、現在のネットワークでのシステム標準の名前解決動作を比較しやすくする設定です。特定のパブリックDNSサービスを示すものではありません。家庭、職場、モバイル通信の間でデバイスがネットワークを切り替えると、システムが使うリゾルバーや名前解決できるホスト名も変わる場合があります。社内ネットワークでは解決できる内部ドメインが、ほかのネットワークでは解決できない場合、まずその名前が社内リゾルバーでのみ解決できるものか確認してください。この違いをすぐにルールの問題と判断しないでください。

既存ファイルを編集する場合は、実際に存在するdns-serverの行を見つけ、元の値を記録してからコピー上で置き換えます。比較のために同名のキーを2つ追加したり、リゾルバー、アドレスファミリーの設定、フォールバックポリシーを同時に変更したりしないでください。まず普段から安定している一般的なドメインをテストし、次に問題のドメインをテストします。同じネットワークとサーバーを使って比較してください。比較用のドメインも失敗する場合は、まず環境または共通パラメータを確認します。問題のドメインだけ失敗する場合は、該当する[Host]項目、名前解決の結果、特定のドメインルールの有無も確認してください。

結果なし、結果の違い、接続失敗を区別する

結果が返らない場合は、入力したホスト名が完全か、名前解決サービスに現在のネットワーク経由で到達できるか、ネットワークへのログインが済んでいるかを確認してください。結果が異なっても、必ずしも障害ではありません。同じサイトでも、場所、通信事業者、アクセス時刻によって異なるアドレスが返ることがあります。正しく比較するには、テストに使ったネットワーク、ホスト名、アドレスファミリーを記録し、同じ接続先で再テストしてください。別のデバイスを別の回線で使った結果を、固定の正解として比較しないでください。名前解決後にタイムアウトや証明書エラーが起きる場合は、接続先またはサービス名の確認に進みます。リゾルバー設定を切り替え続ける必要はありません。

IPv4とIPv6の結果も分けて確認してください。サイトが両方のアドレスを公開していても、デバイスが常に同じアドレスファミリーで接続するとは限りません。IPv4アドレスへのアクセスは正常なのに、ホスト名でアクセスすると失敗する場合は、失敗した接続でどのアドレスが実際に使われたかを確認します。IPv6の結果が表示されただけでは、IPv6が原因だとは断定できません。同じ接続先へのアクセスがそのアドレスで失敗したこと、現在のネットワークからそのアドレスファミリーに到達できることを比較する必要があります。調査のために一時的にアドレスファミリー関連の設定を変更する場合は、元の値を保存し、確認後に戻して長期的な原因を調べてください。

名前解決と振り分けの相互作用を確認する

DNS設定の問題に見えても、実際にはアドレスルールが判定に必要なアドレスを取得できていない場合があります。ドメインルールはホスト名があれば直接照合できます。一方、先にあるアドレスルールは、ネットワーク範囲と照合する前にホスト名のアドレスを取得することがあります。ドメインで定義した明確な例外を優先するには、該当するドメインルールがアドレス系ルールより前にあるか確認し、アドレスルールにno-resolveが付いているかも確認してください。1つのアドレスルールを一致させるために、すべてのリクエストに不適切な値となるような共通の名前解決設定に変更しないでください。

リゾルバーを変更してすぐに変化が見られなくても、ファイルを何度も編集する必要はありません。以前のDNS結果と確立済みの接続には、それぞれ異なる有効期間があります。テスト中のセッションを終了して新しいリクエストを開始してください。必要に応じてクライアント接続を再確立し、現在の結果を再度比較します。古いページがキャッシュから読み込まれただけなら、今回のリクエストは想定したネットワーク処理を経ていない可能性もあります。ページを何度も再読み込みするより、明示的に新しいリクエストを1回送信して確認するほうが結果を判断しやすくなります。

リゾルバー設定は特定の名前解決問題を解決するためのもので、すべてのアクセスを速くしたり、接続経路の代わりになったりするものではありません。テストの最後に、結果を説明できる記録を残してください。使用した設定ファイル、リゾルバーがシステム提供か手動指定か、どのネットワークで失敗したか、アドレスが返らなかったのか、アドレスはあるが接続できなかったのかを記録します。次回同じような現象が起きても、すべての変更をやり直さず、まず同じ層を再確認できます。

接続先の名前解決に失敗する場合は、まず名前解決を確認します。アドレスが返るのにアクセスできない場合は、そのアドレスに対するポリシー、接続経路、接続先サービスを確認してください。「名前解決できる」ことと「アクセスできる」ことは別です。

03 / DOMAIN MATCH

ドメインルール:完全一致・サフィックス・キーワード

接続先を安定したホスト名で指定できる場合は、範囲が最も狭く、説明しやすいルールを優先します。ログイン用ホスト1つだけの例外にはDOMAINを使います。同じドメインとそのサブドメインに同じポリシーを適用する必要がある場合はDOMAIN-SUFFIXを使います。複数ドメインへの誤一致を許容でき、明確な一覧を作れない場合に限り、DOMAIN-KEYWORDを検討してください。種類を選ぶ前に、ページタイトル、サービス名、ブラウザーに表示される略称から推測するのではなく、実際のリクエストのホスト名を特定します。

完全なURLからルールに使う値を取り出す

https://assets.example.com:443/manual/index.htmlの場合、ドメインルールに使う値はassets.example.comです。先頭のプロトコル、後ろのポート、パス、クエリパラメーターはホスト名に含まれません。特定のディレクトリだけに適用するルールは、ドメインルールでは作れません。同じホスト名にあるほかのディレクトリにも同じドメインポリシーが適用されます。サフィックスルールの値はexample.comと直接書き、先頭にアスタリスクを付けたり、パスを追加したりする必要はありません。

種類照合値一致する例一致しない例
DOMAINassets.example.comassets.example.comimg.assets.example.com
DOMAIN-SUFFIXexample.comexample.com、img.example.comnotexample.com
DOMAIN-KEYWORDexampleassets.example.comassets.test.invalid

サフィックス照合はドメイン階層を境界として、ルートドメインとそのサブドメインの両方に一致します。同じ文字列で終わるだけの別ドメインは一致しません。キーワード照合はホスト名に指定した文字列が含まれるかどうかで判定します。たとえばnotexample.comはexample.comの一部ではありませんが、exampleを含みます。そのため、短いキーワードを使うと、無関係なサービスまで変更されることがあります。キーワードを使う前に、一致させたい接続先と、名前が似ていても変更してはいけない比較対象を1つずつ挙げてください。

例外を先に、まとめるルールを後にする

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

この設定例では、まず特定のホスト名を処理し、その後に同じサフィックスを持つほかの接続先をまとめています。assets.example.comはどちらのドメイン条件にも一致しますが、先にある完全一致ルールでポリシーが決まるため、後続のサフィックスルールでは処理されません。2行を入れ替えると、完全一致ルール自体が正しくても例外として機能しません。管理者が用意した広範なルールがある場合は、例外を追加する前にファイルの先頭から確認してください。新しい行をFINALの上に置くだけでは不十分です。

1つのサフィックスルールでアプリ全体を指定することはできません。ページはメインサイト、ログインAPI、静的リソース、メディアサービスなどへ個別にリクエストする場合があり、後者はまったく異なるホスト名を使うこともあります。ホームページは開くのにログインや画像の表示に問題がある場合は、失敗したリクエストを特定し、その接続先にもメインサイトと同じポリシーを適用すべきか判断してください。必要であれば、実際の接続先を完全一致で追加します。同じページに表示されたというだけで、共通の単語や上位サフィックスに対象を広げないでください。

ドメイン名を確認できない場合は、ルールの範囲を広げない

アドレスを直接入力した場合、アプリが既存の接続を再利用した場合、または現在の接続先のホスト名をクライアントが認識できない場合は、想定したドメイン名が見えないことがあります。このとき、DOMAINをより広いキーワードに変えても、ホスト名が補われるわけではありません。接続を新たに開始し、リクエストがホスト名とアドレスのどちらで確立されたかを確認してください。業務上、固定のネットワーク範囲が接続先なら、アドレスルールを確認します。あるドメインがたまたま共有アドレスに解決されたからといって、そのアドレスを恒久的にそのドメインのものとみなさないでください。

ドメインルールを管理するときは、「追加する理由」とあわせて「削除できる条件」も記録してください。トラブルシューティング用の一時的な例外は、原因を特定したら戻します。長期的な例外は、ホスト名が引き続き同じサービスに使われているか定期的に確認します。検証には、対象ホスト名、同じサフィックスの別ホスト名、サフィックスが異なるよく使う比較対象の3つ以上を含めてください。すべてが変わった場合は、例外を増やすのではなく、広範なルールや最終ルールを変更していないか確認します。

ドメインルールが対象とするのはホスト名であり、パスではありません。また、アプリのすべての通信を指定するものでもありません。実際のリクエスト先を特定してから、照合範囲を決めてください。

04 / ADDRESS & REQUEST

GEOIP、IP-CIDR、USER-AGENT

アドレス系ルールを使う前に、照合対象がリクエスト送信時の端末のローカルアドレスではなく、接続先のアドレスであることを確認してください。IP-CIDRはIPv4ネットワーク、IP-CIDR6はIPv6ネットワークを対象とします。GEOIPはIPアドレスの位置情報データベースに依存し、接続先アドレスを地域ごとに分類します。いずれも正確なドメイン識別の代わりにはなりません。一方、USER-AGENTが照合するのは参照可能なリクエスト識別子であり、信頼できるアプリ識別情報として扱うべきではありません。

プレフィックス長でアドレス範囲を指定する

[Rule]
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
IP-CIDR,192.0.2.0/24,PROXY,no-resolve
IP-CIDR6,2001:db8::/32,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

最初の2行はIPv4の範囲を比較した例です。/32は1つのアドレスだけを指定し、/24は同じ先頭3区画に属するアドレス群を対象とするため、単一アドレスの例外はネットワーク範囲より前に記述します。3行目はIPv6のプレフィックス例で、IPv4ルールには使えません。IPv6アドレスを1つだけ指定する場合は/128を使います。例示用のネットワーク範囲は文書上の説明にのみ使い、実際のサービスのテストに利用しないでください。自分のネットワーク範囲を記述する場合は、管理対象の範囲を確認し、ネットワークアドレスとプレフィックスをあわせて入力します。

no-resolveをアドレスルールの末尾に付けると、そのルールを確認するためだけにドメインを自動で名前解決しません。接続先がアドレスそのものの場合や、照合時に使用できるアドレスがすでにある場合は、引き続き照合できます。これはDNSを全体で無効にする設定ではなく、後続のGEOIPに同じ動作を自動適用するものでもありません。接続先がホスト名しかわからない場合、このオプション付きアドレス条件では判定できないことがあります。その後は、引き続き後続のルールで処理されます。同じサービスでも、ドメイン名とアドレスでアクセスしたときにポリシーが異なるからといって、必ずしもルールが誤っているとは限りません。

地域分類は広範な条件として扱う

GEOIP,CN,DIRECTは、IPアドレス位置情報データベースでCNに分類された接続先アドレスをDIRECTで処理するという意味です。中国語のサイト、アカウントの地域、デバイスの所在地、特定のドメインサフィックスを照合するものではありません。コンテンツ配信サービスのドメインは地域によって異なるアドレスを返すことがあり、同じ接続先でもネットワークによって結果が変わる場合があります。特定の安定したドメインに固定ポリシーを適用する場合は、地域分類より前にドメインルールを記述してください。1つの接続先を調整するために、地域全体のデフォルト経路を変更しないでください。

地域ルールを調査する際は、手動で取得した結果だけでなく、失敗した接続が実際に使ったアドレスを記録してください。複数のアドレスが返っても、今回の接続でリストの先頭が使われたとは限りません。接続先が複数のアドレス範囲にまたがる場合も、観測したアドレスを集めて範囲を広げ続けないでください。同じ範囲を共有する別サイトまで対象にするおそれがあります。接続先を自分で管理していて、アドレス範囲が比較的安定している場合に限り、ネットワーク範囲を長期的な識別条件として使うのが適切です。

リクエスト識別子ルールで確認できる範囲

[Rule]
USER-AGENT,ExampleClient*,DIRECT
FINAL,PROXY

上記の架空の識別子は記述例です。クライアントが該当するリクエスト識別子を読み取れる場合、ExampleClientで始まる値がこのルールに一致します。一般的な暗号化接続では、接続先しか見えないクライアントがHTTPリクエストヘッダーを読み取れない場合があります。また、リクエスト自体に利用可能な識別子が含まれないこともあります。識別子が見えていても、アプリの更新やリクエストを構成する要素の変更で変わることがあり、別のアプリと同じ値になる場合もあります。接続先サービスを安定して識別するには、明確なドメイン名を優先してください。このルールを機能させるために暗号化の信頼設定を変更しないでください。

アドレス系ルールと識別子ルールを比較する場合は、まず現在のリクエストからどの情報が得られるかを確認し、次に条件の記述が正確かを確認します。照合可能な値がない条件は、構文が正しくても一致しません。検証できるシナリオを分けて、ドメイン例外、アドレス範囲、リクエスト識別子を個別にテストし、どの条件が先に一致したか記録してください。結果が不安定な場合は、アドレスを直接入力すると安定して一致するが、ホスト名でアクセスすると一致しない、といった再現可能な違いを確認してから、条件や順序を変更します。

ネットワーク範囲はドメインの代わりではなく、地域分類はサイトの識別ではありません。リクエスト識別子もアプリの識別情報ではありません。ルール条件の範囲が広いほど、一致してはいけない接続先を比較対象として用意することが重要です。

05 / POLICY & ORDER

ポリシー、Global Routing、照合順序

ルールが機能しているか判断するには、ルールの数を数える前にGlobal Routingを確認します。画面上では、設定、プロキシ、直結の各モードがそれぞれConfig、Proxy、Directと表示されます。現在のルールファイルにあるドメイン例外、アドレス条件、最終ルールをテストするにはConfigを使います。ほかのモードでアクセス結果が変わっても、接続経路を診断する手がかりにはなりますが、特定の[Rule]行が正しいかどうかの判断には使えません。

モード画面表示トラブルシューティングでの用途
設定Config選択中の設定ファイルのルールを使い、ルール処理の対象となるリクエストを判定
プロキシProxy接続先をプロキシ経由にするとアクセスできるかを比較する。個々のルール照合テストには使わない
直結Direct現在のネットワークから接続先へ直接アクセスした場合の動作を比較

画面のモードとルールのアクションを分けて考える

PROXYはルール行のアクションで、一致したリクエストをプロキシ接続で処理します。サーバー情報を作成するものでも、現在のサーバーから接続先へ到達できることを保証するものでもありません。DIRECTはリクエストを現在のネットワーク経由で接続先へ直接送りますが、システムや接続先サービスのアクセス要件を解除するものではありません。REJECTは一致したリクエストの転送を停止し、特定の接続先を明示的にブロックできます。ページエラー、タイムアウト、リソース不足などの表示はアプリによって異なります。見た目だけで拒否ルールへの一致を判断しないでください。

画面のProxyとファイル内のPROXYは混同しやすいため注意してください。前者は全体のルーティングモードを指定し、後者はルールで判定するときに、一致条件によって選択されるアクションです。通常のアクセスは直結し、特定のサービスだけプロキシを使いたい場合、全体のモードをProxyに切り替える必要はありません。Configを選び、ファイル内にプロキシ条件を記述します。逆に、プロキシ経由で接続できるか一時的に比較する場合は、何十行ものルールを編集せず、元のモードを記録してテスト後に戻してください。

ファイルの順序に沿って照合結果を確認する

[Rule]
DOMAIN,updates.example.com,DIRECT
DOMAIN,telemetry.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

この独立した例では、更新用ホストは1行目で直結し、指定した別のホストは2行目で拒否され、同じサフィックスを持つほかの接続先は3行目でプロキシを使います。4行目は上のルールに一致せず、地域分類が可能なリクエストだけを処理します。FINAL,PROXYは、前の条件に一致しなかったすべてのリクエストを処理します。拒否対象のホスト名は完全一致で拒否する例であり、そのまま使える一覧ではありません。実際に使用する場合は、誤って拒否しても必要な機能に影響しないか確認し、明確な復元方法を用意してください。

これらのルールでは、最初に一致した項目で接続先が決まり、一致した項目の中から最も具体的なものが選ばれるわけではありません。サフィックスルールを2つの完全一致ルールより前に移動すると、例外が機能しなくなります。地域ルールを上に移動すると、本来ドメインルールで処理するリクエストを先に捕捉する場合もあります。順序を確認するには、具体的な接続先を1つ選び、ファイルを上から読みながら各行について「判定に必要な情報があるか」「すでに一致したか」を確認してください。最初に一致するルールが見つかったら処理は終わりです。下にある別のルールのほうが適切に見えるからといって、そのルールで結果を説明しないでください。

ルールにないリクエストの行き先を決める

FINALにはドメイン、地域、ネットワーク範囲の指定が不要で、通常は1つだけルール末尾に置きます。FINAL,DIRECTは、一覧にないリクエストを直結させます。明示した接続先だけにプロキシを使う構成に適しています。FINAL,PROXYは、それ以外のリクエストをプロキシ経由にします。動作は選択中のプロキシが利用可能かどうかに左右されます。最終ルールを変更するか判断する際は、現在問題が起きているサイトだけでなく、一般的なオフィス利用、家庭内のデバイス、一時的な新規ドメインをどう処理するかも考慮してください。1つのサイトの問題を解決するために最終ルールを頻繁に変更している場合は、正確な例外ルールに戻って見直します。

ポリシーのテストには、少なくとも3種類の接続先を用意してください。完全一致の例外になる接続先、広範なルールに一致する接続先、最終ルールに該当する接続先です。拒否ルールがある場合は、安全に失敗しても問題のないリクエストも追加します。変更後は新しいテスト接続を確立してください。すでに確立済みの接続から新しいポリシーを判断することはできません。この方法で、想定した接続先が変わらない問題と、影響を受けるべきでない接続先まで変わる問題の両方を見つけられます。設定を保持する前に、どちらも解決してください。

06 / HOST

Host:ホスト名に対する名前解決結果を指定する

[Host]は、明確な範囲の名前解決に適しています。たとえば、管理下の環境で特定のホスト名を所定のアドレスに解決し、すべてのドメインに使うリゾルバーは変更したくない場合です。ホスト名とアドレスの対応関係に作用します。特定のホスト名に直結またはプロキシのポリシーを適用したいだけで、アドレスを固定する必要がない場合は、[Rule]を変更してください。2種類の変更を混ぜると、単純なポリシーの問題が、名前解決、証明書、サーバー到達性の3つを調べる複雑な問題になります。

アドレスの固定とポリシーの選択は別

[Host]
lab.example.com = 192.0.2.20

[Rule]
DOMAIN,lab.example.com,DIRECT
FINAL,PROXY

この学習用の例では、[Host]行が指定したホスト名を文書用のアドレスに割り当て、[Rule]行がそのホスト名を完全一致で直結させます。上下の設定はそれぞれ別の役割を持ちます。前者だけを残しても自動的に直結にはなりません。後者だけを残しても名前解決の結果は固定されません。実際の環境でこの構成を使う場合は、自分で管理しているホスト名と到達可能な実際のアドレスを指定してください。文書用のアドレスをダウンロードサービスや診断先として使わないでください。

左側にはホスト名を記述し、プロトコル、URLのパス、ポートは書きません。右側には用途に合ったアドレスを指定します。ホスト名の対応付けを設定しても、サービスのポートが設定されるわけではなく、ブラウザーのリクエストに含まれるホスト名も変更されません。新しいアドレスでサービスが稼働していない場合や、指定ポートで待ち受けていない場合は、名前解決に成功しても接続に失敗します。複数のサイトが同じアドレスを使っている場合は、サーバーがリクエストのホスト名に応じて正しいサービスを選ぶことも確認してください。そのアドレスで何らかのページが返るだけでは不十分です。

アドレスを固定する場合の注意点

手動で固定した対応付けは、元のサービスのDNS変更に合わせて自動更新されません。通常は複数のアドレスを切り替えて利用するサービスを1つのアドレスに固定すると、元の切り替え機能が失われます。移行後に削除し忘れた項目があると、特定のデバイスが古いサーバーへ接続し続けることもあります。そのため、長期的に使う項目には、対象となるネットワークとホスト名、対応するアドレスの管理者を明記してください。一時的な移行テストでは、元に戻す条件を明確にします。観測時に取得したパブリックアドレスを恒久的な項目として記述しないでください。

アドレスが社内ネットワークや実験ネットワークからしか到達できない場合、モバイル通信に切り替えた後に失敗するのは想定内かもしれません。確認時は、デバイスが接続しているネットワーク、DIRECTが選択されているか、接続先アドレスと実際の待受ポートが対応しているかを記録してください。プロキシ経由の場合は、プロキシ側から同じアドレスにアクセスできるか、名前解決がローカルとリモートのどちらで行われるかも確認します。ローカルの名前解決設定が、リモート側での同じホスト名の名前解決結果も変えると決めつけないでください。

HTTPSでは、ホスト名と証明書の一致も必要です。割り当てたアドレスに接続できても、相手が別サイトの証明書を返した場合は、テスト成功と判断できません。接続先アドレスを直接開いてページが表示されても、ドメイン名でアクセスした場合に成功するとは限りません。2つのアクセスでホスト名が異なる可能性があります。ホスト名が一致しない場合は、テスト用ドメインに正しいサイト設定と証明書をサーバー側で用意してください。身元確認を無視することを、名前解決の完了条件にしないでください。

変更前・変更後・復元後の3段階で確認する

まず変更前の名前解決結果とアクセス結果を記録し、次にマッピングを1件だけ追加して、元のドメイン名で新しい接続を確立します。接続先アドレスが変わったか、ポリシーが維持されているか、サービスが元のホスト名に対して正しく応答するかを確認してください。次に、同じドメイン配下にある、影響を受けないはずの別のホスト名で比較します。共通のリゾルバーや広範なルールを誤って変更していないことを確認してください。結果が変わらない場合は、まず変更後のファイルが選択されているか確認します。そのうえで、キャッシュ、古い接続、別の名前解決経路が使われていないか調べます。

元に戻す場合は、自分で追加したマッピングをコピーから削除するか、古いファイルを再選択し、新しいリクエストを送ってアドレスが元の名前解決経路に戻るか確認します。関連する直結ルールだけを削除すると、固定アドレスが残り、その後も古いサーバーへ接続する可能性があります。エディターから該当行が消えただけでは不十分です。実際に新しいリクエストを送信し、想定どおりに名前解決されることを確認してください。比較記録はテスト終了まで保管し、実際の内部ホスト名やアドレスを公開しないでください。

[Host]ではアドレスを、[Rule]では接続経路を設定します。固定アドレスを検証する際は、元のホスト名で新しいリクエストを送信し、復元可能な設定ファイルのコピーを必ず残してください。

07 / URL REWRITE

URL Rewrite:リクエストURLの書き換えとリダイレクト

[URL Rewrite]は、参照できるURLに基づいてリクエストを書き換える機能です。たとえば、自分で管理しているテストサイトの古いヘルプページを、同じサイト内の新しいページへ誘導できます。ルールポリシーの別の書き方ではありません。[Rule]は現在の接続先にどの経路を使うかを扱い、[URL Rewrite]は一致したリクエストのURLをどう変えるかを扱います。特定のドメインにプロキシを使いたいだけの場合は、リダイレクトではなくルールを追加してください。リダイレクトを使うと、アクセス先のページやリクエストの流れも変わります。

プロトコル、ホスト名、パスを指定して照合範囲を絞る

[URL Rewrite]
^http://docs\.example\.com/old-help$ http://docs.example.com/help 302

この行では、空白で照合式、転送先URL、リダイレクトのステータスを区切ります。先頭の^と末尾の$はURL全体を対象とし、ホスト名内の\.は任意の文字ではなく、文字としてのピリオドを表します。この例は、クエリパラメーターと末尾のスラッシュがない古いページにだけ一致します。より深いパスのリクエストにも、転送先ページそのものにも一致しません。似た文字列をすべて拾う式より、範囲を明記したほうが確認や復元が容易です。

この例は通常のHTTPを使い、クライアントがURL全体を参照できる場合の動作を説明しています。自分で管理しているテスト環境で検証してください。実際のサービスをHTTPSからHTTPへ変更したり、例に合わせるためにシステムの証明書確認要件を緩めたりしないでください。HTTPS接続のホスト名だけを認識できても、完全なパスやクエリパラメーターまで認識できるとは限りません。自分で管理している暗号化サイトの正式なURL移行は、サーバーが適切なリダイレクトを返す方法を優先してください。異なるクライアントでも同じ結果を得られます。

書き換え後に新しいリクエストが発生することを確認する

この302の例では、アプリがリダイレクトを受け入れると、返された新しいURLへもう1つリクエストを送信します。新しい接続先へ個別に到達できることを確認し、その接続先に適用されるポリシーも確認してください。古いURLへの一致を確認しただけで、新しいページの読み込みまで成功したと判断してはいけません。テストでは、古いリクエストが期待したリダイレクトを受け取ったか、新しいURLへのリクエストでサービスが期待した内容を返したかを分けて記録します。後者が失敗する場合は、新しい接続先の名前解決とポリシーを確認してください。古いURLの式をむやみに広げないでください。

ヘルプページ向けのリダイレクトを、ログイン、フォーム送信、メソッドやリクエスト内容の維持が必要なAPIにそのまま適用しないでください。アプリが302に従う際、別のリクエストメソッドに変える場合や、元のリクエスト内容を転送しない場合があります。ログイン状態、認証情報、個人情報を含むクエリ項目がある実際のリクエストをテストに使わないでください。ドメインが同じでも、パスが変われば用途の異なる処理先に到達することがあります。機密情報を含まない静的コンテンツの読み取り専用ページで比較すれば、こうした副作用を検証から除外できます。

重複一致、ループ、キャッシュを確認する

まず書き換えを一切適用せずに旧ページと新ページをそれぞれ開き、どこから応答が返るか確認します。ルールを1つ追加したら、旧URLで一致することを確認し、新URLと隣接するパスで一致しないことも確認します。新URLも同じ式に一致する場合や、サイト側で新URLから旧URLへ戻す場合は、ループが発生します。この場合は照合範囲を絞るか、書き換えを取り消してください。3つ目のリダイレクトを追加して問題を覆い隠さないでください。ほかの書き換えが両方のURLに一致していないかも確認します。複数の式を同時に変更するより、1つずつ無効にしてテストするほうが原因を特定しやすくなります。

ルールを削除してもリダイレクトが続く場合は、新しいリクエストを送信してから、クライアントが古い設定を使っているのか、アプリが以前の応答を再利用しているのか、サーバー自身がリダイレクトしているのかを確認します。アドレスバーの最終位置から、途中で何回リダイレクトしたかはわかりません。最初のテストより前から転送先が自動的にリダイレクトする場合、新しいルールが有効かどうかは1回のリクエストで返された応答から判断します。最終ページが同じというだけでは判断できません。診断情報が得られない場合は、まず書き換えを削除し、接続を再確立して、2つのURLを個別に比較します。

適用範囲を明確に説明できる書き換えルールだけを残してください。各項目について、旧URLを残す理由、書き換えてはいけないリクエスト、新URLの管理者、削除できる時期を説明できる必要があります。正式なサービス移行を担う唯一の手段として書き換え設定に頼らないでください。複数の利用者やデバイスで同じ結果が必要な場合は、各デバイスでローカルの書き換え設定を管理するより、サーバーが明示的な応答を返すほうが確認しやすくなります。

書き換えルールを1つと、管理可能なURLを2つ使って比較してください。必要な情報が参照できない暗号化パスの場合、式の範囲を広げても照合の問題は解決しません。

08 / VERIFY & RESTORE

設定の検証、問題の切り分け、復元

設定を調べる目的は、ページを更新して偶然成功させることではなく、どの変更によって再現可能な変化が起きたかを特定することです。繰り返し実行できるリクエストを1つ選び、想定するホスト名、ポリシー、結果を書き留めてから、使用中のネットワーク、設定ファイル、サーバーを記録してください。できるだけ同じデバイスで比較し、Wi-Fi、接続モード、サブスクリプション内のサーバーを同時に切り替えないでください。テスト中にWi-Fiからモバイル通信へ切り替えたなど、制御できない条件も記録します。

4つの手順で問題の発生箇所を切り分ける

  1. 接続:Homeで接続状態と現在選択中のサーバーを確認します。手元にある情報でConnectivity Testを実行できますが、テストの成功はそのテストが成功したことだけを示します。すべての接続先に到達できることを意味するものではありません。
  2. 設定:Configで実際に使用中のファイルを確認し、Global RoutingでConfigが選択されているかを確認します。新しいリクエストを1回送信し、接続先が想定したルール処理の対象になるか観察してください。
  3. 名前解決:アドレスを使って判定する必要がある場合は、現在のネットワークで実際に使われているアドレスとアドレスファミリーを比較します。接続先に利用可能なアドレスが1つもない場合は、先にアドレスルールを追加しないでください。
  4. サービス:プロキシまたは直結のポリシーが想定どおりか確認し、接続確立時、証明書確認時、サービスから応答が返った後のどの段階で失敗したかを切り分けます。

Proxyでは成功し、Configでは失敗する場合は、Configに異なるポリシーを適用する先行ルールがないか、最終ルールの行き先が想定と異なっていないかを重点的に確認します。どちらのモードでも失敗する場合は、共通するサーバー、接続先、ネットワーク条件から確認してください。Directで成功する場合は、直結の結果を比較対象として利用できますが、それだけで特定のルールが原因だとは判断できません。モードの比較後は元の設定に戻し、診断のための変更を日常の設定として残さないでください。

ルールの不一致と先行ルールによる遮断を確認する

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

この例を使って、3種類の接続先で検証できます。1つ目は直結が想定される特定の例外、2つ目はプロキシが想定される同じサフィックスの別ホスト、3つ目はそのサフィックスに属さず、ほかの条件にも一致しないため最終ルールが適用されるホストです。例のホスト名はルールの関係を示すだけです。実際のテストでは、これらの条件に合い、到達可能だとわかっている接続先を使ってください。1つ目が失敗する場合はファイルの先頭にある先行ルールを確認します。2つ目が失敗する場合は、接続先が本当に同じサフィックスに属するか確認します。3つ目の結果が変わった場合は、最終ルールやほかの共通パラメータを誤って変更していないか確認します。

ルールの不一致と誤解しやすい状況が2つあります。1つ目は変更前に確立済みの接続が再利用されている場合です。設定ファイルが正しくても、その古い接続は新しいルールで処理されません。2つ目はメインページは表示されても、失敗したサブリクエストがまったく異なるホスト名を使っている場合です。前者では新しいテスト接続を確立し、後者では実際に失敗した接続先を特定してください。画面にエラーが表示されないようにするためだけに、関連サービス全体のポリシーを変更しないでください。リクエスト記録を確認する必要がある場合は、ルールの種類を識別するのに必要な範囲だけ抜き出し、サブスクリプションのクエリパラメーター、認証情報、個人用アドレスを先に削除してください。

症状に応じて最小限の変更を元に戻す

影響が1つの接続先だけに限られる場合は、最後に追加した完全一致ルールをまず削除し、同じリクエストをテストしてください。正常だった複数の接続先が同時に失敗する場合は、最近変更した広範なルール、FINAL、または[General]のパラメータを優先して元に戻します。複数のセクションにまたがる変更を行い、記録もない場合は、正常に動作していた古いファイルを再選択してください。古いファイルに戻した後も、モードとサーバーを確認します。比較テストに使ったモードのままでは、ファイルを復元しても元の状態を再現できません。

変化の原因が設定ファイルではない場合もあります。ネットワークを切り替えると、On Demandの条件に従ってクライアントが接続を再確立することがあります。既存のリモート設定が更新され、テストに使っていた内容が置き換わることもあります。ネットワーク切り替えのときだけ問題が発生する場合は、まず1つのネットワークに固定して比較し、次にOn Demandの条件とリモート設定に変更がなかったかを確認してください。接続の起動条件とバックグラウンド動作については、On Demandとバックグラウンド動作・バッテリー消費の説明をご覧ください。接続再確立の原因を特定する前に、新しい振り分けルールで補おうとしないでください。

最終的な記録は設定全体の書き写しでなくても構いません。ただし、変更した場所、変化した接続先、変化しなかった比較対象、元に戻す方法の4点を確認できるようにしてください。古い設定でもアクセスできない場合は、変更を重ねるのをやめ、サーバー情報、デバイスの接続状態、接続先サービスを確認してください。接続できない場合のFAQとトラブルシューティングを続けてご覧ください。サーバー情報の追加、モードの選択、接続確認までの手順をやり直す場合は、クイックスタートの順に進めてください。

新しいリクエストで確認してください。変更する接続先は想定どおり変わり、影響を受けない接続先はそのままで、古いファイルと元の設定にも復元できます。