Shadowrocketの設定ファイル(.conf)の構造と使い方|General・Rule・Host・URL Rewriteを解説

Shadowrocketの.confをセクションごとに解説。[General]、[Rule]、[Host]、[URL Rewrite]の役割と、変更を反映する手順を紹介します。

この記事の概要

Shadowrocketの.confはテキスト形式の設定ファイルであり、サブスクリプションURLでも、接続情報の代わりになるものでもありません。利用者自身が用意したサービス情報を前提に、各セクションの実行パラメータ、ルールによる振り分け、ドメインのマッピング、URLリダイレクトの違いを説明し、バックアップ、編集、有効化、元に戻す手順を紹介します。まず最小限のルールで確認してから設定を一つずつ戻すと、DNS、ルールの順序、接続エラーを切り分けやすくなります。

1. .confのセクション構成と設定の範囲

設定ファイルでは、[General]のように角括弧でセクションを指定します。セクション名以降の内容は、次のセクション名が現れるまで、そのセクション固有の書式で解釈されます。[General]では一般にキー = 値の形式を使いますが、[Rule]はカンマ区切りのルール行を使います。すべてのセクションに同じ書式を当てはめることはできません。編集時は半角の角括弧、カンマ、等号を使い、日本語入力によって記号が置き換わらないようにしてください。

セクション役割対象外
[General]DNSなどの基本動作パラメータ個別サイトの振り分けルールの代わりにはならない
[Rule]条件に応じてDIRECTやPROXYなどのポリシーを選択リクエストURLは変更しない
[Host]特定ドメインの名前解決結果を指定プロキシを使うかどうかを単独で決めない
[URL Rewrite]正規表現に一致するURLを処理DNSマッピングやルーティングルールとは異なる

この4つのセクションをすべて記述する必要はありません。サイトの振り分けだけを行う場合は、必要な基本パラメータと[Rule]だけを残し、HostやURL Rewriteは追加せずに始められます。設定ファイルには、ほかにも対応しているセクションが含まれる場合があります。この記事で説明していないからといって削除しないでください。別形式の設定ファイルは、拡張子を.confに変えただけでは使用できません。

2. [General]:DNSの基準を確認してからほかの設定を変更

[General]では、対応が明確な設定を少数から確認します。以下の例のdns-server = systemは、ここでの名前解決にシステムDNSを使う指定です。すべてのネットワークで名前解決できることを保証するものではなく、実際の結果は利用中のネットワークやキャッシュ、ほかのDNS設定にも左右されます。

[General]
dns-server = system

既存の設定にDNSパラメータがある場合は、まず元の値を記録してから比較テストを行います。名前解決先を変更すると、ドメインに割り当てられるIPが変わり、GEOIPやIP-CIDRのマッチ結果に影響することがあります。サイトの問題を調べるときは、DNSの変更、ルール順の調整、接続項目の切り替えを同時に行わないでください。どの変更が結果に影響したのか分からなくなります。

基本パラメータの確認

セクション
[General]
キーの例
dns-server
値の例
system
記述形式
キー = 値

動作する状態を基準として保ち、意味が分からないパラメータは名前から推測して追加しないでください。

名前解決の問題を確認

テスト対象
同じ完全修飾ドメイン名
固定する条件
同じネットワーク、同じ接続項目
記録する内容
名前解決結果、マッチしたルール、接続エラー
元に戻す方法
元の値に戻して新しい接続を確立

ドメインを名前解決できても、接続先のポートに接続できるとは限りません。それぞれ個別に確認してください。

3. [Rule]:マッチ順、ポリシー、FINALによるフォールバック

[Rule]では上から順に評価され、最初にマッチしたルールのポリシーがそのリクエストに適用されます。以下は「example.comとそのサブドメインにはPROXYを使い、それ以外にはDIRECTを使う」例です。振り分けの仕組みを示すもので、接続に必要な情報は含みません。PROXYを使うには、Homeで利用可能な自分の接続項目を用意して選択してください。

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

DOMAIN-SUFFIX,example.com,PROXYは、example.comとwww.example.comにマッチします。URLのパスを文字列検索するものではありません。https://、ポート番号、/pathは記述しないでください。FINALは、それ以前のルールにマッチしなかった場合のフォールバックなので、ルールの末尾に置きます。先頭に置くと、後続のルールがマッチする機会を失います。

