Shadowrocketの設定ファイル「.conf」を解説:General・Rule・Host・URL Rewriteの役割

.confの各セクションを解説。Generalは全般設定、Ruleはルールの評価順、Hostはローカル名前解決、URL Rewriteはリクエストの書き換えを担当します。実例付き。

この記事の概要

送信先の振り分けを変更するなら [Rule]、ドメインの名前解決結果なら [Host]、リクエストURLなら [URL Rewrite]、DNSなどの全般設定なら [General] を確認します。この記事は、Shadowrocketで設定ファイルを使用していて、項目の確認や編集を行う方向けです。画面操作はiPhone / iPadを例に説明します。ほかのプラットフォームではセクション名を照らし合わせてください。

まず有効な設定ファイルを確認し、編集するセクションを特定する

.confは、角括弧で囲まれた見出しでセクションを区切ります。ある見出しから次の見出しまでの項目が、同じセクションに属します。4つのセクションは、リクエスト処理の固定順序を示すものではありません。たとえば[Host]を[Rule]より前に移動しても、名前解決の項目が振り分けで優先されるわけではありません。行の順序が重要なのは、[Rule]セクション内です。

4セクション
この記事ではGeneral、Rule、Host、URL Rewriteを比較
1項目
Ruleは最初に一致したルールを適用
302
この記事の書き換え例で使用する一時リダイレクトのステータスコード

まずHome → Global Routingを確認

Configで選択中のファイルを確認し、次にHome → Global RoutingでConfigを選んで振り分けを検証します。現在ProxyまたはDirectになっている場合は、接続結果だけを見てルールの順序を変更しないでください。

以下の流れは、Configモードで振り分け先がどのように選ばれるかを示すもので、DNS問い合わせとURL書き換えが常に同じタイミングで実行されるという意味ではありません。Sceneでは状況に応じたルーティング方式を選べます。個別のルールを調べるときは、Sceneの切り替えによる影響を避けるため、まずConfigに切り替えてください。

アプリからリクエスト接続先の判定ルールの照合ポリシーの適用
  1. 元の設定を残し、コピーを編集してください。元ファイルがリモートURLから更新される場合は、次回の更新で上書きされないよう、変更内容をローカルに別途保存します。
  2. 1回の検証で変更するのは1か所だけにし、同じデバイス、ネットワーク、接続先で再テストします。設定変更前の状況を記録しておくと、ネットワークの切り替えやキャッシュの変化を、設定が反映された結果と誤認しにくくなります。

General:DNSなどの全般設定

[General]ではキー = 値の形式を使います。ここでは、ドメインごとに送信先のポリシーを指定するわけではありません。以下の2行は、システムDNSとIPv6の設定例です。DNSをテストするために、IPv6まで変更する必要はありません。

[General]
dns-server = system
ipv6 = false
  • dns-server = system:システムに設定されたDNSを使用します。同じドメインの名前解決が特定のWi-Fiでだけ失敗する場合は、まずそのネットワークでシステムの名前解決が正常に行われるか確認し、モバイル通信や正常に動作する別のネットワークと比較してください。システムDNSはネットワークごとに異なる場合があります。
  • ipv6 = false:設定内のIPv6サポートを無効にし、IPv6経路の影響を切り分けます。これはシステム全体の設定ではなく、接続先にIPv4アドレスが必ずあることを保証するものでもありません。テスト後は元の設定に戻し、変更を残すか判断してください。

誤ったアドレスに名前解決されるドメインが1つだけなら、全体のDNSを変更する前に[Host]に同じドメインの項目がないか確認します。正常に名前解決されるのに送信先が違う場合は、[Rule]を確認してください。ほかの項目については設定項目の説明をご覧ください。

Rule:上から順に照合し、最初に一致したルールを適用

[Rule]の一般的な形式はタイプ,マッチ値,ポリシーです。FINALにはマッチ値を指定しません。以下の例では、完全一致のドメイン例外をサフィックスルールより前に置いています。先行する条件に一致しなかったリクエストはFINALで処理されます。PROXYは選択中のプロキシを使用し、DIRECTは直接接続、REJECTはリクエストを拒否します。例中のドメインとIP範囲はマッチ方法の説明用であり、利用可能なサービスの接続先ではありません。

[Rule]
DOMAIN,lab.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,REJECT,no-resolve
FINAL,DIRECT

ドメインの照合

DOMAIN
lab.example.comに完全一致します。サブドメインは含みません。
DOMAIN-SUFFIX
example.comとそのサブドメインに一致します。
FINAL
それ以前のルールに一致しなかった場合はDIRECTを選択します。

サフィックスルールを完全一致ルールより前に移動すると、両方の条件を満たす場合は先にPROXYが選択されます。

IPアドレスの照合

IP-CIDR
指定したIP範囲に一致します。たとえば、IPアドレス192.0.2.10は192.0.2.0/24に含まれます。
no-resolve
このIPルールを試すために、ドメインを意図的に名前解決する必要はありません。
GEOIP
接続先IPの地理的な分類で照合します。たとえばGEOIP,CN,DIRECTは、ドメインのサフィックスではなく、接続先IPの分類を使います。

GEOIPを設定に追加する場合は、FINALより前に置き、それより上に先に一致するルールがないか確認してください。

