公式マニュアル · 設定項目

Shadowrocket
設定項目とルールリファレンス

有効な設定を確認してから、ルール条件、並び順、最終ポリシーを確認します。ファイル構成に沿って解説するため、既存の設定を見ながら項目ごとに参照できます。

初めて使う場合は、まずクイックスタートガイドを読み、既存のサブスクリプションを追加して初回接続を完了してください。このページでは設定が機能する仕組みを解説し、初回操作の手順は扱いません。アプリの入手先は全プラットフォームのダウンロードページをご覧ください。

[General] [Rule] [Host] [URL Rewrite]

01 · 設定ファイルの構成と適用範囲

Shadowrocket の設定ファイルでは、角括弧でセクションを区切り、それぞれのセクションで異なる設定を行います。ファイルを読むときは、まずセクション名を確認し、次にセクション内の構文を見ます。カンマを含む文字列がすべてルールとは限りません。よく使われる構成は、基本動作を設定する [General]、リクエストの経路を決める [Rule]、ドメインとIPアドレスを対応付ける [Host]、条件に合うURLを書き換える [URL Rewrite] です。セクションには明確な区切りがあります。行を誤ったセクションに記述すると、単語の綴りが正しくても期待どおりに動作しません。

最小構成のファイルを読む

以下は構成を確認するための例で、あらゆるネットワークに適した完全な設定ではありません。システムに関する基本動作を残し、ドメイン条件とフォールバックルールを1つずつ記載しています。example.com は文書用の例示ドメインです。テスト対象には、利用権限のあるドメインを指定してください。ルールの PROXY を使うには、クライアントに利用可能なプロキシの選択肢が必要です。このテキストをコピーするだけでは、サーバー設定、認証情報、サブスクリプションの追加を代替できません。

[General]
bypass-system = true
dns-server = system

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

設定ファイル、サーバー一覧、現在の接続状態は、それぞれ異なるものです。サーバー一覧には接続に必要な情報が保存され、設定ファイルには通信の処理方法が記述されます。接続のオン・オフは、システム通信を現在の処理に通すかどうかを決めます。ファイルが一覧にあるだけでは選択中とは限らず、ファイルを選択していても、通信が必ずそのルールに従うとは限りません。確認時は Global Routing の現在のモードも確認し、一時的に Proxy または Direct に切り替えたまま戻し忘れていないか注意してください。

開く・編集する・切り替えるは別の操作

Config(設定ファイルの画面)を開き、まず使用中のファイルを確認してから、編集または詳細画面に進みます。画面上の操作位置はプラットフォームによって異なるため、アプリに表示される実際の項目名を確認してください。変更前に元ファイルを複製し、保存後は解析エラーがないことを確認してから、選択中の項目を改めて確認します。問題の切り分け中は、今回のテスト対象となる複製を1つに絞るのがおすすめです。同名ファイル、リモートファイル、ローカルの複製が混在すると、使用中ではないファイルを編集してしまうことがあります。

セクション主な役割確認する項目
[General]基本動作と解析の設定項目名、値、適用条件
[Rule]リクエスト条件に応じたポリシー選択条件の範囲、並び順、フォールバックポリシー
[Host]ドメインとIPアドレスの固定対応付けアドレスの有効性と名前解決への適用範囲
[URL Rewrite]URLのマッチと書き換え式、置換先、確認できるリクエストの範囲

ファイル内の空行は読みやすくするための区切りであり、前後のルールを別々の処理に分けるものではありません。一方、セクション名が変わると、以降の内容の解釈も変わります。ファイルを手作業で統合する際は、ルール本文だけをコピーして所属セクションを忘れたり、別ファイルの基本設定をルールの末尾につなげたりしがちです。安全に統合するには、ファイル全体を単純に連結せず、セクションごとにまとめて比較してください。重複項目は推測で処理せず、曖昧さを取り除いて保存結果を確認します。

Webページやチャットから設定をコピーする際は、全角カンマ、曲がった引用符、見えない空白、長い行の自動折り返しに注意してください。ルールの区切りには半角カンマ、キーと値の区切りには通常イコールを使います。画面上の折り返しはファイル内の改行とは限りませんが、貼り付け時に実際の改行が入ることがあります。ルールが不完全な複数行に分かれてしまった場合は、ルールを追加して補うのではなく、プレーンテキストの編集画面で内容を確認してください。

問題の範囲に応じて、参照する順序を変えられます。ファイルを保存できない場合は構成と構文、通信が想定外のポリシーに進む場合はモードと評価順序、ドメインを解決できない場合は基本設定とアドレス対応付け、特定のURLだけ遷移がおかしい場合は書き換えを確認します。「ファイルを読み込めるか」「ルールにマッチするか」「マッチ後に接続できるか」を分けて判断することで、サーバーの利用不可をルールの構文エラーと取り違えにくくなります。

02 · General、DNS、基本動作

