公式マニュアル · 設定リファレンス

Shadowrocket 設定ガイド

設定ファイルの構成、振り分けルール、評価の優先順位

初めて接続するときは、まずクイックスタートを参考に、手元のサブスクリプションまたはサーバー情報を追加し、接続できることを確認してください。特定のリクエストがなぜ直接接続になるのか、既定のポリシーに一致するのかを調べたいときや、設定ファイルを編集するときは、該当する項目を本ページで確認できます。クライアントをまだ入手していない場合は、全プラットフォームのダウンロードをご覧ください。

iPhone / iPad 版は App Store で $2.99 の買い切りです。システム要件は App Store の掲載内容をご確認ください。Mac(Apple シリコン版・Intel 版)、Windows、Android、Linux 版は無料で、インストーラーは当サイトの /dl/ から入手できます。クライアントの買い切り購入と通信サービスの利用料金は別です。当サイトではノードやサブスクリプションの提供、販売、推奨は行っていません。

設定ファイルの構成と [General]

設定を確認するときは、まず現在使用中のファイルを特定してから、ルールの内容を確認します。インポートに成功しても、ファイルがクライアントに追加されただけで、現在の接続に適用されているとは限りません。Config で有効なファイルを確認し、Home に戻って Global Routing を確認してください。後者で Config が選択されていない場合、実際の接続結果からファイル内の通常の振り分けルールが一致したかどうかは判断できません。編集前に元の設定を保存し、いつでも戻せるようにしておきましょう。現在使用中のファイル名とモードも記録してください。

まずセクションを確認し、各行の設定値を読む

角括弧で囲まれた部分がセクション名です。次のセクション見出しが現れるまで、その後の内容は同じセクションに属します。[General] は共通設定、[Rule] は条件とポリシー、[Host] はホスト名の名前解決マッピング、[URL Rewrite] は条件に一致した URL の書き換えを指定します。これは優先順位が4段階あるという意味でも、1つのリクエストに対してファイルを上から4回実行するという意味でもありません。問題に応じて確認するセクションを選びましょう。接続先が想定と違う場合は振り分け、名前解決が違う場合はホストマッピング、パスが変化した場合は書き換えを確認します。

よく使う4つの設定セクション
セクション主な役割編集前に記録する内容
[General]接続処理に関する共通オプションを設定します。既存の除外項目と、引き続き処理するリクエスト。
[Rule]条件に応じて接続ポリシーを選択します。リクエストの実際の宛先、想定するポリシー、既定のポリシー。
[Host]特定のホスト名に名前解決マッピングを設定します。対象のホスト名、元のアドレス、テスト用アドレス。
[URL Rewrite]URL に一致する条件を指定し、書き換えを実行します。元の URL、想定する遷移先、リダイレクト結果。

これら4つのセクションでは、行の書式を相互に置き換えることはできません。設定名と値、および後述する静的マッピングの例では等号を使います。ルールセクションではフィールドをカンマで区切り、書き換えの例では、パターン、遷移先、アクションを空白で区切ります。コード例をコピーするとき、説明文を設定ファイルに混ぜないでください。アプリで読み込みエラーが表示された場合は、直前に編集したセクション名と区切り文字を確認します。特に、IME が入力した全角カンマや全角イコール、エディターが自動挿入した改行に注意してください。画面上の折り返し表示と、ファイル内の実際の改行は異なります。1つのルールは1行に収めてください。

共通設定:用途が確認できている除外項目だけを残す

[General]
skip-proxy = localhost, 127.0.0.1

skip-proxy は共通設定の除外リストで、この例ではローカルの宛先を2つ指定しています。1行の DIRECT ルールとは異なります。前者はリクエストがプロキシ処理の対象になる範囲に関わり、後者はリクエストがルール評価に進んだ後に選ばれるポリシーです。振り分けログに項目がないからといって、その項目が直ちに直接接続ルールに一致したとは限りません。特にネットワークやアプリによってリクエストの取得方法が異なる場合は、まずリクエストが現在のクライアントの処理対象になっているかを確認してから、一致した行を調べてください。

元のファイルにある他の共通設定はそのまま残し、ドメインルールを追加するために、出所の不明な設定一式をコピーしないでください。除外リストに他の宛先が含まれている場合は、用途を1つずつ確認します。同じ設定名を重複して記述してもリストの統合にはならず、自動的に追記されると考えるべきではありません。特定のサービスの接続経路を直したい場合は、まず [Rule] に範囲を絞ったルールを追加してテストしてください。問題が共通設定の適用範囲にあると確認できた場合に限り、その設定を個別に変更します。こうすることで、変更前後を比較できる状態を保てます。

