Shadowrocketの設定ファイル解説:.confのGeneral・Rule・Host・URL Rewriteの書き方

Shadowrocketの.confをセクションごとに解説。[General]の基本設定、[Rule]の照合順序とFINAL、[Host]と[URL Rewrite]の書き方を紹介します。

この記事の概要

.confを編集する前に、Configで現在のファイルをバックアップし、一般設定、ルーティングルール、ドメインマッピング、URL書き換えを個別に確認します。ルールに基づいて通信を振り分ける場合は、Home → Global RoutingをConfigに設定してください。この記事では、自分で利用するサービスとサブスクリプションをすでに用意し、設定構文を理解したい方向けに、個別に検証できる例と元に戻す手順を解説します。設定ファイルは接続用の認証情報ではありません。

1. .confのセクション構成と適用条件

Shadowrocketの.confはテキスト形式の設定ファイルです。角括弧で囲まれた部分がセクション名で、各セクションにはそれぞれの構文に従ってパラメータやルールを記述します。[General]は通常キー = 値形式、[Rule]はカンマ区切りのルール行を使います。この2種類の構文を混在させないでください。保存できても設定が有効になったとは限りません。Configで現在選択されているファイルを確認してください。

4セクション
この記事で扱う範囲:General、Rule、Host、URL Rewrite
32ビット
IPv4の/32プレフィックスは単一のアドレスを表します
302
この記事の書き換え例で使う一時リダイレクトのステータスコード

以下は構成を理解するための最小限の例であり、現在の設定をそのまま置き換える完全な接続設定ではありません。PROXYは現在選択されているプロキシを使用します。利用可能なサーバーと認証情報は、あらかじめ設定しておく必要があります。例に使うドメインとドキュメント用アドレスは構文の説明を目的としており、接続可能なサービスを示すものではありません。

[General]
dns-server = system

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

[Host]
lab.example.com = 192.0.2.10

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

Homeでは主にサーバーの選択と接続を行い、Configでは設定ファイルを管理し、Settingsではアプリの設定を行います。Subscribeでインポート・更新されるのは、サブスクリプションに含まれる接続項目です。その操作によってローカルの.confも同期されるとは限りません。逆に、.confのルールを変更しても、サーバーアドレス、パスワード、サブスクリプションの認証情報は修正されません。トラブルシューティングでは、この2つを分けて記録してください。

ファイルをバックアップ セクションごとに編集 設定を選択 ルーティングを確認 新しいリクエストを実行

2. [General]:DNSとIPv6を理解してから一般設定を調整

[General]は設定の基本動作に影響します。まず確認したいのはDNSの参照元です。dns-server = systemは、システムが提供するDNSを使用する設定です。特定のパブリックDNSを指定するものではありません。Wi-Fiとモバイル通信を切り替えると、システムが提供する名前解決環境も変わることがあります。ドメインを解決できない場合は、まずシステムのネットワーク自体に問題があるのか、現在の設定によって名前解決の動作が変わったのかを切り分けてください。

[General]
dns-server = system
ipv6 = false

ipv6 = falseはIPv6関連の問題を調べる際に使えますが、あらゆるネットワークに適用する固定の最適化設定ではありません。IPv6を無効にすると利用できるアドレスファミリーが変わります。IPv6に依存するネットワークもあるため、そのままコピーすると接続可能な経路が減ることがあります。元の設定で問題なく動作している場合は値を維持し、明確な症状があるときだけ一項目ずつ比較してください。テスト後に設定を戻すか判断します。

Generalの設定を確認

dns-server
system:システムが提供するDNSを使用します。
ipv6
false:この設定でIPv6を無効にし、対象を絞って問題を調べます。
変更単位
一度に変更するのは1項目だけにし、保存後に新しい接続で検証します。

複数のパラメータを同時に変更した結果を、特定の1項目の影響だと決めつけないでください。

Ruleの構文を確認

DOMAIN-SUFFIX
example.com,PROXY:ドメインのサフィックスで照合します。
IP-CIDR
192.0.2.10/32,DIRECT,no-resolve:単一のIPv4アドレスに照合します。
FINAL
DIRECT:前のルールに一致しない場合の最終ポリシーとして使用します。

ルール行では半角カンマを使い、FINALにはドメインやネットワーク範囲を指定しません。