[General] は基本動作を設定するセクションであり、ドメインごとにプロキシを選ぶものではありません。ここを読む際は、まず、その項目がどのリクエストに影響するのか、名前解決の方法を変えるのか、システムの機能に関係するのかを確認します。別の設定ファイルに項目が多く並んでいるからといって、項目が多いほど完全というわけではありません。意味を理解していない値は、問題の切り分け範囲を広げます。必要な設定だけを残し、それぞれの値の役割を説明できるファイルのほうが、検証やメンテナンスをしやすくなります。

例にある2つの項目を確認

bypass-system = true はシステム関連の通信をバイパスする動作を有効にします。ただし、これを根拠に「すべてのDIRECTルールが不要」と判断したり、システムプロキシを無効にする設定と解釈したりしないでください。対象となるシステム通信の範囲は、アプリの設定と実行環境を確認する必要があります。dns-server = system は、システムのDNSを名前解決に使う設定です。解決結果が固定されるわけではなく、どのネットワークでも同じ結果になることを保証するものでもありません。

[General]
bypass-system = true
dns-server = system

ドメインの名前解決とルーティングは関連しますが、同じ処理ではありません。ドメイン条件は、リクエストに含まれるドメイン名やクライアントが認識したドメイン名を基に判定できます。アドレス条件では、比較できる宛先IPアドレスが必要です。リクエストによっては最初からドメイン名しかなく、IPアドレスを直接指定するものもあります。また、キャッシュにより前回の結果を使って接続する場合もあります。そのため、ブラウザーにドメイン名を入力したというだけで、毎回名前解決が行われるとは限りません。今回のリクエストが必ず特定のDNSサーバーを通るとも限りません。

名前解決の失敗と接続の失敗を切り分ける

アクセスできない場合は、まず失敗した段階を確認します。ドメイン名から有効なアドレスを取得できない場合は、現在のネットワークの名前解決機能、システムDNS、固定マッピングを確認します。アドレスが取得できているのに接続できない場合は、ポリシー、プロキシサーバー、接続先サービスを確認します。最終ポリシーをDirectからProxyに変えるだけでは、誤った固定アドレスが修正されるとは限りません。名前解決に成功しても、そのアドレスに現在の接続経路からアクセスできるとは限りません。

Wi-Fiとモバイル通信を切り替えると、システムが使うDNS、ローカルネットワークのアドレス、アクセス可能な範囲が変わる場合があります。社内ネットワークのホスト名は特定のネットワークでしか解決できないことがあり、家庭内機器のアドレスはルーターから割り当てられる場合があります。公開サイトでも、接続元のネットワークによって異なるサービスアドレスが返ることがあります。切り分けでは、まずネットワークを固定して明確な対象を1つテストしてください。ネットワークの切り替え、DNSの変更、サブスクリプションの更新、ルールの変更を同時に行うと、アクセスが復旧しても原因を特定できません。

複数の設定元にあるDNS設定を機械的にまとめないでください。項目によって、名前解決元、フォールバック条件、特定状況での処理など、役割が異なる場合があります。見た目はどれも「アドレスを追加する」設定でも、リクエストの順序や失敗時の動作を変えることがあります。このページでは再現しやすい基本的な例を紹介しています。より細かい動作を変更する場合は、現在のクライアントの項目説明を確認し、対象を1つに絞って比較テストを行ってください。明確な問題がない場合は、項目を増やすためだけに名前解決の方法を変更する必要はありません。

キャッシュと再テストの注意点

名前解決に関する設定を変更しても、古い接続やキャッシュがしばらく結果に影響する場合があります。対象のリクエストを終了し、必要に応じてクライアントの接続を再確立してから、新しいアクセスを試してください。アプリに関連する記録やキャッシュ操作がある場合は、実際の画面で確認します。更新後も古いページが表示されるからといって、ルールが保存されていないとは限りません。ブラウザーのコンテンツキャッシュ、アプリの長時間接続、DNSキャッシュは別々の層にあり、1つを消去しても他のものには影響しない場合があります。

基本設定を記録する際は、現在のネットワーク、システムが追加のネットワーク設定を使用しているか、テスト対象がドメイン名かIPアドレスかを明記します。組織のネットワークや管理対象デバイスでは、ルールの検証を目的に組織指定の設定を勝手に削除しないでください。まず元に戻せる比較条件を用意し、その後、項目ごとに切り分けます。同じファイルがネットワークによって異なる動作をする場合、ファイルの内容が変わったのではなく、環境条件が変わった可能性があります。

設定項目を残す基準は、用途を説明でき、現在の環境で検証でき、元に戻す方法があることです。問題が解決したら、一時的に追加した不明な値を削除し、元ファイルの複製と簡単な変更記録を残します。問題が特定の対象に限られる場合は、後述のドメイン条件やアドレス条件を確認してください。すべての対象で失敗する場合は、ルールに同じ条件を追加し続けず、接続方法と既存サーバーの状態も確認します。

03 · Global Routing と3つのポリシー

