公式マニュアル · ルールリファレンス

Shadowrocketのルール・設定リファレンス完全ガイド

まず現在の設定とGlobal Routingを確認し、リクエストがどのルールに一致したかを判断します。設定ファイルは照合条件を定め、ポリシーは一致後の処理を決めます。両者を分けて確認してください。

このページは、設定を詳しく確認するためのマニュアルです。自分のサブスクリプションまたはサーバー情報をすでにお持ちで、ルールを調整したい方を対象としています。初めて使う場合は、まずかんたんセットアップガイドに沿って追加、接続、基本的な動作確認を行ってから、該当する章で構文を確認してください。以下では追加や接続に触れる際にもガイドを案内し、インストール手順を重複して説明しません。

ShadowrocketはiPhone、iPad、Mac(Appleシリコン/Intel)、Windows、Android、Linuxに対応しています。プラットフォームによって画面上の場所は異なる場合があるため、以下では設定キーワードと実際の照合動作を基準に確認します。入手方法とOSのインストール許可手順は全プラットフォームのダウンロード案内をご覧ください。

General Rule Host URL Rewrite

設定ファイルの構成と安全な編集手順

設定ファイルは設定項目とルールをまとめたもので、サブスクリプションURLやサーバー一覧とは異なります。サブスクリプションからは通常、プロバイダーが管理するサーバー情報を取得します。一方、設定ファイルはリクエストの解析、照合、処理方法を定義します。両者は連携して使えますが、サブスクリプションを更新しても現在のルールが正しいとは限らず、ルールを変更してもサーバーの接続情報は修正されません。編集を始める前に、Configで使用中のファイルを確認してください。端末にダウンロードしたばかりの同名ファイルを見るだけでは不十分です。

4つのセクションの役割

[General]にはDNSやシステムトラフィックの処理方法など、全般的な設定を記述します。[Rule]には照合条件とポリシーを1行ずつ記述します。[Host]では指定したホスト名に静的な名前解決を設定します。[URL Rewrite]では正規表現を使ってURLの書き換えやリダイレクトを定義します。セクション名は構文の一部なので、日本語に置き換えないでください。また、セクション名を省略して、あるセクションの内容を別のセクションの末尾に追加しないでください。

以下は構成を理解するための例であり、個人用の設定をそのまま置き換えられる完全な設定ではありません。例に含まれるドメインは説明用です。PROXYを使う場合は、利用可能なサーバーを選択する必要があります。実際の設定には、ここで取り上げていないセクションが含まれることもあります。このページに載っていないからといって削除しないでください。内容が分からない場合は、まず出所と用途を確認してから編集してください。

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

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

[Host]
localhost = 127.0.0.1

[URL Rewrite]
^http://example\.com(?=/|$) https://example.com 302

キーと値、フィールド、改行の違い

Generalの設定やHostのマッピングでは、左右を等号で区切ることがよくあります。Ruleの行では通常、種類、条件、ポリシーを半角カンマで区切ります。全角カンマや全角スペース、コピー時に混入した引用符は解析結果を変える場合があります。各ルールは1行に記述してください。エディターの表示上の折り返しに注意しましょう。画面で2行に見えても、ファイルに改行文字が2つあるとは限りません。

空行は内容の整理に役立ちますが、優先順位を新たに設定するものではありません。ルールの所属先はセクション名で決まり、適用順はRule内の位置で決まります。説明を加える場合は、#で始まるコメント行として独立させてください。ルールのフィールド末尾に説明文を付けないでください。条件に自然文を追加しても、クライアントが余分な文字列を無視するとは限りません。

まずコピーし、編集してから、使用するファイルを選ぶ

現在使用できるファイルを複製し、元の内容とプロバイダーから提供された情報を保存しておくことをおすすめします。まず複製したファイルで変更を1つ行い、保存後に選択中の設定を確認してから、新しいテストリクエストを送信してください。リモートで管理されているファイルのローカルコピーを編集する場合は、リモート側の内容とローカルの変更を区別しましょう。次回の更新で一時的な変更が上書きされるのを防げます。

ファイル名が同じでも内容が同じとは限らず、保存したファイルが現在の使用項目になったとも限りません。問題を調べるときは、複製ファイルに見分けやすいテストルールを追加し、リクエスト記録で照合結果を確認できます。記録に古いルールが表示される場合は、変更を重ねる前に、使用中のファイルとGlobal Routingを確認してください。元に戻すときは、記憶を頼りに1行ずつ取り消すより、元のファイルに切り替えるほうが確実です。

例は汎用の完全な設定ではありません

ルールを統合するときは、既存の必要なセクションとサーバー情報を残し、理解できている行だけを移動または追加してください。出所の異なる設定ファイル全体を単純につなぎ合わせないでください。

