公式マニュアル / CONFIG
Shadowrocket ルール設定ガイド
このページでは、セクションやルールの種類、照合結果から設定を確認できます。サーバー情報をまだインポートしていない場合や、初回接続が完了していない場合は、先に使い方ガイドで基本操作を済ませてから、このページでルール振り分けを調整してください。インストールやストアアカウント、機種変更についてはアプリの入手方法とよくある質問をご覧ください。
iPhone / iPad 版は App Store から入手できます。米国ストアでは $2.99 の買い切りで、システム要件は App Store の掲載情報をご確認ください。Mac(Apple シリコン / Intel)、Windows、Android、Linux 版は無料です。インストーラーは当サイトの /dl/shadowrocket/ から入手できます。アプリの買い切り料金と通信サービスの利用料金は別です。このガイドは、ご自身のサーバーや契約済みのサブスクリプションをお持ちの方が対象です。当サイトでは接続サービスの提供・販売・推奨は行っていません。
設定ファイルの構成:General、Rule、Host、URL Rewrite
まず、3つの層を区別します。アクティブな設定はクライアントが使用するファイルを決め、ファイルのセクションは各行の機能を決め、[Rule] 内の順序はどのルールから評価するかを決めます。ファイルが Config の一覧に表示されていても、選択できることを示すだけで、現在使用中とは限りません。Home を開き、Global Routing が Config になっていることを確認してから、Config で使用中のファイルを確認してください。変更前に、いつでも戻せるコピーを保存しましょう。特にリモート管理されている設定を、そのままローカルの作業用ファイルとして編集しないでください。
General:解析の基準を整える
[General]
bypass-system = true
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[General] はキーと値の形式で記述します。ここでは dns-server = system を使い、システム DNS を基準にテストします。DNS サーバーの変更とルール振り分けの変更を一度に行わないでください。bypass-system はシステム通信のバイパス設定に関わるもので、特定のドメインに対する DIRECT ルールの代わりにはなりません。また、ルールが一致した記録だけを見て、すべてのシステム通信がクライアントを経由したと判断することもできません。カスタム DNS や DoH と比較するときは、アクティブな設定、テスト対象、ネットワークを変えずに確認してください。詳しくはDNS設定ガイドをご覧ください。
Rule:条件・対象・処理を1行に記述
DOMAIN-SUFFIX,example.com,PROXY は、ルールの種類、照合対象、適用するポリシーの3項目で構成されます。FINAL,DIRECT には対象の項目がありません。URLやプロトコルの接頭辞、説明文をドメイン欄に貼り付けないでください。手動編集では半角のカンマ、角括弧、等号を使い、リッチテキストからのコピーで全角記号が混ざらないようにします。この例にはサーバー情報が含まれていません。PROXY を検証するには、まず Home で自分が利用できるサーバーを選択してください。例示のドメインはルールの範囲を説明するためのもので、実際の環境で接続できるテスト先を示すものではありません。
Host と URL Rewrite:アドレスの割り当てとリクエストの書き換え
[Host]
dev.example.com = 192.0.2.10
[URL Rewrite]
^http://old\.example\.com/guide$ http://new.example.com/guide 302
[Host] の例では、指定したホスト名を説明用のアドレスに割り当てています。自分の環境で使う場合は、アドレスに到達できること、そのアドレスでサービスが実際に提供されていること、元のホスト名がサーバー証明書や仮想ホストの設定と一致していることを先に確認してください。アドレスの割り当ては、リクエストのホスト名の変更でも、直接接続の設定でもありません。この割り当てを追加したときだけ失敗する場合は、DNS やポリシーを同時に変更せず、割り当てを外して再テストしてください。
[URL Rewrite] の例は、記述された HTTP パスだけに一致し、302 で別のアドレスへリダイレクトします。旧ドメインへのすべての接続をプロキシ経由にする設定ではありません。正規表現内のピリオドはエスケープが必要です。末尾の $ は文字列末尾までの一致を指定するため、クエリパラメーターが付いたリクエストはこの例には一致しません。暗号化された接続ではパスが常に見えるとは限りません。この例を、任意の HTTPS リクエストを書き換えられるという前提で流用しないでください。自分で管理するサービスを使ってテストし、元のアドレスとリダイレクト先の両方を確認します。
インポートエラーが発生した場合は、セクション名の右角括弧が欠けていないか、ルール行が正しいセクションにあるか、チャットの文章からコピーした際にコードフェンスまで含めていないかを確認してください。インポートできても動作が想定と異なる場合は、アクティブなファイルと照合対象を確認します。書式の確認と動作の確認を分ければ、ファイルがルーティングに使われていないのにルール順を何度も変更する事態を避けられます。
ドメインルール:完全一致、サフィックス一致、キーワード一致
リクエストのホスト名がわかっている場合は、対象範囲が最も明確なドメインルールから設定します。ルールの判断基準は接続先であり、Webページのタイトル、アプリ名、画面に表示されたボタンの文言ではありません。たとえばブラウザーでページを開くと、メインドキュメント、画像、API、ログイン後のコールバックがそれぞれ異なるホストに接続することがあります。ルールは条件に一致した接続にだけ適用され、同じアプリからのリクエストすべてを自動的に同じポリシーにまとめるものではありません。
| ルール | 照合対象 | 適用範囲の目安 |
|---|---|---|
DOMAIN | 完全なホスト名 | 単一の API、ゲートウェイ、例外ホスト |
DOMAIN-SUFFIX | 指定したドメインとそのサブドメイン | 同じポリシーで扱うホストのグループ |
DOMAIN-KEYWORD | ホスト名に含まれるキーワード | 誤一致の範囲を評価した命名パターン |
DOMAIN:既知のホストに例外を設定
[Rule]
DOMAIN,auth.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
1行目は auth.example.com だけに一致します。サービスに api.auth.example.com もある場合、このホストは自動的に直接接続されず、次のルールの評価に進みます。この設定は、ログインゲートウェイを同一ドメインのプロキシ対象から除外する場合に使えます。ただし、ホスト名に auth が含まれるというだけで、すべての認証リクエストを網羅できるとは限りません。ログイン画面の表示、送信、ログイン後の業務ページへの遷移をそれぞれ実行し、失敗した手順で実際に接続したホスト名を記録してください。1つのホストの修正のために、ドメイン全体のポリシーを変更しないようにします。
DOMAIN-SUFFIX:ドメイン本体とサブドメインに適用
DOMAIN-SUFFIX,example.com,PROXY は example.com と img.example.com に一致しますが、notexample.com や example.com.example.net は同じドメインの一部ではありません。API ドメインだけを対象にする場合は、メインドメイン全体を指定して多くの例外を追加するのではなく、DOMAIN-SUFFIX,api.example.com,PROXY を使えます。欄にはドメイン名だけを記述し、https://、ワイルドカードの接頭辞、ポート、スラッシュ、パスは含めません。ドメインルールが判定するのは「どのホストに接続するか」であり、「そのホスト上のどのページにアクセスするか」ではありません。
アプリの不具合からルールを調べる場合は、対象が完全なホスト名なのか、リダイレクト前に表示されたアドレスなのかをまず確認してください。ユーザーに見える URL が、最終的な接続先のホスト名とは限りません。別名の名前解決が行われたからといって、解決先の別の名前で一致するとも限りません。クライアントが実際に認識した接続先と、確認可能な一致情報を基準にしてください。接続でアドレスが直接使われる場合や、クライアントが利用できるドメイン名を取得できない場合、ドメインルールは評価されないことがあります。その場合はアドレスルールを確認し、キーワードルールで推測しないでください。
DOMAIN-KEYWORD:誤一致するケースもテスト
[Rule]
DOMAIN,media-admin.example.com,DIRECT
DOMAIN-KEYWORD,media,PROXY
FINAL,DIRECT
キーワードでは組織やドメインの境界を識別できません。この例は media.example.com だけでなく、multimedia.example.net にも一致する可能性があります。URL のパスから media を探すわけでも、ページの内容を分類するわけでもありません。対象が既知の1つのドメインに限られる場合は、広いキーワードを追加するより、サフィックスで範囲を限定するほうが確認しやすくなります。キーワードが必要な場合は、想定どおり一致する例、一致しない例、先に除外するホストをそれぞれ挙げて、この3種類のサンプルでテストしてください。
トラブル対処でキーワードルールのポリシーを一時的に変更するのは、最初の検証方法として適切とは限りません。変更範囲が広く複数のリクエストが同時に変化するため、どの結果でページが復旧したのか判断しにくくなります。まず設定のコピーで、単一の対象に DOMAIN ルールを追加し、その対象のルーティングがどう変化するかを確認してから、サフィックスやキーワードに範囲を広げるか判断します。一時ルールを削除して再テストすれば、最終的な設定がデバッグ用の例外に依存していないことを確認できます。
アドレス・リクエストルール:IP-CIDR、IP-CIDR6、GEOIP、USER-AGENT
ドメインルールは名前に基づいて分類し、アドレスルールは接続先のアドレスに基づいて分類します。その結果が異なることもあります。同じ名前でもネットワークや DNS サーバーによって異なるアドレスが返され、同じアドレスが複数の名前のサービスを提供する場合もあります。サービス名に基づいて接続先を区別する場合は、一般にドメインルールのほうが管理しやすく、特定のローカルネットワークや固定アドレスを対象にする場合は、プレフィックスルールが直接的です。「ドメインを正しく設定したのに別の経路になる」場合は、今回の接続で元のホスト名、IPv4 アドレス、IPv6 アドレスのどれが使われたかを確認してから、ルール順を調べてください。
IP-CIDR と IP-CIDR6:プレフィックス長で範囲を指定
[Rule]
IP-CIDR,192.168.50.0/24,DIRECT
IP-CIDR,192.168.0.0/16,PROXY
IP-CIDR6,2001:db8:20::/48,DIRECT
FINAL,DIRECT
/24 は IPv4 アドレスの先頭24ビットを固定し、/16 は先頭16ビットを固定します。この例では、重複時の例外の選ばれ方を示すため、範囲の狭いネットワークを広いネットワークより前に記述しています。ほかのプライベートネットワークをすべてプロキシ経由にする設定ではありません。2行目を1行目より前に置くと、192.168.50.8 は先に広いネットワークに一致し、より具体的な /24 を理由にポリシーが再選択されることはありません。IPv4 アドレス1つだけに一致させる場合は /32、IPv6 アドレス1つだけの場合は /128 を使います。
IP-CIDR6 は IPv6 のプレフィックスを扱います。この例には説明用のネットワーク範囲を使っているため、実際のサービスのアドレスとしてそのまま使用しないでください。デュアルスタックのネットワークでは、あるテストは IPv4、次のテストは IPv6 で接続する場合があります。IPv4 の一致だけでは、両方の経路に同じポリシーが適用されているとは判断できません。LAN 内の機器が対象の場合は、機器の管理画面やネットワーク設定でサブネットを確認し、同じネットワークからアドレスに到達できるかテストしてください。DIRECT はプロキシを経由せずに転送する指定であり、現在のネットワークに接続先ネットワークへの経路を追加するものではありません。
名前で指定された対象に IP 条件を適用する場合、照合時に名前解決が関わることがあります。そのオプションに対応していることを確認したアドレスルールでは、IP-CIDR,192.168.50.0/24,DIRECT,no-resolve を使うことで、そのルールのために名前解決を行うのを避けられます。これは全体に適用される DNS 設定ではなく、ほかの処理で名前解決が行われるのを防ぐものでもありません。有効にした後、アドレスを直接入力すると一致するのに、名前を入力すると一致しない場合も、すぐにルールの不具合と判断しないでください。2つの入力で、その条件を判定するための情報がそろっているかを比べます。
GEOIP:IP アドレスの分類はサービスの帰属を示すものではない
[Rule]
DOMAIN,api.example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
GEOIP,CN,DIRECT は接続先 IP アドレスのデータベース上の分類を判定するもので、言語、トップレベルドメイン、端末の所在地、アカウントのストア地域で分類するものではありません。共有インフラや近接拠点を使うサービスでは、同じドメインでもネットワークが変わると異なるアドレスが返り、適用されるポリシーも変わることがあります。自分が管理するサービスに安定した経路を適用する必要がある場合は、地域ルールより前にそのドメインの例外を設定し、地域条件をサービスの定義として扱わないでください。トラブル対処では、テスト時の接続先アドレスを記録します。「昨日はこのドメインに直接接続できた」だけでは不十分です。
USER-AGENT:リクエスト識別情報が取得できる場合にのみ判定
[Rule]
USER-AGENT,ExampleDesktop*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
USER-AGENT は取得できるリクエスト識別情報に一致するもので、プロセス名やシステム権限、接続元アプリの識別情報ではありません。異なる2つのリクエストが同じ識別情報を送信する場合もあれば、同じアプリが機能によって異なる識別情報を送信する場合もあります。この項目がリクエストに含まれない、確認できない、または接続が HTTP を使用していない場合、このルールに一致することは期待できません。この例は、想定した識別情報を自分のテスト環境で確認する場合に限って使用してください。特定のサービスに常に同じポリシーを適用したい場合は、個別に確認できるドメインまたはアドレスを優先します。
ポリシーとルーティング:PROXY、DIRECT、REJECT の動作
Global Routing とルール内のポリシーは異なる階層にあります。前者はクライアントに入る接続の処理方法を選び、後者は Config の状態で各ルールが指定する処理結果です。ルールファイルを検証する際に、Home の Global Routing が Proxy または Direct のままでは、観察した接続経路からファイル内のルール順を確認することはできません。トラブル対処の前に状態を記録し、同じリクエストを再現して比較してください。
| モード | 処理方法 | 確認できること |
|---|---|---|
| Config(設定) | アクティブな設定に従って振り分ける | ルール条件、順序、デフォルトポリシー |
| Proxy(プロキシ) | 対象となる接続にプロキシ経路を適用 | 選択したサーバーから同じ接続先にアクセスできるか |
| Direct(直接接続) | 対象となる接続に直接接続の経路を適用 | 現在のネットワークから同じ接続先に直接アクセスできるか |
PROXY:ルールへの一致とサーバーへの接続を分けて確認
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
PROXY は、一致した接続をプロキシ経路に送る指定です。サーバーを自動作成したり、サブスクリプションが現在も利用できるか確認したりするものではありません。PROXY に一致しても、サーバーへの接続不可、認証情報の不一致、接続先サービスの異常、アプリのタイムアウトなどが原因で失敗する場合があります。自分が利用できるサーバーでテストし、まず Home で選択中の項目を確認してから、Connectivity Test も参考にしてください。テストで応答があったとしても、その条件で応答したことを示すだけで、すべてのサービスへの接続を保証するものではありません。Config と Proxy を比較するときは、同じサーバー、ネットワーク、接続先を使ってください。条件が異なると、結果の差をルールに帰属できません。
DIRECT:クライアントを一時停止する設定ではない
DIRECT は接続先への通信をプロキシサーバー経由で転送しない指定です。現在のネットワークから接続先への名前解決と通信は引き続き必要です。local.example.com が直接接続に一致しても開けない場合は、端末がそのサービスにアクセスできるネットワークに接続しているか、名前解決の結果が想定どおりか、サービスが稼働中かを確認してください。Direct に切り替えて比較することはできますが、クライアントを終了した後の結果を DIRECT ルールと同じものとして扱わないでください。終了後はアクティブな設定による処理が行われず、名前解決の設定なども変わる可能性があります。
同じページでも、メインリクエストと付随するリクエストがそれぞれ直接接続とプロキシに分かれることがあります。検証では、ページタイトルが表示されるかだけで判断せず、これまで問題があったログイン、一覧の更新、添付ファイルの読み込みなどもテストしてください。依存する処理が1つでも完了しなければ、アプリには一般的な接続エラーが表示されることがあります。その処理に必要なドメインを個別に確認するほうが、機能全体のモードを切り替えるより、必要なルール範囲を判断しやすくなります。
REJECT:一致すると処理を終了し、失敗後に次のルールを試すわけではない
REJECT は、一致したリクエストをブロックします。この例では blocked.example.com をブロックするため、完全一致の条件をサフィックスのプロキシルールより前に置いています。その後、アプリが予備ホストなどへの別のリクエストを送信した場合は、そのリクエストが独立して評価されます。元のリクエストが REJECT から次の行へ自動的にフォールバックしたわけではありません。アプリには読み込み失敗、即時エラー、再試行などが表示される場合がありますが、表示だけではブロックが有効になったか判断できません。
ドメインルールでホストをブロックすると、そのホスト上で条件に一致する正常なリクエストにも影響します。対象のリクエストと正常なコンテンツが同じホストを使う場合、ドメインだけで2つを区別することはできません。設定のコピーで完全一致のルールを1つ使って検証し、ブロックするリクエストと許可するリクエストをそれぞれ確認してください。両者を区別できない場合は、メインドメイン全体に対象を広げないでください。例と適用範囲についてはREJECT ルールの設定方法をご覧ください。
評価順序:最初の一致、例外、FINAL
Config モードで通常のルールを理解するには、まず「上から順に評価し、最初に一致したルールのポリシーを適用する」と覚えてください。ルールの種類によって優先順位が自動的に並び替わることはありません。完全一致のドメインも、先に記述されたサフィックスルールより自動的に優先されず、長いアドレスプレフィックスも、先に記述された広いネットワークより自動的に優先されません。同じ端末で同じルール一式を含む2つの設定を使っていても、順序が異なれば結果が変わることがあります。
例外を先に、例外を含む汎用ルールを後に記述
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN,unused.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
対象が login.example.com なら、1行目で評価が終了します。unused.example.com は2行目に一致し、files.example.com は3行目に一致します。3行目に一致したドメインは、GEOIP,CN に一致するアドレスに解決されても、後続ルールで結果が上書きされることはありません。逆に、地域ルールを前に置くと、ドメイン単位で処理するつもりの接続が先に分類される場合があります。順序を確かめるには、結果がたまたま同じになる対象だけをテストせず、重複する2つのルールが異なるポリシーを指定するサンプルを用意してください。
順序を検証するときは設定をコピーし、関連する2つのルールだけを入れ替えて、DNS、サーバー、末尾のポリシーは変えないでください。保存後、そのコピーに切り替わっていることを確認し、例外ホスト、汎用サフィックスに一致するホスト、どちらにも関係しないホストをそれぞれテストします。例外だけをテストすると、例外は機能しても汎用ルールが遮られていることに気づけない場合があります。汎用ホストだけのテストでは、例外が一度も評価されていないことがわからない場合があります。対象外のサンプルも役立ち、広い範囲のルールが無関係なアクセスに影響していないか確認できます。
FINAL で未一致時のデフォルト処理を明示
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
この設定では、指定したドメインとそのサブドメインをプロキシに送り、それ以外は直接接続します。FINAL,DIRECT を FINAL,PROXY に変更すると、開けない特定のホストだけでなく、それまで一致しなかった対象の接続すべてに影響します。設定を作る前に「一覧にない対象はどこへ接続するか」を言葉で明確にし、そのうえでデフォルトポリシーを選んでください。設定を統合するときは FINAL を1つ明確に残して末尾に置き、既存の FINAL より後ろに追加ルールを記述しないでください。
FINAL に一致したリクエストを調べるときは、まずその接続が本来デフォルト処理の対象でよいか確認してください。そうでない場合は、接続先が別のサブドメインではないか、アドレスを直接使っていないか、リダイレクトされていないか、またはクライアントが取得できないリクエスト属性を条件としていないかを確認します。漏れていた対象に具体的なルールを追加するのは照合範囲の修正です。FINAL の変更は設定全体のデフォルトポリシーの変更であり、両者は置き換えられません。
2つのルールセットを統合する前に、重複と先行ルールによる遮蔽を確認
統合後のテキストで、具体的な例外ルールごとに、その対象に一致する広い範囲のルールが前にないか確認します。同じ対象の重複行も調べてください。たとえば DOMAIN,api.example.com が2行あり、異なるポリシーを使っていても、後の行が優先されることはありません。先に記述された行が検証対象です。範囲が重複していても、狭い範囲が広い範囲より前にあり、異なるポリシーを指定しているなら、例外として意図した構成です。逆に、広い範囲が前にありポリシーも同じなら、後の具体的な行が冗長な場合があります。削除する前に、メンテナンス用の説明や今後の例外として必要か確認してください。
ルールは、単一ホストの例外、ドメインサフィックスによる分類、アドレスまたは地域による分類、デフォルトポリシーなど、目的ごとに明確な小さなグループに分けます。この順序は必須のテンプレートではありません。特定のプライベートネットワークを一部のドメインより優先したい場合は、その意図に合わせて配置し、名前解決に依存する条件も記録してください。優先順位は暗記するものではありません。特定の接続先に対して、どのルールが一致しないか、どれが一致するか、その後どのルールが評価されなくなるかを順に説明できることが重要です。
よくある組み合わせ:リストによる振り分け、LAN の例外、完全一致のブロック
以下の各設定例は個別の参考例です。つなげて1つの設定ファイルにしないでください。それぞれデフォルトの処理を示したうえで、例外と検証方法を説明しています。自分の端末で使う場合は、確認済みのドメインとネットワーク範囲だけを置き換えてください。プロキシを使う場合は、自分が利用できるサーバーを指定します。使用中のファイルに [Host] や [URL Rewrite] が含まれる場合、組み合わせルールをテストするときはそのセクションを変更せず、アドレス割り当てやリダイレクトの変化をルールの効果と取り違えないようにしてください。
組み合わせ例1:明示したサービスだけをプロキシ経由にする
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,assets.example.net,PROXY
FINAL,DIRECT
デフォルトは直接接続で、プロキシを使う対象が少数の業務用サービスに限られる設定に適しています。まずログイン用ホストへの直接接続を確認し、次に業務用ドメインのサブドメインがプロキシを使うことを確認してから、別ドメイン上の独立したリソースの処理も確認します。ホームページが表示されるかだけで判断しないでください。キャッシュされた内容だけが表示され、認証や静的リソースには別の接続が使われている可能性があります。新規または独立したセッションで、ログイン後に未表示のページを開くなど一連の操作を再現し、メインリクエストとリソースリクエストの結果を記録するのがおすすめです。
リソース用のドメインを追加する場合は、同じドメインの別用途までプロキシ経由にしないよう、まず DOMAIN から始めます。テストでサブドメインも同じ用途だと確認できたら、DOMAIN-SUFFIX に広げてください。ブラウザーとアプリで同じサービスへのアクセス結果が異なる場合は、それぞれの接続先とエラーが発生した段階を比較します。一方で開けたからといって、もう一方も同じルールに一致したとは限りません。
組み合わせ例2:既知の LAN アドレスは直接接続にする
[Rule]
DOMAIN,printer.example.com,DIRECT
IP-CIDR,192.168.50.0/24,DIRECT
FINAL,PROXY
この例ではデフォルトをプロキシにし、既知のホスト名と実際に使うプライベートネットワーク範囲に、それぞれ直接接続の条件を設定しています。同じ自分の機器にホスト名とアドレスの両方で接続すると、名前解決の問題と接続経路の問題を区別しやすくなります。アドレスでは接続できるのに名前ではできない場合は、その名前が想定したアドレスに解決されているか確認します。名前では接続できるのに特定のアドレスではできない場合も、入力したアドレスが現在の機器のものか、古いアドレスや管理画面に表示された別インターフェースのアドレスではないかを確認してください。
家庭内ネットワークからモバイルネットワークに切り替えると、接続先に到達できなくなることがあります。Wi-Fi ネットワークを切り替えた場合、同じプライベートアドレスが別の機器を指す可能性もあります。そのためにすべてのプライベートアドレスを例外に追加したり、接続できなくなった原因を FINAL に求めたりしないでください。アプリがローカル機器の検出を必要とする場合は、システムでアプリに許可したローカルネットワークアクセスと、機器が接続しているネットワークを確認します。直接接続ルールだけでは、ブロードキャスト、検出、実際の接続がすべて成功するとは限りません。
組み合わせ例3:特定のホストだけをブロックし、同じドメインの業務通信は維持
[Rule]
DOMAIN,telemetry.example.com,REJECT
DOMAIN,updates.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
この例では指定したホストだけをブロックし、同じサフィックスを使う更新や業務用リクエストはブロックしません。テスト前に、失敗してよい操作と成功させる必要がある操作を明確にします。指定ホストへの接続が想定どおり拒否されることを確認し、更新用ホストや通常の業務用ホストが引き続き利用できることも確認してください。クライアントの記録で拒否が確認できてもアプリで同じ操作を完了できる場合、キャッシュ、予備ホスト、別の通信方式を使っている可能性があります。実際の接続先を確認し、ドメイン全体に対象を広げないでください。
ブロックルールによって頻繁な再試行、追加のエラー表示、機能低下が生じた場合は、まず設定のコピーからその行を外して比較します。外すと復旧した場合でも、その行が症状に関係していることしかわかりません。ブロック対象そのものを止めたのか、同じホストに依存する別の処理にも影響したのかを調べる必要があります。ドメインで区別できないとわかったら、正常な機能を維持し、曖昧な DOMAIN-KEYWORD を追加し続けないでください。組み合わせルールは、実際の接続先と想定した処理が一致するかで検証します。ルールの数を増やすことが目的ではありません。
検証とトラブル対処:設定、名前解決、ポリシー、接続の問題を切り分ける
トラブルが起きたら、再現できる操作を記録します。端末のネットワーク、アクティブな設定名、Global Routing のモード、Home で選択したサーバー、問題が発生したアプリの操作、わかっている接続先を記録してください。サブスクリプションの URL、パスワード、サーバーの認証情報は記録しないでください。「アプリを開けない」より、「再起動後、自分が管理するサービスへのログインリクエストを送信すると失敗する」のように具体的に記録すると、説明と実際の接続を対応させやすくなります。接続情報や診断情報を確認できる場合は、接続先、ポリシー、結果の3点を優先して保存し、無関係な情報を集めないでください。
手順1:設定がルーティングに使われているか確認
接続状態を確認してから、Home の Global Routing と Config で現在使用中のファイルを確認します。同名のバックアップを編集した、下書きだけを保存した、インポート後に選択していない、といった場合は想定したルールが反映されません。ネットワーク切り替え後に問題が発生した場合は、接続が復旧してからテストしてください。切断直後の状態をルールによる拒否と混同しないでください。テストごとに新しいリクエストを送信します。再利用中の接続、ブラウザーのキャッシュ、確立済みのアプリセッションは、変更したばかりのルールを判断するのに適していません。
初期設定と初回接続の手順は使い方ガイドをご覧ください。Home に利用できるサーバーが1つも表示されない場合は、自分の Subscribe 情報または個別のサーバー情報が正しくインポートされているかを先に確認してください。リストが空の場合はサブスクリプションの解析失敗とリストが空のときの確認手順をご覧ください。データの取得元の問題を解決するために FINAL をむやみに変更しないでください。ルールでプロキシ経路は選べますが、欠けているサーバー情報を補うことはできません。
手順2:制御可能な1つの接続先で最小限の比較を行う
[General]
dns-server = system
[Rule]
DOMAIN,check.example.com,PROXY
FINAL,DIRECT
設定のコピーで check.example.com を、自分がテストできるホスト名に置き換え、現在選択中のサーバーは変えないでください。対象は完全一致のドメインルールに一致し、それ以外の接続はデフォルトで直接接続されると予測してからテストします。予測と結果が異なる場合は、実際の接続にそのホスト名が使われたかを確認してください。リダイレクト後に別のホストが使われている場合があります。その後、同じ接続先への Direct と Proxy の結果を比較します。単発の速度テストは実際のサービス利用とは異なるため、できる限り同じリクエスト、同じネットワーク、同じ時間帯で比べてください。
Proxy でも同じ接続先にアクセスできない場合、原因がルール順とは限りません。サーバーが稼働中か、インポートした情報がサービス提供元から渡された内容と一致するか、同じサーバーからほかの既知の接続先にアクセスできるかを確認してください。Config だけが失敗し、Proxy と Direct ではアクセスできる場合は、Config の一致条件、先行する REJECT の有無、設定に追加された Host や URL Rewrite を重点的に確認します。モードの切り替えは診断のために行い、完了したら検証対象の状態に戻してください。
手順3:症状から確認範囲を絞る
想定したアドレスが得られない場合は、まず名前解決と [Host] を確認します。アドレスは得られるのに接続を確立できない場合は、ルーティング、ネットワークへの到達性、サービスの状態を調べます。接続が確立した後に証明書の警告、リダイレクトループ、サービス側のエラーが発生する場合、すぐにサーバーが利用できないと判断しないでください。DNS キャッシュ、アプリのキャッシュ、接続の再利用はそれぞれ別の要因です。1つを消去しても、ほかの要因まで必ず解消されるわけではありません。変更は一度に1つにし、識別できる新しいリクエストを送信すれば、変更前後を比較できます。
ログや画面に必要な一致情報が表示されなくても、記録がないことを未一致と判断しないでください。管理下の設定で比較できます。まず異なるデフォルトポリシーを指定した完全一致ルールを1つ使って対象を切り分け、同じ環境で元の設定に戻します。結果が異なる場合は、元の設定からルールやほかのセクションを少しずつ戻していきます。再現する前にすべてのルールや設定をリセットしないでください。動作が戻っても、どの行が原因だったのか特定しにくくなります。
管理とロールバック:設定の入手元、ルール変更、再テスト用サンプル
ルールを長く使うには、デフォルトポリシーが明確で、例外を追跡でき、変更を元に戻せることが重要です。普段使うファイルと検証用のコピーを分け、サービスに問題が起きたら検証済みの設定に戻してから、コピーで原因を調べてください。以前の設定に戻しても、サーバーの状態まで以前に戻るわけではありません。サーバーの選択、サブスクリプションの更新、現在のネットワークが変わっている可能性があります。ロールバックのたびに、現在使用中のファイルと Home の選択項目を確認し、以前のサンプルで再テストしてください。
設定ファイルとサーバーリストを区別する
Config のルール設定は振り分けと関連設定を定義し、Subscribe からインポートしたサーバーリストは接続先を提供します。ルール設定のコピーを保存しても、サーバーの認証情報が保存されるわけではありません。サーバーリストの更新も、特定のルール条件を修正する方法ではありません。利用中のリモート設定を提供元が管理していて、ローカルで例外を追加する必要がある場合は、元の情報を記録したうえで作業用コピーとして別に保存してください。リモートの内容を再取得したら、新たな統合として変更点を確認し、ローカルの編集が保持されると決めつけないでください。
2つの設定ファイルを比較するときは、まず [General]、[Host]、[URL Rewrite] に変更がないか確認し、次に [Rule] の追加、削除、順序変更を確認します。両方の設定をインポートできても、テキストが受け入れられたことを示すだけで、動作が同じとは限りません。特に、広い範囲のルールが例外より前に移動していないか、デフォルトポリシーが変わっていないか、ドメインルールで処理されていた接続が、経路の決定に名前解決後のアドレスを必要とするようになっていないかを確認してください。
変更ごとに検証可能な期待結果を設定
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
期待する動作は「ステータス確認用ホストは引き続き直接接続、業務用サブドメインはプロキシ、無関係なホストは引き続き直接接続」のように具体的に記述します。「ルールを最適化した」では、何をテストすべきかわかりません。この例なら少なくとも3つの接続先を確認します。LAN の例外を変更する場合は、許可範囲外のアドレスもサンプルに追加してください。IPv6 の条件を変更する場合は、テストで実際に IPv6 が使われたことを確認します。ブロックルールを変更する場合は、同じドメイン上で許可する必要のある機能もテストします。例示のドメインやネットワーク範囲は接続テスト用ではありません。自分で管理し、期待結果がわかっている接続先を使ってください。
特に重要なサービスでは、ホームページを開くだけでなく、再現可能な業務操作を1つ検証項目として残します。ログイン例外を変更したら、少なくとも一度ログインして業務ページに戻る操作を行います。ファイルサービスのルールを変更したら、実際のリソースを1つ取得してください。テスト前に、以前のセッションが接続の変化を隠さないようにします。サンプルが失敗した場合は、その時点の接続先、選択されたポリシー、名前解決に成功したかを記録します。条件が記載されていない「成功・失敗」の一覧より役立つ情報です。
ファイル全体を連続して変更せず、変更を1つずつ戻す
統合後の設定で問題が発生した場合は、まず検証済みの直前のアクティブな設定に戻し、業務が復旧するか確認します。復旧する場合は、問題のある設定から変更を1つのグループずつ取り消します。たとえば、ほかのルールを残したまま先に FINAL を元に戻し、問題が続くか確認します。設定を戻しても業務が復旧しない場合、現在のネットワーク、サーバーの変更、アプリの状態なども関係している可能性があります。その場合は検証とトラブル対処に戻り、無関係なルールを削除し続けないでください。
自分の別の端末で使う前に、画面上の機能、設定の入手元、現在のネットワーク条件をもう一度確認してください。サンプルをコピーしても、テキストが移るだけで、端末の権限、DNS 環境、選択中のサーバーは同期されません。ドキュメントにはポリシーの意図、ルールの範囲、ロールバックの手順を記録できます。個人用のサブスクリプション URL や認証情報は、別途安全に保管してください。アクティブなファイルを使ってルールの一致を再現でき、失敗した段階を説明でき、検証済みの動作に戻せるなら、その設定は保守可能な基準として運用できます。