公式マニュアル ルールと設定

Shadowrocketのルールガイド

設定のセクション構成から最初に一致するルールまで、条件・ポリシー・適用範囲を項目ごとに確認できます。

このページは、接続操作を理解し、設定を編集する方向けのリファレンスです。初めて使う場合は、まず入門ガイドを読み、手元のサブスクリプションを追加して接続を確認してから、ルールを参照してください。以下では、ご自身のサブスクリプションまたはサーバー情報をお持ちであることを前提とします。サブスクリプションURLはサービス提供元から取得してください。

ShadowrocketにはiPhone / iPad、Mac、Windows、Android、Linux版があります。iPhone / iPad版はApp Storeで2.99ドルの買い切り、Mac / Windows / Android / Linux版は無料です。アプリの買い切り購入と接続サービスの契約は別です。各デバイスの入手方法はダウンロードガイドをご覧ください。iPhone / iPadのシステム要件はApp Storeの記載をご確認ください。以下の画面操作はiPhone / iPadを例に説明します。ほかのデバイスでは、項目の場所や利用できる設定がアプリの表示と異なる場合があります。

設定ファイルの構成

Shadowrocketのルール設定は通常、.conf形式のテキストファイルで保存し、角括弧で機能ごとのセクションを区切ります。設定全体を暗記するより、セクションごとの役割を理解することが大切です。接続情報はサーバーへの接続方法、ルールはリクエストに適用するポリシー、DNSはドメイン名からアドレスを取得する方法を定めます。互いに影響することはありますが、同じ設定ではありません。サブスクリプションURLをルールのセクションに貼り付けたり、ドメインルールをHostセクションに書いたりしても、意図した結果にはなりません。

まず3つの項目を区別する

Homeのサーバー情報は接続に使い、サブスクリプションはそれらをまとめて管理し、Configの設定ファイルはルーティングや関連動作を定めます。登録済みサブスクリプションの更新は、現在の設定ファイルの切り替えとは別の操作です。別の設定ファイルを選んでも、使用中のサーバーが変わるとは限りません。トラブル対処では、サブスクリプション名、使用中のサーバー、選択中の設定ファイル名をそれぞれ記録し、別々の変更を一つの操作と混同しないようにしましょう。

Configで対象の設定ファイルを開き、編集しているのがローカルコピーかリモート設定かを確認します。リモート設定は再取得時に、直接加えた変更が上書きされることがあります。継続して使うテスト内容は、先にローカルファイルへ複製し、判別しやすい名前を付けておくと安心です。保存後は、そのファイルが選択状態になっていることも確認してください。リストに設定ファイルがあるだけでは、使用中とは限りません。

セクション主な役割代用できないもの
[General]DNSなど全体の動作設定サーバーの認証情報や個別の振り分け
[Rule]リクエストをマッチさせ、ポリシーを指定する接続可能なプロキシサーバーを用意する
[Host]指定ドメインの静的なアドレス対応付け接続にPROXYとDIRECTのどちらを使うか決める
[URL Rewrite]識別可能なリクエストのURLを処理する一般的なネットワークルーティングや、あらゆる暗号化コンテンツの読み取り

最小限の構成から確認する

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

この例では、全体設定とルールセクションの関係を示します。dns-server = systemはシステムDNSを使う設定です。続くルールは、例示したドメイン、プライベートIPアドレスの範囲、その他のリクエストを順に処理します。Hostや書き換えのセクションはありませんが、空のセクションを用意する必要はありません。設定が簡潔なほど、実際の設定とその影響を対応付けやすく、トラブル対処の基準として使えます。

ルール内のカンマは項目の区切りなので、半角の英語記号を使います。タイプ名、マッチ対象、ポリシーの順に記述し、追加パラメーターは末尾に置きます。ポリシーの直後に日本語の説明を書き足さないでください。説明を加える場合は、コピー時に見えない空白や全角カンマが混ざらないよう、別のコメント行にします。ドメイン欄にはプロトコルを含めず、WebページのURL全体も入力しません。

保存しただけでは検証は完了しない

編集後は、セクション見出しが正しく閉じているか、ルールが適切なセクションに残っているかを確認してから保存し、対象の設定ファイルを選び直します。アプリに解析エラーが表示された場合は、ほかのルールを追加する前に、変更した行の項目数を確認してください。保存できたことは編集が完了したという意味にすぎません。実際のルーティングが意図どおりかは、新しいリクエストを発生させ、接続記録を確認する必要があります。