サブスクリプションはご利用のプロバイダーから取得してください。追加方法はガイドの追加と初回接続の手順をご覧ください。追加後に選択できるサーバーがない場合は、ルールを調べる前に入力情報と追加結果を確認してください。PROXYに一致しても、その先で接続できるサーバーがなければ通信できません。設定ファイルの構成が正しいことは最初の確認項目にすぎず、すべての通信経路が検証済みという意味ではありません。

Global Routingの3つのモードと基本ポリシー

Global Routingは全体のルーティングモードを制御し、ルール内のポリシーは一致したリクエストの処理方法を決めます。画面上のConfig、Proxy、Directと、ルール内のPROXY、DIRECT、REJECTは同じ階層の設定ではありません。「ルールが反映されない」場合は、まずConfigモードになっているか確認してください。ProxyまたはDirectを使用中の接続結果だけでは、Ruleの照合ロジックが正しいとは判断できません。

Config、Proxy、Directの役割

Configは現在の設定に従って通信を振り分けるため、カスタムルールの検証に適しています。Proxyはクライアントが処理するリクエストをプロキシ経由で扱うため、ルールによる振り分けの影響を切り分ける際に使えます。Directでは直接接続の動作を確認できます。ここで説明しているのは、クライアントが処理する範囲の全体的な動作です。システム上のすべてのパケットが同じ処理を通るという意味ではなく、モードを切り替えると既存の接続がすべて直ちに再確立されるという意味でもありません。

Global Routingとルール検証の関係
モード主な用途確認ポイント
Config(設定)現在の設定に従って通信を振り分けるルールの順序、照合条件、最終ポリシー
Proxy(プロキシ)プロキシ経由の基本的な接続可否を確認する選択中のサーバーと接続情報
Direct(直接接続)現在のネットワークで直接接続した場合の動作を確認するローカルネットワーク、名前解決、接続先サービス

たとえば、あるドメインがProxyでは開けてConfigでは失敗する場合、2つのモードで結果が異なることは分かりますが、DNSのエラーとは断定できません。Configで実際に選ばれたポリシー、より上にあるDIRECTまたはREJECTに先に一致していないか、実際のリクエストのドメイン名が最初に入力したものと同じかを確認してください。ブラウザーでリダイレクトされた後、ドメイン名が変わっていることもあります。

PROXY、DIRECT、REJECTの意味

PROXYは一致したリクエストを現在選択されているプロキシで処理します。DIRECTは一致したリクエストを直接接続します。REJECTは一致したリクエストを拒否します。これらのポリシーは接続を保証するものではありません。PROXYには有効なサーバー情報と接続先への到達性が必要で、DIRECTの結果は現在のネットワークに左右されます。REJECTの適用範囲は照合条件によって決まります。「速い」「遅い」「修復ボタン」と捉えるより、処理方法を指定するものと理解するのが適切です。

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

この例では、特定のホストを拒否し、別のホストを直接接続します。それ以外の同じドメイン配下のリクエストはPROXYに渡します。サフィックスルールを最上部に移動すると、その後の2つの個別例外が照合されない可能性があります。ポリシー自体に固定の優先順位はありません。REJECTが常にPROXYより優先されるわけではなく、条件と記述順で適用結果が決まります。

プロキシの選択とプロトコル情報は別途確認

ルールにPROXYと書いても、サーバーアドレス、ポート、認証情報が設定されるわけではありません。Shadowsocks、VMess、VLESS、Trojanなどのプロトコルを使う場合も、プロバイダーが提供した情報に従って必要な接続情報を設定してください。名前が似ているからといって、別のプロトコルのフィールドを流用しないでください。プロトコルは接続層、ルールは選択層の設定です。ルールが正しくても、接続情報の不足は補えません。

On Demandは、条件を満たしたときの接続動作を管理する機能であり、Ruleのポリシーではありません。テスト中に接続状態が頻繁に変わる場合は、トリガー条件も確認してください。切断や再接続を、ルールが不安定だと誤認するおそれがあります。Connectivity Testはテスト対象の接続状態を確認するための機能です。成功しても、個別の通信リクエストが意図どおりに振り分けられた証明にはなりません。

モードの切り替えは、変数を1つに絞って行うのがおすすめです。元の設定を記録し、切り替え後に新しいリクエストを作成して結果を記録したうえで、普段使うConfigに戻してください。詳しい比較はGlobal RoutingのConfig / Proxy / Direct比較をご覧ください。同じテスト中にサーバー、DNS、ルールを同時に変更すると、成功や失敗の原因を特定しにくくなります。

DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD

ドメインルールは、「このホスト」「このドメインとそのサブドメイン」「名前に特定の文字列を含むドメイン」のような条件を表すのに適しています。ルールの種類は、広いキーワード条件から始めるのではなく、必要最小限の範囲に絞って選んでください。範囲が広いほど、ログイン、決済、コンテンツ配信など無関係なリクエストまで影響を受けやすくなり、意図しないサイトへの影響も説明しにくくなります。