ファイル、モード、サーバーを同時に変更すると、テスト結果を比較できなくなることがあります。一度に変える要素は1つにして、再テストしてください。まず設定ファイルを読み込めることを確認し、次にリクエストが新しいルールに到達していることを確かめます。

サブスクリプションの内容と、ローカルにあるルールのコピーを区別することも重要です。サブスクリプションはサーバー項目の更新に使われる場合も、外部の提供元から設定ファイル全体を取得する場合もあり、両者は同じではありません。編集前に、アプリがインポート後のローカルコピーを使っているのか、リモートの提供元から更新される設定を使っているのか確認してください。更新後にローカルの変更が消えた場合は、ルールの書式をすぐに変えるのではなく、ファイルの提供元と現在選択中のファイルを確認します。カスタムの行は認証情報を含めずに別途保存しておけば、次回の更新後に再度統合が必要か確認できます。

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

対象のホスト名が分かっている場合は、まずドメインルールを使います。ドメイン欄にはホスト名だけを記述し、プロトコル、ポート、パス、クエリパラメーターは含めません。Web アドレスから条件を転記するときは、完全な URL からホスト名を取り出してください。アドレスバーに表示されるのはトップレベルページの場所だけです。画像、セッション用 API、静的リソースが別のホストにアクセスすることもあります。トップページは表示できるのに一部の内容が読み込めない場合は、失敗したリクエストを特定してください。同じホスト名のリクエストが2種類のポリシーを同時に使ったとは判断できません。

要件を最小限の条件で表す

ドメインルールの比較
キーワード条件の例一致する範囲
DOMAINapi.example.comこの完全なホスト名だけに一致します。
DOMAIN-SUFFIXexample.comそのドメインとサブドメインに一致します。似た綴りのドメインはサブドメインとして扱いません。
DOMAIN-KEYWORDexampleホスト名にこの文字列を含むリクエストに一致します。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

この例では、まず API ホストを例外として指定し、同じドメイン配下の他のリクエストを PROXY に送ります。api.example.com へのリクエストは1行目で処理が終わり、2行目には進みません。www.example.com はサフィックスルールに一致します。api.example.org はそのサフィックスには属しませんが、キーワードルールに一致します。キーワードルールは一致範囲の広さを示す例であり、すべての設定に残すことを推奨するものではありません。列挙できる特定のドメインだけを処理したい場合は、この広い条件を削除してください。複数のサフィックスが必要な場合は、個別に記述したほうが後から確認しやすくなります。

サフィックスはファイルの拡張子でも URL の末尾でもありません。たとえば、example.com.other.test は example.com のサブドメインではありませんが、assets.example.com はサブドメインです。キーワードはドメインの区切りに沿った一致を必要としないため、無関係なホスト名に同じ文字列が含まれていても一致することがあります。類似ドメインを確認せずに、ブランドの略称、環境名、一般的な業務用語をキーワードにしないでください。1つのサイトとそのテスト用ドメインの両方を対象にする場合は、曖昧な条件を1つ使うより、完全一致またはサフィックス条件を2つ指定するほうが管理しやすいでしょう。

サイトの表示名ではなく、リクエストの宛先を確認する

Web ページの不具合を調べるときは、ページを開く、画像を読み込む、フォームを送信するなど、再現できる操作を記録し、その操作で使われるホスト名を確認してください。他のアプリの場合、デスクトップアイコンの名前をドメイン欄に入力しないでください。クライアントが接続先 IP アドレスしか認識できない場合、ドメインルールではホスト名に一致させられません。ログに表示されているのがリクエストのドメインかアドレスかを確認し、それに応じたルールを選びましょう。あるドメインが特定のアドレスに解決されても、そのアドレスを共有する他のドメインに同じポリシーを適用すべきとは限りません。

パスの違いはドメインルールの一致範囲に含まれません。同じホスト上にある2つのパスは、機能が違っていても同じドメイン条件に一致します。DOMAIN の2番目のフィールドにスラッシュとパスを追加しても、より細かい振り分けにはなりません。管理している HTTP URL のパスを変更する場合は、URL Rewrite を参照してください。1つの API だけをテストしたい場合は、その API の完全な URL でテストを開始できますが、条件に記述するのはホスト名です。

ドメインルールは、少なくとも2種類の例で確認します。1つは一致するはずの対象、もう1つは綴りが似ていても一致しない対象です。例外も設定した場合は、その例外もテストし、先にある広いルールに処理されないことを確認してください。

サービス側に新しいリソース用ドメインが追加された場合は、同じ用途のリソースかどうかを確認してから、完全一致ルールを追加するか、既存のサフィックスを広げるか決めてください。サフィックスを広げると、後から追加されるサブドメインにも影響します。ルールの重複を減らせる一方、テスト用や管理用の入口まで別の経路に変えてしまう可能性があります。適用範囲が不明な場合は、新しいホストを個別に指定してください。各キーワードのフィールドや一致範囲を確認するには、ルールタイプの詳細をご覧ください。