変更の影響が新しい接続だけに及び、確立済みの長時間接続では以前の経路が使われ続ける場合があります。検証前にテストページを閉じて開き直し、必要に応じて適切なタイミングでShadowrocketを再接続してください。重要なデータを転送中に、設定を何度も切り替えないでください。ロールバック後にすぐ現象が変わらない場合は、ロールバックが無効だったと判断する前に、接続の再利用やアプリのキャッシュを確認します。

実際の設定には、この記事で扱うより多くのセクションや項目が含まれる場合があります。用途がわからない項目は、まず元の値を保ち、役割を確認してください。異なる情報源の設定ファイルを丸ごとつなぎ合わせるのは避けましょう。セクションの重複、設定の競合、リモート更新による上書きは、単純なルールの入力ミスより原因を特定しにくいことがあります。以下の例は、必要な箇所だけ差し替えたり確認したりするためのもので、すべてを一度に有効にする必要はありません。

マッチ順とGlobal Routing

ルールの記述内容と同じくらい、記述する順番も重要です。Global RoutingがConfigの場合、Ruleセクションは通常、上から順に確認されます。リクエストがルールに一致すると対応するポリシーが適用され、それ以降のルールは確認されません。ShadowrocketがDOMAINをDOMAIN-SUFFIXより自動で前に並べることはなく、より具体的に見えるルールを優先するよう順序を調整することもありません。

まずGlobal Routingを確認する

Global Routingの主な3つのモードは、Config、Proxy、Directです。独自ルールを確認する場合は、まずConfigが選択されていることを確かめてください。ProxyやDirectになっている状態でリクエストがRuleセクションどおりに振り分けられなくても、ルールの構文ミスとは限りません。モードは設定の使い方を決めますが、実際のトラフィックはシステムのルーティング範囲やアプリが処理できる範囲にも左右されます。

画面上の表記動作確認に適した内容
Config現在の設定に従ってルーティングするRuleの順序とポリシーのマッチを確認する
Proxyプロキシモードで、アプリが処理するトラフィックを扱う一時的にプロキシ経由の接続が可能か比較する
DirectDirectモードで、アプリが処理するトラフィックを扱うローカルネットワークから到達できるか比較する

3つのモードは診断時に比較する条件であり、性能の順位ではありません。Proxyに切り替えてページが開いたとしても、経路を変えると現象が変わったことを示すだけで、DNSの設定がすべて正しいとは限りません。Directで開けない場合も、ローカルネットワークから目的のサーバーに到達できない可能性があります。比較を終えたらConfigに戻して、残すルールを検証してください。一時的なモードを最終的な修正と取り違えないようにしましょう。

個別の例外は先に記述する

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

login.example.comへのアクセスでは最初のルールに一致するため、2つ目のルールは確認されません。www.example.comへのアクセスでは最初のルールに一致せず、2つ目が適用されます。先頭の2行を入れ替えると、後方一致ルールが先にloginドメインを処理し、DIRECTの例外が適用されません。これはルールの順序の問題で、同じドメインを何度も追加しても解決しません。

一般的には、明確な例外を先頭に置き、その後に対象範囲の狭いルール、より広いアドレスや地域の条件、最後にFINALを記述すると確認しやすくなります。ただし、これは固定の決まりではありません。条件が重なる場合は、意図した結果に沿って優先順位を決めてください。たとえば、あるドメインがキーワード条件にも当てはまり、個別の例外もある場合は、例外をキーワードルールより先に置きます。

ルールのマッチと接続成功は分けて確認する

ルールに一致したということは、ポリシーが選ばれたという意味です。PROXYに一致しても、サーバーに到達できない、認証に失敗する、通信が制限されているなどの理由で接続できない場合があります。DIRECTに一致しても、接続先が通信を拒否することがあります。「ルールが正しく一致した」と「アクセスに成功した」を別々に判断すると、サーバーや接続先の問題に対してルールを変更し続けるのを防げます。

前のポリシーで接続に失敗しても、Ruleの次のルールが自動で試されるわけではありません。後続ルールは、先行ルールのフェイルオーバー先ではありません。接続先を切り替える必要がある場合は、同じドメインに異なるポリシーを複数並べて順番に再試行させるのではなく、実際に設定しているサーバー選択やポリシーグループの動作を確認してください。ここでのPROXYは現在選択中のプロキシを指し、最速の接続先を自動で選ぶ意味ではありません。

On Demandは条件に応じて接続を開始するかを決める機能であり、リクエストごとのRuleマッチに代わるものではありません。Sceneの設定も、前述の3つのモードと混同しないでください。ネットワークが変わった後に接続状態が想定と異なる場合は、まず自動接続の条件を確認し、次にトラフィックの振り分けを確認します。最初に一致するルールの例はカスタムルールと優先順位の解説をご覧ください。

ドメインとリクエスト条件