DOMAIN:完全なホスト名だけを指定

DOMAINはホスト名を完全一致で照合します。条件にexample.comと指定しても、www.example.comまで自動的に含まれるわけではありません。特定のAPIやホストだけを調整したい場合に適しています。条件にはドメイン名のみを指定し、プロトコル、ポート、パス、クエリパラメーターは含めないでください。アドレスバーからコピーした完全なURLをそのまま指定しないでください。

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

1つのWebページで複数のホストにアクセスすることはよくあります。ページ本体、画像、API、認証情報がそれぞれ別のドメインから取得される場合があります。一部しか読み込まれなくても、すぐにキーワード条件の範囲を広げないでください。まずリクエスト記録で失敗したホストを特定し、必要に応じて個別ルールを追加します。1つのドメインに接続できても、ページに関わるすべてのリクエストが同じポリシーを使っているとは限りません。

DOMAIN-SUFFIX:ドメイン階層をまとめて照合

DOMAIN-SUFFIX,example.com,PROXYは、指定したドメインとそのサブドメインに一致します。たとえば、www.example.comや、さらに下の階層にあるホスト名も対象です。単純な文字列の部分一致ではなく、ドメインのサフィックス境界に基づいて照合します。そのため、末尾の文字が似ているnotexample.comは、このドメインのサブドメインには該当しません。通常、条件にアスタリスクやプロトコルを追加する必要はありません。

同じドメイン配下の大半のサービスをPROXY経由にし、内部APIだけDIRECTにする場合は、まず内部APIに対するDOMAINの例外を書き、その後にDOMAIN-SUFFIXの包括ルールを記述します。先に例外、次にドメイン全体のルールと、意図が明確になります。サービスが別のドメインに移行しても、古いサフィックスルールは新しいドメインを自動的に対象にしません。実際のリクエストに応じてルールを更新してください。

3種類のドメイン条件の範囲
種類条件の例対象範囲
DOMAINapi.example.com指定した完全なホスト名
DOMAIN-SUFFIXexample.com指定したドメインとそのサブドメイン
DOMAIN-KEYWORDexampleドメイン名に指定した文字列を含むもの

DOMAIN-KEYWORD:便利だが、影響範囲が広がりやすい

DOMAIN-KEYWORDはドメイン名に含まれる文字列を照合します。Webページの内容を検索したり、URLのパスを調べたりするものではありません。条件にexampleと指定すると、互いに関係のない複数のドメインに一致する可能性があります。範囲の広い文字列条件が本当に必要で、その適用範囲を確認済みの場合に使ってください。内容の分からないサービスに対して最初に使うルールとしては適さず、REJECTにごく短い一般的な文字列を指定するのも避けてください。

REJECTを使う場合は、特に範囲の狭い条件から始めてください。共有ドメインを拒否すると、画像、認証コード、アカウント機能まで使えなくなることがあります。サービスのコンテンツを配信するホストを拒否しても、意図したリソースだけをブロックできるとは限りません。ドメインルールでは、同じ暗号化接続内のページ要素を個別に判定できません。詳しくはREJECTルールの役割と適用範囲をご覧ください。

ドメイン条件の一致を確認する方法

まず、既知のホスト1つに対象を絞ってテストします。リクエスト記録に表示される名前が条件と一致していることを確認し、照合されたルールとポリシーを確認してください。ブラウザーのアドレスバーだけを見て判断しないでください。リダイレクト、キャッシュ、バックグラウンドAPIによって、実際のリクエストは異なる場合があります。記録に接続先のIPしか表示されない場合は、同じルールを繰り返し追加するのではなく、ドメイン情報を照合に利用できるか確認してください。

ドメインの別名とリソースの移行も区別してください。名前解決で別の名前が参照されても、名前解決の経路に含まれるすべてのドメインをルールに追加する必要はありません。クライアントの実際の記録と新しいリクエストを基準にしてください。変更後は同じ入口から再テストし、変更前後の記録を保存します。影響が想定したホストに限られることを確認してから、サフィックス全体に適用するか判断してください。

IP-CIDR、GEOIP、USER-AGENTの適用範囲

ドメイン以外にも、接続先アドレスやリクエストから取得できる情報を条件にしてルールを設定できます。これらはドメインルールの代わりではありません。ドメインはサービス名、IPは接続先アドレス、USER-AGENTは特定のリクエストフィールドを表します。条件を選ぶ前に、リクエスト処理のどの段階でクライアントがその情報を取得できるか確認してください。構文が正しくても、条件を照合できる機会がなければルールは一致しません。

IP-CIDR:アドレス範囲をCIDRで指定

