01 設定ファイルの構成と編集範囲
Shadowrocketの設定ファイルは、接続がクライアントに届いた後の処理方法を定めるもので、サーバー認証情報の一覧ではありません。Subscribeから取り込む内容は通常サーバー項目の管理に使い、Configで選ぶファイルはルールや関連設定を管理します。それぞれ個別に更新できます。「サブスクリプションの更新は成功したのに通信先が変わらない」場合は、同じサブスクリプションを何度も読み込むのではなく、まず現在の設定を確認してください。サーバー情報は接続先を、ルールはリクエストに適用するポリシーを決めます。
セクション見出しで構成を整理する
設定ファイルでは角括弧でセクションを示します。例:[General]、[Rule]。Generalにはキーと値の形式で設定を記述し、Ruleには通常、1行につき1つのルールを英語のカンマ区切りで記述します。セクション見出しは単なるコメントではありません。見出しを省略すると、後続の内容が誤ったセクションに含まれる場合があります。全角カンマや全角イコール、リッチテキストからコピーした特殊な空白があると、正しく見える行でも想定どおりに解析されないことがあります。
[General]
bypass-system = true
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY
これは構成の例であり、あらゆるネットワークで使える完全な設定ではありません。bypass-systemはシステム通信をバイパスする動作に関わり、dns-server = systemはシステムが提供するリゾルバーを使う設定です。どちらもサーバー情報を補うものではなく、すべての接続が必ずRuleを通ることを保証しません。設定を読むときは、まず通信の入口とバイパス条件を確認し、次にルール一覧を見てください。最後の数行だけに注目しないようにしましょう。
よく使う4つのセクションと役割
| セクション | 主な役割 | 確認ポイント |
|---|---|---|
[General] | ネットワークと名前解決の共通設定 | DNSの参照元とバイパス条件が現在のネットワークに合っているか |
[Rule] | リクエストに一致するルールを確認し、ポリシーを選択 | ルールの順序、対象フィールド、FINAL |
[Host] | 指定したホスト名にローカルの名前解決結果を設定 | アドレスが有効か、通常の名前解決を上書きしていないか |
[URL Rewrite] | URLの式に基づいて書き換えやリダイレクトを実行 | 式の適用範囲、転送先、動作条件 |
機能を使わない場合、設定を完全に見せるためだけに該当セクションを追加する必要はありません。特に、出所の分からないHostや書き換え設定をコピーしないでください。古いマッピングは通常の名前解決を迂回させ、広すぎる書き換えはログインやリダイレクトの動作を変える可能性があります。設定は短ければよいというわけではありませんが、各項目の用途、影響範囲、元に戻す方法を説明できるようにしましょう。
編集・保存・有効化は別々の操作
Configで実際に使用中の設定を探し、まず複製を保存して、用途を見分けられる名前を付けてから編集します。テキストを保存したらエラー表示を確認し、設定一覧に戻って選択状態を確認してください。有効になっていない複製を編集しても、現在のルール分けには反映されません。別のリモート設定を有効にしても、それまでのローカル変更が自動的に統合されるわけではありません。接続の再確立が必要な設定を変更した場合は、切断してから再接続し、新しいリクエストで確認してください。
リモート設定には、更新時に変更が上書きされる問題もあります。更新で置き換えられるファイルを直接編集すると、次回の更新でカスタムルールが失われる可能性があります。ファイルの更新方法を確認してから、独立したローカルコピーを使うか、アプリが対応する保持機能を使うか決めてください。名前が似ていて内容の異なる有効候補を複数管理するのは避けましょう。トラブルシューティングでは、最近どのファイルを編集したか覚えておくより、「ファイル名、選択状態、変更内容」を記録するほうが確実です。
プラットフォームやビルドによって設定画面の場所が異なる場合があります。ここでは設定の意味を説明し、画面をピクセル単位で案内するものではありません。現在のクライアントが認識しない項目は元に戻し、アプリ内の案内を確認してください。エラーを解消しようとしてパラメーターを次々と追加しないでください。初めて操作する場合はガイドの設定・確認手順に戻り、具体的な疑問はFAQで症状から探してください。
02 ルールの優先順位、上書き関係、FINAL
ルール分けで最も重要なのは、リクエストが設定ルールの処理対象になっている場合、Ruleは通常上から順に確認され、最初に一致したルールのポリシーが適用されるという点です。すべての一致結果を集めてから「最も正確そうな」ルールを選ぶわけではありません。そのため、ルールの内容だけでなく位置も重要です。広い範囲のルールより下に例外を書いても、その例外は実質的に機能しないことがあります。
例外を先に、広い範囲のルールを後に書く
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
FINAL,PROXY
この例では、login.example.comは最初の行に一致してDIRECTになり、example.comに属するその他のドメインは2行目に一致する可能性があります。最初の2行を入れ替えると、ログイン用ドメインも先にサフィックスルールに一致し、後続のDOMAINルールでその判定を変えることはできません。DOMAINがDOMAIN-SUFFIXより本質的に優先されるわけではありません。ここでの優先順位は記述順で決まります。
3行目は別の上書き関係も示しています。example.comのサブドメインにadsが含まれていても、2行目にすでに一致しているため、後続のキーワード拒否ルールは実行されません。まず目的を明確にしてください。ドメイン全体をPROXYにするのか、広告に関するキーワードを優先して拒否するのか。順序に目的から独立した正解はありませんが、条件が重なるリクエストにどの行を適用するのか説明できる必要があります。
FINALは最終的な受け皿であり、強制的な上書きではない
FINAL,PROXYは、それ以前のルールで通信先が決まらない場合にPROXYを適用する指定です。ドメイン条件はなく、前のルールの誤りを修正するものでもありません。FINALをルールの途中に置くと、後続のルールで処理できるはずの通常のリクエストが届かなくなります。通常はRuleの末尾に置き、内容が明確な兜底を1つだけ残してください。FINALを重複させると読み取りづらくなります。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
ここではまずドメインを確認し、次に宛先アドレスの地理データベース分類を確認し、それ以外のリクエストには最後のルールを適用します。ドメインがGEOIPでCNに分類されるアドレスに解決されても、先にサフィックスルールに一致すればPROXYになります。逆に、ドメイン情報を取得できずドメインルールに一致しない場合は、アドレスルールを確認する必要があります。結果を検証する前に、その時点で照合可能だった情報がホスト名かアドレスかを確認してください。
ルールの順序とバイパス条件は別のもの
「上から順に」は、このルール一覧に入った後の処理を示します。一覧がすべてのシステムルーティング、共通のバイパス設定、既存の接続を制御するという意味ではありません。より前の処理経路でバイパスされた通信は、Ruleの行を移動しても対象に戻りません。LANへのアクセスを調べるときは、Generalのバイパス設定、システムのルーティング、RuleのDIRECTを区別してください。似た動作に見えても処理される段階が異なります。
ルールを切り替えた後も、既存の長時間接続が以前の経路を使い続ける場合があります。ブラウザーの接続再利用、アプリのバックグラウンド接続、ドメイン名のキャッシュなどがあるため、一度更新しただけでは新しいルールが効かないとは判断できません。対象への新しい接続を発生させ、必要に応じて対象アプリを終了してから再試行し、記録された宛先ドメイン、一致ルール、ポリシーを照合してください。ページが開くかどうかだけで優先順位を判断すると、サーバーの状態とルールの問題を混同します。
反例を使って優先順位を検証する
例外を1つ追加するたびに、少なくとも2つのテスト対象を用意してください。新しいルールに一致するべき対象と、似ているが一致してはいけない対象です。たとえばlogin.example.comを変更したら、api.example.comもテストします。アドレス範囲を追加したら、その範囲外のアドレスも確認します。これにより「ルールが効かない」と「ルールの範囲が広すぎる」の両方を見つけられます。一度アクセスに成功するかだけを見るより、確実に判断できます。
03 ドメイン・アドレス・リクエスト属性のルール
ルールの種類によって、リクエストのどの情報を照合するかが決まります。ドメイン系はホスト名、アドレス系は宛先IP、USER-AGENTは取得可能なリクエスト識別情報を参照します。これらは同じ情報の異なる書き方ではなく、自由に置き換えられるものでもありません。種類を選ぶ前に、「完全なドメイン、ドメイン全体、アドレス範囲、識別可能なリクエストのどれを対象にしたいか」を確認し、適切な構文を選びます。
DOMAINとDOMAIN-SUFFIX
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.net,DIRECT
DOMAINはapi.example.comというホスト名への完全一致に適しており、img.api.example.comには自動的に一致しません。DOMAIN-SUFFIXはドメインのサフィックスに使います。example.net自体とそのサブドメインが対象になり、notexample.netはexample.netのサブドメインではありません。ドメイン欄にプロトコル、パス、ポート、末尾のスラッシュを含めないでください。これらはドメイン照合の対象ではありません。
同じWebサイトのログイン、画像、APIを分けて扱う場合は、すべてがメインドメイン配下にあると想定せず、実際のリクエストから各ホスト名を確認してください。最新のアプリではリソースごとに異なるドメインを使うことがあり、1つのページでも複数の接続が発生します。メインページでルールに一致したことが分かっても、そのページの全リソースが同じポリシーになるとは限りません。
DOMAIN-KEYWORDは広い範囲に一致する
DOMAIN-KEYWORD,ads,REJECT
このルールは、ドメインにキーワードが含まれる場合の一致方法を説明する例であり、一般的なブロックの推奨ではありません。adsは単なる文字列の一部なので、拒否する必要のないドメインにも含まれている場合があります。キーワードルールは通常、サフィックスルールより範囲を限定しにくいため、設定前に誤一致の例を確認してください。対象の完全なドメインや安定したサフィックスが分かっている場合は、より明確なルールを使うと管理しやすくなります。
IP-CIDR、IP-CIDR6、GEOIP
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
GEOIP,CN,DIRECT
IP-CIDRはIPv4アドレスとプレフィックス長でネットワーク範囲を表し、IP-CIDR6はIPv6を扱います。プレフィックスはポート番号ではなく、任意に省略できる注記でもありません。範囲を広く取りすぎると、無関係な宛先アドレスまで含まれる可能性があります。例にあるプライベートアドレスやIPv6のリンクローカルアドレスは用途を示すものです。DIRECTにするかどうかはシステムルーティングや接続中のネットワークも考慮し、すべての内部アドレスに到達できると判断しないでください。
no-resolveは、このアドレスルールのためだけにドメインを積極的に名前解決しないという意味です。リクエストに宛先IPがすでにある場合は、引き続き照合できます。クライアント全体のDNSを無効にする設定ではなく、すべてのドメインリクエストが自動的にプライベートアドレス範囲に一致するという意味でもありません。GEOIPはアドレスデータベースの分類に依存しており、Webサイトの言語、企業の登記地、ユーザーの所在地を示すものではありません。データベースの違いやアドレス割り当ての変更によって結果が変わることもあります。
USER-AGENTと取得可能な情報の範囲
USER-AGENT,ExampleApp*,DIRECT
USER-AGENTは取得可能なUser-Agent識別情報との照合に使います。例のExampleAppは架空のテスト名で、アスタリスクはワイルドカードでの照合を示します。OSのアプリパッケージ名を指定するルールではなく、暗号化されたすべてのリクエストを識別できるわけでもありません。接続時に該当するリクエストヘッダーを取得できなければ、照合できる情報がありません。アプリ名が例に似ているからといって、そのアプリのすべての接続に一致するとは限りません。
| 種類 | 照合対象 | よくある誤り |
|---|---|---|
| DOMAIN | 完全なホスト名 | 完全なURLを記述する |
| DOMAIN-SUFFIX | ドメインとサブドメイン | 任意の文字列で終わると誤解する |
| DOMAIN-KEYWORD | ドメイン内の文字列 | 誤一致の範囲を過小評価する |
| IP-CIDR / IP-CIDR6 | 宛先アドレスのネットワーク範囲 | アドレス範囲をドメイン範囲と混同する |
| GEOIP | 宛先アドレスのデータベース分類 | Webサイトの言語から結果を推測する |
| USER-AGENT | 取得可能なリクエスト識別情報 | アプリ単位の汎用ルール分けと誤解する |
| FINAL | 先行ルールに一致しなかったリクエスト | ルール一覧の途中に置く |
2種類のどちらでも要件を満たせる場合は、意味が明確で、前提条件の少ない方を選びます。ドメインの例外にはDOMAIN、ドメイン全体にはDOMAIN-SUFFIX、明確な内部アドレス範囲にはCIDRを使うのが一般的です。広い範囲を対象にする必要がある場合に限りキーワードを検討し、各広範囲ルールに一致してはいけない反例を用意してください。ルールの数が増えるにつれて誤りが見えにくくなるのを防げます。
04 PROXY、DIRECT、REJECTとGlobal Routing
ルールは「どのリクエストに一致するか」を、ポリシーは「一致後にどう処理するか」を決めます。このページで扱うPROXY、DIRECT、REJECTは基本的なポリシーキーワードで、設定内では英大文字のまま記述します。これらは画面上のConfig、Proxy、Directとは別の階層です。前者はルールのアクション欄で使い、後者はGlobal Routingの動作モードです。この2つを混同すると、「ルールを書いたのに適用されない」という問題につながります。
3つの基本ポリシー
PROXYは、一致した接続にプロキシ経路を使う指定です。実際に使われるサーバーや関連ポリシーは、Homeでの選択と現在の設定を確認してください。PROXYを書いただけで使用可能なサーバーが用意されるわけではなく、認証、転送方式、接続先へのアクセスが成功する保証もありません。サーバーの選択違い、認証情報の期限切れ、接続先への到達不能があれば、ルールは正しく一致していても接続に失敗することがあります。
DIRECTは選択中のプロキシサーバーを経由せず、接続先へ直接接続する指定です。端末のネットワーク、DNS、システムルーティング、接続先サービスの状態には引き続き依存します。「ネットワークの問題をすべて回避する」という意味ではありません。たとえば内部管理ページにアクセスする場合、DIRECTが選ばれていても、端末が該当するLANに接続されていなければ接続できません。トラブルシューティングでは、「DIRECTが選ばれたこと」と「DIRECTで到達できること」を分けて確認してください。
REJECTは一致した接続を拒否します。想定される結果はリクエストの失敗やリソースの読み込み停止であり、別の経路へ自動的に切り替えるものではありません。アプリが拒否されたリクエストを繰り返し再試行し、ログが増えることがあります。また、基本機能に必要な接続が拒否されると、アプリ全体に問題が起きる場合もあります。このような現象が発生したら、ページが開かないだけでサーバーの障害と決めつけず、まず拒否された接続先を特定してください。
Global Routingの3つのモード
| 画面上の用語 | 日本語での説明 | 確認内容 |
|---|---|---|
| Config | Config:現在の設定に従ってルール分けする | Rule、優先順位、最終ルールを確認 |
| Proxy | Proxy:引き受けた通信をプロキシモードで処理する | 一時的にルールの違いを切り分ける |
| Direct | Direct:引き受けた通信を直接接続モードで処理する | 端末のネットワークでの接続結果を比較 |
カスタムルールの日常的な確認にはConfigを選びます。Proxyは「プロキシ経路自体が動作するか」、Directは「端末のネットワークから到達できるか」を比較するために使えますが、どちらも特定のRuleが有効になった証明にはなりません。これらのモードは、システム通信をすべて引き受けることを意味するわけではありません。システムのバイパス、アプリの動作、既存の接続も個別に考慮してください。
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN,printer.example.net,DIRECT
DOMAIN,metrics.example.org,REJECT
FINAL,PROXY
同じ接続先で条件を揃えて比較する
ある接続先がProxyでは開けるのにConfigで失敗する場合、すぐにサーバーを変更せず、ConfigでDIRECT、REJECT、またはそれ以前のルールに一致していないか確認してください。ProxyとConfigの両方で失敗する場合は、プロキシ経路、名前解決、接続先の状態を確認します。Directでは成功しProxyでは失敗する場合は、選択中のサーバーと接続先への経路を調べてください。その結果だけで、すべてのルールに問題があるとは判断できません。
比較テストでは接続先、ネットワーク、サーバーの選択をできるだけ揃え、一度に変える条件は1つにします。ネットワーク、モード、サーバーを同時に何度も切り替えると、結果の原因を特定できません。ページの初回読み込みと後続のリソースリクエストも区別してください。1つのWebページでPROXY、DIRECT、REJECTの記録が同時に出ることがあります。いずれか1つだけを見て、ページ全体の動作を判断しないでください。
プロトコル設定とルール分けは別の役割
Shadowsocks、VMess、VLESS、Trojanなどのプロトコルはプロキシ接続の確立方法を決め、Ruleはどのリクエストをプロキシ経路に送るかを決めます。DOMAIN-SUFFIXをDOMAINに変えてもサーバーのパスワード誤りは直りません。転送パラメーターを変更しても、範囲が広すぎる拒否ルールが自動的に修正されるわけではありません。プロトコル項目を確認する場合は、プロトコルと主な設定項目の解説を参照し、その後ここでリクエストの処理先を確認してください。
On Demandは条件に応じて接続を開始する機能です。Global Routingで選んだルール分けのモードとは分けて考えてください。自動接続されたからといって必ずConfigが使われるわけではなく、手動で接続したからといってルールが無視されるわけでもありません。モードを切り替えたら、現在の接続状態と設定の選択をもう一度確認し、自動接続の動作をルールの選択結果と混同しないようにしましょう。
05 DNS、Host、アドレスルールの相互作用
ドメインルールとアドレスルールが参照する情報は異なるため、DNSはルール分けのトラブルシューティングで重要な分岐点になります。DNSでホスト名をアドレスに変換し、Ruleはその時点で取得できる情報をもとにポリシーを判断します。実際の処理はキャッシュ、接続方式、クライアント設定にも影響されます。「あるアドレスに名前解決された」ことと「特定の経路で接続した」ことを同一視せず、名前解決の経路と実際の通信経路をそれぞれ確認してください。
現在の状態を記録してから、名前解決の参照先を変更する
[General]
dns-server = system
この行はシステムのリゾルバーを使う指定です。項目の意味を理解する出発点にはなりますが、どの環境にも適した最適設定ではありません。システムのリゾルバーは現在のネットワークやシステム設定に基づきます。Wi-Fiやモバイルネットワークを切り替えると、実際の環境も変わることがあります。たとえば内部ホスト名のように特定のネットワークでしか解決できない宛先では、別の名前解決先に変更すると使えなくなる場合があります。変更前に対象ドメイン、元の名前解決結果、ネットワーク条件を記録してください。
名前解決の問題を調べるときは、失敗が名前解決の前か、接続後かをまず確認します。アドレスを取得できない、アドレスは取得できたが接続がタイムアウトする、接続後に証明書エラーが発生するのは、それぞれ異なる段階の問題です。名前解決の経路を優先して疑えるのは最初のケースです。それ以外はアドレスへの到達性、接続先サービス、時刻設定、ハンドシェイク条件も関係します。失敗の段階を確認せずDNSを次々と変更すると、原因を見えにくくすることがあります。
Hostマッピングが変更するのは名前解決結果だけ
[Host]
portal.example.com = 192.0.2.10
test.example.net = 198.51.100.20
Hostセクションでは指定したホスト名にローカルのマッピングを設定します。上記のアドレスは文書用の予約範囲に属し、実際の接続には使用できません。Hostはサーバー証明書を生成せず、到達できないアドレスに接続できるようにするものでもありません。ドメインが指定IPに解決されても、サーバー側がそのホスト名を正しく処理する必要があります。HostをあらゆるWebサイトのエラーを解決する簡易スイッチとして使わないでください。
実際のマッピングを設定する前に、対象アドレスが安定しており、自分が管理権限を持つサービスによって提供されていることを確認してください。多くのサイトは動的アドレス、地域別の振り分け、複数アドレスによる冗長化を利用しています。一度の名前解決で得たIPに固定すると、一時的に動作しても後で使えなくなる可能性があります。ネットワークが変わった後もマッピングは通常の名前解決を上書きし続けます。各Hostに明確な用途を持たせ、不要になったら削除してください。
アドレスルールが一致しないことがある理由
[Rule]
DOMAIN,portal.example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
FINAL,PROXY
1行目はホスト名で直接ポリシーを決めるため、後続のアドレス範囲に同じ意図を持たせる必要はありません。後の2行は特定のアドレス範囲だけが対象で、照合のためにドメインを積極的に名前解決しません。特定の内部ドメインを常にDIRECTにしたい場合は、通常、ドメインルールを明示してください。常にプライベートアドレスに解決されると想定し、アドレスルールで間接的に一致させようとしないでください。
同じドメインがIPv4とIPv6の両方のアドレスを返す場合があります。IPv4の範囲だけを設定しても、IPv6接続もそのルールに入るとは限りません。一度の名前解決結果だけを確認しても、すべてのリクエストが同じアドレスを使うとは限りません。「ときどき動作が異なる」場合は、実際の宛先アドレスとアドレスファミリーを記録してルール範囲と比較してください。ドメイン項目を重複して追加し続けないようにしましょう。
キャッシュ、GEOIP、観測の誤差
DNSキャッシュはクライアント、システム、接続先アプリに残っている場合があり、既存の接続が古いアドレスを再利用することもあります。Hostや名前解決の設定を変更した後は、新しい接続を作って新しい結果が使われるか確認してください。必要に応じてアプリが提供する方法で関連キャッシュを消去します。1つのドメインを検証するために、最初からネットワーク設定全体をリセットしないでください。変数が増え、どの変更が効果をもたらしたか分かりにくくなります。
GEOIPは宛先アドレスのデータベース分類を使うもので、ドメインの所属地域を確定するものではありません。コンテンツ配信サービスやアドレスの再割り当てによって、直感と分類が異なることがあります。特定のサービスに固定ポリシーが必要な場合は、明確なドメイン例外をGEOIPより前に記述してください。1つの接続先のために地理的なルール全体を変更しないでください。アドレス分類が疑わしい場合は、実際の宛先IPと最初に一致したルールを確認してください。
06 URL Rewriteの役割と安全上の注意
URL Rewriteは識別可能なURLのパターンと置換先を処理し、Ruleは接続に適用するポリシーを処理します。同じ設定ファイルに記述できますが、互いに代用できるものではありません。特定のドメインをプロキシ経由にする場合はルールを記述し、明確な旧URLから新URLへリダイレクトする場合にURL Rewriteを検討してください。アクセス失敗をすべてURL Rewriteで解決しようとすると、単純な接続問題が追跡の難しいリダイレクト問題に変わることがあります。
最小限のリダイレクト例を読む
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
この例は、指定されたHTTPアドレスからHTTPSアドレスへのリダイレクトを示します。左側は正規表現、中央は置換先、末尾の302は一時的なリダイレクトを表します。先頭のキャレットは文字列の先頭からの一致を、末尾のドル記号は文字列末尾との一致を指定します。バックスラッシュにより、ドメイン内のピリオドを通常のピリオドとして扱います。キャプチャグループの内容は、置換先にある$1で参照します。
これは構文の説明であり、例のドメインに実際にアクセスする必要があるという意味でも、すべてのWebサイトでクライアント側の書き換えが適切という意味でもありません。実際に使う前に、接続先サービスが新しいアドレスに対応していること、パスの意味が同じこと、クエリパラメーター、ログイン後のコールバック、リソース参照が正しく保たれることを確認してください。書き換えでリクエスト先を変更できても、同じコンテンツや権限で利用できる保証はありません。
正規表現の範囲を説明できるようにする
ドメイン内のピリオドをエスケープしない場合、正規表現では通常、任意の1文字として扱われ、意図せず範囲が広がる可能性があります。先頭や末尾の指定を省略すると、想定外の位置に一致することもあります。通常のドメインサフィックス照合の感覚を正規表現に当てはめないでください。DOMAIN-SUFFIXと正規表現は意味が異なり、前者のドメイン境界は後者に自動的には適用されません。
すべてのアドレスを対象にする式を1つ書くより、範囲を少しずつ絞るほうが検証しやすくなります。まず完全なホスト名と明確なパスを対象にテストし、その後でキャプチャグループを追加するか検討してください。ワイルドカードの範囲を広げるたびに、書き換えてはいけないアドレスを反例として用意します。括弧やエスケープ文字の用途を説明できない場合は、稼働中の設定を試行錯誤で変更せず、いったん導入を止めてください。
リダイレクトと見えない変更を区別する
302リダイレクトでは、対応するクライアントが転送先へ改めてリクエストします。その後のリクエストでも名前解決、接続、ルール処理が行われます。元の接続を別経路に見えない形で置き換える機能ではありません。転送先が別のリダイレクトにも一致すると複数回の転送が発生し、反対方向を向いた2つのルールは循環する可能性があります。その結果、ページの読み込みが完了しないことがあります。
リダイレクトの循環を調べるには、まず追加したばかりの書き換えを無効にし、元のアクセスが戻るか確認します。次に、元のアドレスから転送先までの経路をすべて確認してください。ブラウザーキャッシュやサイト独自のリダイレクトも関係する場合があるため、URL欄の最終位置だけでなく、新しいリクエストで検証します。恒久的なリダイレクトには特に注意し、テスト中はキャッシュ結果が判断に影響しないようにしてください。
HTTPSで完全なパスが自動的に見えるわけではない
暗号化された通常の接続では、設定にURL Rewriteが記述されているだけで、クライアントがすべてのリクエストパスやヘッダーを取得できるわけではありません。ドメイン単位の接続情報と完全なURLは別のものです。HTTPSの書き換え機能には、追加の復号条件や証明書の信頼設定が必要な場合があります。このページではルール分けのためにそれらを有効にする必要はなく、ドメインルールの修正を目的に復号範囲を広げることも推奨しません。
目的が「特定ドメインをDIRECTまたはプロキシ経由にする」ことであれば、証明書関連の設定を追加せずRuleを確認してください。許可を得たテストで必要な場合も、対象ホストを限定し、アプリの証明書ピンニングや機密セッションへの影響を理解したうえで、元に戻す方法を用意してください。「書き換えが実行されない」原因をすぐに式の誤りと決めつけず、まずクライアントが照合に必要なリクエスト情報を取得できるか確認します。
リモート設定を管理している場合は、新たに追加された書き換えセクションに特に注意してください。ルールの更新はプロキシ経路だけでなく、アクセス先のURLも変更する可能性があります。更新後にログイン後の戻り先がおかしい、リダイレクト先が変わった、リソースのURLが置き換わった場合は、RuleだけでなくURL RewriteとHostの差分も確認してください。必要な機能だけを残せば、後から問題を調べる範囲を絞れます。
07 よくあるルールの書き方と組み合わせ
ルールを組み合わせる前に、目的を一文で表し、それを完全一致の例外、広い範囲のルール、最終ルールに分けます。以下の例はそれぞれ独立しており、記述順を説明するためのものです。接続情報は含まれていません。実際に使う前に、例のホスト名を確認済みの対象に置き換え、比較用に元の設定を保存してください。コードが短いからといって、検証を省略したり既存ファイルを上書きしたりしないでください。
指定ドメインをプロキシ経由にし、それ以外は直接接続する
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.net,PROXY
FINAL,DIRECT
このルールセットは明示的な許可リストです。完全一致するAPIドメインと指定したドメイン全体だけにPROXYを適用し、それ以外はDIRECTにします。対象範囲が明確で、継続して管理できる場合に適しています。アプリがほかのリソースドメインも使う場合、それらの接続にはFINAL,DIRECTが適用されます。APIには接続できるのに画像やログインが失敗する場合は、既存の項目を何度も追加するのではなく、まず漏れているドメインを確認してください。
この設定を管理するときは、アドレスバーの表示だけでなく、サービスが依存する接続先も記録してください。ログイン認証、静的リソース、ファイルのアップロードで異なるホスト名を使う場合があります。ドメインを追加するときも、必要最小限の範囲にし、同じサービスの処理に関係することを確認してからDOMAINとDOMAIN-SUFFIXのどちらを使うか決めてください。実際の通信を確認せず、範囲の広いキーワードを追加すると、ほかのアプリの通信先まで変わる可能性があります。
一部は直接接続し、それ以外はプロキシ経由にする
[Rule]
DOMAIN,router.example.net,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
ここでは、特定のホスト名をDIRECTにする例外を先に置き、プライベートアドレスとGEOIPを処理してから、最後にプロキシを適用します。前の例との主な違いは行数ではなく、「一覧にない接続先」に適用するポリシーです。設定を評価するときは、まずFINALを確認してください。新しいサービス、未登録のドメイン、どのルールにも一致しないアドレスの既定動作が決まります。
このルールセットは、あらゆるLANを網羅するものではありません。ネットワークによってはほかのプライベートアドレス範囲が使われ、IPv6も別途考慮が必要です。システムやGeneralのバイパス設定が先に適用される場合もあります。内部サービスにアクセスする場合は、実際のアドレスとホスト名に基づいてルールを追加してください。確認していないアドレス範囲をそのままコピーして、LANの問題が解決したと決めつけないでください。
サフィックスルールに対する完全一致の例外
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
ログイン用と統計用のAPIを例外として先に記述し、それ以外のドメイン全体に共通のポリシーを適用します。ここでのREJECTは例外の位置を示す例であり、実際のサービスで安全に拒否できることを意味しません。統計、初期化、必須機能を同じホスト名で提供するサービスもあります。ホスト名全体を拒否すると影響が広がるため、役割を確認してから適用してください。
同じドメイン内の異なるパスに別々の処理を適用したい場合、DOMAINではパスを区別できません。同じドメインを複数行追加しても変わりません。この場合は、パス単位の処理が本当に必要かを改めて検討し、ドメイン欄にスラッシュを追加しないでください。ルール分けとURL Rewriteではできることが異なります。構文をつなぎ合わせて、一方のルールをもう一方の機能に変えることはできません。
設定を統合するときは、判断順序を保つ
2つのルール一覧を統合する作業は、2つのファイルを単純につなげることではありません。重複するセクション見出しや途中にあるFINALを取り除き、業務上の例外、ドメインの集合、アドレス範囲、最終ルールの順に見直します。まったく同じ行の重複は通常、読みづらさを増すだけです。同じ条件に異なるポリシーを指定すると実際の競合になります。先にある行が適用され、後の行は管理者に誤った期待を持たせる可能性があります。
サブスクリプションのグループ分けとルール分けも分けて管理してください。サブスクリプション名が変わったことで通信先を説明できなくなる状態は避けましょう。サブスクリプションを削除する前に、現在選択中のプロキシが引き続き有効であることを確認してください。複数の提供元から取得した項目の整理方法は、複数サブスクリプションのグループ分け、更新、重複項目の整理をご覧ください。サーバー一覧を整理した後、ルールが想定した経路を参照しているか個別に検証してください。
組み合わせる目的は一度に1つだけ追加してください。たとえば、まず内部アドレスをDIRECTにし、次に特定ドメインをプロキシ経由にし、最後に拒否の例外を加えます。各段階で成功例と反例を1つずつ記録してください。設定が短くても各ルールの理由を説明でき、問題が起きたときはすべてを作り直さず、直近の変更だけをすぐに元に戻せます。
08 ルールの検証、トラブルシューティング、保守手順
ルール分けの検証では、Webページが開くかどうかだけでなく、リクエストの対象、一致したルール、適用ポリシー、最終的な接続結果を結び付けて確認します。ページが表示されたのはキャッシュのおかげかもしれず、失敗はサーバーや接続先サービスが原因かもしれません。どちらも単独ではルールが正しい証拠になりません。まず確認しやすい現在の状態から調べ、接続処理を順に追って範囲を絞ってください。複数の独立した項目を同時に変更しないようにしましょう。
手順1:テスト条件を固定する
現在のネットワーク、選択中のサーバー、Global Routingのモード、Configファイル名を記録します。接続が有効で、現在Configが選ばれていることを確認してから、想定する通信先を明確に説明できるテスト対象を選んでください。サーバーを複数切り替えたり、サブスクリプションを再インポートしたりするのは一旦控えます。テスト条件が変わり続けると、次の成功がルール変更によるものか、ネットワークの復旧によるものか判断できません。
設定が保存されているか、有効になっているか、リモート更新でローカルの変更が上書きされていないか確認します。新しいルールを試す場合は新規接続を開始し、古いセッションの再利用をできるだけ避けてください。ブラウザーでは該当ページを閉じてから開き直し、単独のアプリでは終了してから再試行します。最初からシステムのネットワーク設定をリセットする必要はありません。各操作で、具体的な変数を1つずつ取り除いてください。
手順2:対象と最初に一致したルールを確認する
アプリで確認できる接続ログや診断情報から、今回のリクエストのドメイン、宛先IP、ルール、ポリシーを探してください。ログに表示されるAPIのドメインはページのアドレスと異なる場合があるため、実際のリクエストを基準にします。リクエストが現在の設定に入っているかを確認した後、先行するサフィックス、キーワード、アドレスルール、拒否の例外に一致していないか調べてください。自分が追加した行だけを検索しないようにしましょう。
想定したドメインが見つからない場合は、リクエストにアドレスしか含まれていない、暗号化接続で取得できる情報が限られている、アプリが別のホスト名を使っている、ログの対象範囲が異なるといった可能性があります。推測で数十個のドメインを追加しないでください。同じ種類のルールで観測しやすいテスト対象を使い、基本的な照合の動作を確認してから元のアプリを調べます。USER-AGENTでは特に、対象の識別情報を実際に取得できるか先に確認してください。
手順3:ポリシーが正しいことと接続できることを分けて確認する
| 確認結果 | まず確認する項目 | 次の手順 |
|---|---|---|
| 意図しないREJECTに一致 | キーワードの範囲、完全一致の例外の順序 | ルールの範囲を絞り、接続を新しく開始する |
| PROXYに一致したが接続に失敗 | サーバーの選択、認証、接続先への到達性 | Proxyモードで同じ接続先を比較 |
| DIRECTに一致したが接続に失敗 | 端末のネットワーク、DNS、内部ルーティング | 実際の宛先アドレスとネットワーク条件を比較 |
| 常にFINALに一致する | 対象フィールド、ルールの種類、取得可能な情報 | ドメインとアドレスが条件に合っているか確認 |
| 変更後も動作が変わらない | 選択中のファイル、キャッシュ、既存の接続 | 保存と有効化を確認してから、新しいリクエストを開始 |
Connectivity Testはサーバーへの接続状況を確認する補助機能ですが、特定のサービスへの完全なアクセス確認に代わるものではありません。テスト先と実際の接続先は異なり、使われるプロトコル機能やリクエストの種類も同じとは限りません。同様に、Dataにアップロードやダウンロードの数値が表示されても、その集計範囲に通信があったことを示すだけです。通信量だけで特定のルールに一致したと判断することはできません。統計画面の見方はDataの通信量統計ガイドをご覧ください。
手順4:記録を残し、変更を最小限に戻す
設定を追加した後に問題が起きたら、まず直近に追加したルールまたは書き換えを一時的に無効にし、保存しておいた設定に戻して比較します。元に戻して正常になった場合は、一項目ずつ再度追加してください。すべての設定をリセットする必要はありません。記録には対象、想定したポリシー、実際に最初に一致したルール、エラーが発生した段階を含めます。「ときどき開かない」よりも、順序、名前解決、プロキシ接続のどれが問題か判断しやすくなります。
トラブルシューティングの資料を共有する場合は、サブスクリプションリンク、認証情報、アクセストークン、個人情報を含むクエリパラメーターを削除してください。設定の構造を共有するときはexample.comや予約済みアドレスを使えば、実際の認証情報を公開する必要はありません。ルール例のドメインは通常、機密情報ではありませんが、接続ログには完全なパスやセッション情報が含まれる場合があります。設定全体をそのまま転送せず、共有前に項目ごとに確認してください。
繰り返し実行できる保守チェックを用意する
ルールを更新したら、少なくともプロキシ経由にする対象、直接接続する対象、対象外となるべき反例を1つずつ再テストしてください。REJECTを使う場合は、拒否範囲が広がっていないことも確認します。ネットワークを切り替えた後は内部アドレスとDNS、サーバーを変更した後はプロキシ経路、設定を更新した後はルール順序と追加されたセクションを重点的に確認してください。テスト対象は少数でも構いませんが、固定し、実際の用途をカバーできるようにします。
初回接続の手順に関する問題はクイックスタートガイドに戻って確認してください。インストールやOSによる許可に関する問題はダウンロードページのインストール・許可設定を、よくある使い方の疑問はFAQをご覧ください。ルール解説の目的は、場当たり的にルールを増やして偶然アクセスできるようにすることではなく、各結果の条件を追跡できるようにすることです。