アドレスルール:GEOIP、IP-CIDR、IP-CIDR6

アドレスルールが照合するのは接続先のアドレスです。端末自身のアドレスや、アクセスする人の所在地ではありません。IP アドレスで直接アクセスするサービス、用途を確認済みのアドレス範囲、またはドメイン例外の後に適用する広い地域条件に適しています。変わらない内部ネットワークの範囲をアドレスで表すのは分かりやすい方法ですが、公開ドメインの代わりに IP アドレスを使う場合は注意が必要です。公開サービスのアドレスは変更されることがあり、無関係なサイトと共有される場合もあります。一度の名前解決結果を、そのまま長期間使うルールにしないでください。

アドレスの種類とプレフィックスの範囲を確認する

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,2001:db8:1::/48,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

IP-CIDR には IPv4 のネットワーク範囲を指定します。例の /16 は先頭16ビットが固定されることを表し、192.168.0.0 から 192.168.255.255 までの全範囲が対象になります。固定アドレスの機器1台だけが対象なら、そのアドレスに /32 を付けるほうが範囲を絞れます。先頭3つのオクテットで示されるサブネット全体が必要な場合に限り、/24 を使ってください。プレフィックスが短いほど範囲は広くなります。スラッシュの後の数字を、機器の台数と混同しないでください。設定ファイルに書き込む前に、範囲内のアドレスと隣接する範囲のアドレスをそれぞれ使って境界を確認しましょう。

IP-CIDR6 には IPv6 のネットワーク範囲を指定します。例では文書用に予約されたアドレスを使っており、実際にアクセスできるオンラインサービスではありません。IPv6 アドレス1つだけを固定する場合は /128 を使います。IPv4 の条件だけを設定しても、IPv6 リクエストに同じポリシーが適用されるとは限りません。1つのホスト名が両方の種類のアドレスに解決されることがあり、実際の接続先はネットワークやサービスの状態によって変わります。同じドメインでもネットワークによって結果が異なる場合は、実際に使われたアドレスの種類を比較し、片方にだけ対応する条件が設定されていないか確認してください。

地域データと名前解決の適用範囲を理解する

GEOIP,CN,DIRECT は、接続先アドレスが地域データで CN に分類された場合に DIRECT を実行するルールです。ドメインのサフィックスで判定するものではなく、コンテンツの言語、アカウントの地域、事業者名を識別するものでもありません。共有インフラを使うサイトはネットワークによって異なるアドレスに解決されることがあり、データベースの地域分類も想定と異なる場合があります。特定のサイトを常に同じ経路にしたい場合は、まずドメイン例外を設定し、地域ルールは一般条件として扱ってください。地域ラベルだけでサイトの種類を判断することはできません。

接続先が最初はドメイン名として指定される場合、ドメイン名だけではアドレス条件を判定できません。照合には有効な接続先アドレスが必要で、名前解決が関わる場合もあります。先に記述されたアドレスルールによって、本来はドメインで判定できるリクエストがアドレス判定に進むこともあります。特定のホストに決まったポリシーを適用したい場合は、アドレスを判定する一般ルールより前にドメインルールを置いてください。アドレス範囲を優先する必要がある場合に限り、アドレスルールを前に移し、既知のドメインを使ったリクエストで再テストします。ブラウザーで別途調べた結果が、クライアントでも必ず使われるとは限りません。

アドレスが一致することと、そのアドレスに到達できることは別です。対象が正しく DIRECT に一致していても、現在のネットワークにその範囲へのルートがない場合があります。そのときプレフィックスを変更しても、ルートは作成されません。

内部サービスを調べるときは、まず接続しているネットワークを確認してください。離れた場所で同じプライベートアドレス範囲が使われることがあります。元のネットワークを離れると、以前のアドレスに接続できなくなったり、別の機器を指したりする可能性があります。広いプライベートアドレス範囲を直接接続にしても、場所の違いは判別できません。特定の場所にあるサービスだけを許可する場合は、条件を記録し、手間を省くためにすべてのプライベートアドレスへ範囲を広げないでください。既存の共通除外項目も確認しましょう。対象がルール処理に進まない場合、アドレスルールの一致がログに表示されなくても、プレフィックスが間違っているとは限りません。