IP-CIDRでは、アドレスとプレフィックス長を使ってIPv4のネットワーク範囲を指定します。プレフィックスが長いほど対象範囲は狭くなります。単一のIPv4アドレスには/32を指定できます。たとえば、192.168.0.0/16はその範囲のアドレスを対象とし、192.168.10.0/24はより狭い範囲を指定します。ルールには対象ネットワークに対応するネットワークアドレスを指定してください。スラッシュの後の数字はポートではありません。

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

これらの行は、ローカルネットワークのアドレス、IPv6のローカルアドレス範囲、地域判定の記述例です。すべての設定にそのまま追加する必要はありません。企業ネットワークやリモートネットワークでも、同じプライベートアドレス範囲が使われる場合があります。特定のリモート経路からプライベートネットワークにアクセスしたい場合、広範囲のDIRECTルールを設定すると、接続が誤った場所に向かうおそれがあります。現在のネットワークと接続先に応じてポリシーを選んでください。

no-resolveはDNSを無効にする設定ではありません

追加パラメーターのno-resolveは、そのIPルールの判定だけを目的としたドメインの名前解決を自動で行わないための指定です。アプリ全体のDNSを停止したり、その後のすべてのルールで名前解決できなくしたりするものではありません。リクエストがすでにIPアドレスである場合や、利用可能なアドレス情報がある場合は、アドレス条件が判定されることがあります。名前解決の結果を使って照合する必要がある場合、安易に追加すると想定した結果にならないことがあります。

ドメインのリクエストが特定のIP範囲に一致しない場合は、アドレス照合のための名前解決が許可されているか、後続のルールがどのように処理するかを確認してください。すべてのアドレスルールにno-resolveを追加して、汎用的なパフォーマンス設定として使わないでください。どの名前解決処理を減らしたいのかを明確にしてから、記録で動作を確認しましょう。名前解決の回数を減らすことと、適切なポリシーが選択されることは別の問題です。

GEOIP:IPアドレスのデータベースによる判定であり、Webサイトの識別ではありません

GEOIP,CN,DIRECTは、使用するデータベースに登録された接続先IPの地域情報に基づいて判定します。Webサイトの使用言語や運営主体の所在地を判別するものではありません。また、ネットワーク、時刻、名前解決の結果が変わっても、同じドメインが常に同じ地域に一致するとは限りません。コンテンツ配信サービスは異なるIPアドレスを返すことがあり、データベース上の分類が実際のサービスの配置場所すべてを示すわけでもありません。

業務上の要件が明確なドメインは、まずドメインルールで意図を表し、その後にGEOIPを広範囲の分類条件として使うのが一般的です。Webサイトの経路が変わった場合は、当時の名前解決結果と照合記録を確認し、「アドレスが変わった」のか「ルールが機能していない」のかを切り分けてください。具体的なドメイン要件を隠すためにGEOIPの位置を何度も変えると、より多くのリクエストに影響します。

USER-AGENT:取得できるリクエストフィールドにのみ有効

USER-AGENT,Example*,DIRECTは、User-Agentのパターン照合を行う記述例です。アスタリスクはパターン照合に使います。アプリ名、プロセス名、アイコンを識別するものではありません。同じリクエストライブラリを複数のアプリが使う場合や、アプリがフィールドを変更する場合があります。また、USER-AGENTを取得できず、このルールで判定できないリクエストもあります。

暗号化されたリクエストでは、すべてのHTTPフィールドをクライアントが当然確認できるとは限りません。そのため、USER-AGENTをすべてのアプリ通信の分類に使える汎用条件と考えないでください。このルールを使うために、追加の復号設定を有効にする必要はありません。特定のサービスを優先してある経路に送ることが目的なら、明確なドメイン条件やアドレス条件で表現できるか検討し、テストではフィールドの可視性とポリシーの結果を確認してください。

IPv4とIPv6も個別に確認してください。IP-CIDRだけでは、対応するIPv6アドレスまで自動的に対象になるわけではありません。接続先サービスが別のアドレスファミリーを使うと、異なるルールが適用されることがあります。同じドメインでもネットワークによって動作が異なる場合は、特定のネットワーク機能をすぐ無効にするのではなく、アドレスファミリーも確認項目に加えてください。実際の接続先アドレスを確認してから、不足している条件を判断できます。

上から順に照合するルール、例外、FINAL

Ruleは上から順に確認し、最初に一致したルールがそのリクエストのポリシーを決めます。より具体的な種類だからといって自動的に優先順位が上がるわけではなく、ファイルの末尾が先頭のルールを上書きすることもありません。この仕組みを理解すると、「ルールを書いたのに反映されない」という問題を検証可能な問いに置き換えられます。そのルールに到達する前に、別の条件に一致していないでしょうか。

具体的な例外は広範囲のルールより前に記述