ルールの例判定基準確認ポイント
DOMAIN-SUFFIX,example.com,PROXYドメインのサフィックス関連するドメインをまとめて指定する場合に適する
GEOIP,CN,DIRECT接続先IPの地理情報データベース上の判定結果Webページの言語やドメインのサフィックスでは判定しない
IP-CIDR,192.0.2.0/24,DIRECT,no-resolveIPv4アドレスが属するネットワーク範囲no-resolveを指定すると、このルールの判定だけを目的としたドメインの名前解決を行わない
FINAL,DIRECTほかのルールにマッチしない場合最後に置き、残りのリクエストの行き先を指定

表内の各項目は書式の説明であり、すべてを同じ設定ファイルに追加する必要はありません。192.0.2.0/24は文書用の例示ネットワークで、実際のサービスアドレスではありません。GEOIPのように広範囲に適用されるルールを追加する場合は、より具体的なサイト例外の後、FINALの前に置きます。条件が広すぎると、後続のルールで処理するはずのリクエストが先にマッチすることがあります。

4. [Host]:ドメインのマッピングは通信の直接接続とは別

[Host]では、特定ドメインの名前解決結果を固定できます。以下は予約済みのテスト用ドメインを文書用の例示アドレスに割り当てたもので、実際のサービスには対応していません。左側にプロトコルやパスを含まないドメイン、右側に指定するアドレスを記述します。

[Host]
lab.example.test = 192.0.2.10

Hostが解決するのは「ドメインをどのアドレスに割り当てるか」、Ruleが決めるのは「リクエストにどのポリシーを適用するか」です。Hostを設定しても、リクエストがDIRECTになるとは限りません。マッチしたルール、現在のGlobal Routingのモード、接続ログに記録された接続先とポリシーを確認してください。

問題に応じて変更する場所を選ぶ

接続先アドレスを固定したい
  • Hostでドメインとアドレスの対応を明示します。
  • 接続先サーバーが引き続きそのドメインのリクエストを受け付けているか確認します。
  • HTTPSでは、元のドメインに対応する有効な証明書も必要です。
リクエストのポリシーを変更したい
  • RuleにドメインまたはIPの条件を追加します。
  • 例外ルールが広範囲に適用されるルールより前にあることを確認します。
  • Configモードで実際にマッチしたポリシーを確認します。

アドレスのマッピングとルーティングの選択は、個別に確認してください。IPを固定しても証明書の不一致は解消されず、サービスが長期間利用できる保証にもなりません。

5. [URL Rewrite]:URLの書き換えはRuleの代わりにならない

[URL Rewrite]では、URLに対する正規表現を使って処理を行います。以下の例はHTTPのルートURLをHTTPSのルートURLへリダイレクトします。末尾の302は一時リダイレクトを表します。例はルートパスだけを対象とし、ドメイン内の全ページには適用されないため、テスト範囲を絞れます。

[URL Rewrite]
^http://example\.com/$ https://example.com/ 302

通常のHTTPSリクエストでは、完全なパスは暗号化によって保護されています。URL Rewriteを追加しただけで、パスまでマッチできると考えないでください。HTTPSの内容を処理するには、復号の対象範囲や証明書の信頼設定なども必要です。この記事で扱う基本設定の確認では、これらの機能を有効にする必要はありません。リダイレクトのテストだけを目的に、すべてのドメインへ処理範囲を広げないでください。

6. 編集後に有効化する:保存、選択、接続の再確立

ファイルを保存するだけでは設定は反映されません。Configで編集した設定が選択されていることを確認し、Home → Global RoutingでConfigを使用してください。以下ではiPhone/iPadのHome、Config、Settingsの構成を例に手順を説明します。ほかのプラットフォームでは対応する機能を確認してください。画面上の配置がすべてのプラットフォームで同じとは限りません。

  1. 元のファイルをバックアップ

    Configを開き、現在の設定の操作メニューから元の設定を書き出して、別の場所に保存します。現在の設定名と、Home → Global Routingのモードも記録してください。

  2. 1項目ずつ編集

    Configで対象設定のテキスト編集画面を開き、1回につき1つのセクションだけを変更します。セクション名、半角記号、FINALの位置を確認してから保存してください。

  3. 設定を選択

    Configの一覧に戻り、対象ファイルが選択されていることを確認します。複製を編集した場合は、その複製に明示的に切り替えてからテストしてください。元のファイルを使ったままテストしないようにします。

  4. モードを切り替え

    Home → Global Routingを開き、Configを選択します。Settings → On Demandが有効な場合は設定を記録し、テスト中に自動接続が手動での切り替えに影響しないようにしてください。

  5. 接続を再確立して確認

    いったん切断してから再接続し、新しいテストリクエストを送信します。接続ログでドメイン、マッチしたルール、ポリシーを確認してください。失敗した場合はバックアップ設定に戻し、同じリクエストでもう一度テストします。