アドレスルールのテストでは、2種類の記録を残します。実際に一致した行の記録と、接続がどの段階で終了したかの記録です。対象範囲のテストに失敗した場合は、ポリシーの選択を誤ったのか、それとも想定どおり直接接続を選んだものの宛先に到達できなかったのかを確認します。プロキシ経由で失敗する場合は、選択中のサーバーからテスト対象にアクセスできるかを調べてください。一度到達できなかっただけで、ネットワーク全体を直接接続からプロキシに変更すべきではありません。変更を戻すときは、追加したアドレス条件を削除して同じ宛先を再テストします。変更が結果に影響したかを判断できます。

リクエスト識別情報と PROXY、DIRECT、REJECT

ルールの先頭にあるフィールドは何を判定するかを示し、末尾のフィールドは一致した後に何をするかを示します。USER-AGENT は取得可能なリクエスト識別情報で判定する条件の一種です。一方、PROXY、DIRECT、REJECT はポリシーです。識別情報とポリシーを混同したり、画面上の Proxy モードをルールの先頭に記述したりしないでください。以下の例では、3つのポリシーを別々の行にして、一致条件と実行結果を個別に確認できるようにしています。

リクエスト識別情報で照合するための前提

[Rule]
DOMAIN,unused.example.com,REJECT
USER-AGENT,ExampleReader*,PROXY
DOMAIN,docs.example.com,DIRECT
FINAL,DIRECT

例の ExampleReader* は前方一致を示すためのものです。照合対象はリクエストに実際に含まれる User-Agent の値であり、アプリアイコンの名前、インストーラー名、ログインアカウントではありません。リクエストライブラリーによって識別情報は異なる場合があり、同じアプリでも Web ビュー、リソースの読み込み、バックグラウンド処理で異なる値が使われることがあります。識別情報は変更または省略できるため、本人確認の代わりにはなりません。また、特定のアプリからの接続だと断定することもできません。テストでは制御可能なリクエストを使い、送信された識別情報と実際に一致した行を記録してください。

この条件を使えるかどうかは、対象のリクエストについてクライアントがどのフィールドを取得できるかによって決まります。接続ログにホスト名があるからといって、読み取り可能なリクエストヘッダーも記録されているとは限りません。特に、暗号化されたサイトへの接続が見えることと、識別情報フィールドで必ず照合できることは別です。ログで確認できない場合、キーワードを短くし続けて一致させようとしないでください。特定のサービスを処理するのが目的なら、確認可能な正確なドメインを優先します。識別情報でリクエストを区別する必要があり、テストで該当フィールドを確認できる場合に限って、この種のルールを使ってください。

ポリシーを選んだら、ページ表示だけでなく実際の処理を確認する

組み込みポリシーの役割と確認方法
ポリシー動作まず確認する項目
PROXY現在のプロキシ選択に従ってリクエストを処理します。プロキシの選択が正しいか、サーバーから対象にアクセスできるか。
DIRECT現在のネットワークから接続先サービスに直接アクセスします。現在のネットワークでの名前解決、ルーティング、接続先サービスの状態。
REJECT一致したリクエストを拒否します。拒否された対象が、意図したホストまたはリクエストかどうか。

PROXY はサーバーアドレスではなく、サブスクリプションを自動で追加するものでもありません。一致した後も、クライアントに利用可能なサーバーが登録され、選択されている必要があります。ログ上の一致が想定どおりなのにページのリクエストが失敗する場合は、まず同じサーバーを選んだまま、既知の到達可能で機密性のない宛先をテストしてください。その後、そのプロキシから失敗した宛先にアクセスできるか確認します。サブスクリプションの更新で問題がある場合は、クイックスタートで追加方法と接続手順を確認してください。サーバーの利用可否の確認と振り分け条件の編集は別々に行い、同時に変更しないでください。

DIRECT も、クライアントを終了したり接続を切断したりするという意味ではありません。そのリクエストに直接接続を選択したという意味であり、他のリクエストには別のルールを適用できます。REJECT はリクエストを明示的に拒否します。アプリには失敗が表示されたり、再試行が繰り返されたり、一部のリソースだけが欠けたりすることがあります。ページが表示されないだけで拒否ルールが原因だと決めつけないでください。一部のリソースが読み込めないからといって、すべての拒否ルールを変更するのも避けましょう。まず実際に一致したリクエストとルールを絞り込みます。広いサフィックス条件が本文、ログイン、リソース配信用のサービスをまとめて対象にする場合は特に注意が必要です。

1つのリクエストが複数の条件に当てはまる場合があります。たとえば、この例のドキュメント用ホストが指定の識別情報も使っている場合です。識別情報で照合できるなら、後ろにある完全一致のドメイン直結ルールではなく、識別情報の行にある PROXY が先に実行されます。ドキュメント用ホストを必ず直接接続にするには、そのドメインルールを識別情報の行より前に移してください。変更後はそのホストだけでなく、引き続きプロキシを使うはずの比較対象も再テストします。関係のない動作まで変わっていないことを確認してください。