ドメインルールは「どのサービスにどのポリシーを適用するか」を表すのに適しており、WebサイトのIPアドレスの変化を直接追うより管理しやすいことが一般的です。まず、手元にある情報がホスト名、完全なURL、アプリに表示された名称のどれかを確認し、ルールタイプを選びます。ページタイトル、アプリ名、実際に接続するホスト名は同じとは限りません。画面に表示された日本語名をDOMAINに入力しても、対応するネットワークサービスが自動で見つかるわけではありません。

DOMAINとドメインの後方一致

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

DOMAINはドメイン名を完全一致で判定します。1つ目のルールはapi.example.comだけを対象とし、www.example.comや、さらに下の階層にあるホスト名には一致しません。入力するのはホスト名のみで、https://、ポート番号、パスは含めません。特定のインターフェースだけを対象にする場合、完全一致ルールなら影響範囲を予測しやすく、後のドメイン変更にも気づきやすくなります。

DOMAIN-SUFFIXは指定したドメインとそのサブドメインに一致します。2つ目のルールはexample.orgとimg.example.orgを対象にできますが、文字列の末尾を無条件に検索するものではありません。通常、notexample.orgは一致対象になりません。先頭にアスタリスクを付ける必要もありません。*.example.orgは、ここで説明する後方一致の書き方ではありません。

後方一致を使う前に、対象ドメインの範囲を確認してください。共用ホスティングサービスの広いドメインを一律に指定すると、互いに関係のない多くのサイトにも影響する可能性があります。具体的なサービスのドメインで指定できる場合は、共用ドメイン全体まで範囲を広げないでください。反対に、サービスが複数のサブドメインを使う場合、トップページのDOMAINだけでは対象が足りず、トップページは表示されても画像やログインに失敗することがあります。

キーワード一致はサービスの識別ではない

DOMAIN-KEYWORDは、ドメイン名に含まれるキーワードで一致を判定するため、後方一致より対象範囲が広くなる傾向があります。例のexampleは異なる複数のドメインに一致する可能性があり、それらが同じサービス提供元のものとは限りません。キーワード一致は、確認できる既知の命名規則には使えますが、よくある短い単語を確実な分類条件として使うのには向きません。誤って対象になった場合は、多数の例外を追加するのではなく、まず条件をより具体的にしてください。

たとえばadsをREJECTに指定する例は、キーワードで拒否する構文を示すだけで、広告リクエストだけに一致する保証はありません。通常のドメインにも同じ文字列が含まれることがあります。拒否する前に、実際の接続記録でドメインを確認してください。ページが開いても、ログイン、メディア、送信に使うインターフェースが誤って拒否されている可能性があります。検証では、実際に使う操作も試してください。

USER-AGENTで判定できる範囲

[Rule]
USER-AGENT,ExampleClient*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

USER-AGENTは、識別可能なリクエストに含まれるUser-Agentの内容で一致を判定します。例のアスタリスクはワイルドカードを表します。プロセス名による判定でも、「特定アプリのすべての通信」を表すものでもありません。同じアプリでも異なるリクエストライブラリや識別子を使うことがあり、複数のアプリが似た識別子を共有する場合もあります。そのため、1つのUSER-AGENTルールだけでアプリ単位の通信を完全に振り分けられるとは限りません。

HTTPSではリクエストヘッダーが暗号化されるため、通常のトンネル転送ではUser-Agentを自由に読み取れません。この種のルールが一致するかどうかは、アプリから取得できる情報と関連する処理条件によります。ルールを機能させるために、追加の証明書信頼設定や復号設定が必須だと考えないでください。このページの説明に、それらを有効にする必要はありません。一般的な振り分けでは、確認しやすいドメイン条件を優先してください。

ドメインルールが一致していないように見えるときは、まず接続で実際に使われている接続先を確認します。ページのリダイレクト、コンテンツ配信、認証専用ドメイン、IPアドレスへの直接接続などで、当初の想定が外れることがあります。クライアントがドメイン情報を取得できない場合、DOMAIN系のルールが情報を推測することもできません。接続記録を確認し、必要な条件だけを追加してください。あらゆる失敗を「後方一致が弱い」と決めつけないようにしましょう。

メンテナンスでは、根拠のある少数のルールをサービスごとにまとめ、個別の例外をそのグループの前に置くのがおすすめです。サービスの変更後は、不要になった古いドメインを削除し、説明しづらい条件を蓄積させないようにします。ドメインの数を増やしても、必ずしも判定が正確になるわけではありません。各ルールの目的と一致する対象を説明できることが、安定した設定につながります。

IPアドレスと地域によるマッチ

