Shadowrocketの設定ファイル解説:.confのGeneral・Rule・Host・URL Rewrite各セクションの役割

Shadowrocketの.conf設定ファイルを構成する各セクションを解説。[General]、[Rule]、[Host]、[URL Rewrite]の役割と、ルールが上から順に評価される仕組みを紹介します。

この記事の概要

Shadowrocketのローカル設定を確認・編集する方向けの記事です。まず有効なファイルとGlobal Routingを確認し、現象に応じて該当セクションを調べます。接続経路が異なる場合は[Rule]、名前解決の結果が正しくない場合は[Host]と[General]、URLパスに応じたリダイレクトが必要な場合は[URL Rewrite]を確認してください。

.confのセクション構成と書式

角括弧内のセクション名によって、次のセクション名が現れるまでの各行をどの書式で読み取るかが決まります。[General]と[Host]はいずれも等号を使いますが、左辺の意味は異なります。前者は設定項目、後者はホスト名です。[Rule]では通常、種類・照合値・ポリシーを半角カンマで区切ります。[URL Rewrite]のリダイレクト項目は、照合式・転送先URL・アクションを空白で区切ります。

4セクション
この記事で扱う設定セクション
3項目
DOMAINルールの例:種類、ドメイン、ポリシー
2項目
FINALルール:キーワード、ポリシー

既存ファイルにルールを追加するときは、まず元の[Rule]セクションを見つけ、挿入位置を決めます。例全体をファイル末尾に追加しないでください。末尾が別のセクションに属している可能性があり、ルールのように見える行でも、読み込まれる位置に置かれていなければ適用されません。

Configで編集してファイルを有効にする

設定一覧にファイルが表示されていても、現在の接続でそのファイルが使われているとは限りません。以下ではiPhone / iPad版の画面表示を例に説明します。初回の編集では1行だけ変更し、変更前のファイルをコピーして保存してください。同じ条件でテストし、元に戻して確認できます。

  1. ファイルを確認する

    Configを開き、編集するファイル名を確認してから、未編集のコピーを保存します。リモート設定が更新される場合は、テストにローカルコピーを使い、更新によって編集内容が上書きされないようにします。

  2. 設定ファイルを編集する

    Configでファイル名をタップし、Edit Plain Textを選択します。該当セクションを見つけ、設定を1項目だけ追加または変更してください。英語の句読点と区切り文字はそのままにして、保存します。

  3. 設定を有効にする

    Configに戻り、編集したファイル名をタップしてUse Configを選択します。復元用のコピーではなく、編集したファイルが有効になっていることを確認してください。

  4. 接続を再試行する

    Home → Global Routing → Configの順に開きます。同じ接続先に対して新しい接続を開始してください。アプリが既存の接続を再利用している場合は、元の接続を終了してからテストします。

Configは設定画面の名前であると同時に、Global Routingで選べるモードの1つでもあります。前者ではファイルを選択し、後者ではそのファイルのルールに従って通信を振り分けるかどうかを指定します。[Rule]の問題を調べるときは、両方の設定を確認してください。

Config

推奨

選択中の設定ファイルにあるルールに従って接続ポリシーを決定します。例外ルール、サフィックスルール、FINALの順序によって結果が変わります。

適した用途:有効な設定ファイルのルールが適用されるか確認する。

Direct

直接接続モードを使用します。直接接続できても、現在のネットワークから接続先に到達できることが分かるだけで、設定ファイル内のDIRECTルールが適用された証明にはなりません。

適した用途:同じ接続先で直接接続できるかを個別に確認する。

Proxy

クライアントが処理する接続にプロキシモードを使用します。テスト前にHomeで自分のサーバーが選択されていることを確認し、同じ接続先への新しい接続を開始してください。

適した用途:通信の振り分けルールを介さずにプロキシ経路を確認する。

[General]と[Host]:名前解決の設定とホスト名ごとのマッピング

[General]には、設定ファイル全体に適用される設定を記述します。たとえばdns-server = systemは、システムDNSを使う指定です。[Host]では特定のホスト名にアドレスを割り当てられます。前者は通常どの名前解決設定を使うか、後者はShadowrocketが名前解決を処理するときに個別のマッピングがあるかを示します。どちらも[Rule]による接続ポリシーの選択を置き換えるものではありません。

[General]
dns-server = system

[Host]
docs.example.com = 192.0.2.10