評価順、FINAL、Global Routing

振り分けを確認するときは、まず Global Routing、次にファイル内の行順を確認します。同じファイルでもモードによって動作は異なります。[Rule] のルールが適用されているか調べるには、まず Config を選択してください。Proxy または Direct で接続を比較している場合、結果から分かるのはプロキシ経由または直接接続の経路全体が使えるかどうかだけです。個別のルールが正しいことの証明にはなりません。比較テストが終わったら、必要な元のモードに戻してください。

モードとルールポリシーの関係
画面上の表示処理方法確認できること
Config現在の設定に従って振り分けます。ルールの一致順、例外、既定のポリシー。
Proxy処理対象の通信をプロキシ経由にします。選択中のサーバーでリクエストが完了するか。
Direct処理対象の通信を直接接続にします。現在のネットワークから接続先に直接アクセスできるか。

先に一致したルールを実行し、最も詳細なルールを自動で選ぶわけではない

[Rule]
DOMAIN,health.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

すでにルール評価の対象になった新しいリクエストを考えてみます。health.example.com にアクセスすると、最初の行が条件に一致し、その時点で直接接続が選択されます。www.example.com へのアクセスは2行目で処理されます。それ以外のリクエストだけが地域判定に進み、どの条件にも一致しなかった場合に FINAL が実行されます。最初の2行を入れ替えると、確認用のホストもサフィックスルールに処理されます。これは完全一致ルールが機能していないのではなく、実行順が後ろになっているためです。ルールは既知の例外、通常の条件、広い条件の順に並べます。業務上、例外より広い条件を優先する必要がある場合に限り、この順序を変えてください。

同じ範囲を対象に異なるポリシーを指定した条件が複数あっても、ファイル末尾まで評価して最後の行を採用するわけではありません。重複した行を見つけたら、まず前の行が元の設定に含まれていたか確認し、既存のポリシーを置き換えるのか、より狭い例外を追加するのかを決めます。どの行が先に一致しているか分かりにくい場合は、対象のホストと一致する可能性のある条件を、ファイルの順に書き出してください。必要な情報を含み、最初に条件を満たした行を優先して確認します。下にある完全一致条件ばかりを書き直して、先に一致する行を見落とさないでください。

既定のポリシーは動作の選択であり、障害を修復するものではない

FINAL にはルール名とポリシーだけを指定し、ドメインやアドレスのフィールドは記述しません。[Rule] の最終行に置いてください。その後に通常の条件を書いても、有効な例外にはなりません。FINAL,DIRECT は、個別に指定されていないリクエストを直接接続にします。プロキシを使う対象だけを明示する設定に適しています。FINAL,PROXY は、指定されていないリクエストをプロキシ経由にします。プロキシを既定にして、直接接続の例外を管理する設定に適しています。選択する前に、未知の宛先をどのように扱うべきか考えてください。テストに一度失敗したからといって、未指定のリクエストすべての処理を逆にしないでください。

リクエストが FINAL に一致した場合、それより前の条件には一致しなかったということです。ルールを追加する必要が本当にあるかを確認し、対象フィールド、プレフィックス、行順を調べてください。まず全体のフォールバックを変更しないでください。

ルールを確認するには、少なくとも3つの比較テストを行います。完全一致の例外、広い条件だけに一致する対象、どちらにも該当しない対象にそれぞれアクセスしてください。アドレスまたは識別情報の条件もある場合は、3つ目の対象が他のルールに先回りされていないことも確認します。変更を保存して有効になったことを確認してから、新しい接続を開始してください。画面を更新するだけでは、以前の接続が再利用される場合があります。ブラウザーのキャッシュ、アプリの長時間接続、以前のページリクエストによって、結果が遅れて表示されることがあります。前回の記録が表示されている場合、行順が機能していないとは判断できません。

リクエストの動作とログが一致しない場合は、モードを使った短い比較テストを行ってください。直接接続はできるのにプロキシ経由では失敗する場合は、選択中のサーバーを優先して調べます。どちらも使えるのに設定モードだけ失敗する場合は、一致した行とそのポリシーに絞って確認します。どちらも失敗する場合は、接続先と現在のネットワークを優先して確認してください。直接接続とプロキシ経由を比較する場合は、両方の経路でテストしてよい対象を使ってください。比較表はルールログの代わりにはなりませんが、違うセクションを繰り返し変更するのを防げます。

[Host]:名前解決マッピングと振り分けの違い