接続先がIPアドレスで指定される場合や、ローカルネットワークのアドレスを明示的に扱う場合は、IPルールが直接的です。ドメイン名の表記ではなく、最終的な接続先アドレスを基準にします。使う前に、単一のアドレス、サブネットの範囲、地域データベースを区別してください。Webサイトが複数のアドレスに解決されることも、1つのアドレスが複数のドメインをホストすることもあります。IPによる振り分けの範囲は、特定サイトのサービス範囲と一致するとは限りません。

IP-CIDRの範囲

[Rule]
IP-CIDR,192.168.50.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
FINAL,PROXY

IP-CIDRはIPv4のネットワーク範囲を指定します。スラッシュの後の数字はプレフィックス長で、ポート番号やアドレス数ではありません。/32は単一のIPv4アドレス、/16は先頭16ビットが固定された範囲を示します。必要なネットワーク範囲を指定してください。特定のデバイスをDIRECTにするためだけに、実際のローカルネットワークより大幅に広い範囲を指定しないでください。

例の最初の3種類は、一般的なプライベートアドレス範囲です。ローカルネットワークへの直接接続を理解する例として使えますが、現在のネットワークから必ず到達できるとは限りません。社内ネットワーク、ゲストネットワーク、家庭用ルーターでは、通信が分離されていたり、ルーティングテーブルが異なったりする場合があります。DIRECTに一致しても、ローカルネットワークから接続を試みるだけです。アクセス権限を作ったり、ネットワーク機器で隔離されたサブネット間を自動で接続したりはしません。

no-resolveの意味

no-resolveの要点は、そのIPルールに一致させるためだけのドメイン解決を積極的に行わないことです。すべてのDNSを停止する機能でも、解決後のアドレスがルールから見えなくなることを保証するものでもありません。接続先がもともとIPアドレスで指定されている場合や、処理の過程で接続先アドレスを取得済みの場合は、該当するアドレスで判定できます。一部のネットワーク範囲を確認するためだけに追加の名前解決を行うことを抑えられますが、効果は実際のリクエスト経路に応じて判断してください。

リクエストが最初はドメイン名だけを持ち、先行するドメインルールに一致した場合、後続のIPルールでポリシーを決める必要はありません。ドメインルールに一致せず、後続のアドレスルールにno-resolveが指定されている場合、クライアントが必ず先に名前解決をしてネットワーク範囲を照合すると想定することはできません。説明やトラブル対処では、「判定に使えるアドレスがすでにある場合」と「判定のために名前解決が必要な場合」を区別してください。

IPv6とGEOIP

[Rule]
IP-CIDR6,fd00::/8,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

IP-CIDR6はIPv6アドレスに対し、同じプレフィックスの考え方で範囲を指定します。例では構文の説明のために、ユニークローカルアドレス空間の一部だけを取り上げており、すべてのIPv6ローカルアドレスを網羅した一覧ではありません。接続先にAとAAAAの両方のレコードがある場合、IPv4の範囲だけでは意図をすべて表せません。検証ではドメイン名だけでなく、実際に使われたアドレスファミリーを確認してください。

GEOIPは接続先IPの地域データベースに基づいて判定します。例のCNは地域コードであり、中国語のWebページ、中国語のドメイン名、アカウントの地域を表すものではありません。コンテンツ配信や地域ごとのサーバー配置により、同じドメインでも異なるネットワークからは別の地域のアドレスに解決されることがあります。データベースにも更新状況や分類上の境界があります。そのため、GEOIPは広い範囲を分類する条件として使い、明示的な個別例外の代わりにはしないでください。

ポリシーを固定したいサービスには、まずドメインまたは特定アドレスの例外を記述し、その後にGEOIPで残りの範囲を処理します。逆に、対象範囲の広い地域ルールを先頭に置くと、後続のサービス別ルールが適用されないことがあります。GEOIPで積極的な名前解決を避けたい場合は、no-resolveの指定によって、どのリクエストに判定可能なアドレスがあるかが変わることを理解してください。パラメーターをコピーするだけでなく、結果も確認しましょう。

アドレスを調べるときは、接続先ドメイン、実際の接続先IP、アドレスファミリー、一致したルールをあわせて記録してください。端末で調べたIPアドレスを、アプリが接続する唯一のアドレスと決めつけないでください。キャッシュ、ネットワークのDNS、コンテンツ配信の振り分けによって結果が異なる場合があります。「同じドメインなのに別のポリシーになる」場合は、ネットワーク範囲を広げる前に、この4項目が一致しているか確認するほうが効果的です。

ポリシーとFINAL