Global Routing は全体の通信モードを決め、ルール末尾のポリシーは個々のルールにマッチした後の処理を決めます。名称は似ていますが、異なる階層の設定です。画面上の Config(設定)、Proxy(プロキシ)、Direct(直接接続)は全体のモードを選びます。設定ファイル内の PROXY、DIRECT、REJECT はルールのポリシーです。設定が有効か判断するには、片方だけでなく両方を確認してください。

まずモードを確認し、次にルールを調べる

日常的にルールに沿って通信を振り分ける場合は、Config を選び、使用する設定ファイルを確認します。Proxy モードでは通信全体がプロキシ経由となるため、この状態で特定のドメインがルールによって直接接続されるかは検証できません。Direct モードでアクセスに成功しても、プロキシサーバーが正常とは判断できません。ここで説明しているのは全体の振り分け方針です。システム側の除外設定や通信の可視範囲なども個々のリクエストに影響するため、モード名がすべてのシステム通信を制御する保証と考えないでください。

画面上のモード主な役割確認時の注意点
Config(設定)現在のファイルのルールに従って振り分けファイル、ルールの順序、最終的にマッチした項目を確認
Proxy(プロキシ)一時的にプロキシ経由の経路を確認ルール内の直接接続条件が有効かどうかの確認には使えない
Direct(直接接続)一時的に直接接続の経路を確認接続できてもプロキシサーバーが利用可能とは限らない

ルールで使う3つのポリシー

PROXY は現在選択されているプロキシに処理を渡します。設定ファイルが常に利用可能なサーバーを自動指定するという意味ではありません。サーバーの停止、認証情報の不一致、プロトコルパラメーターの誤りがあれば、このポリシーにマッチしても接続に失敗します。DIRECT は現在のネットワークから直接接続しますが、ローカルの名前解決、ルーティング、接続先サービスに依存します。REJECT はマッチした通信を拒否します。「速度の速い経路を選ぶ」ためのものではなく、原因を特定できないエラーに対する汎用的な修正方法でもありません。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN,service.example.com,PROXY
FINAL,DIRECT

上の拒否ルールは例示したホストだけにマッチし、直接接続とプロキシのルールもそれぞれ明確なホストを対象にしています。設定ファイルが速度を測定するわけではなく、プロキシ接続に失敗したとき、リクエストを自動的に直接接続へ切り替えることもありません。フォールバック動作が必要な場合は、現在のクライアントが対応する仕組みを提供しているか確認し、明示的に設定してください。複数のポリシー名を記載しただけで自動的に障害を回避できるわけではありません。通常、1行の末尾には、その条件にマッチした場合の処理結果を1つ指定します。

接続テストと実際のリクエストは分けて考えます。Connectivity Test(接続テスト)で結果が得られても、それは該当テストの条件で結果が得られたというだけで、対象サイトへの実際のリクエストを代替しません。対象によっては、異なるポートや通信機能が必要な場合や、複数の関連ドメインに依存する場合があります。まず既存サーバーが基本的に利用できることを確認し、次に対象が想定したポリシーにマッチすることを確認してから、実際のサービスが一連の処理を完了できるか調べてください。この3段階を混同しないようにします。

一時的な確認モードからConfigに戻す

一時的にProxyモードへ切り替えてアクセスできるようになった場合、プロキシ経由の経路を調べる価値があることは分かりますが、問題のルールが特定できたわけではありません。Configモードに戻し、失敗したリクエストが本来どのルールにマッチしたか確認します。Directに進んでいた場合は、適切なルールがないのか、広い条件に先にマッチしたのか、ドメイン名を認識できなかったのかを調べてください。特定の対象のために一時モードのまま使い続け、他のアプリも設定ファイルの例外ルールに従っていると思い込まないようにします。

Directモードでは成功しProxyモードでは失敗しても、すべてのルールをDirectに変更すべきとは限りません。プロキシサーバーが利用できない、接続先がその出口からの通信を受け付けない、サーバー設定と利用者の情報が一致しないなどの可能性があります。対象とネットワークを変えず、変更する条件は1つだけにし、テストごとのモードと結果を記録してください。3つのモードの操作方法は、Global Routing の3つのモードの違いをご覧ください。

設定をメンテナンスする際は、各ポリシーの目的を説明できるようにします。このホストにプロキシが必要な理由、このネットワークを直接接続する理由、この対象を拒否する理由を記録してください。用途が分からない広範囲の拒否ルールは、ログイン、更新、リソース読み込みに影響する可能性があるため、特に慎重に扱います。トップページが表示されるかだけでなく、日常的に必要な操作も確認してから、ポリシーの変更を残すか戻すか判断してください。

04 · DOMAIN 系ドメインルール

ドメインルールは「どのホストをどの経路にするか」を表すのに適しており、思いついたIPアドレスをいくつか集めるより意図を把握しやすい方法です。よく使われる条件は DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD の3つです。それぞれ、完全一致するホスト名、ドメイン境界に沿ったサフィックス、ドメイン名に含まれる文字列を条件にします。まず対象範囲を明確にし、必要十分な最も狭い条件を選んでください。記述が簡単だからといって、安易にキーワード条件を使わないようにします。

完全一致とサフィックス一致