同じドメイン配下で、特定のホストだけを直接接続し、ほかのホストはプロキシ経由にする場合を考えます。まず対象ホストのDOMAINを記述し、その後にドメイン全体を対象とするDOMAIN-SUFFIXを記述してください。逆の順序にすると、個別ルールが保存されていても照合されない可能性があります。ルールの種類が範囲を、記述位置が順序を表します。両方を正しく設定する必要があります。

[Rule]
# まず個別の例外を確認
DOMAIN,intranet.example.com,DIRECT
DOMAIN,blocked.example.com,REJECT

# 次に広いドメイン範囲を確認
DOMAIN-SUFFIX,example.com,PROXY

# アドレス分類と最終ポリシーは後に配置
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

この例では、明確なサービス要件を広範囲のアドレス分類より優先するため、ドメインルールをGEOIPより前にしています。すべての設定に当てはまる固定の並び順ではありません。特定のアドレス範囲を優先する要件が明確であれば、内容を確認したアドレス例外を前に置くこともできます。重複する条件の適用関係を説明できるようにし、重複部分を確認するテストリクエストを用意してください。

FINALは最後のフォールバックであり、後から上書きするためのルールではありません

FINAL,PROXYは、前のルールに一致しなかった場合にPROXYを使う指定です。ドメインやネットワーク範囲の条件は含みません。通常は、FINALをRuleセクションの最後にある有効なルールとして残し、後続の条件が無効にならないようにします。FINALを途中に移動しても、「まずプロキシを試し、失敗したら次のルールを調べる」という動作にはなりません。照合処理は接続状況に応じて1行ずつ再試行するものではありません。

FINALにDIRECTとPROXYのどちらを指定するかは、全体の振り分け方針によって決まります。あらゆる状況に共通する正解はありません。PROXYを選ぶと、分類されなかったリクエストは利用可能なプロキシに依存します。DIRECTを選ぶと、現在のネットワークで直接接続できるかに依存します。フォールバックの方針をメンテナンス用の説明に記録し、前の条件に一致しないリクエストをテストして、想定どおりに処理されることを確認してください。

重複ルール、競合ルール、照合されないルール

完全に同じルールを重複させると、通常は読みづらくなるだけです。同じ条件に異なるポリシーを設定した場合は、先にあるルールが後の判断を遮ります。さらに見つけにくい競合は、条件の範囲が重なる場合です。たとえば、キーワード条件がサフィックス条件を含み、サフィックス条件が特定ホストの条件を含むことがあります。問題を調べる際は、完全一致する行だけでなく、対象リクエストに先に一致する広い条件も探してください。

異なる出所のルールを統合するときは、単純にアルファベット順に並べるのではなく、用途ごとに整理してから条件の重複を確認してください。並べ替えツールを使うと、先頭にあった例外が後方に移動することがあります。ルール群の前に用途をコメントで記載すると読みやすくなりますが、コメントは照合順位を変えません。「最優先」と書いてあっても、FINALより後ろにあれば適用されません。

複数のリクエストを使って範囲を確認

サフィックスルールを検証する場合は、少なくともドメイン本体、サブドメイン1つ、そのドメインに属さない名前を確認してください。個別例外を検証する場合は、同じドメイン配下の別ホストもテストします。目的は「ページが開く」ことを確認するだけではありません。対象にすべきリクエストが対象になり、対象外のリクエストに影響しないことを確認します。REJECTを使う場合は、通常の機能が引き続き使えるかも確認してください。

同じリクエストに複数のルールが一致する可能性がある場合は、複製ファイルでテスト対象を一時的に絞り、先に一致する候補を順に除外します。変更するのは、順序か条件のどちらか一方にしてください。ポリシーも同時に変えないでください。現在一致しているルール、想定しているルール、対象ホストの3点を記録すると、設定全体を何度も撮影するより問題を説明しやすくなります。

ルール照合は接続失敗後に試す候補の一覧ではありません

PROXYに一致して接続に失敗しても、次の行にあるDIRECTが実行されるわけではありません。後ろに同じ条件のルールを追加するのではなく、選択された経路を確認するか、振り分けの判断自体を明示的に変更してください。

General、DNS、Hostがルール判定に与える影響

DNSは名前をアドレスに変換し、ルールはリクエストの処理ポリシーを決定します。両者は関連していますが、同じものではありません。ドメインルールは、アドレスが得られる前から明確な処理方針を表せます。一方、アドレスルールには接続先のアドレス情報が必要です。問題を調べるときは、「アドレスを取得できない」「適切でないアドレスが返る」「アドレス取得後に誤った経路が選ばれる」を切り分けてください。そうしないと、DNSを変更して現象が一時的に変わっても、原因を説明できないことがあります。

Generalの設定では、動作確認済みの値を維持