ルールの左側は「何に一致させるか」、右側のポリシーは「一致した後どう処理するか」を表します。PROXY、DIRECT、REJECTは異なる動作であり、サーバーのプロトコル名でも接続品質の評価でもありません。条件とポリシーの両方が正しく記述されて初めて、ルールの意図が表されます。設定を確認するときは、各行を「接続先がこの条件に一致したら、指定の方法で処理する」と読み替えてみてください。

PROXYとDIRECT

PROXYはプロキシ経由のポリシーを指定します。実際に使われる出口は、現在のプロキシ選択や設定内の関連付けによって異なります。サブスクリプションから利用可能なサーバーを自動で見つける機能ではなく、接続先がその出口からの通信を受け入れる保証もありません。PROXYに一致した後は、選択中のサーバー、プロトコル設定、接続可能性を確認してください。サーバー情報が無効でも、PROXYルールを追加するだけでは認証の問題は解決しません。

DIRECTは、選択中のプロキシサーバーを経由せず、ローカルネットワークから接続先へ直接アクセスすることを表します。Shadowrocketを無効にするという意味ではなく、すべてのシステムネットワーク機能を回避するという意味でもありません。アプリが処理する範囲では、DNSやほかの設定がアクセスに影響する場合があります。ローカルネットワークから接続する必要がある宛先に使えますが、「直接接続なら場所やネットワークを問わず到達できる」とは限りません。

ポリシー動作次に確認する項目
PROXYプロキシ経由で接続する選択中のサーバー、認証、接続先の応答
DIRECTローカルネットワーク経由で接続するローカルルーティング、ネットワーク権限、接続先への到達性
REJECT一致したリクエストを拒否する必要なインターフェースや関連ドメインまで誤って拒否していないか

REJECTの対象は限定する

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

この例では、まず特定ドメインへのリクエストを拒否し、ログイン用ドメインはDIRECTの例外として残し、それ以外の例示したサブドメインはプロキシ経由にします。REJECTに一致したリクエストは、自動的にDIRECTへ切り替わりません。アプリが何度も再試行する、一部のコンテンツが表示されない、送信ボタンが反応しないといった場合は、トップページが読み込めるかだけでなく、必要なインターフェースまで拒否していないか確認してください。

拒否ルールには、特に明確な根拠が必要です。用途がわからないドメインは、拒否する前に実際のリクエストと機能との関係を確認してください。統計、認証、設定のリクエストが同じベースドメインを使うこともあり、範囲の広い後方一致やキーワード条件は必要な機能に影響する場合があります。誤って拒否しているか調べるには、ルール一式をまとめて削除するより、1つのルールを一時的に無効にし、同じ操作を繰り返すほうが原因を特定しやすくなります。

FINALでデフォルトの動作を指定する

FINALにはドメインやネットワーク範囲の項目は不要で、一般的な書き方はFINAL,PROXYまたはFINAL,DIRECTです。先行する条件のどれにも一致しない場合の処理を決めるため、設定全体のデフォルトポリシーになります。どちらを選ぶかは利用目的とネットワーク環境によって異なり、すべてのデバイスに当てはまる正解はありません。変更前に、未知のドメイン、バックグラウンドのリクエスト、新しいサービスがどちらの経路に進むか確認してください。

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

この例は「明示したドメインはプロキシ経由、それ以外は直接接続」というパターンです。FINALをFINAL,PROXYに変更すると、それ以外のリクエストもプロキシ経由になり、DIRECTにする例外を事前に記述する必要があります。どちらの方式も使えますが、前者ではプロキシ経由にしたい対象の書き漏らし、後者では直接接続にしたい対象の書き漏らしに注意します。同じ設定を説明するときに、異なる方式の考え方を混ぜないでください。

許可する範囲を維持し、すべての項目を検証する準備ができている場合を除き、FINALをREJECTにして日常利用することはおすすめしません。デフォルトで拒否すると、明示的に許可されていない新しいドメインへのアクセスが失敗します。ページにインターフェースが1つ追加されただけで、新たな問題が起きる場合もあります。学習段階では結果を確認しやすいデフォルトを使って基準を作り、その後、目的に応じて条件を絞り込んでください。

設定で独自のポリシー名を参照している場合は、その名前が実際に登録され、綴りも一致していることを確認してください。この記事ではこの混乱を避けるため、組み込みポリシーだけを使います。サービス提供元のサーバー表示名を、共通の組み込みキーワードとして使わないでください。最終確認では、条件が正しいか、動作が意図に合うか、その動作で通信経路が使えるかの3点を確認します。いずれかが欠ければ検証完了とはいえません。

GeneralとDNS