DOMAIN は指定したホスト名だけを対象にします。api.example.com の完全一致ルールは、example.com や同じサービスの画像用ホストまで自動的に対象にするものではありません。DOMAIN-SUFFIX はドメイン自体とそのサブドメインを対象にします。たとえば example.com と api.example.com が該当します。サフィックスルールはドメインの境界に沿って判定されるため、似た文字列で終わるだけの別ドメインを同じ範囲として扱いません。

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

このルール群では、まずAPIホストにプロキシの例外を設定し、同じドメイン範囲のその他の対象をDirectにしています。これは「完全一致の例外を先に、広い範囲の条件を後に」置く例であり、完全一致ルールが自動的に上位へ並べ替えられるわけではありません。2行を入れ替えると、APIホストが先にサフィックス条件にマッチし、必要な例外が適用されなくなります。ファイルを読むときは実際の行順に沿って確認し、具体的なルールが自動で先頭に移動すると考えないでください。

キーワード条件は範囲を絞る

DOMAIN-KEYWORD はドメイン名に指定した文字列が含まれているかを調べる条件であり、ドメインへの所属関係を表しません。example というキーワードは、example.com のサフィックス条件より広い範囲を対象とし、異なるドメインにもマッチする可能性があります。このような広い条件が必要だと確認できている場合には使えますが、「完全なドメイン名がまだ分からない」状況の恒久的な代替には向きません。短すぎるキーワードは誤マッチと切り分けの手間を増やします。

ルールマッチ範囲の例よくある範囲の違い
DOMAIN,api.example.com,PROXY指定したAPIホスト同じドメインの他のホストは自動的に含まれない
DOMAIN-SUFFIX,example.com,DIRECT指定ドメインとそのサブドメイン似た任意の文字列を対象にするものではない
DOMAIN-KEYWORD,example,PROXYドメイン名に指定文字列を含むホスト無関係なドメインにマッチする可能性がある

ドメイン条件にはホスト名を指定し、完全なURLは指定しません。スキーム、ポート、パス、クエリパラメーターはドメイン名の一部ではありません。サフィックス欄にURL全体を貼り付けると、通常はルールの対象から外れてしまいます。一般的なドメイン条件ではURLのパスによる違いを判定できません。同じホストのログインページと画像パスに、同じドメインルールが適用される場合があります。URL単位で処理する場合は、ドメイン名にスラッシュを加えるのではなく、後述の書き換え条件と範囲を確認してください。

1つのページが複数のドメインを使うことがある

トップページは開けるのにログインできない場合でも、メインドメインのルールが間違っているとは限りません。認証API、静的リソース、別のサービス用ドメインにもリクエストが送られている可能性があります。実際に失敗したリクエストからホスト名を確認し、必要に応じて個別のルールを追加してください。ブランド名を含むすべてのドメインに同じポリシーを設定するのは避けましょう。名前が似ているだけでは、用途や必要な接続経路が同じとは限りません。

ログインや決済など一連の処理を確認する場合は、トップページを再読み込みするだけでなく、入口、リダイレクト、コールバック、必要なリソースまで同じテスト中に確認します。APIにプロキシが必要でメインページはDirectでよい場合は、その違いを個別の条件として残して動作を確認してください。クロスドメインのリクエスト失敗は、サーバー側の権限、アカウント状態、アプリのキャッシュが原因の場合もあります。ルールが決めるのは接続経路だけであり、認証情報の誤りや接続先サービスの制限は修正できません。

同じドメインのルールが複数ある場合は、最初にマッチする位置で判断します。まったく同じ条件に異なるポリシーを指定しても、後のルールが「予備」として使われるわけではありません。一方のサフィックスルールが他方を含む場合は、対象範囲の重なりを確認します。ファイルを整理する際は、まず同じホスト名を探し、次に親ドメインとサブドメイン、最後にキーワードと他の条件との重なりを調べます。重複を削除する前に複製を保存し、テキストだけを基準に削除せず、残すルールが正しい位置にあることを確認してください。

ドメインルールが効かないように見えるときは、対象がそのホスト名で新しい接続を開始しているかを確認し、リクエスト記録でドメインを識別できるかを調べます。IPアドレスへの直接アクセス、既存接続の再利用、異なるリダイレクト経路などにより、想定した対象と実際の対象が異なることがあります。リクエストと条件が一致していると確認してから、ルールの順序を調べてください。対象を誤ったまま同じ意味のルールを追加し続けても、実際に失敗したリクエストには対処できません。

05 · IP-CIDR、GEOIP、USER-AGENT

アドレスルールが扱うのは接続先のIPアドレスであり、Webサイト名ではありません。IP-CIDR はIPv4アドレスの範囲、IP-CIDR6 はIPv6アドレスの範囲を指定します。GEOIP はIPアドレスの地域情報に基づいて分類します。これらはドメインルールと併用できますが、判定基準は異なります。リクエストから取得できる情報を確認して条件を選んでください。ドメインのサフィックスやページの言語だけを根拠に、特定の地域分類にマッチすると判断することはできません。