[Host] は指定したホスト名の名前解決マッピングを設定します。ブラウザーの URL を別のドメインに変更したり、PROXY や DIRECT を直接選択したりするものではありません。管理下の環境で元のホスト名を保ったまま既知のテスト用アドレスを使い、自分で管理するサービスを検証する場合に適しています。既存のサイトを別のネットワーク経路に通すだけなら、[Rule] を変更すれば十分です。ポリシーに合わせるために、先に名前解決を変更しないでください。

ホスト名、アドレス、ポリシーをそれぞれ記録する

[Host]
lab.example.com = 192.0.2.20

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

マッピング行では左側にホスト名、右側にアドレスを指定します。ここでは文書用に予約されたアドレスを使用しており、実際にアクセスできるサービスではありません。ルール行はそのホスト名にアクセスしたときに使うポリシーを指定しますが、マッピングを作成するものではありません。例では同じホスト名を両方に記述していますが、テスト結果は2つの問題に分けて確認してください。想定したアドレスに接続しているか、想定した経路でリクエストが処理されたかです。自分で管理するテストサービスの場合は、サーバーがリクエストを受信したかどうかとクライアントのログを照合してください。ページが表示されただけでは、マッピングが機能したとは証明できません。

元サイトの完全な URL をイコールの左側に書かないでください。右側にポートやパスを加えることもできません。ホスト名の名前解決と接続先ポートは別の設定です。実際のポートはリクエストで指定されるか、プロトコルの既定値が使われます。テスト用サービスが特定のポートを使う場合は、リクエストを送る側で明示的に指定してください。ホスト名をドメイン全体に適用するパターンに広げるのも避けましょう。1つのサービスだけを検証する場合は、ホスト名を個別に記述し、同じドメインの他の入口の名前解決まで変わらないようにしてください。

キャッシュ、名前解決の経路、サービスの識別

静的マッピングは、そのマッピングを使う名前解決の処理に影響しますが、すべてのアプリや名前解決経路を強制的に変更するものではありません。アプリにキャッシュがある場合、IP アドレスに直接接続する場合、アプリ自身が名前解決する場合、または名前解決がリモートで処理される場合は、ローカルにマッピングを1行追加しただけですべてのリクエストに新しいアドレスが使われるとは限りません。確認したいアプリから新しいリクエストを送り、ログに記録された接続先アドレスを確認してください。別のアプリやシステムの検索ツールが返す結果だけを比較しても、同じ名前解決経路を使っているとは限りません。

ホスト名に新しいアドレスを指定しても、そのサイトの本人確認が新しいアドレスに引き継がれるわけではありません。リクエストでは元のホスト名が使われるため、管理下のテストサーバーはそのホスト名で適切に応答できる必要があります。証明書が一致しない、表示されるページが違う、サーバーから想定外のサイトが返る場合は、そのホスト名とポートに対するサーバーの設定を確認してください。証明書の警告を無視してマッピングが成功したと判断してはいけません。管理していないサイトの名前解決を安易に変更することも避けてください。検証中はアカウント情報を含まないテストリクエストを使い、実際のセッションが誤った宛先に送られないようにしましょう。

問題の原因が名前解決だと特定できている場合は、同時に GEOIP の例外を追加したり既定のポリシーを変更したりしないでください。アドレス条件は実際の接続先アドレスに依存するため、マッピングを変更すると一致結果も間接的に変わる可能性があります。この要因を切り分けるには、テスト用コピーに明示的なドメインルールを残し、アドレスだけを個別に確認します。マッピングが正しいと確認できた後で、アドレスに依存する通常の条件を戻すか判断してください。これにより、新しいアドレスを検証しながら、プロキシと直接接続の違いを名前解決の確認に持ち込まずに済みます。

マッピング行は、明確な期限のあるテストに適しています。テストが終わったら使用中の設定から削除し、新しい接続を開始して名前解決が元に戻ったことを確認してください。検証用コピーを残す場合は、テスト環境専用であることも記録しておきましょう。

削除後も古いアドレスに接続する場合は、現在のファイルに同じホスト名のマッピングが別に残っていないか、前回の接続を引き続き使用していないかを確認してください。その後、同じネットワークで新しいリクエストを送り、ログを比較します。すぐにシステム全体の名前解決設定を変更しないでください。使用中のファイルが更新される提供元から取得したものなら、マッピングをローカルで追加したのか、元のファイルに含まれていたのかを確認します。後者の場合、設定の更新時に再び追加されることがあります。継続的に使う変更は正しい提供元の設定に反映し、一時的な確認は別のコピーで行ってください。

[URL Rewrite]:URL の照合とリダイレクトの確認