設定ファイルのDNS設定と、デバイスが現在使っているネットワークのDNSは、必ずしも同じ層の状態を示すものではありません。ブラウザーが既存の接続やキャッシュを利用している場合、変更直後に再読み込みしても変化が反映されないことがあります。テストではファイルを保存して有効化を確認した後、接続を新しく確立してください。必要に応じて対象アプリを終了して再起動し、古い接続を使って新しい設定を判断しないようにします。

3. [Rule]:上から順に照合し、FINALは末尾に置く

[Rule]では上から順に照合し、最初に一致した有効なルールが該当リクエストのポリシーを決めます。より具体的な例外は、通常、範囲の広いルールより前に置きます。たとえばstatus.example.comはDIRECTにし、それ以外のexample.comドメインはプロキシ経由にしたい場合、完全一致のドメインルールをサフィックスルールより前に記述します。

[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
ルールキーワード照合対象確認ポイント
DOMAIN完全なドメイン名スキーム、ポート、パスは含めません。
DOMAIN-SUFFIXドメイン本体とそのサブドメインexample.comはapi.example.comにも一致しますが、文字列の一部に含まれるだけのものには一致しません。
IP-CIDR接続先のIPv4アドレス範囲/24はネットワーク範囲を表します。no-resolveを付けると、このルールの照合だけを目的とするドメイン解決を避けられます。
GEOIPアドレスデータベース上の地域情報CNはアドレスデータベースの地域コードです。照合結果はそのデータベースの記録に従います。
FINAL前のルールに一致しなかったリクエスト末尾に置き、DIRECTまたはPROXYを明示します。

no-resolveはアプリ全体のDNSを無効にする設定でも、「このドメインを解決しない」という指定でもありません。対象のIPルールで照合を行う際の動作を制限します。ドメインのリクエストがこのルールに到達したとき、照合に使える接続先IPがなければ、このルールに必ず一致するとは限りません。特定のドメインを正確に制御するには、IPの地域情報だけに頼らず、DOMAINまたはDOMAIN-SUFFIXを優先してください。

要点:個別ルールを確認してから、最後にフォールバックを検証

まずstatus.example.comに対応する実際のテスト対象で個別の例外を確認し、次にサフィックスルール、最後に前述の範囲に含まれない自分の管理下の対象をテストします。FINALを前に置くと、後続の例外ルールは想定どおりに照合されません。重複ルールを増やすのではなく、まず順序を見直してください。

ルールがルーティングに使われるかどうかは、Home → Global Routingの設定にも左右されます。Configは現在の設定に基づいて通信を振り分けます。ProxyとDirectは、それぞれ全体をプロキシ経由または直接接続にするための選択肢であり、ルールによる振り分け全体の検証には適しません。Sceneは設定済みの条件に応じてルーティング動作を選ぶ機能で、Configと同じ意味ではありません。この記事の例を調べる際は、まずConfigを選択してください。

4. [Host]:ドメインのマッピングだけを記述し、URLは入力しない

[Host]では、ドメイン名とIPアドレスのローカルマッピングを指定します。左側にドメイン名、右側に接続先IPを記述してください。https://、パス、:443は入力しません。ポートは接続先の情報であり、この種のドメインマッピングには含まれません。以下ではフォーマットの説明に予約済みのドキュメント用アドレスを使います。実際のウェブサイトに接続できるかを試す用途には使えません。

[Host]
lab.example.com = 192.0.2.10
status.example.com = 192.0.2.20

Hostのマッピングは、通信を強制的に直接接続する設定ではありません。最終的にどのポリシーが適用されるかは、Global Routingとルールによって決まります。また、ドメインにIPアドレスを指定すれば、すべてのドメインルールを迂回できると考えないでください。自分が管理するHTTPSサービスをテストする場合は、アドレスのマッピング、ルールの照合、証明書のドメイン名、サーバーの応答を個別に確認してください。互いに代用できるものではありません。

5. [URL Rewrite]:HTTPリダイレクトの例で書き方を理解する

[URL Rewrite]はURLの照合と書き換えを行うもので、サーバー認証の問題を解決したり、DNSマッピングを行ったりする機能ではありません。一般的なリダイレクトの行は、照合式、転送先URL、ステータスコードで構成され、各フィールドをスペースで区切ります。以下の例では、サンプルサイトへのHTTPリクエストをHTTPSへリダイレクトし、パスを維持します。

[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
  1. ^はURLの先頭から照合する指定です。式が別の位置で誤って一致するのを防ぎます。
  2. example\.comではピリオドをバックスラッシュでエスケープしています。正規表現の任意の1文字ではなく、通常のピリオドとして扱われます。
  3. (.*)で後続の内容を取得し、転送先の$1で1番目のキャプチャ結果を参照します。
  4. 302は一時的なリダイレクトを表します。クライアントはリダイレクト先へ後続のリクエストを送信します。サーバーのレスポンス本文を直接置き換えるものではありません。

このルールの対象となる送信元アドレスはHTTPです。式のhttpをhttpsに変えるだけで、暗号化されたリクエストの完全なURLをすべて読み取れるわけではありません。通常のトンネル転送では、TLS内部のパスや内容は取得できません。また、HSTSやHTTPS優先の設定によって、リクエスト送信前にブラウザーがURLをHTTPSへ切り替えることがあります。その場合、このHTTPの例に一致する機会はありません。

URL RewriteとRuleが解決する問題は異なります。前者は一致したリクエストのURL動作を変更し、後者は接続時のルーティングポリシーを決定します。リダイレクトが機能していても、転送先に接続できるかどうかはDNS、ルーティング、サーバーの状態に左右されます。最終的にページを開けない場合は、最初のリクエスト、リダイレクト処理、新しい接続先への接続のどこで失敗したかを確認してください。

6. 保存・有効化・復元:変更は一度に1つずつ検証

編集前にConfigで、現在正常に使えるファイルのコピーを保存し、ファイル名を記録してください。編集メニューの表示はプラットフォームによって異なる場合があるため、現在のアプリで利用できる編集、コピー、書き出しの操作に従います。作業用の設定が1つしかない状態で直接上書きしないでください。リモート設定もローカルにコピーを残し、後から更新した際に手動変更を追跡できなくなるのを防ぎます。

  1. Configで編集するファイルを開き、1つのセクションから1項目だけ変更して、英語式の句読点で保存します。
  2. そのファイルが現在の設定として選択されていることを確認し、Home → Global RoutingでConfigを選択します。
  3. 現在選択されているプロキシが利用可能か確認してください。ルールを正しく記述しても、有効なサーバー認証情報の代わりにはなりません。
  4. 接続を確立し直し、そのルールに直接関係するテスト対象へアクセスして、アプリに表示される接続記録やログを確認します。
  5. 対象ドメイン、想定するポリシー、実際の結果、変更した項目を記録します。失敗した場合はバックアップに戻し、同じリクエストを再実行して比較してください。

Settings → On Demandは条件に応じて接続を開始する機能です。Ruleの照合順序とは別の問題です。手動で切断しても接続が再開する場合は、FINALを削除するのではなくOn Demandの条件を確認してください。原因を切り分けやすくするため、テスト中はOn Demandを一時的に無効にし、検証後に元の設定へ戻すことができます。

Ruleを変更したのに、すべてのサイトで同じ出口になるのはなぜ?

まずHome → Global RoutingがConfigになっているか確認し、次にConfigで現在選択されているファイルを確認します。その後、FINALより前に範囲が広すぎるルールがないかを調べ、新しい接続で再テストしてください。既存の長時間接続中のページを再読み込みするだけでは不十分です。

サブスクリプションを更新したのに、ローカルルールが変わらないのはなぜ?

サーバーのサブスクリプションとローカルの.confは別の設定項目です。Configに戻って現在のファイル内容を確認してください。リモート設定を更新する場合は、該当する設定を更新し、結果を確認します。Subscribeの更新時刻だけを根拠に判断しないでください。

Hostを追加したら、HTTPSで証明書が一致しないと表示されるのはなぜ?

マッピング先のアドレスで該当ドメインが提供されているか、サーバー証明書にそのドメインが含まれているかを確認します。Hostが変更するのはアドレスのマッピングだけで、証明書の問題は解決しません。まず該当のマッピングを解除して元の接続経路を確認し、その後、サーバー管理者に証明書とサイト設定を確認してもらってください。

保存後に構文エラーが発生したら、まずどこを確認すればいい?

まずエラーで示された行番号を見て、セクション名と英語式の句読点を確認します。Ruleでは半角カンマ、GeneralとHostでは等号、URL Rewriteではフィールド間にスペースを使います。追加した内容をいったん取り消し、元のファイルが使えることを確認してから、1行ずつ戻してください。

Shadowrocketをダウンロード