CIDRはIPアドレスの範囲を表す

192.168.0.0/16 は該当するプライベートIPアドレスの範囲を表し、「現在接続中のすべてのLAN」を意味するわけではありません。家庭内ネットワークでは別のプライベートアドレス範囲を使う場合があり、組織のネットワークでも独自の構成が使われることがあります。LAN内サービスのルールを書く前に、実際の接続先アドレスとネットワーク範囲を確認してください。Webで見つけたネットワーク範囲を、現在の環境にそのまま当てはめないようにします。ルールが通信を許可してもネットワーク経路が自動で作られるわけではないため、到達できないネットワークではDirectにしても接続できません。

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR6,fc00::/7,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

例にはプライベートアドレス範囲、IPv6のローカルアドレス範囲、アドレスの地域分類を示していますが、すべての利用者がそのまま有効にする必要はありません。プレフィックス長が大きいほど、通常、対象の範囲は狭くなります。IPv4アドレス1つは /32、IPv6アドレス1つは /128 で指定できます。編集時はアドレスとマスクが同じアドレスファミリーか確認してください。IPv6アドレスをIPv4用のルールタイプに記述したり、通常のポート番号をプレフィックス長と取り違えたりしないようにします。

名前解決オプションは性能設定ではない

アドレスルールで比較するには、ドメイン名の名前解決が必要になる場合があります。対応するルールに no-resolve を付けると、その条件にマッチさせる目的だけで名前解決を開始しないようにできます。「端末全体でDNSを使わない」という意味ではありません。リクエストにすでにIPアドレスが含まれていれば、アドレス条件にマッチする場合があります。ドメイン名しかなく、利用可能なIPアドレスがない場合、このオプション付きルールにはマッチできず、後続のルールへ進む可能性があります。追加するかどうかは、期待する動作に応じて判断してください。

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

GEOIP,CN,DIRECT はIPアドレスの地域分類に基づく条件です。ドメイン名に含まれる文字列で判定するものではなく、関連するサイトがすべて同じ地域のIPアドレスだけを使うことを示すものでもありません。コンテンツ配信、サービスの移行、データ更新などにより、実際の結果が想定と異なる場合があります。特定のサービスでポリシーを安定させたい場合は、まず具体的なドメインを確認し、明示的なルールを設定するのが一般的です。地域分類は判断材料の1つであり、サービスの所属先を証明するものではありません。

USER-AGENTで識別できる範囲

USER-AGENT はリクエストに含まれる該当フィールドのクライアント識別子を条件にします。OSがアプリのプロセスごとに通信を振り分ける機能とは異なります。複数のアプリが同じ識別子を使うことも、1つのアプリがリクエストの種類によって異なる値を使うこともあります。さらに、通常の暗号化接続では内部のリクエストフィールドが自動的に見えるわけではありません。アプリ名を書けば、そのアプリのすべての通信を識別できるとは限りません。この条件を使う前に、対象のリクエストで実際に照合できる情報が提供されていることを確認してください。

[Rule]
USER-AGENT,ExampleClient*,PROXY
FINAL,DIRECT

ここにある識別子はワイルドカードによるマッチ方法を示す例で、実在するアプリの固定識別子ではありません。テストでは、閲覧権限のあるリクエストから実際の値を確認し、大文字・小文字、空白、ワイルドカードの範囲を照合してください。ブラウザーに表示されるアプリ名を完全なリクエストフィールドとみなしたり、複数のアプリ名を推測でルールに並べたりしないでください。フィールドを確認できない場合は、マッチしない原因をプロキシサーバーの障害と決めつけず、検証済みのドメイン条件を優先します。

アドレス、ドメイン、リクエストフィールドの条件に、あらかじめ決まった全体的な優先順位はありません。いずれもルールセクションに記載された順序で評価されます。広範囲のアドレス条件が先にあると、後続のドメイン例外より先にマッチする場合があります。リクエスト識別子の条件が広すぎると、ドメインで分けていた結果を変える可能性もあります。メンテナンス時は条件の種類と並び順を合わせて確認し、残したい例外をテストできる対象を用意してください。条件を種類ごとに分けて構文だけ確認しても十分ではありません。

同じドメインがテストによって異なるポリシーに進む場合は、IPv4とIPv6のどちらで接続したか、異なるIP範囲にマッチしたか、名前解決の結果が変わったかを確認します。すぐにどちらかのアドレスファミリーを削除して解決しようとしないでください。まず対象が実際に使ったアドレスを確認し、両方のアドレスファミリーに対するルールが同じ意図を表しているか比較します。環境上の制約がある場合は条件と元に戻す方法を記録し、ネットワーク変更後に再検証してください。

06 · 評価順序、例外、FINAL

[Rule] を読む基本は、上から順に条件を確認し、最初にマッチしたルールのポリシーを適用することです。複数のマッチ結果で多数決を取ったり、すべての結果をまとめてからポリシーを選んだりする仕組みではありません。完全一致のルールがサフィックスルールより自動的に優先されることも、ドメインルールがアドレスルールより優先されることもありません。優先順位はまず行の順番で決まります。これを理解すれば、同じルールを使った2つのファイルでも、並び順だけで結果が変わる理由を説明できます。