Generalはネットワーク全体の動作を設定する項目で、DNSは「ルールが正しそうなのにWebページを開けない」場合の重要な要因です。DNSはドメイン名をアドレスに変換し、ルーティングルールは利用可能な情報に基づいてポリシーを選びます。実際の処理では両者が影響し合う場合がありますが、考え方としては分けて調べてください。プロキシサーバーの応答速度が正常でも、確認できたのはテスト対象の接続部分だけです。接続先ドメインの名前解決やページのリソース取得まで成功したとは限りません。

比較の基準となるDNS設定を用意する

[General]
dns-server = system

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

dns-server = systemはシステムDNSを使う例であり、すべてのネットワークに適した速度設定ではありません。すでに明確なDNS設定がある場合は、比較する前に元の値をバックアップしてください。インターネットで見つけた多数のDNSサーバーを設定に追加しても、数が多いほど信頼性が高くなるとは限りません。応答結果、ネットワークからの到達性、障害時の待ち時間が絡み、かえって原因を特定しにくくなることがあります。

カスタムDNSを使う場合は、まずアドレス形式が現在のアプリで使える書き方か確認し、次にローカルネットワークまたは該当するリクエスト経路から到達できるかを確認します。DNSサービスへの到達性、利用可能な結果の取得、接続先への到達性は、それぞれ別の確認項目です。名前解決ができても、返されたアドレスが現在の接続経路に適さない場合があります。プロキシが使えても、DNSリクエストが想定どおりプロキシを経由するとは限りません。

3種類の失敗を区別する

1つ目はアドレスを取得できないケースで、名前解決のタイムアウトやドメインに関するエラーが発生します。2つ目はアドレスを取得できても、そのアドレスへの接続がタイムアウトするケースです。3つ目は接続が確立した後に、接続先から証明書エラーやアプリケーション層のエラーが返されるケースです。それぞれ対処方法が異なります。ブラウザーの「ページを開けません」という表示だけでは区別できないため、Shadowrocketで確認できる接続記録と同じ時間帯のテスト結果をあわせて判断してください。

同じドメインでも、異なるネットワークで別のIPが返されることはあります。すぐにどちらかの結果が誤りだと決めつける必要はありません。コンテンツ配信では、ネットワークの場所や名前解決の経路に応じて接続先が選ばれます。確認すべきなのは、現在の結果で選択中のポリシーから接続できるか、想定したサービスのアドレスかどうかです。ネットワークを切り替えた後は新しいリクエストで検証し、キャッシュに古いアドレスが残っている可能性も考慮してください。すべての差をルールの順序だけに結びつけないようにしましょう。

IPv6も比較に必要な要素です。ドメインがIPv4とIPv6の両方を返す場合、システムはどちらかを優先して接続することがあり、実際に選択されるアドレスはネットワーク状態にも左右されます。IPv4ルールだけを確認しているのにIPv6アドレスで接続されると、適用されるポリシーが異なる場合があります。まず実際のアドレスファミリーを調べ、必要に応じてルールを追加してください。すべてのDNS問題に対して、特定のアドレスファミリーを無効にするのが標準的な解決策だと考えないでください。

全体設定をまとめて変更しない

Generalには、除外範囲、アドレスファミリー、その他の全体的な動作設定が含まれる場合があります。これらはRuleとは異なる階層で作用します。特定のトラフィックが想定した経路に入らない場合、後続の詳細なドメインルールでは説明できません。設定にskip-proxyなどがある場合は、用途と現在の値を確認してください。通常のDOMAIN例外と同じように、安易に置き換えないでください。

全体設定の変更は、特定ルールの追加より慎重に行いましょう。DNS、アドレスファミリー、除外範囲、FINALを同時に変更すると、一時的に問題が解消しても、どの変更が効いたか分からず、副作用にも気づきにくくなります。サーバーとRuleを固定してDNS設定だけを変更し、元に戻してからDNSを固定した状態で対象ルールを調整してください。変更箇所、テスト対象、結果を毎回記録すると、再現可能な比較ができます。

「一部のWebページが開けない」場合は、テスト対象を1つに決め、複数のサイトを次々に切り替えるのではなく、どの段階でエラーになるか記録します。特定のアプリだけで失敗する場合は、ブラウザーと同じドメイン、同じアドレスファミリーを使っているかも比較してください。より詳しい確認手順はDNSの名前解決エラーのトラブル対処をご覧ください。この章では仕組みの違いを説明し、記事では症状に沿って原因を絞り込みます。

HostとURL Rewrite

HostとURL Rewriteはどちらもアクセスの過程に影響しますが、通常のRuleを別の書き方で置き換えるものではありません。Hostは指定したドメインをどのアドレスに対応付けるか、URL Rewriteはリクエスト情報を利用できる場合にURLをどう処理するかを決めます。Ruleが決めるのはトラフィックに適用するポリシーです。役割を分けて考えると、「ドメインの対応付けを変えれば自動でプロキシ経由になる」「リダイレクトを書けばあらゆる接続の問題が直る」といった誤解を防げます。