dns-server = systemは、システムのDNS設定を使う指定です。基本状態を分かりやすくできますが、すべてのネットワーク環境で同じ結果になるとは限りません。bypass-system = trueは、システム関連トラフィックのバイパス処理に関する設定です。ドメインの許可リストではなく、「すべてのローカル通信が必ず直接接続される」という意味でもありません。実際の対象範囲は、システムと現在の設定によって異なります。

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

[Host]
localhost = 127.0.0.1
printer.example.com = 192.168.10.20

現在の設定が問題なく動作しているなら、ファイルを完全に見せるためだけに、内容の分からないGeneralの項目を追加しないでください。全般設定は設定全体に影響する可能性があり、範囲を限定しやすい個別のドメインルールとは異なります。変更前に元の値を記録し、名前解決の参照先、システムの通信処理、その他のどの項目を変更するのかを確認してください。複数の全体設定を同時に変えないようにしましょう。

システムDNS、カスタムDNS、DNS over HTTPS

システムDNSは現在のネットワーク環境に設定された名前解決方法を引き継ぎます。カスタムDNSを使う場合は、実際に利用でき、提供元も把握しているサービスを設定してください。DNS over HTTPSは名前解決のリクエストをHTTPSで送りますが、接続先サービスのアドレスに到達できること、接続が有効であること、通信経路が適切であることが必要です。通信方式を選んだからといって、現在の用途に適した名前解決結果が得られるとは限りません。また、アプリの通信自体がプロキシ経由になるわけでもありません。

このページでは、外部のDNSサービスを推奨していません。DNSを変更する場合は、まず設定ファイルの複製で名前解決の設定だけを変え、同じドメインと同じルーティングモードでテストしてください。ドメイン名でアクセスするDNSサービスでは、最初の名前をどう解決するかも確認し、設定が自身に依存して循環しないようにします。選び方の比較はシステムDNS、カスタムDNS、DNS over HTTPSの比較をご覧ください。

Hostは名前とアドレスを対応付ける設定で、ポリシーは指定しません

Hostのprinter.example.com = 192.168.10.20は、指定した名前をアドレスに対応付ける設定です。自動的にDIRECTになるわけではありません。直接接続が必要な場合は、明確なルールで経路も指定し、接続先アドレスが現在アクセス可能なネットワークに属しているか確認してください。名前をプライベートアドレスに割り当てても、リモートのプライベートネットワークへの接続性が端末に自動的に備わるわけではありません。

静的なマッピングは、アドレスが固定され、自分で管理しているホストに適しています。大型サービスの名前解決結果を確認せずに固定する用途には向きません。サービスのアドレスは地域、負荷、障害対応によって変わることがあり、古いマッピングを残すと通常の名前解決による変更を迂回してしまいます。突然接続できなくなった場合は、RuleだけでなくHostの手動設定も確認してください。

アドレスのマッピングを変えても、暗号化サービスの識別情報は変わりません

ドメインを別のサーバーに割り当てても、ブラウザーは元のドメイン名を使って暗号化接続や証明書の検証を行う場合があります。接続先サーバーがその名前のサービスを提供していなければ、接続に失敗することがあります。Hostは証明書エラーを一般的に修復する方法でも、URLを転送する機能でもありません。認証を無視してマッピングの誤りを隠さず、ドメイン名、アドレス、接続先サービスが一致しているか確認してください。

名前解決のキャッシュや接続の再利用により、変更後の動作がすぐに反映されないことがあります。設定を保存したら新しいリクエストを送信し、アプリが古い接続を再利用していないか確認してください。必要であれば、関連するアプリの既存セッションを終了してからテストします。古いアドレスを使ったリクエストが一度あっただけでHostが無効だと判断しないでください。記録を取らずに複数のDNS設定を続けて切り替えるのも避けましょう。

「ドメインでは失敗するが、IPアドレスに直接アクセスすると成功する」場合でも、すぐにDNSの問題とは断定できません。IPアドレスに直接アクセスすると、別の仮想ホストや証明書、ルールが使われる可能性があります。両者は厳密に同じ条件のテストではありません。同じドメイン名を使い続け、名前解決結果、照合ルール、実際の接続先アドレスだけを確認するほうが、各テストの違いを説明しやすくなります。

URL Rewriteの照合、リダイレクト、注意点

URL RewriteはURLの照合や書き換えを扱うもので、Ruleの別形式ではありません。Ruleはリクエストの処理ポリシーを選び、リダイレクトはアプリに別のアドレスへの再リクエストを促すことがあります。どちらも同じアクセスの流れに順番に影響する場合があります。ルールを追加する前に、目的が「接続経路を変える」ことなのか、「リクエスト先のアドレスを変える」ことなのかを明確にしてください。ドメインをプロキシ経由にしたいだけなら、通常、書き換えは不要です。

正規表現、置換先、ステータスコードを理解する