具体的な例外を広範囲の条件より先に置く

よく使われる構成は、明確な例外を先頭に置き、通常のグループを中段に、フォールバックを最後に置く方法です。たとえば特定のAPIにはプロキシが必要で、同じ親ドメインの他のホストはDirectにする場合、APIの完全一致条件を親ドメインのサフィックス条件より前に置きます。「例外を先に」は整理の原則であり、条件を特定の分類順に機械的に並べる決まりではありません。特定のアドレス範囲を優先する必要がある場合も、まずどのドメインのリクエストを対象にするか明確にしてから順序を決めてください。先に順番をコピーして、後から用途を考えるのは避けます。

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

APIホストを例にすると、1行目で条件にマッチすればプロキシが選択され、後続の親ドメイン条件で結果が変わることはありません。同じドメインの別ホストでは1行目にマッチせず、サフィックス条件によってDirectになります。これらのドメインや指定アドレス範囲に該当しない対象は、さらに下のルールで判定されます。1行ずつ確認するときは、各条件について「マッチ」「マッチしない」「現在の情報では判定できない」と記録してください。印象だけで最終結果を決めないようにします。

FINALはフォールバックであり、自動修復ではない

FINAL は、それ以前の条件にマッチしなかった場合の最終ポリシーを指定します。ドメインなどのパラメーターは不要で、FINAL,PROXY や FINAL,DIRECT のように記述します。通常は前の具体的な条件が評価されるように、ルールセクションの末尾に置きます。先頭に置くと、通常のルール評価では後続のルールに意味がなくなります。複数のFINALを予備として使うこともできません。意図を確認しやすくするため、明確な最終ポリシーを1つ指定してください。

広範囲のキーワード、地域分類、親ドメインのサフィックスは、後続の例外より先にマッチする可能性があります。ルールが効かないように見える場合は、同じ文字列のルールだけでなく、上にあるすべての条件が対象を含んでいないか確認します。まったく同じ行の重複は見つけやすい一方、対象範囲が重なっている行は見落としがちです。問題の対象を1つ選び、現在のファイルを先頭から順にたどって最初にマッチする行を確認してから、位置を変更してください。複数のセクションへ対象ルールをむやみに複製しないようにします。

比較表で変更の意図を検証する

ルールの順序を変更する前に、対象の種類ごとに明確なサンプルを選びます。完全一致の例外ホスト、同じ親ドメインの別ホスト、LAN内アドレス、フォールバック対象などを用意し、期待するポリシーを記録してから変更後の結果を確認してください。問題のホストだけをテストすると、例外は直っても親ドメインの他のリクエストを損なうことがあります。サンプルは多くなくても構いませんが、ルールの境界を網羅してください。広い範囲の条件を追加するたびに、誤って対象に含まれる可能性があるサンプルも少なくとも1つ追加します。

テスト対象最初にマッチする想定ルール想定ポリシー
api.example.comドメインの完全一致例外PROXY
www.example.com親ドメインのサフィックス条件DIRECT
192.168.1.20プライベートIPアドレス範囲DIRECT
先行条件にマッチしない対象FINALPROXY

異なる設定元のファイルを統合するときは、元ファイルそれぞれのフォールバックと例外を確認してください。個別には正常に動く2つのファイルでも、統合後に同じように動くとは限りません。既定のポリシーが互いに異なる場合があります。まず最終ポリシーを1つに決め、必要な例外を同じルールの流れにまとめ、最後に条件の重なりを確認します。2つのファイルの順序をそのまま残せば、クライアントが異なる作成者の意図を自動で理解すると思い込まないでください。

テストが終わったら、一時的に先頭へ移動したルールを整理します。切り分けのために対象を一時的に最上位に置くと経路の確認に役立ちますが、そのまま残すと、後から追加した業務上の例外より先にマッチすることがあります。最終的なルールは説明できる位置に戻し、変更理由も記録してください。ルールには正しくマッチするのに接続できない問題は、最終章の検証手順またはルールとトラブル対処のFAQを参照してください。評価順序とは無関係の問題を、並び替えで解決しようとしないでください。

07 · Host と URL Rewrite の役割の違い

[Host] と [URL Rewrite] は最終的なアクセス結果を変える場合がありますが、同じ処理ではありません。前者はドメインとIPアドレスの固定対応付けを行い、後者は条件にマッチするURLを書き換えます。どちらも [Rule] のポリシー選択とは異なります。問題を切り分ける際は、アクセスするホスト名、ホスト名に対応するIPアドレス、URLの変更有無、接続に使うポリシーをそれぞれ確認してください。これらを混同すると、名前解決、リダイレクト、通信の振り分けを誤って判断しやすくなります。

Hostの固定マッピングは既知で管理可能なアドレスに使う