Hostはアドレスを対応付ける設定

[Host]
test.example.com = 192.0.2.10

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

ここではtest.example.comを192.0.2.10に対応付け、さらにRuleでこのドメインに適用するポリシーを指定しています。このアドレスはドキュメント用の例示範囲に属し、実際のサービスは提供していません。ページに接続できるかを検証するために使わないでください。実際に使う場合は、利用する権利があり、そのドメインに適用できると確認したアドレスを入力します。一時的な対応付けには、設定した理由と解除条件も記録してください。

静的な対応付けを行うと、通常のDNS更新に伴うアドレス変更が反映されなくなり、自動的な接続先選択にも追従できません。サービスの移行やコンテンツ配信先の切り替え後、古いアドレスが使えなくなることがあります。ほかのデバイスではドメインに接続できるのに、現在の設定だけで問題が起きる場合は、新しいDNSサーバーを追加する前に古いHost設定が残っていないか確認してください。一時的な対応付けは、検証後に残すか削除するか決めましょう。

HTTPSでは、接続時に使うドメイン名が証明書の検証に重要です。ドメインを任意のIPに対応付けても、そのサーバーに正しい証明書や対象サイトが自動で用意されるわけではありません。証明書エラーが起きたときに検証を無視して、アドレスの不一致を隠すべきではありません。対応付けたアドレスが対象サービスを実際に提供しているか確認し、必要に応じて設定を削除して通常の名前解決と比較してください。

URL Rewriteの項目

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

これはHTTPリダイレクトの例です。先頭は正規表現のマッチ条件、中央はリダイレクト先のURL、末尾はリダイレクトのステータスコードです。^は文字列の先頭からの一致を指定し、ドメイン名のピリオドはバックスラッシュでエスケープします。(.*)は後続の内容を取り込み、遷移先の$1でその内容を参照します。この例は構文を示すもので、例示した2つのホストでWebページを利用できるという意味ではありません。

正規表現では、プロトコル、ホスト、必要なパスをできるだけ明確に指定します。ドメイン内のピリオドをエスケープしないと、任意の1文字に一致するメタ文字として扱われます。先頭からの一致を指定しない場合も、対象範囲が広がることがあります。編集前に、一致させたいURLと一致させたくないURLを1つずつ用意し、正規表現で区別できるか確認してください。正例だけをテストすると、対象範囲が広すぎることに気づけない場合があります。

リダイレクト後はクライアントが新しいURLへリクエストを送るため、ループにも注意が必要です。遷移先が元の正規表現に再び一致したり、別のルールで元のURLへ戻されたりすると、リダイレクトが繰り返されることがあります。新しいドメインも通常どおり名前解決され、対応するRuleのポリシーが適用されます。書き換えが機能しても、遷移先に接続できるとは限りません。元のリクエストが処理されたか、新しいリクエストが送信されたか、その後どの経路が適用されたかを別々に確認してください。

暗号化の範囲と機密パラメーター

通常のHTTPS転送では、暗号化されたリクエストパスやヘッダー全体は見えません。正規表現を書けば自由に書き換えられるわけではありません。この記事ではHTTPの例を使い、証明書の信頼設定や復号の条件を基本的なルールの説明と切り分けています。明確な必要性がなく、仕組みを十分に理解していない場合は、書き換えを試すためだけにデバイスの信頼設定を変更しないでください。基本的なドメイン振り分けに、その操作は必要ありません。

URLにはログイン状態などの機密性の高いクエリパラメーターが含まれることがあります。例の(.*)は、マッチした範囲の内容を遷移先へ引き継ぐため、実際に使う前に、異なるドメインへ渡すべきでないパラメーターが含まれていないか確認してください。実際のサービスURL、認証リンク、非公開の設定を公開の場に貼り付けないでください。問題の説明には例示用ドメインを使い、項目の形式は残しつつ機密値を削除してください。

Hostと書き換えを同時に設定している場合は、段階的に検証してください。まず書き換えを無効にして、元のドメインのアドレスとルーティングを確認します。次に書き換えを有効にし、接続先が変わるか観察します。最後に新しい接続先の名前解決とポリシーを確認してください。一度に1つの設定だけを有効に戻すと、静的アドレスの期限切れ、正規表現の不一致、遷移先のルーティング誤りを切り分けやすくなります。単純なDNSの問題を、複雑な書き換えで覆い隠すことも防げます。

検証・トラブル対処・メンテナンス

