Shadowrocketの設定ファイル「.conf」の構成と読み方|General・Rule・Host・URL Rewriteを解説

.conf設定ファイルをセクションごとに解説。Generalは全般設定、Ruleは通信の振り分け、Hostはローカルの名前解決、URL RewriteはURLの書き換えを担当します。記述方法と適用順も紹介します。

この記事の概要

Shadowrocketの.confファイルは、サーバー情報の一覧でも、上から順に実行されるスクリプトでもありません。利用するサーバー情報をすでに持ち、設定を読んだり変更したりする方に向けて、4つのセクションの役割を整理します。ルール例や動作モードの違い、確認手順を通じて、変更箇所の選び方や、保存後に反映されない原因を解説します。

1. .confのセクション構成と読み取り範囲

設定ファイルでは、[General]のように角括弧でセクション名を指定します。セクション名から次のセクション名の直前までが、そのセクションの内容です。セクションごとに記述方法は異なります。Generalは主にキーと値の組み合わせ、Ruleはカンマ区切りのマッチ条件、Hostはホスト名とアドレスのマッピング、URL Rewriteはマッチ式と処理内容を記述します。あるセクションの書式を別のセクションにそのまま移すことはできません。

以下は構成を読むための最小限の例です。プロキシサーバーのパラメーターは含まず、現在のネットワークで使えるとは限りません。説明用の2つのドメインはマッチ動作を示すためのもので、実際の通信テストには使用しないでください。#で始まる独立した行はコメントです。コメントは接続を確立せず、ポリシーも変更しません。

# 構成例:使用前に現在の設定をバックアップ
[General]
dns-server = system

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

[Host]
example.com = 192.0.2.10

[URL Rewrite]
^http://example\.org/(.*)$ https://example.org/$1 302
4つのセクション
General / Rule / Host / URL Rewriteは、それぞれ異なる役割を担う
3種類のポリシー
この記事のルールでは PROXY / DIRECT / REJECT を使用
1つのフォールバック
例では FINAL を Rule の最後の行に配置

セクションの記述順は、リクエストの処理順を意味しません。HostをRuleの後ろに書いても、先に振り分けてからHostを参照するわけではありません。URL Rewriteをファイルの先頭に移しても、すべての通信で書き換えが先に行われるわけではありません。各セクションは対応する機能によって読み込まれます。「上から順に評価し、マッチした時点で終了する」という振り分けの意味を持つのは、Rule内のルール順だけです。

2. General:全般設定は通信の振り分けルールではない

[General]には、DNS関連の設定など、設定ファイル全体に関わる共通動作を記述します。例のdns-server = systemは、システムのDNS設定を使用する指定です。「すべての通信をDIRECTにする」という意味でも、「すべてのドメインをプロキシ経由にする」という意味でもありません。接続ポリシーは、Global Routing、Rule、現在利用可能なプロキシ設定をあわせて確認してください。

このセクションを編集するときは、オプション名を変更せず、値の型も確認してください。真偽値、アドレスのリスト、テキスト形式のパラメーターは相互に置き換えられません。他の設定ファイルに合わせるために、セクション全体を一括置換するのは避けましょう。既存設定のネットワーク例外やDNS動作、その他の共通設定が変わると、明らかな構文エラーではなく、一部の機能だけに問題が起きることがあります。

Generalを読むときのポイント

セクション名
[General]
キー名の例
dns-server
設定値の例
dns-server = system
確認する項目
現在選択中の設定ファイルにある全般設定

各キーの用途を確認してから変更を判断してください。セクションの位置から優先順位を推測しないでください。

設定の適用範囲

通信の振り分けモード
Home → Global Routing
設定ファイルの選択
Config → 現在使用中の設定ファイル
自動接続
Settings → On Demand
プロキシのパラメーター
Home → すでに登録済みのサーバー項目

On Demandは接続を開始する条件を決める機能です。Ruleの代わりではなく、設定セクションの実行を切り替えるものでもありません。

よくあるのは、Generalを変更した後にSettings → On Demandで自動接続の条件も変更してしまい、どの変更が結果に影響したのか判断できなくなるケースです。設定を検証するときは、接続状態とネットワーク環境を固定してください。自動接続の動作は別途テストします。この記事ではHome、Config、Settingsの画面構成を基準に説明します。ボタンの配置はプラットフォームによって異なる場合があります。

3. Rule:上から順に評価し、FINALは最後に配置