以下の例は、指定したホストのHTTPアドレスを同じホスト名のHTTPSアドレスへ転送します。接続先サーバーがHTTPSに対応している必要があります。照合式、置換先、ステータスコードはそれぞれ役割が異なります。このセクションにカンマ区切りのドメインルール構文を記述しないでください。これは1つのルールを説明する例であり、既存の内容を確認せずにすべての設定へ追加することはおすすめしません。

[URL Rewrite]
^http://example\.com(?=/|$) https://example.com 302

先頭の^はURLの先頭から照合する指定です。\.は正規表現の任意の1文字ではなく、文字としてのピリオドを表します。(?=/|$)はホスト名の後ろがスラッシュまたは文字列の末尾であることを条件にし、似た接頭辞を持つ別のホストが対象になるのを防ぎます。置換内容は一致した先頭部分を変更します。後続のパスが維持されるかは、実際にテストして確認してください。

302は一時的なリダイレクトを表し、クライアントが応答を受け取った後に新しいリクエストを送信する場合があります。これはプロキシのポリシーではなく、接続失敗時に元の経路へ戻る指定でもありません。テストでは、最初のページが表示されたかだけでなく、新しい接続先、リダイレクトの回数、最終的に一致したルールを確認してください。転送先で逆向きの書き換えに再び一致すると、転送を繰り返して失敗することがあります。

パス、クエリパラメーター、リクエストメソッドを確認

アドレスの接頭辞を書き換えると、そのホスト配下の複数のパスに影響する場合があります。維持するパスとクエリパラメーターをテスト対象に含め、トップページだけで確認しないでください。ログイン後の戻り先や署名付きリクエストはURLに大きく依存します。ページが表示されても、パラメーターの意味が変わるとサーバーに拒否されることがあります。複雑なキャプチャグループは、それぞれの用途を記録し、後から確認しにくい式への依存を避けてください。

ブラウザーのページ遷移とアプリのAPIリクエストも同じではありません。リクエストボディを含む通信では、ブラウザーとアプリでリダイレクトの扱いが異なる場合があります。ブラウザーで一度テストしただけで、同じルールをすべてのAPIに適用しないでください。アカウント、認証、データ書き込みに関わる通信は、元の動作を優先してください。接続先サービスの要件を十分理解している場合に限り、範囲を限定してテストします。

暗号化通信で情報が見える範囲の制限

HTTPSリクエストの完全なパスは通常、暗号化で保護されています。通常の転送中にクライアントが任意に読み取って書き換えられるとは限りません。特定の書き換えが適用できるかは、通信の可視性と実際の設定によります。ドメインルールでホスト名を照合できるからといって、パスの書き換えも必ず使えるとは限りません。ホスト情報と完全なHTTPの内容は別の階層です。

このページでは、書き換えのために復号設定を追加することも、証明書をインストールすることも通常のトラブルシューティング手順として求めていません。ドメインルールで目的の振り分けができる場合は、適用範囲が明確なRuleを優先してください。アカウントや機密データが関わる場合は、各設定が影響する範囲を十分理解してください。内容を説明できない書き換えルールは、日常の設定に直接追加せず、複製ファイルで検証してください。

書き換えと後続のルールの組み合わせを確認

元のアドレスが別のドメインにリダイレクトされる場合、新しいリクエストには改めてルーティングルールが適用されます。元のドメインがDIRECTでも、リダイレクト先のドメインもDIRECTになるとは限りません。「最初のリダイレクトは成功するが、その後失敗する」場合は、リダイレクトの経路全体を一覧にし、各ホストの名前解決、照合ルール、ポリシーを確認してください。最初のドメインルールだけを繰り返し変更しないでください。

書き換えルールを管理する際は、元のURLパターン、転送先、想定するステータスコード、誤って一致してはいけない例を記録してください。誤一致の例には、似ているが対象外のホストと、維持する必要があるパスを最低1つずつ含めます。異常が見つかったら、新たに追加した書き換えをまず無効にし、ほかの設定は変更しないでください。問題が解消した場合は、DNS、サーバー、ルールを一度に変更するのではなく、式の範囲を少しずつ絞ってください。

ドメインの振り分けとアドレスの書き換えを分けて検証

PROXYはURLを変更せず、リダイレクトも自動的にPROXYを指定しません。各リダイレクト先のホストとポリシーを記録し、どの段階で問題が起きたかを確認してください。

ルールの検証、よくある問題、継続的なメンテナンス

ルールの検証は、期待する動作の明確化、ファイルの複製、1項目だけの変更、新しいリクエストの送信、記録の確認、変更の維持またはロールバックという流れで行います。「Webページが開く」ことだけを合格基準にしたり、一度の失敗で設定全体が無効だと判断したりしないでください。ルールは接続全体の一部です。名前解決、選択したサーバー、接続先サービス、ローカルネットワークを、それぞれの段階に分けて確認してください。

繰り返し実行できるテストを用意