ルールを管理する目的は、設定を長くすることではなく、重要なリクエストに現在のポリシーが適用される理由を説明できるようにすることです。信頼できる手順には、バックアップ、変更を一項目に絞ること、正例と反例によるテスト、ロールバックが含まれます。まず正常に接続できる設定を残してテスト用コピーを作成してください。基本的な接続が不安定な場合は、サーバーやネットワークの問題を先に調べ、同じタイミングでルール全体を作り直さないでください。

決まった順序で検証する

  1. Homeで現在のサーバーが使えること、Global RoutingがConfigであること、Configでテスト対象の設定ファイルが選択されていることを確認します。
  2. ルールは一度に1つだけ追加または変更します。保存後、対象への新しいリクエストを発生させ、古い接続が以前の経路を使い続けないようにします。
  3. 接続先ドメイン、実際のIP、アドレスファミリー、一致したルール、最終的なポリシーを確認し、アクセス結果を記録します。
  4. 新しい条件の影響を受けないはずの接続先もテストし、対象範囲が意図せず広がっていないことを確認します。
  5. 結果が意図どおりなら変更を残します。そうでなければその項目を元に戻し、基準状態に戻してから次の仮説を試します。

正例では追加したルールに確実に一致し、反例では正例にできるだけ近い条件のうち、対象条件を満たさないものを選びます。後方一致ルールなら、同じ後方一致範囲のホストと、別のドメインをそれぞれ選んでください。完全一致のドメインを試す場合は、別のサブドメインでも確認します。この比較により、先行する広範囲のルールがすでに一致していて、追加ルールが実際には働いていないのに成功したと思い込む状況を見つけやすくなります。

最小限のルールで競合を切り分ける

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

設定が長く、判断が難しい場合は、コピー内で特定条件とデフォルトポリシーだけを一時的に残します。最小構成が意図どおりに機能することを確認してから、ほかのルールをグループごとに戻します。あるグループを戻した後に結果が変わったら、そのグループのルールが対象より先に一致していないか確認してください。元のファイルから広範囲に削除し、記憶を頼りに作り直すのは避けましょう。テスト用コピーと明確なバックアップがあれば、いつでも確実な状態から再開できます。

確認された現象優先して確認する項目すぐに決めつけないこと
すべてのリクエストが同じポリシーになっているように見えるGlobal Routing、現在の設定ファイル、先行して一致するルールドメインルールがすべて使えない
ルールには正しく一致するが、アクセスに失敗するDNS、選択中のサーバー、接続先の応答同じルールを追加すれば直る
一部のページ機能だけが動作しない関連ドメイン、REJECT、書き換え、キャッシュトップページが開けばサイト全体も正常
更新後に編集内容が消えたリモート設定による上書き、ローカルコピー、選択状態サブスクリプションの更新で設定がすべて変更された

2種類の更新を区別する

サブスクリプションの更新は主に、サービス提供元から提供されたサーバー情報を更新します。リモート設定の更新ではルールのテキストが置き換わる場合があります。この2つを混同しないでください。更新前に使用中の項目と名前を記録し、更新後にサーバー一覧と設定内容を別々に確認します。サーバー情報の更新方法だけを確認したい場合は、サブスクリプション更新ガイドをご覧ください。通常の更新の代わりに、設定ファイル全体を何度もインポートしないでください。

長期的に管理する場合は、ルールのグループごとに用途を一文で記録しておくと、曖昧な「修正」というメモより役立ちます。対象、意図するポリシー、設定を残す理由を記載し、実際の認証情報は書かないでください。ネットワーク環境やサービスのドメインが変わったら、ルールがまだ必要か確認します。不要な条件を削除すると、条件同士の関係が整理され、後から調べる人も関連する行を見つけやすくなります。

トラブル対処の情報を共有するときは、ルールタイプ、相対的な順序、エラーが起きた段階を残せば十分です。サーバーの認証情報、非公開のサブスクリプションURL、個人のネットワーク情報は先に削除してください。サブスクリプションURLはサービス提供元から取得します。認証やサーバー側の設定に問題がある場合も、手元にあるサービス提供元の情報を確認してください。このマニュアルではクライアントの設定を説明しており、出所不明のサーバー情報を解決の前提にはしません。

最後に、Webページの読み込み、ログイン、メディアやファイルの転送など、実際の操作をひと通り確認します。ネットワークを切り替えた後も意図どおりに動作するかも確認してください。遅延テストを1回行っただけなら、そのテストで接続を確認できたという範囲にとどめ、設定全体が正常だと判断しないでください。基本的な操作手順に戻る場合は入門ガイドをご覧ください。各プラットフォームの入手方法とよくある質問は全プラットフォームのダウンロード案内で確認できます。安定した設定とは、再現でき、理由を説明でき、明確に元へ戻せる設定です。