[Rule]では、条件に合致したリクエストに適用するポリシーを指定します。通常のルールは、タイプ、マッチ値、ポリシーで構成されます。FINALにはマッチ値が必要ありません。PROXYはリクエストをプロキシ経由にし、DIRECTは直接接続、REJECTはリクエストを拒否します。PROXYを指定しただけで利用可能なサーバーが作られるわけではありません。接続可能なサーバー情報が別途必要です。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT,no-resolve
FINAL,PROXY
ルールタイプ例の意味確認ポイント
DOMAINapi.example.comという完全一致のドメインだけにマッチします。他のサブドメインは含みません。
DOMAIN-SUFFIXexample.comとそのサブドメインにマッチします。より具体的な例外ルールは、このルールより前に配置します。
IP-CIDR192.0.2.0/24のアドレス範囲にマッチします。no-resolveを指定すると、このルールのためだけにドメイン名を解決する動作を避けられます。
GEOIPアドレスの割り当てデータベースを使って、CNに属するかどうかを判定します。判定基準はIPデータです。Webページの言語やドメインの末尾ではありません。
FINALそれ以前のルールにマッチしなかった場合、PROXYを適用します。後続のルールが先に処理されないよう、最後に配置します。

上記の順序では、api.example.comは最初にDOMAINにマッチするためDIRECTになります。www.example.comは1行目にマッチせず、続いてDOMAIN-SUFFIXにマッチするためPROXYになります。これはルールから導いた想定結果であり、例示ドメインに対する実通信テストの結果ではありません。サフィックスルールを先頭に置くと、完全一致ドメインの例外が適用されなくなります。

no-resolveは、アプリ全体のDNSを無効にする設定ではありません。該当するIP系ルールが名前解決を行うかどうかを制御します。リクエストにすでにIPアドレスが含まれている場合は、引き続きマッチ対象になることがあります。宛先アドレスがまだ得られていないドメインのリクエストは、後続ルールやFINALに進む可能性があります。すべてのアドレスの所属が判定済みだと想定しないでください。

4. Host:アドレスのマッピングと接続ポリシーは別

[Host]では、ホスト名をローカルで静的にマッピングします。次の行は、example.comを192.0.2.10に対応付ける例です。このアドレスは説明用に予約された範囲に属し、この記事で提供するサーバーアドレスではありません。実際に使う場合は、使用権限があり、正しいと確認できた宛先アドレスに置き換えてください。

[Host]
example.com = 192.0.2.10

「どこに接続するか」と「どの経路で接続するか」を区別する

Host:アドレスのマッピング
  • 指定したホスト名にローカルアドレスを割り当てます。
  • ページのURLを別のドメインに自動で書き換える機能ではありません。
  • DIRECTかPROXYかを自動で選択する機能ではありません。
Rule:接続経路の選択
  • ドメイン名やアドレスなどの条件に応じてポリシーを選びます。
  • DOMAINを使って、特定のドメインに適用するポリシーを指定できます。
  • Webサイトの宛先ホスト名を単独で置き換える機能ではありません。

アドレスを固定し、接続経路も指定する場合は、HostとRuleをそれぞれ設定してください。マッピング結果とポリシーのマッチ状況も個別に確認します。

Hostは証明書を修復する機能でもありません。HTTPS接続では、静的マッピングで接続先アドレスを指定しても、Webサイトがアクセス時のホスト名に一致する証明書を提示する必要があります。誤ったサーバーにマッピングすると、証明書の不一致、接続の切断、異なるWebサイトの表示などが起きる可能性があります。その場合は、証明書検証を緩めて宛先の誤りを隠すのではなく、まずマッピングを確認してください。

アプリがIPアドレスに直接接続する場合や、独自の名前解決方法を使う場合、通常のドメイン名リクエストとは異なる動作になることがあります。トラブルシューティングでは、実際のリクエストのホスト名と宛先アドレスを記録してください。ブラウザーのアドレスバーだけを見て、Hostが名前解決に使われたと判断することはできません。古い接続が以前のアドレスを使い続けることもあるため、変更後は新しい接続で確認します。

5. URL Rewrite:リクエストURLにマッチさせて動作を指定

[URL Rewrite]が処理するのはURLのマッチと書き換えであり、ネットワークのルーティングではありません。次の例では、正規表現で特定ドメインの平文HTTP URLにマッチさせ、HTTPS URLへの302リダイレクトを返します。例がhttp://から始まるのは、平文リクエストの見え方を説明するためです。すべてのHTTPSリクエストの内容をそのまま読み取れるという意味ではありません。

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

式に従うと、http://example.org/docsの書き換え先はhttps://example.org/docsです。新しいリクエストでも名前解決、接続ポリシーとのマッチ、接続の確立が必要です。RewriteはRuleを回避する手段ではなく、到達できない宛先を自動で接続可能にするものでもありません。

リダイレクトがループする場合は、書き換え後のURLが同じ、または別の書き換え式に再びマッチしていないか確認します。パスが欠落する場合は、キャプチャグループと$1の対応を確認してください。まったく動作しない場合は、ルールをすぐ変更するのではなく、ブラウザーが実際のリクエストをすでにHTTPSへ自動昇格していないかを確認します。

6. ConfigとGlobal Routing:ファイルを選んだ後、動作モードも確認