変更ごとに、一致するはずのホスト、適用したいポリシー、影響を受けないはずの比較対象ホストを用意します。テスト前に、Global RoutingがConfigであること、保存した複製ファイルが使用中であること、サーバーの選択が前回と同じであることを確認してください。キャッシュ済みのページを見るだけではなく、新しいリクエストを送信します。実際のホスト、接続先アドレス、ポリシーを記録し、必要に応じてそのときのネットワーク環境も記録してください。

Connectivity Testに成功してもサービスが使えない場合は、サーバーのテストを繰り返すだけでなく、そのサービスが実際に送信したリクエストを調べてください。逆に、Webページが表示されたからといって、すべてのルールが正しく一致したとは限りません。コンテンツがキャッシュや別のホストから読み込まれている場合があります。有効な根拠は今回の新しいリクエストに対応し、どのルールを通ったかを示せる記録です。「速くなった気がする」という印象だけでは判断できません。

症状に応じて確認範囲を絞る

ルールのトラブルシューティングで最初に確認する項目
症状優先して確認する項目次の手順
新しいルールに一致しない使用中の設定、Config、先行する条件実際のホスト名と先に一致したルールを確認
PROXYに一致するが接続できないサーバーの選択と接続情報プロキシ経路と接続先サービスを切り分けて検証
一部のリソースだけ失敗するAPI、静的リソース、リダイレクト先のドメインホストごとにポリシーを確認
更新後にローカルの変更が消えたリモートの設定元とローカルの複製更新前後の該当セクションを比較

保存後に構文エラーが出た場合は、直近の変更箇所にあるセクション名、半角カンマ、等号、行末の文字列を確認し、最小限の行に絞って検証してください。接続後にすべてのサービスで失敗する場合は、最後に動作していたファイルに戻し、全般設定の変更と個別ルールの変更を切り分けます。特定のドメインだけが失敗する場合は、そのドメインの名前解決、先に一致したルール、書き換えを優先して確認してください。サーバー情報全体を最初から設定し直す必要はありません。

サブスクリプションの更新とルールのメンテナンスを分けて記録

サブスクリプションはご利用のプロバイダーから取得してください。サブスクリプションの更新と設定ファイルの更新は、別々の操作として扱います。更新によってサーバー項目や選択状態が変わることがあり、リモート設定の更新でローカルのルールが置き換わる場合もあります。更新後は、どの種類の内容が変わったのかを確認してから、関連するテストをやり直してください。追加方法の違いはSubscribe、Add Server、QRコード、クリップボードからの追加方法をご覧ください。

ローカルの例外ルールには、用途、条件の範囲、想定するポリシー、検証方法を記した簡潔な説明を残すことをおすすめします。使わなくなったホスト、重複行、ほかのルールに覆われた例外を定期的に見直してください。ルールを増やし続けるだけでは、適用範囲の精度は上がりません。各条件の目的を説明でき、すぐに元に戻せる設定ファイルのほうが、サービスの変更後も保守しやすくなります。

記録を保存する際は個人情報を保護

リクエスト記録にはアクセス先のドメイン、パス、クエリパラメーターが含まれることがあります。サブスクリプションURLにアクセス認証情報が含まれる場合もあります。問題を他の人に説明するときは、必要なルールの種類、匿名化したホスト、照合されたポリシーだけを残してください。サブスクリプションURL全体、認証情報、内容を確認していない設定ファイル全体をそのまま送らないでください。例にはexample.comを使えますが、問題を再現するための条件の関係とルールの順序は維持してください。

クライアントの入手と接続先サービスの利用は別のものです。iPhone / iPad版はApp Storeで2.99米ドルの買い切り、Mac / Windows / Android / Linux版は無料です。クライアントの買い切り料金に接続サービスの料金は含まれません。Shadowrocketはクローズドソースの商用アプリです。このマニュアルでは、すでにサービス情報をお持ちの方に向けて設定方法を説明しており、接続先サービスは提供していません。iPhone / iPadのシステム要件はApp Storeの掲載内容をご確認ください。

クライアントを再入手する場合はダウンロードページで指定の入手方法をご確認ください。iPhone / iPad版では、開発者名のShadow Launch Technology LimitedとアプリIDの932747118を確認してください。その他のプラットフォームのインストーラーは、当サイトの/dl/から提供しています。インストールがブロックされた場合の手順はインストール許可の案内をご覧ください。ルールの問題はこのページの該当章に戻って順に確認し、インストールの問題と通信の振り分けの問題を混同しないでください。

初回接続を行う場合は、かんたんセットアップガイドに戻り、順番に操作してください。特定の問題の原因を調べる場合は、実際のリクエストを起点に、使用中のファイル、Global Routing、照合条件、最終ポリシー、名前解決の結果、接続経路を順に確認します。観察できる問題を1つずつ解決すれば、変更と結果を対応付けやすくなり、明確な復旧方法も残せます。