書き換えは、認識できるリクエスト URL を処理する機能です。自分が管理するテストサービスで、古いパスから新しいパスへの移行を確認する場合に使えます。振り分けルールとは解決する問題が異なります。DOMAIN はホストのリクエストに適用するポリシーを決めますが、古いパスを新しいパスに変更するものではありません。[Host] は、そのマッピングを使う名前解決のアドレスを変更できますが、パスは変更しません。リクエストの宛先に異常がある場合は、経路、名前解決結果、クライアントが実際に要求した URL のどれが変わったのかを切り分けてください。

まずは HTTP の単一 URL に限定して試す

[URL Rewrite]
^http://example\.com/old$ http://example.com/new 302

この行には、照合パターン、遷移先 URL、アクションの順に記述します。先頭の ^ と末尾の $ で URL 全体を条件にし、\. はドメイン中の実際のドットを表します。任意の文字を表すものではありません。完全な URL が古いパスと一致するサンプルだけが対象です。クエリパラメーターが付いた URL、末尾にスラッシュがある URL、異なるプロトコルの URL はこの例には一致しません。末尾の 302 は一時的なリダイレクトを指定します。リダイレクトに従うリクエスト元は、遷移先 URL に対して次のリクエストを送信します。その後のリクエストがどこに到達するかは、アドレスと適用されるルールを個別に確認してください。

例の URL は書式を説明するためのものであり、実在するサイトがこれらのパスを提供しているという意味ではありません。検証には、自分で管理するテスト用ホストと個人情報を含まない読み取り専用のリクエストを使ってください。example.com をテスト用ホストに置き換える場合、左側のパターンではドットを引き続きエスケープします。右側は文字列としての遷移先 URL なので、通常のドットを使います。テストサービスが明示的なポートを必要とする場合は、実際の入力に合わせて照合パターンにもポートを含めてください。すべてのページに一致するパターンを先に書き、後から別のルールで影響を除外するのではなく、まず1つのパスが想定どおりに遷移することを確認してから範囲を広げましょう。

一致する範囲、クエリパラメーター、リダイレクトループを確認する

この例では意図的に HTTP を使用しています。クライアントに HTTPS 接続のホスト情報が見えていても、暗号化された接続内のパスやリクエスト内容を直接読み取れるとは限りません。ホスト名が見えるからといって、先頭のプロトコルを HTTPS に変えるだけで完全に同じ結果になるとは考えないでください。ブラウザーから HTTP をテストする場合は、入力した URL がブラウザーによって最初に HTTPS へ変更されていないかも確認します。その場合、実際のリクエストは例の条件に一致しません。テスト側のログで実際のプロトコルと URL を確認し、ルールを一致させるために通常の閲覧時のセキュリティ設定を下げないでください。

クエリパラメーターも照合範囲の一部です。この例では、パラメーター付きの古い URL は対象にならず、遷移先にもパラメーターは自動的に追加されません。業務上パラメーターを処理する必要がある場合は、引き継ぐものと転送しないものを明確にし、認証情報を含まないテスト値で結果を確認してください。ログインや送信を伴うリクエストで、この例の動作を推測しないでください。リダイレクトを追う際にリクエスト元がメソッドを変更することがあり、サービス側がリクエスト本文に依存している場合もあります。移行の確認は通常の読み取りから始め、送信を伴うパスは別途テストしてください。

遷移先 URL は、このルールの条件に再び一致せず、別の書き換えルールによって元の URL に戻らないようにします。少なくとも3回リクエストを行い、古い URL がリダイレクトされること、遷移先 URL が正常に完了すること、条件に似ているが一致しないパスが変更されないことを確認してください。ブラウザーにリダイレクト回数が多すぎると表示された場合は、実際の遷移先を順番に確認し、設定によるものかサーバーによるものかを切り分けます。最終的なアドレスバーだけを見ないでください。誤った中間リダイレクトが後続のページに隠されても、リソースの読み込みや別のアクセス方法に影響することがあります。

テストではまず最初のレスポンスを確認します。想定した一時リダイレクトが発生したか、遷移先 URL が正しいかを見てください。次に、リダイレクト後のリクエストが到達できるかを確認します。書き換えに一致したことと、遷移先に接続できることは別の結果です。

テスト用の書き換えを無効にした後は、新しいリクエストを送って再確認してください。キャッシュされたページ、サーバーにもともと設定されていたリダイレクト、アプリによる URL の自動変更が引き続き発生し、設定がまだ有効であるように見える場合があります。現在のファイルに該当行がないと確認できたら、リクエスト元が前回の結果を再利用していないか、遷移先サービスがもともと同じリダイレクトを返していないかを調べます。記録にはテスト用ドメイン、パス、アクションだけを残し、個人情報を含む実際の URL 全体はコピーしないでください。

設定例、検証の手順、変更の取り消し