192.0.2.10はドキュメント用の例示アドレスであり、接続テストには使いません。上のマッピングに記載されているのはdocs.example.comだけで、api.example.comは含まれていません。マッピングを確認するときは、元のホスト名でリクエストし、ブラウザーのアドレスをIPアドレスに変更しないでください。リクエストに使われるホスト名が変わり、HTTPS証明書の検証条件も変わる可能性があります。

問題の範囲に応じて確認箇所を選ぶ

複数のドメインで名前解決に問題がある
  • [General]のdns-serverを確認し、問題が特定のネットワークでのみ起きるか記録します。
  • 同じ設定を使い、2つのネットワークでそれぞれ新しいリクエストを送信して、システムDNSが使うネットワークに応じて現象が変わるか確認します。
特定のホスト名だけに問題がある
  • [Host]に該当するホスト名が完全な形で記載されているか確認します。特にwwwなどのサブドメインに注意してください。
  • コピーから該当するマッピングを削除し、同じホスト名で再試行して、既存の接続やキャッシュの影響を除外します。

まず、名前解決の結果が誤っているのか、アドレスは正しいが接続できないのかを切り分けます。現象によって確認箇所が異なります。

[Rule]:上から順に評価し、最初に一致したルールを適用

ルールが自動的に具体的なものから順に並ぶことはありません。特定のホスト名をサフィックスルールの例外にするには、そのホスト名のDOMAINを先に記述し、対象範囲の広いDOMAIN-SUFFIXを後に記述します。それ以前のルールに一致しない接続は、末尾のFINALに渡されます。

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

先頭の2行を入れ替えると、docs.example.comは先にDOMAIN-SUFFIXに一致し、後にある完全一致ルールは適用されません。例のFINAL,DIRECTは、この設定で最後に適用されるフォールバックです。既存ファイルを編集する際は、元のフォールバックポリシーを確認してください。例外を1つ追加するために、ほかの接続先の動作まで変えないようにします。

IP-CIDRは、接続先IPが属するネットワーク範囲に基づいて一致します。例:IP-CIDR,192.0.2.0/24,DIRECT。GEOIPはIPアドレスの地理情報に基づいて一致し、ドメインのサフィックスでは判定しません。ドメインへのリクエストを調べるときは、まず上位のドメインルールに一致しているか確認し、次にIPルールの照合に使える接続先アドレスが取得されているか確認します。

[URL Rewrite]:URLパスに応じてリダイレクト

[Rule]は接続経路を決定し、[URL Rewrite]はクライアントが処理できるHTTPリクエストURLに一致します。次の例では、プロトコル、ホスト名、パスを指定し、302で新しいアドレスに転送します。構文を示す例であり、例示ドメイン上のページには依存しません。

[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302

HTTPSリクエストではパスが暗号化されるため、接続先のホスト名だけではパスに一致させられません。テストツールが送信前にHTTPをHTTPSへアップグレードすると、上の式にはそのまま一致しません。実際に送信されたプロトコルとURLを確認してから、式を変更する必要があるか判断してください。

保存しても反映されないときの主な原因

DIRECTを指定したのに、なぜプロキシ経由になる?

まず、Home → Global RoutingがConfigになっているか確認し、次に現在有効なファイルの[Rule]を調べます。該当ホスト名に一致するDOMAIN-SUFFIXが上にある場合は、完全一致の例外DOMAINをその前に移動し、新しい接続で確認してください。

新しいルールをFINALの下に追加してもいい?

通常のルールをフォールバックの後に置かないでください。すでにFINALがある場合は、その前に新しいルールを挿入し、さらに上に対象へ一致する項目がないか確認します。保存後、一致するはずの接続先とフォールバックに該当する接続先をそれぞれテストしてください。

Hostでアドレスを変更したのに、ブラウザーのアドレスバーが変わらないのはなぜ?

[Host]が変更するのはホスト名に対応するアドレスです。アドレスバーに元のURLが表示されるのは正常です。マッピングを検証するには、自分で管理する接続先サービスを使い、新しい接続が想定したアドレスに到達するか確認してください。/oldから/newへ変更したい場合は、ホスト名のマッピングではなくリダイレクトを確認します。

元のファイルに戻した後、問題の原因となった変更を特定するには?

同じネットワークで、元のファイルと編集後のコピーを使い、同じリクエストをそれぞれ送信します。その間、Global Routingと選択中のサーバーは変更しないでください。コピーでのみ問題が起きる場合は、直近で変更したセクションから1行ずつ元に戻し、1か所変更するたびに再試行して、現象の原因となる項目を特定します。

Shadowrocketの全プラットフォーム版をダウンロード