以下は文書用の例示ホストを、説明用のアドレスに対応付けた例です。書式の確認用であり、実際のサービスアドレスとして使用しないでください。イコールの左側はドメイン名、右側はIPアドレスです。プロキシのポリシーではありません。マッピングを設定すると対象の名前解決に指定アドレスが使われますが、プロキシ経由かどうかは実際のルールと現在のモードで決まります。同じドメインに固定マッピングとプロキシルールがあっても構文上の矛盾ではありません。異なる階層の動作を指定しています。

[Host]
lab.example.com = 192.0.2.10

固定マッピングは、管理責任が明確なテストサービスや内部サービスに適しています。動的な振り分けに依存する公開サイトに安易に使わないでください。接続先サービスの移行、アドレス変更、コンテンツ配信方法の変更により、古いアドレスが無効になったり、適切でないサービスを指したりすることがあります。設定を保存できても、アドレスが正しいとは限りません。用途と検証条件を記録し、通常の名前解決が復旧した後に固定マッピングがまだ必要か確認してください。一時的な対処が長期間残ることを防げます。

暗号化されたWebサイトに接続する場合、固定アドレスを設定しても証明書内のドメイン名は書き換わらず、証明書検証エラーも解消されません。指定先のIPアドレスが該当ホストのサービスを提供していない場合は、接続できてもページが誤って表示されたり、証明書が一致しなかったり、サービスに拒否されたりする可能性があります。セキュリティ警告を無視してマッピングの正しさを確認しようとせず、アドレスの割り当て先とサービス設定を確認してください。ドメイン名でのアクセスとIPアドレスを直接入力するアクセスは、まったく同じテストではありません。後者では接続先に伝わるホスト情報が変わることがあります。

URL Rewriteは条件にマッチするURLを処理する

書き換えルールは一般に、マッチ式、置換先、アクションで構成されます。以下は例示ホストのHTTP URLを、同じホストのHTTPS URLへリダイレクトし、後続のパスを保持する例です。式のドットにはバックスラッシュを付け、任意の1文字ではなくドメイン内の文字として指定しています。先頭のアンカーはURLの先頭からマッチさせるためのものです。この例は構文と範囲を説明するもので、あらゆる接続先に同じリダイレクトが適切という意味ではありません。

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

ここで 302 はリダイレクトのアクションで、$1 は前の括弧でキャプチャした内容を参照します。式を変更したら、マッチ範囲と置換後の結果を合わせて確認してください。スラッシュが重複していないか、パスが失われていないか、クエリパラメーターが想定どおり保持されるかに特に注意します。個人情報を含まない簡単なテストパスで確認してから、実際の用途で必要なパラメーターを検証してください。認証情報を含む完全なリクエストを公開の問い合わせに貼り付けないでください。

暗号化リクエストとリダイレクトループは別途確認する

通常の暗号化接続では、完全なURLパスがクライアントから自動的に見えるわけではありません。設定に書き換えセクションがあっても、すべての暗号化リクエストが検査・書き換えされるとは限りません。このページでは、ルールによる振り分けのために追加の復号処理を有効にすることを推奨していません。ドメインごとにポリシーを選ぶ多くの用途では、URL書き換えも必要ありません。特定サイトをプロキシ経由にしたいだけなら、そのサイトのURLをすべてリダイレクトしようとせず、ドメインルールを検討してください。

リダイレクトループは、遷移先URLが元の式に再びマッチする場合や、2つのルールが互いにURLを書き戻す場合によく発生します。テストでは最終URLが繰り返し変化していないか確認し、追加したばかりのルールを1つずつ無効にして比較します。接続先サービス自体がリダイレクトしていることもあるため、すべてのループがローカルルールの原因とは限りません。最小限の書き換え条件を残し、そのセクションを無効にした場合と比較すると、ループがローカル処理と接続先のどちらで発生するか切り分けられます。

書き換えルールを含む設定を統合する前に、各ルールの目的、対象ドメイン、適用範囲を確認します。保存できるかどうかだけでは不十分です。範囲が広すぎる式は無関係なパスに影響することがあり、固定マッピングによって複数の機能が誤ったアドレスに接続される場合もあります。明確な用途がなければ、元ファイルを保管したうえで該当セクションを有効にしないでください。振り分けの問題にはまずルールを使い、固定の名前解決やURL書き換えが必要な場合は、それぞれを別に追加して個別のテストと復元方法を用意します。

08 · 検証、トラブル対処、設定のメンテナンス

設定が正しいかどうかは、ファイルを保存できるかだけでなく、「期待する処理」と「実際の結果」を比較して判断します。保存に成功した場合、主に現在の構文チェックを通過したことが分かります。リクエストが想定したルールにマッチすれば、振り分けの判断が設計どおりだと分かります。実際の操作が成功して初めて、そのテストでは現在のネットワーク、サーバー、接続先サービス、利用条件がそろったと判断できます。それぞれの結論が示す範囲は異なるため、記録をまとめて「すべて正常」と判断しないでください。

元に戻せる最小限の検証手順を作る