Config画面では設定ファイルを管理し、Home → Global Routingでは現在の通信モードを選択します。名前は似ていますが、役割は異なります。Configの一覧にファイルが表示されていても、使用中とは限りません。ファイルを選択していても、そのルールに従って通信を振り分けるモードが選ばれているとは限りません。

Config

推奨

現在の設定ファイルのルールに従って接続ポリシーを選びます。どのルールにもマッチしないリクエストの処理は、最後のルールによって異なります。FINALはDIRECTの場合もPROXYの場合もあり、常に「その他は直接接続」とは限りません。

適した用途:Ruleの順序や、特定ドメインの振り分け結果を検証するとき。

Proxy

グローバルプロキシモードを使い、通常のRuleによる振り分けに従わず経路を選びます。ただし、対象となるシステム通信の範囲やネットワーク例外、プロトコルの利用可否が影響する場合があります。

適した用途:短時間でプロキシ経路が使えるか比較するとき。Ruleの適用確認には使えません。

Direct

直接接続モードを使い、ローカルネットワーク経由の動作を確認します。設定ファイル内のPROXYという記述をすべてDIRECTに書き換える機能ではありません。

適した用途:同じ宛先への直接接続時の動作を比較するとき。

Scene

設定済みのシーン条件に応じて動作を切り替えます。結果はシーンの定義に依存するため、使用前に現在のネットワークがどのシーンに該当するか確認してください。

適した用途:シーンを明確に設定済みの環境。特定ルールの問題を調べる場合は、まずこの変数を減らしてください。

ルールを検証するときはConfigを選ぶと、リクエスト結果を具体的なRuleに結び付けて確認しやすくなります。Proxyに切り替えるとアクセスでき、Configに戻すと失敗する場合、2つの経路やポリシー選択に差があることは分かります。ただし、実際にマッチした行、名前解決の結果、利用可能なサーバーも確認してください。それだけで「設定ファイルが破損している」とは判断できません。

7. 保存・有効化・トラブルシューティング:一度に変えるのは1項目

編集前に元のファイルを保存してください。リモートURLから取得した設定は特に注意が必要です。リモート更新によってローカルの変更が上書きされることがあります。サーバーのサブスクリプション更新と設定ファイルの更新も別の処理です。前者では通常サーバー項目が更新され、後者ではGeneralやRuleなどが変わることがあります。サブスクリプションの更新に成功したからといって、Ruleが再読み込みされたとは限りません。

  1. バックアップを保存

    Configで現在使用中のファイルを確認し、復元できる元ファイルのコピーを保存してから編集画面を開きます。唯一使える設定ファイルを直接上書きしないでください。

  2. 変更は1か所だけ

    たとえば、Rule内のDOMAINルールを1つだけ移動します。General、Host、URL Rewriteは変更せず、変更前後の行全体を記録してください。

  3. 有効化を確認

    保存後にConfigへ戻り、変更したファイルが選択されていることを確認します。次にHome → Global RoutingでConfigを選び、接続が有効になっていることを確認してください。

  4. 新しいリクエストを送信

    同じネットワークで対象へのリクエストを再実行し、リクエスト記録で確認できるドメイン名、宛先IP、ポリシーを確認します。必要に応じて接続を作り直し、古いセッションの影響を避けてください。

  5. 変更前と比較して戻す

    想定どおりの結果にならない場合は、変更した行を元に戻して再テストします。自動接続の動作を確認する場合は、複数の設定を同時に変えないよう、別途Settings → On Demandを開いてください。

症状まず確認する項目次に行うこと
ルールを保存してもポリシーが変わらない選択中のファイルとGlobal Routingのモード。Configを使用していることを確認し、より広い条件にマッチするルールが前にないか調べます。
特定のドメインで証明書エラーが発生するHostで誤ったアドレスにマッピングされていないか。該当するマッピングを削除して新しい接続を作り、証明書と宛先ホスト名を比較します。
URL Rewriteが動作しないリクエストのプロトコル、ドメイン、パスが式にマッチするか。まず平文HTTPの例で動作を確認し、その後、実際のリクエストが確認可能か調べます。
更新後にカスタムルールが消えた更新したのがリモート設定ファイルか、サーバーのサブスクリプションか。バックアップと照合して変更を復元し、今後編集するファイルの取得元を確認します。
PROXYにマッチしても接続できない登録済みサーバーのプロトコル設定と接続性。ルールへのマッチとプロキシ接続の成否を分けて調べ、Ruleの順序を何度も入れ替えないでください。

最終的な判断では、設定ファイルが選択されているか、リクエストが想定したルールにマッチしたか、名前解決されたアドレスが正しいか、選択した経路で接続できるか、の4点に分けて確認します。General、Rule、Host、URL Rewriteはそれぞれ異なる要素を扱うため、1つのセクションの変更だけでトラブルシューティング全体を代替することはできません。画面設定については設定ガイド、プロトコルの項目についてはプロトコルリファレンスをご覧ください。

Shadowrocketをダウンロード