ルールの順序を検証するときは、「ルールによってポリシーが選択された」ことと「接続先のサービスにアクセスできる」ことを区別してください。たとえば接続先がlab.example.comと判定され、1行目のDIRECTに一致した場合、サービス自体に接続できなくても、2行目のPROXYに切り替わることはありません。まず一致したルールを確認し、その後でサービスへの到達性を調べてください。

Host:指定ドメインの名前解決結果を上書き

[Host]では、設定内でドメインを指定したアドレスに対応付けられます。以下では、例示用に予約されたアドレス192.0.2.10を使って書式を説明します。実際の検証では、自分で管理するテスト用ドメインと、現在のネットワークからアクセスできるアドレスを使用してください。また、接続が設定の影響を受ける名前解決経路を実際に使っていることを確認してください。

[Host]
lab.example.com = 192.0.2.10
  1. まず元の設定でテスト用ドメインにアクセスし、接続できるか、サーバー側でリクエストをどこから受信したかを記録します。マッピングを設定したコピーを有効にしたら、同じドメインに新しい接続を行い、既存の接続やDNSキャッシュの影響を避けてください。
  2. それでも毎回元のアドレスに接続される場合は、コピーが選択されているか、対象アプリが既存の接続を再利用していないか、独自のDNSを使用していないか確認してください。システムの名前解決ツールに表示される結果は、そのアプリがShadowrocket経由で接続する際の結果と異なることがあります。
  3. 指定したアドレスに接続できてもHTTPS証明書エラーが表示される場合は、接続先サービスに元のドメイン用の有効な証明書が設定されているか確認してください。[Host]が変更するのは名前解決先のアドレスです。URL内のドメインは変わらず、ドメインが一致しない証明書が有効になることもありません。

「同じドメインにアクセスし、別のサーバーから応答させたい」場合は[Host]を確認します。「あるパスにアクセスした後、別のパスへ移動させたい」場合は[URL Rewrite]を確認してください。IPアドレスを変更しても、ブラウザーのアドレス欄が/oldから/newに変わるわけではありません。

URL Rewrite:URLパターンに応じてリダイレクトを返す

[URL Rewrite]の例では、マッチ式、転送先URL、アクションコード302を順に記述し、各フィールドをスペースで区切ります。このルールは完全なHTTP URL http://lab.example.com/oldにのみ一致します。ドメイン内のピリオドはバックスラッシュでエスケープし、^と$でマッチ範囲を限定しています。そのため、/old/やクエリパラメーター付きのURLには一致しません。

[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
  • テストには、自分で管理し、平文HTTPを許可しているドメインを使用してください。アカウント情報などの機密情報は送信しないでください。リクエストがhttp://のままであることを確認します。ブラウザーが先にHTTPSへアップグレードすると、この例の条件には一致しません。
  • 想定される動作は、元のリクエストに対して302が返り、レスポンスのLocationに/newを含む完全なURLが指定されることです。リダイレクトを追跡するクライアントは、その後、新しいリクエストを送信します。アドレス欄が/newに変わってもページが見つからない場合は、サーバー上に転送先のパスが実際に存在するか確認してください。
  • HTTPSのパスとクエリパラメーターは暗号化されています。Shadowrocketからリクエスト内の完全なURLを確認できない場合、式のhttpをhttpsに変えるだけではパスに一致しません。まず管理下のHTTP環境で式を検証し、HTTPSで一致しない原因をすぐに[Rule]に求めないでください。

よくある質問:設定変更後の確認ポイント

ドメインルールを追加したのに、なぜ元のポリシーが使われる?

まずConfigでファイル名を照合し、Home → Global RoutingがConfigに設定されていることを確認してください。[Rule]を上から順に確認し、特に先に記述されたDOMAIN-SUFFIXに注意します。対象となる例外の範囲を明確にしたうえで、完全一致ルールを該当する広範なルールより前に移動してください。

IPアドレスを直接入力した場合と、ドメイン名を入力した場合で結果が違うのはなぜ?

まず、2つのリクエストの接続先を分けて記録します。ドメイン名を入力するとドメインルールに一致することがありますが、IPアドレスを直接入力した場合は同じドメイン名を使った照合はできません。接続先が同じでも、サーバーがドメイン名に応じてサイトを選ぶことがあり、IPアドレスで直接アクセスすると証明書が一致しない場合もあります。

書き換え後にリダイレクトが繰り返される場合、最初にどの行を削除すればよい?

まずコピーから今回追加した書き換えを削除して、再試行してください。ループが解消した場合は、転送先URLも元の式に一致していないか、転送先ページが元のURLへ再びリダイレクトしていないか確認します。式の対象を具体的な元のパスに絞り、元のURLと転送先URLをそれぞれテストしてください。

設定を更新したら、ローカルで追加した項目が見つからない。どうすればよい?

まずConfigで、現在選択している設定がリモート設定かローカルコピーか確認してください。リモートの内容によってローカルの変更が置き換わっている場合は、保存してあるコピーから項目を復元し、新しいコピーにセクションごとに統合します。統合後はルールの順序と重複したドメインのマッピングを確認し、項目ごとに再テストしてください。

Shadowrocketをダウンロード