開始前に使用中のファイルを複製し、選択中のファイル、Global Routingのモード、ネットワーク環境、選択中のサーバーを記録します。次に、対象ドメインのルール位置だけを変更するなど、条件の種類を1つに絞って変更してください。名前解決元などを同時に変更しないようにします。保存後に設定が反映されたことを確認して、対象へのリクエストを新たに開始します。アプリで利用できる接続記録やリクエスト記録を開き、ホスト名、接続先IPアドレス、マッチしたルール、処理ポリシーを確認してください。記録画面の場所はプラットフォームによって異なるため、実際の画面で確認します。

実際のポリシーが想定と異なる場合は、まずモードと使用中のファイルを確認し、次に上から順にルールの重なりを調べます。ポリシーは正しいのに接続できない場合は、サーバー設定、接続先サービス、現在のネットワークを確認します。ページの一部の機能だけ失敗する場合は、設定全体を書き換えず、失敗したリクエストのホスト名を調べます。このように順を追って分岐すれば、無関係な変更を減らし、元に戻す操作も簡単にできます。今回の変更を取り消せば、テスト前の状態に戻れるようにしてください。

確認された現象まず確認する項目すぐに決めつけないこと
ファイルを保存できないセクション名、カンマ、項目数、改行サーバーが利用不能になった
リクエストのポリシーが想定と異なる使用中のファイル、モード、最初にマッチした条件接続先サイトの障害が確定した
ポリシーは正しいが接続できないサーバー設定、名前解決、接続先への到達性同じルールをもう1つ追加すれば復旧する
トップページは表示されるがログインできない認証API、リダイレクト、関連ドメイン親ドメインのルールがすべての機能をカバーしている

サーバーやサブスクリプションの問題をルールで解決しない

既存サーバーがタイムアウトする場合は、アドレス、ポート、認証情報、プロトコル関連項目、システム時刻を順に確認し、利用者自身の情報と一致していることを確かめます。すべての失敗をDirectに変更して解決しようとしたり、サブスクリプションを何度も更新すればローカルルールの順序が変わると思ったりしないでください。サブスクリプションの更新で変わるのは主に提供されるデータです。設定ファイルは別の場所から取得している場合があり、両者が連動するかは現在の利用方法によります。詳しい手順はサーバーのタイムアウトと接続失敗の確認方法をご覧ください。

複数の既存サブスクリプションを管理する場合は、サブスクリプショングループ、手動で追加した項目、設定ファイルを区別してから、削除する内容を確認してください。更新後に項目が重複しても、同じルールをさらに追加する必要があるとは限りません。項目を識別する目的で、アクセス認証情報を含む完全なURLを設定メモに書かないでください。複数サブスクリプションのグループ分けと重複項目の管理を参考に、まず登録元を整理してから、接続とルールの関係を確認します。

リモート更新とローカル編集を分けて保存する

リモート設定の更新でローカルの変更が置き換わるかどうかは、ファイルの入手元と更新方法によって異なります。カスタムルールを長期間使う場合は、現在のファイルが独立したローカル複製なのか、リモートの内容で引き続き更新されるのかを確認してください。更新前に複製を保存し、更新後はファイル名が同じかだけでなく、基本項目、例外ルール、最終ポリシーを比較します。用途が分からない同名ファイルを複数管理しないようにしてください。ファイル名で用途を示せても、実際に適用中かどうかは別途確認が必要です。

問題の切り分け情報を共有する場合は、必要最小限のルール部分と、個人情報を取り除いた状況説明だけを提供してください。サーバーアドレス、サブスクリプションURL、パスワード、認証項目、個人的なアクセス先には機密情報が含まれる可能性があるため、共有前に削除します。例には文書用ドメインを使い、ルールの種類と順序は残してください。これで条件の重なりを確認できます。スクリーンショットも通知、一覧、ログに機密情報が映っていないか確認してください。一部分だけを切り取ったからといって、認証情報が写っていないとは限りません。

複数のデバイスで使う場合は、システムのネットワーク環境と、現在のクライアントで利用できる設定画面をそれぞれ確認してください。あるデバイスの結果を、すべてのプラットフォームにそのまま当てはめないようにします。Shadowrocket は iPhone、iPad、Mac、Windows、Android、Linux 向けに提供されています。iPhone/iPad 版は App Store で2.99米ドルの買い切り、Mac(Appleシリコン/Intel)、Windows、Android、Linux 版は無料です。入手方法と初回インストールについてはダウンロードページのインストール案内をご覧ください。iPhone/iPadのシステム要件はApp Storeの記載をご確認ください。

最後に日常使用するルーティングモードへ戻し、一時的なテストルールを削除します。最終版のファイルと簡単な変更記録を残し、事前に用意した境界条件のサンプルで再テストしてください。次に問題が起きたときは、設定全体をすぐに変更せず、ネットワーク、サーバー、設定のどこが変わったかを比較します。サブスクリプションの追加と初回接続はクイックスタートガイド、項目の意味は用語集、よくある操作の質問はFAQをご覧ください。初回操作、設定項目の参照、トラブルの切り分けをそれぞれ適切なページで確認できます。