Shadowrocket公式マニュアル · 設定リファレンス
Shadowrocketのルールと設定ガイド
このページでは、設定の構成、ルール項目、トラブルシューティングの手順をまとめています。設定の編集や確認にお使いください。既存のサブスクリプションを初めて読み込む場合や、接続モードの選択、接続のオン・オフについては、まず使い方ガイドをご覧ください。接続できているものの、特定のリクエストがなぜ直接接続、プロキシ経由、または拒否になるのかを確認したい場合は、下の目次から該当する項目へ移動できます。
例では説明用に予約されたドメインと文書用アドレスを使用しています。設定やマッチングの仕組みを説明するためのもので、接続先としては使用できません。プロキシポリシーを検証する前に、利用可能なサブスクリプションまたはサーバー情報があることを確認してください。本サイトではノードやサブスクリプションを提供、販売、推奨していません。
設定ファイルの構成:設定・ルール・マッピングを区別する
まず使用中のファイルを確認する
設定ファイルには、角括弧で示された複数のセクションを含めることができます。セクション名によって、その後の各行の解釈が決まり、次のセクション名が現れるまで適用されます。同じ文字列でも、記述するセクションによって意味が異なります。たとえば portal.example.com は、[Rule] では照合対象のホスト名、[Host] ではマッピング先のホスト名として扱われます。編集する前にセクションを確認してください。ファイル全体を自由に連結できるルールの羅列と考えたり、既存のルール一覧の途中に新しいセクション名を挿入したりしないでください。
Config で現在選択されている設定を確認します。同名のファイルが一覧にある場合、名前だけでは編集したファイルを特定しにくいため、使用可能な元ファイルを残し、テスト用コピーには用途が分かる名前を付けてください。編集・保存・選択はそれぞれ別の操作です。コピーを保存しても、その設定で通信が処理されるとは限りません。変更後はコピーが選択されていることと、Global Routing が Config になっていることを確認します。元ファイルがリモートURLから取得されている場合、更新によってローカルの変更が上書きされることがあります。個別ルールを長く使う場合は、独立したコピーを用意してください。
| セクション | 主な役割 | 確認する状況 |
|---|---|---|
[General] | 名前解決の設定など、ネットワーク全体の動作を設定する | IPアドレスでは接続できるが、ドメイン名の名前解決に問題がある |
[Rule] | 条件に応じて処理ポリシーを選択する | 実際に適用されたポリシーが想定と異なる |
[Host] | 特定のホスト名にマッピングを指定する | 一部のホスト名だけ意図しないアドレスに解決される |
[URL Rewrite] | 確認・照合できるURLに書き換え処理を行う | リダイレクトやパスに応じた処理の結果に問題がある |
[General] と [Host]:名前解決と通信の振り分けは別
[General]
dns-server = system
[Host]
portal.example.com = 192.0.2.10
ここでの dns-server = system は、システムのDNS設定を使う指定です。実際の名前解決結果は、現在のネットワーク、キャッシュ、アプリの名前解決方法にも左右されます。[Host] の例では、指定した名前を文書用アドレスにマッピングしています。これはルーティングポリシーではなく、そのアドレス上のサービスが自動的に利用可能になるわけでもありません。実環境でローカルテスト用サービスに固定マッピングを設定するのは、接続先アドレスの所有者、用途、管理者を確認できている場合に限ってください。接続先が複数サーバー間で切り替わる場合や、動的DNSに依存する場合、アドレス変更後に一部のリクエストが失敗する可能性があります。
固定アドレスを設定しても、ブラウザーが元のドメイン名に対して行う証明書検証は変わりません。接続できても、そのドメイン名用の証明書が設定されていないサーバーを指定すると、名前の不一致が発生することがあります。テスト結果が単に「開けない」場合は、名前解決、接続確立、証明書検証の3段階に分けて確認してください。前の段階が成功したことは、次の段階まで進んだことを示すだけで、次の段階の確認にはなりません。テスト用マッピングを削除したら、リクエストを再実行してください。すでに開いているページだけで変更の反映を判断しないでください。
[Rule] と [URL Rewrite]:混同しない
[Rule]
DOMAIN,portal.example.com,DIRECT
FINAL,PROXY
最初のルールは完全一致するホスト名を直接接続し、最後のルールはそれ以外のルール処理対象トラフィックをプロキシ経由にします。[URL Rewrite] は別の構文を使うため、パスに一致する正規表現を DOMAIN のフィールドに記述することはできません。また、リダイレクト処理を PROXY の代わりに使うこともできません。内容を把握していないファイルを確認する場合は、まずセクションを特定し、キーワード、区切り文字、ポリシーを確認してください。1行がドメイン名のように見えるだけでは、DNS、振り分け、リクエスト処理のどれに適用されるか判断できません。
設定のコピーを作り、最小限の変更から検証できます。既存設定を複製したら、まず名前解決の設定には手を加えず、検証するルールを正しいセクションに置いて、フォールバックより前に配置します。そのうえで正常に読み込めるか確認してください。保存後に構文エラーが出た場合は、DNSやサーバーではなく、直近で追加したセクション名、全角の句読点、エディターによって分割された行を優先して確認します。画面上の折り返しは表示上のものですが、ファイル内の改行は1つのルールを無効な2行に分けることがあります。元に戻す場合は元ファイルを選び直せばよく、同じファイル内で何度も手動で取り消す必要はありません。
サブスクリプションには接続に必要な情報が含まれ、設定にはリクエストの処理方法が記述されています。既存のサブスクリプションを更新した後も、現在の設定が選択されているか、ポリシーで必要なサーバーが利用可能かを確認してください。この2つは互いに代わりにはなりません。
Global Routingとポリシー:モードを選んでからルールを確認する
3つのモードを使ったトラブル対処
Global Routing は、クライアントの処理対象となる通信を現在の設定に従って振り分けるかどうかを決めます。設定モードは Config で、ルールの検証に使います。プロキシモードは Proxy で、プロキシ経由の経路との比較に使います。直接接続モードは Direct で、直接接続の経路との比較に使います。対象はクライアントの処理範囲に入る通信であり、端末上のあらゆる通信が必ず同じ設定に従うわけではありません。他の2つのモードで比較した後、個々のルールの有効性を確認するには Config に戻してください。
| 画面上の表示 | 処理の基準 | 確認できること |
|---|---|---|
Config | 現在の設定にあるルールとそのポリシー | このリクエストに一致したルールはどれか? |
Proxy | 現在のプロキシ経路で処理する | 現在の振り分けルールを使わずに、プロキシ経路を利用できるか? |
Direct | 直接接続経路で処理する | 現在のネットワークから同じ接続先へ直接アクセスできるか? |
比較するときは、同じネットワーク、同じ接続先、同じサーバーを使い、モードだけを切り替えてください。途中でWi-Fiからモバイル通信に切り替えたり、サーバーを変更したりすると、モードとネットワーク条件のどちらが差の原因なのか判断しにくくなります。すでに読み込んだページだけで判定しないでください。ブラウザーが以前の接続を再利用したり、キャッシュを表示したりすることがあります。同じ接続先への新しい接続を確立し、確認できるリクエスト記録と合わせて判断するほうが、ページが表示されたかどうかだけを見るより確実です。何度か比較する場合は、その都度モードと結果を記録し、記憶だけで原因を推測しないでください。
PROXY、DIRECT、REJECT
[Rule]
DOMAIN,admin.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
DIRECT はプロキシサーバーを経由せずに接続する指定ですが、名前解決とローカルネットワーク経路が利用できる必要があります。PROXY はプロキシ経由で接続する指定で、サーバーのアドレス、プロトコル、認証情報が利用可能であることが前提です。REJECT は、このルールに一致したリクエストを拒否します。アプリ側では接続失敗、再試行、機能の欠落などとして現れることがあり、明確な拒否メッセージが表示されるとは限りません。設定ではこれらの大文字のポリシー名を使いますが、画面上の Proxy や Direct はモードの選択肢です。両者は異なる階層の設定です。
上の設定で Config を選ぶと、管理用ホストは1行目、メトリクス用ホストは2行目に一致し、後のホストはサフィックスに一致した場合にのみプロキシ経由になります。手動で Proxy に切り替えた後に接続先へアクセスできても、まず分かるのは、このテスト対象でプロキシ経路が使えるということだけです。元のルールで必ず DIRECT に一致していたとは断定できません。実際には REJECT に一致していた、または別の段階で失敗していた可能性があります。逆に、ルールが想定どおり PROXY に一致していてページの読み込みに失敗しても、失敗だけを根拠に「ルールが有効でない」とは言えません。
接続状態、テスト、リクエスト結果を分けて記録する
接続スイッチをオンにすると、クライアントの接続状態が変わりますが、すべての接続先にアクセスできるとは限りません。Connectivity Test は現在のサーバーへの到達性を比較する参考になりますが、テスト対象と実際の通信リクエストは同じではありません。サイトのメイン文書を読み込めても、認証、画像、APIリクエストで失敗することがあります。その場合は、同じモードで問題の操作を再現し、その操作と同じ時間帯に発生した失敗リクエストを探してください。トップページが開くことだけを合格基準にすると、後から確立される決済、ログイン、ファイルアップロードなどの接続を見落とす可能性があります。
On Demand は、どの条件で接続を確立・維持するかを設定するもので、ドメインごとのポリシーを指定するものではありません。ネットワーク切り替え後に接続が再確立された場合は、まず接続の挙動を確認し、次に現在のモードとルールを確認してください。「クライアントの処理対象になっているか」と「対象になった後にどの経路を通るか」を別々の問題として切り分けられます。両方を1つの FINAL で解決しようとしないでください。端末が組織の管理下にある場合、システムによって接続動作が制限されることがあります。端末管理の要件に従ってください。
ドメインルール:ホスト名の完全一致・サフィックス・キーワード
ルールのフィールドにはホスト名を指定する
ドメインで振り分ける場合は、URLからホスト名だけを取り出します。たとえば https://api.example.com:443/v1/items のホスト名は api.example.com です。スキーム、ポート、パス、クエリパラメーターはドメイン照合の対象ではありません。DOMAIN は特定のホスト1台だけを対象にする場合、DOMAIN-SUFFIX はドメイン本体とサブドメインをまとめて対象にする場合、DOMAIN-KEYWORD はホスト名に含まれる文字列で照合する場合に適しています。後の2つは、意図していないリクエストまで対象にする可能性が高いため、変更前に一致させたくない例も洗い出してください。
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,preview-build,DIRECT
FINAL,PROXY
| 条件 | 一致する例 | 一致しない例 |
|---|---|---|
DOMAIN,login.example.com | login.example.com | test.login.example.com |
DOMAIN-SUFFIX,example.com | example.com、api.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,preview-build | preview-build.example.net | preview.example.net |
サフィックスはドメイン名の境界に基づいて判定され、単純に末尾の数文字を調べるものではありません。サブドメインを表すために DOMAIN-SUFFIX に *. を付ける必要もありません。一方、キーワードルールでは、キーワードがサブドメインのラベルと一致する必要はなく、特定の会社やプロジェクトに属することも保証されません。複数のドメインを対象とする一時的なテストでは、後で削除できるよう確認記録を残してください。長期間使うルールでは、確認済みのホスト名やサフィックスに絞るのが一般的です。
ページ名から推測せず、実際のリクエストからドメインを特定する
アドレスバーに表示されたページへアクセスしても、すべてのリクエストがそのホストに送られるとは限りません。ログイン時にリダイレクトされたり、静的ファイルが別のドメインから配信されたり、同じページのデータが複数のAPIから読み込まれたりすることがあります。特定のボタンだけが失敗する場合は、再現しやすい操作を一度行い、問題の範囲を絞ってから、該当時間帯に失敗したホストを確認します。まず関連が確認できたホスト1台に完全一致ルールを追加し、同じ操作を再テストしてください。複数のサブドメインに同じ処理が必要な場合に限り、サフィックスルールに範囲を広げます。ドメイン全体を別のポリシーにすると問題が消えることはありますが、どのリクエストに調整が必要だったのか分からなくなります。
記録に接続先アドレスしかない場合、ドメインルールに必要な照合対象が不足している可能性があります。アプリがIPアドレスに直接接続する場合、独自の名前解決方法を使う場合、既存の接続を再利用する場合は、業務上使われているドメイン名だけを根拠に、クライアントがその名前を認識したとは判断できません。逆に、DNSから別名や複数のアドレスが返されても、別名やすべてのアドレスをルールに追加すべきとは限りません。クライアントから実際に確認でき、比較的安定したリクエスト属性を優先して使ってください。接続先アドレスが頻繁に変わる場合、固定アドレスを管理する方法はホスト名を確認する方法より早く使えなくなることがあります。
検証のたびに少なくとも1つの不一致例を確認する
ログイン用ホストを直接接続にした場合、そのホストが DIRECT に一致することだけでなく、同じドメインの別ホストが想定どおりの経路を通ることも確認します。サフィックスルールでは、ルートドメイン、該当するサブドメインを1つ、似ているもののそのサフィックスに属さないホストを1つ確認できます。正例と不一致例は照合範囲を確認するためのもので、例示のドメインが実在するサービスである必要はありません。実際のテストでは、アクセス可能で検証が許可された接続先を使い、想定したポリシーと実際のポリシーを記録してください。
2つのルールが同じポリシーを指定している場合、アクセス結果だけではどちらに一致したか判別できません。既存の一致記録を確認するか、許可されたテスト対象で一時的なコピーを使い、検証対象の条件とフォールバックに区別できるポリシーを設定してください。検証後は元に戻します。ルール1つを確かめるために、日常業務で使うドメイン全体を拒否しないでください。他のAPIにも影響すると、元の問題とテストルールのどちらが原因か分かりにくくなります。
IPルール:IP-CIDR、IP-CIDR6、GEOIP
プレフィックス長が決めるのは範囲であり、ポートではない
[Rule]
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
IP-CIDR,198.51.100.0/24,PROXY,no-resolve
IP-CIDR6,2001:db8:40::/48,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
IP-CIDR はIPv4、IP-CIDR6 はIPv6に使います。スラッシュの後の整数は、一致判定に使うプレフィックス長です。IPv4の /32 は単一アドレスを示し、198.51.100.0/24 は 198.51.100.0 から 198.51.100.255 までのアドレス範囲を示します。この範囲に含まれるすべてのアドレスにホストとしてアクセスできるという意味ではありません。IPv6で単一アドレスを指定する場合は /128、例の /48 は先頭3組の16進数が一致するアドレス範囲を示します。1台のサーバーだけに例外を設定したい場合、記述しやすさだけを理由にネットワーク全体へ範囲を広げないでください。
IPv4とIPv6の両方に対応する接続先を管理する場合は、実際の接続で使われたアドレス種別を確認してください。ブラウザーやシステムは2種類のアドレスから選ぶことがあり、IPv4ルールだけでIPv6リクエストも対象になるわけではありません。同じ接続先がIPルールに一致したりフォールバックに回ったりする場合は、各接続で使われたアドレスと、ネットワークによる名前解決結果の違いを確認します。テストを成功させるためにアドレス範囲を広げると、同じネットワーク上にある無関係な接続まで変わることがあります。クライアントから安定したホスト名を確認できる場合は、ドメインルールのほうが業務上の意図を正確に表せることが多くあります。
no-resolve が制御するのは、このルールの名前解決動作
リクエストがドメイン名で指定されている場合、IPルールでプレフィックスを比較するには接続先アドレスが必要です。no-resolve は、このオプションに対応したルールの末尾に指定し、そのルールのためにドメイン名を新たに名前解決しないようにします。すでに分かっているアドレスは照合に使えます。設定全体のDNSを無効にするものでも、既存の名前解決結果を消去するものでもありません。上のプレフィックスルールは「接続先アドレスがすでに分かっている場合にIPで分類する」という指定です。後続のルールで名前解決が必要になる場合もあり、接続を開始する際にDNSが必要になることもあります。
このオプションを確認する場合は、IPアドレスを直接指定したリクエストとドメイン名で開始したリクエストを分けて観察してください。HTTPSのURLにブラウザーでアクセスして失敗しただけで、IPルールに一致しなかったと判断しないでください。証明書がそのIPアドレスを対象としていない場合や、サービスが元のドメイン名を必要とする場合があります。一致したポリシーとサービスの応答は別々に記録してください。テストのために no-resolve を外して挙動が変わった場合は、ドメイン名が解決されてアドレスルールに一致するようになったのか、DNS問い合わせが遅延・失敗したのかを確認します。状況によって必要な対処は異なります。
GEOIP はIPアドレスの分類であり、地理的な証明ではない
GEOIP,CN,DIRECT は、接続先アドレスが現在のデータで CN に分類された場合、直接接続を選択する指定です。ドメインのサフィックス、クライアントの所在地、アカウントの地域ではなく、IPアドレスの分類データを使います。同じドメインでもネットワークによって異なるアドレスが返ることがあり、分類データも更新によって変わる場合があります。分類の粒度が粗いため、明確なドメインやネットワーク範囲の例外より後に置くのが適切です。特定のホストが常に通るべき経路を指定する用途には向きません。
たとえば、プロキシ経由にしたい特定のサービスが、たまたま直接接続に分類されるアドレスに解決される場合、地理ルールをサービスの例外より前に置くと、アドレスが先に条件に一致し、後ろにあるサービス個別のルールは照合されません。トラブル対処では、今回の接続で使われた正しいホスト名とアドレス、最初に一致したルールを記録してください。ドメインのサフィックスを見るだけでは、アドレスがどのように分類されたかも、同じドメインが接続ネットワークを変えると別の経路を通る理由も分かりません。
アドレスによる分類が必要な場合に限り、IPルールを使用します。組織内のサービスが対象なら、ネットワーク範囲と現在の接続環境を先に確認してください。
DIRECTを指定しても、社内ネットワークへの経路が自動的に作られるわけではありません。
リクエスト属性と書き換え:USER-AGENT、REJECT、URL Rewrite
USER-AGENTは識別可能なリクエスト属性に一致する
[Rule]
USER-AGENT,ExampleClient*,DIRECT
FINAL,PROXY
USER-AGENT は、クライアントが識別できるリクエストの識別情報を対象にします。上の例では ExampleClient で始まる識別情報をワイルドカードで表しており、システム上のアプリ表示名からプロセスを検索しているわけではありません。同じアプリでも、Webページ、APIリクエスト、バックグラウンド接続で同じ識別情報が送信されるとは限りません。複数のアプリが同じリクエスト機能を使う場合もあります。設定を変更する前に、自分で管理するテストリクエストで識別情報が存在し、安定した形式で送信されることを確認してください。別の識別情報でも比較用リクエストを送り、意図せず同じ条件に一致しないことも確認します。
通常の暗号化接続では、接続先ドメインを確認できるだけでHTTPリクエストヘッダーまで読み取れるわけではありません。USER-AGENT をすべてのHTTPS通信で使えるアプリ識別方法と考えたり、特定のアプリの全リクエストが同じポリシーで処理されたと判断したりしないでください。ルールに一致しない場合は、まずクライアントがそのフィールドを取得できるかを確認し、その後にパターンと順序を確認します。ワイルドカードの範囲を広げても、フィールドが見えない問題は解決せず、無関係なリクエストに一致するおそれがあります。安定した接続先ホストには、確認しやすいドメインルールを優先してください。
ホスト単位の拒否にはREJECTを使う
[Rule]
DOMAIN,telemetry.example.com,REJECT
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
この例では指定したホストを拒否し、同じサフィックスを持つ他のホストは次のルールに進めます。そのホスト上のパスを判定したり、同じホストにある複数のAPIを区別したりはしません。ログインとメトリクス送信が同じホストにあるサービスでは、ドメイン単位の拒否が両方に影響する可能性があります。影響範囲を確認するには、まずコピーでドメインを完全一致させ、メインページ、ログイン、関連APIをテストしてください。最初からサフィックス全体を拒否しないでください。リクエストの再試行、誤ブロック、失敗時の挙動についてはREJECTルールの仕組みと適用範囲もご覧ください。
ルールが拒否するのは照合処理に入ったリクエストです。完了済みのダウンロードを取り消したり、アプリに保存済みの内容を削除したりはできません。初回テストで変化がないように見える場合、アプリがキャッシュを使っている可能性があります。テストのたびに接続通知が増える場合は、アプリが自動で再試行している可能性があります。どちらの場合も、リクエストの時刻と一致記録を合わせて確認してください。エラーが消えても業務機能が失われているなら、ルールが要件を満たしたとは言えません。変更前と同じ操作で再確認してください。
URL Rewriteは確認できるURLを処理する
[URL Rewrite]
^http://example\.com/old$ http://example.com/new 302
この例のルールは、左から順にマッチング式、置換先、リダイレクトの動作を表します。式には開始・終了アンカーを使い、エスケープしたピリオドは文字としてのピリオドを表すため、例にある完全なURLだけが対象です。クエリパラメーター付きのURLには一致しません。302 は一時リダイレクトを示します。リダイレクト後の接続先にも個別にアクセスできる必要があります。新しいURLを同じルールの照合範囲に含めると、テスト中にリダイレクトループが発生することがあります。恒久リダイレクトで試行錯誤するのも避けてください。ブラウザーが以前の結果を保持し、設定を戻した後の再テストが分かりにくくなる場合があります。
ここではURLフィールドの照合条件を示すため、暗号化されていないHTTPを使っています。最近のブラウザーはHTTPSへ自動的にアップグレードすることがあり、その場合は例の条件に一致しなくなります。HTTPSでは、現在の処理環境で必要なURLフィールドを実際に確認できる場合に限り、パスを条件にできます。ホスト名が見えることは、パスやクエリパラメーターも見えることを意味しません。振り分けを検証するために、追加の復号設定を求めるものではありません。ホスト全体の接続経路を選びたい場合は [Rule] を使ってください。アプリが書き換え後のURLへの移動を拒否する場合は、接続先に到達できないのか、リクエストメソッドが変わったのか、アプリ自体がリダイレクトに対応していないのかを確認します。誤りを隠すために式の範囲を広げないでください。
評価順:例外は対象範囲の広いルールより前に置く
ルール名から優先順位を推測せず、最初に一致したルールを確認する
Config モードで通常の [Rule] 一覧を読む場合、上から順に条件に一致する最初のルールを探してポリシーを判断できます。サフィックスルールがリクエストに一致すると、その下にあるホスト完全一致ルールが、より具体的だからという理由で自動的に優先されることはありません。同様に、後ろにある拒否ルールが REJECT だからといって優先順位が上がることもありません。変更前に、次の2点を確認してください。どのリクエストの処理を変えたいのか、また新しいルールより前に一致する条件がないか、です。
[Rule]
DOMAIN,auth.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
この例の順序では、ホスト名が auth.example.com のリクエストを先に直接接続し、metrics.example.com を先に拒否します。サフィックスに一致する他のリクエストは、その後にプロキシ経由になります。サフィックスのルールを先頭に移動すると、最初の2つのホストも先に一致します。地理ルールをサフィックスルールの後に置くのは、接続先アドレスの分類が変わっても、確認済みのドメイン例外を維持するためです。これは「ドメインルールが常にIPルールより優先」という意味ではありません。アプリケーションレベルで明確な例外を先に処理し、その後に範囲が広く条件が変わりやすいリクエストを処理するという考え方です。
FINALが決めるのは、前のルールに一致しなかった場合の処理だけ
FINAL にはドメインやIPアドレスの引数を付けず、カンマの後にポリシーを指定します。日常的な管理では、明確なフォールバックを1つ用意し、一覧の末尾に置いてください。FINAL,DIRECT は、個別ルールにないリクエストを直接接続する指定で、明示した接続先だけをプロキシに通す設定に適しています。FINAL,PROXY は、個別ルールにないリクエストをプロキシに通す指定で、直接接続の例外を明示する設定に適しています。フォールバックの変更は設定全体の既定動作を変えるものであり、特定のホストだけを修正する方法ではありません。変更前に、明示的なルールがなくても正常にアクセスさせる必要があるサービスを確認してください。
たとえば FINAL,PROXY を使うと、特定のプロキシルールにまったく一致していなくても、接続先がプロキシ経由になることがあります。「プロキシを使って接続できる」ことを「追加した行が有効になった」ことと取り違えるのは、よくある誤判定です。実際に一致した条件を確認するか、テスト用コピーで自分が管理するリクエストに識別可能な比較結果を設定してください。REJECT も同様です。接続エラーが一度発生しただけで拒否が成功したとは判断できません。名前解決に失敗したリクエストは、想定したルール分岐に入っていないことがあります。
ルールを移動するたびに適用範囲の変更として確認する
既存設定を見直す場合は、まずフォールバックを特定します。次に一覧の末尾から上に向かって、キーワード、サフィックス、大きなアドレスプレフィックスなど、対象範囲の広いルールを探してください。新しい例外ごとに、どの既存ルールと重複するかを洗い出し、最も早く一致する重複ルールより前に配置します。既存ルールが他の例外より後ろにある一般条件なら、まとまりごと先頭に移動しないでください。元は優先されていた拒否や直接接続のルールまで覆い隠す可能性があります。並べ替え後の意図しない変化をすぐ確認できるよう、以前のルールの代表的なリクエストを1つ残して比較してください。
他の人から受け取った設定例を取り込む場合は、対象セクション、ポリシー、前提条件を先に確認してください。2つ目の [Rule] セクション名、別ファイルの既定設定、未作成のポリシー名をそのまま貼り付けないでください。リモートのルールソースを使う設定では、ローカルで見える順序と、ソース更新による内容の変化も区別する必要があります。以前は一致しなかったホストが、更新で先に評価されるルールに含まれるようになった場合、末尾に追加した例外だけを見ても原因は分かりません。再検証では、実際に使用した設定のソースとコピーを記録してください。
優先順位を調べるときは、1回の検証で移動または変更するルールを1つに絞り、影響を受けないはずのリクエストを比較対象として残してください。変化を確認してから次のルールに進みます。
よく使う設定例:期待する動作に合わせて最小限のルールを選ぶ
指定した接続先だけをプロキシ経由にする
[Rule]
DOMAIN,signin.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
このルールセットでは、ログイン用ホストを直接接続にし、同じサフィックスを持つ他のホストをプロキシ経由にします。それ以外のリクエストは直接接続のままです。対象範囲が明確で、少数のホスト名で表せる場合に適しています。テストでは、ログイン用ホスト、同じサフィックスを持つ業務用ホスト1つ、サフィックスの範囲外の接続先をそれぞれ確認してください。後からファイルサービスが別のサフィックスに移転しても、このルールは自動では対応しません。移転先のホスト名とアクセス要件を確認してから、個別のルールを追加してください。機能を1つ補うために FINAL を変更しないでください。
ログイン前にはサービスを開けても、ログイン後に一部の機能だけ失敗する場合、ログイン用ホストから業務用ホストへ戻った後のリクエストで問題が起きている可能性があります。複数の接続経路が関係しているか確認するには、一連の操作でWebページ、認証、APIをどのホストが処理しているか整理し、それぞれのポリシーを確認します。これらのホストに同じ経路が必要なら、ホスト名に特定の単語が含まれるかで機械的に決めず、業務上の依存関係に合わせて振り分けを設定してください。接続先の要件がある場合は、相手が許可する接続方法に従ってください。
プロキシをフォールバックにし、明確なローカルサービスの例外を残す
[Rule]
DOMAIN,printer.example.net,DIRECT
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
FINAL,PROXY
この例では、特定のサービスへホスト名でアクセスする場合と、指定したIPアドレスへ直接アクセスする場合を、それぞれ直接接続にします。アドレスとドメインは説明用であり、これらを使って端末上のローカルサービスが見つかるわけではありません。実環境では、指定した名前が正しく名前解決されるか、現在のネットワークからその端末への経路があるかを確認し、実際の状況に応じてドメインルール、IPルール、または両方を選んでください。端末のIPアドレスがネットワークから動的に割り当てられる場合、単一アドレスのルールは適宜更新が必要です。広い範囲のアドレスを許可すると、そのサービスと無関係な接続まで例外になる可能性があります。
2つのネットワークで同じ設定を使う場合、プライベートIPアドレスが同じでも接続先の端末が同じとは限りません。オフィスの端末を指していたアドレスが自宅では別の端末を指したり、応答しなかったりすることがあります。確認時はネットワーク環境も含めて想定結果を記録してください。元のネットワークでは接続先の実体と直接接続の結果を確認し、別のネットワークでは同じアドレスを持つ別のサービスへ誤って接続しないことを確認します。IPルールで決められるのはリクエストの経路であり、接続先サービスの本人確認ではありません。
業務用ホストへのアクセスを維持し、独立したリクエストだけを完全一致で拒否する
[Rule]
DOMAIN,stats.example.org,REJECT
DOMAIN-SUFFIX,example.org,DIRECT
FINAL,PROXY
アクセス不要と確認できた独立したホストがある場合は、完全一致の拒否ルールで要件を表せます。変更前に、メインページの読み込みや設定の保存など、引き続き利用できる必要がある操作を洗い出してください。ルール追加後、同じ手順で再テストします。重要な機能が拒否対象のホストを共有している場合、この方法では両者を区別できません。サフィックス全体を直接接続にする必要がある場合は、拒否ルールの位置も重要です。サフィックスルールより後ろに置くと、先に評価された直接接続の条件に上書きされ、想定した拒否が行われません。
日常的に設定を管理する際は、変更の理由、依存する接続先、問題が起きた場合に戻す行を簡潔に記録してください。設定例を抜き出すときは、その前後にある適用範囲の条件も一緒に残します。特に FINAL だけや、一見有効そうなキーワードルール1行だけをコピーしないでください。例を既存設定に追加する前に、元のデフォルトポリシーと照らし合わせます。例外を1つ追加するだけなら、指定していない接続先の動作まで変更するべきではありません。
検証とロールバック:段階的に問題の範囲を絞る
再現可能な基準状態を用意する
開始前に、直近で正常に使えた設定を保存します。Config で現在選択されている設定を確認し、使用中のネットワーク、モード、テスト対象を記録してください。直接接続できると分かっている接続先と、既存サーバーを経由する必要がある接続先を1つずつ選び、実際の結果を記録します。Home でサーバーの選択を確認し、Connectivity Test を参考にできますが、1回のテスト成功ですべての接続先にアクセスできると判断しないでください。直接接続とプロキシ経由の両方が失敗する場合は、まず端末のネットワークを確認します。プロキシ経由だけ失敗する場合は、使用中のサーバーアドレス、認証情報、プロトコル設定を確認してください。
Config だけで失敗し、2つの比較用経路が正常な場合は、設定内で対象に一致するはずのルール、そのポリシー、前にあるすべての競合し得る条件を記録します。新しい接続で同じ操作を行い、現在のプラットフォームで利用できる診断記録を確認してください。フォールバックに一致した場合は、実際に確認できるホスト名またはアドレスを優先して調べます。意図しない一般ルールに一致した場合は、ルールの順序を確認します。ポリシーが想定どおりなら、ルールを追加し続けず、名前解決、接続、接続先サービスを調べてください。
複数の条件を同時に変更せず、失敗した段階ごとに切り分ける
- 設定を読み込めない:直近の変更箇所に戻り、セクションの位置、句読点、引数の数、ポリシー名のつづりを確認します。同じ設定のコピーでその箇所だけを元に戻し、読み込みが復旧するか確認してください。
- 接続先アドレスを取得できない:DNS設定と、
[Host]に古いマッピングが残っていないかを確認します。片方のネットワークだけで失敗する場合は、もう片方での名前解決結果を比較用に残し、サーバーを同時に変更しないでください。 - 接続先アドレスは分かるが接続できない:現在のモード、実際に一致したポリシー、接続経路を確認します。アドレス種別の変化で別のルールに入っていないか、必要なネットワークに接続できているかも調べてください。
- 接続は確立するが機能が一部動かない:問題の操作で発生した後続リクエストを特定し、別ホストが必要か、リダイレクト先にアクセスできるか、拒否ルールの範囲が広すぎないかを確認します。
たとえば、システムが2つのアドレスを解決し、そのうち一方の経路だけで失敗する場合は、まず該当リクエストで使われたアドレスを記録し、アドレス範囲のルールが一方のアドレス種別だけを対象にしていないか確認します。同じドメインへのアクセスで証明書エラーが起きる場合は、静的マッピングが誤ったサーバーを指していないかを優先して確認してください。証明書エラーを無視してテストを成功扱いにしないでください。失敗した段階を切り分ければ有用な手掛かりを残せますが、モード、DNS、サーバーを何度も切り替えると、結果を比較できなくなります。
[Rule]
DOMAIN,check.example.com,PROXY
FINAL,DIRECT
この最小ルールは、制御可能なプロキシ接続先と、それ以外の直接接続先を区別するためのものです。実際にテストするホスト名に置き換え、独立したコピーで検証し、元の設定で必要なネットワーク設定は残してください。比較のために稼働中の設定を削除したり、既存のサーバー情報を消去したり、日常利用しているサブスクリプションの内容を書き換えたりしないでください。最小構成で正常に動作した場合は、ドメイン例外、IP分類、書き換えルールを少しずつ戻します。最初に問題が再現した箇所が、次に範囲を絞って調べる起点になります。
ロールバック後も再テストする
新しい設定の影響範囲を説明できない場合は、バックアップを選び直し、元の Global Routing モードに戻してから、問題が起きた操作と正常に動く比較対象を再テストしてください。エラーページが消えただけでは、ロールバックが完了したとは確認できません。相談する場合は、機密情報を削除したルール、想定ポリシー、使用したネットワークの種類、再現手順を共有できます。サブスクリプションの完全なURL、認証情報、機密パラメーターを含むリクエストURL、未加工のログは公開しないでください。ほかのトラブル対処についてはよくある質問とトラブル対処および接続済みなのにWebページが開けない場合の確認手順をご覧ください。
別の端末で使う場合は、全プラットフォームのダウンロードページから該当する入手先を選んでください。iPhone / iPad版はApp Store製品ページから入手できます。米国ストアでは$2.99の買い切りで、システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン・Intel)、Windows、Android、Linux版は無料で、インストーラーは本サイトの /dl/ からのみ提供しています。アプリの買い切り購入は接続サービスの契約とは別です。端末を変更した後も、ご自身がすでにお持ちのサブスクリプションまたはサーバー情報をご利用ください。