既存の接続には、確立時の状態が引き継がれることがあります。ブラウザーに接続やキャッシュが残っている場合もあります。設定変更後に古いページを1回再読み込みしただけでは、新しい設定が反映された証拠にはなりません。テストでは既存の接続を終了して新しいリクエストを送り、ネットワークと接続項目は変えないでください。必要に応じて、ドメインの名前解決と接続先サービスへの接続を別々に確認します。

7. Global Routingのモードが設定確認に与える影響

「ルールを設定したのに反映されない」ときは、ファイルをさらに編集する前にGlobal Routingを確認します。Configは現在の設定に従って通信を振り分けます。ProxyとDirectは問題の範囲を絞る比較に使えますが、その結果だけではルールのマッチを確認できません。

Config

おすすめ

現在の設定に基づいてリクエストのポリシーを決定します。DOMAIN-SUFFIXとFINALを確認するには、このモードで実際のマッチ結果を確認してください。

適した用途:日常的なルール振り分け、設定変更後の動作確認。

Proxy

通信をプロキシ経由で処理し、現在の接続が利用可能か比較するために使います。ページが開けても、特定のRuleにマッチしたとは限りません。

適した用途:接続項目の問題とルール選択の問題を切り分ける。

Direct

通信を直接接続で処理し、プロキシ経由の経路と比較できます。このモードでは、追加したPROXY振り分けルールがConfigと同じように動作することは期待できません。

適した用途:現在のネットワークから接続先にアクセスできるか確認する。

Scene

設定済みのSceneに基づいて動作方法を決定します。トラブルシューティング時は、Sceneの条件と動作を先に確認し、Sceneの切り替えでテスト条件が変わらないようにしてください。

適した用途:Sceneを設定済みのネットワーク環境を切り替える。

8. よくある設定トラブルと元に戻す手順

.confを保存したのに、以前のポリシーが使われるのはなぜですか?

Configで選択中のファイル、Home → Global Routing → Configの設定、対象ルールがFINALより前にあることを順に確認します。その後、接続を再確立して新しいリクエストを送ってください。ファイルの内容が正しくても、編集したファイルが現在の設定ではないケースをまず除外します。

Hostを追加したらHTTPSで証明書エラーが出るのはなぜですか?

Hostが変更するのはアドレスのマッピングだけで、リクエストのドメインや証明書の検証要件は変わりません。まず追加したマッピングを削除して再テストし、指定したサーバーがそのドメインのサービスを提供しているか確認します。証明書エラーを無視するのではなく、アドレスと証明書の設定を修正してください。

サブスクリプションを更新してもルールが更新されないのはなぜですか?

接続項目のサブスクリプションとリモート設定は別のものです。更新したのがHomeのサービス情報か、Configのリモート設定かを確認してください。更新前にローカルの複製を保存し、リモート設定を再取得した後は、自分で編集したルールが上書きされていないかも確認します。

編集後に接続できなくなりました。すべて再インポートする必要がありますか?

まずバックアップした設定に戻し、元の接続項目は変更せずに再接続します。正常に戻ったら、直近で変更したセクションを1つずつ比較してください。それでも失敗する場合は、サービスのアドレス、ポート、認証情報を確認します。比較の基準を失わないよう、設定やサブスクリプションをすべて削除しないでください。

動作確認では、少なくとも現在選択中の設定、Global Routingのモード、テスト対象のドメイン、実際にマッチしたポリシーの4項目を記録します。変更前後を比較するときは、一度に変更する条件を1つにしてください。これにより、構文エラー、ルールの優先順位、名前解決の差、サービスへの接続不可を切り分けられます。設定を次々に追加する必要はありません。

Shadowrocket公式ダウンロード