以下では、既存設定に小さな変更を加える例を示します。確認用ホストは直接接続にし、同じドメインの他のサービスは選択中のプロキシを使い、確認済みの内部ネットワーク範囲は直接接続にします。指定されていない宛先は直接接続のままにします。設定例のドメインは書式説明用です。テストが許可されている自分のホストに置き換えてください。プロキシを使う場合は、自分のサブスクリプションまたはサーバー情報を追加し、既存の接続で利用可能であることを事前に確認してください。

[Rule]
DOMAIN,health.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.40.0/24,DIRECT
FINAL,DIRECT

期待する結果を書き出してから、項目ごとに確認する

この設定例を既存ファイルの FINAL の後ろにそのまま追加することはできません。また、この例を使うために設定ファイル全体を作り直す必要もありません。既存の [Rule] がある場合は、必要な条件をそのセクションに統合します。まず、それ以前の行が対象のホストにすでに一致していないかを確認してから、追加位置を決めてください。未指定のリクエストに対する動作を実際に変更する必要がある場合に限り、既定のポリシーを置き換えます。元の設定が既定で直接接続なら、内部ネットワークの行は現在の結果と同じです。その行は意図を明示するためのものです。将来、既定のポリシーを変更した場合は、この明示的な例外も再確認してください。

テストメモには、それぞれの対象、想定する一致行、想定するポリシー、実際の結果を記録してください。確認用ホストで1行目、同じドメインの別ホストでサフィックス条件、指定した内部アドレスでネットワーク範囲、他の条件に該当しない対象で既定のポリシーを確認します。条件が競合する例も追加してください。同じドメインのリクエストが最終的にその内部ネットワーク範囲を指す場合は、先にあるドメインサフィックスが優先されます。内部アドレスはドメインに関係なく必ず直接接続にする必要がある場合、この行順では要件を満たしません。まずアドレス条件が利用可能か確認してから順序を変え、最初の2項目も再テストしてください。

一致したルールが正しいことと、接続に成功することは分けて考えてください。誤ったルールに一致していてもページが読み込める場合があります。同じ対象でもプロキシと直接接続の両方で開けることがあるため、接続できたからといって検証に合格したとは限りません。反対に、想定どおりに一致したのに接続できない場合も、すぐルールを変えないでください。失敗する対象の種類を確認します。プロキシを使う対象だけで失敗する場合は、使用中のサーバーの選択と接続状態を確認してください。内部ネットワークの対象だけで失敗する場合は、テスト時のネットワークと実際のアドレスを確認します。ページの一部のリクエストだけが失敗する場合は、リソースが使うホスト名と、そのリクエストに適用されたルールの記録を比較してください。

未反映、未一致、接続失敗の順に切り分ける

最初に確認するのはファイルとモードです。保存後、使用中の設定と Global Routing を確認し、テスト用リクエストを新しく開始してください。新しいルールがどのログにも反映されない場合は、ファイルの選択を誤っていないか、比較用モードのままではないかを確認します。次に照合フィールドを調べます。アドレスしかない場合はアドレスを基準に確認し、ドメインがある場合は実際のホスト名と行順を確認してください。ページのタイトルからホスト名を推測しないでください。最後に実行結果を確認します。正しいポリシーに一致している場合は、直接接続またはプロキシ経由のどの段階で失敗するかを調べます。画面上の項目を確認するときは、画面に表示される英語用語の一覧を参照してください。

ネットワークを切り替えた後に問題が発生した場合は、設定、モード、サーバーを同じにしたまま、ネットワークだけを変えて比較してください。名前解決されたアドレス、一致したルール、アクセス結果のどれが変化したかを記録します。アドレスが変わると地域やネットワーク範囲の条件が変わることがあります。同じルールとポリシーで失敗する場合は、ネットワーク経路を調べる必要がある可能性が高いでしょう。クライアントの起動時にインストールや入手の問題が発生しても、設定の編集で解決しようとしないでください。まずダウンロードページのインストール方法またはストアとアカウントの地域についてをご覧ください。

変更を戻すときは、保存しておいた元の設定に切り替え、サーバーとテスト用ネットワークを変えずに同じリクエストを再テストします。元の設定では問題が再現しないことを確認してから、今回の設定変更を1つずつ比較してください。

変更を戻しても、検証結果を消す必要はありません。機密情報を除いた設定差分と、最小限の再現手順を保存し、想定した結果と実際の結果の違いを記録してください。元のファイルでも同じ現象が起きる場合は、ルールの追加をいったん止めて、クイックスタートに戻り、既存のサブスクリプション、サーバーの選択、基本的な接続を再確認します。新しいファイルでのみ再現すると確認できた場合は、次回は条件を1組だけ追加し、検証に合格してから次の組を追加してください。どの変更が動作に影響したかを特定でき、設定の提供元が更新された後の確認にも役立ちます。