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

1. .conf・サブスクリプション・現在の接続を区別する

.confはテキスト形式の設定ファイルで、角括弧内の名前がセクションを表します。セクションごとに構文が異なります。[General]は主にキーと値の組み合わせ、[Rule]はカンマ区切りのルール、[Host]はホスト名のマッピング、[URL Rewrite]はマッチ条件・転送先・アクションを記述します。あるセクションの書式を別のセクションにそのまま使うことはできません。

Homeでサブスクリプションを追加するのは、利用可能な接続項目を取得するためです。一方、Configで設定を選ぶと、通信をどのように処理するかが決まります。両者は関連しますが、同じ操作ではありません。利用中のプロバイダーとサブスクリプションがある場合は、プロバイダーからリンクを入手し、接続情報が提供されるのか、設定全体が提供されるのかを確認してください。URLの末尾だけで内容を判断しないでください。

[Rule]の振り分け動作を確認するには、Home → Global RoutingでConfigを選択します。ProxyとDirectは、このセクションのルールを検証するための同等の環境ではありません。Sceneを使っている場合は、そのシーンで適用される設定も確認してください。ファイルを保存しただけで現在のモードを確認しないと、「ルールを変更しても何も変わらない」と誤解しがちです。

2. General：全般設定を確認してからDNSを判断

[General]では、DNSなどの全般的な動作を設定します。読むときは、まず等号の左側にあるキーを確認し、次に右側の値を見ます。フィールド名・英語の句読点・真偽値はそのままにしてください。値の中に日本語の説明を加えたり、半角カンマを全角カンマに置き換えたりしないでください。

[General]
dns-server = system

ここでのdns-server = systemは、システムのDNSを使う設定です。すべての接続が直接通信するという意味でも、すべてのリクエストにプロキシを指定するという意味でもありません。DNSは「ホスト名をどう名前解決するか」、Ruleは「接続にどのポリシーを適用するか」を決めます。実際の名前解決先は、ルールのオプションやプロキシプロトコル、ほかのDNS設定にも左右されます。

「接続項目は使えるのに、ドメインにアクセスできない」場合は、まずログで名前解決に失敗しているのか、IPアドレスの取得後に接続が失敗しているのかを確認します。前者ならDNSを優先して調べます。後者の場合は、適用されたポリシー、接続先ポート、サーバーの状態も確認してください。HTTPSの標準ポートは443ですが、プロバイダーの接続ポートが443とは限りません。混同しないようにしましょう。

3. Rule：上から順に照合し、FINALは最後に置く

[Rule]のルールは上から順に照合され、最初に一致したルールのポリシーが適用されます。「より具体的な条件」を探して後続のルールと比較することはありません。そのため、例外ルールは広い条件のルールより前に置き、残りの通信を受けるFINALは最後に配置します。

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

ここに記載したドメインと192.0.2.0/24は説明用の例であり、接続先を示すものではありません。1行目は指定したホストを拒否し、2行目はexample.comとそのサブドメインへの接続を直接行います。ホスト単位の拒否ルールが先にあるため、blocked.example.comは後続のサフィックスルールで許可されません。

4. Host：名前解決を変更する。URLは変わらない

[Host]はローカルの名前解決に使います。次の例では、lab.example.comを文書用アドレス192.0.2.10に割り当てています。このアドレスはアクセス可能なテストサーバーではありません。実際に使う場合は、自分が管理でき、確実に到達できる宛先アドレスに置き換えてください。

[Host]
lab.example.com = 192.0.2.10

• プロトコルやパスは記述しない：左側に指定するのはホスト名です。https://lab.example.com/pathではありません。
• ポートをIPアドレスとして扱わない：右側のIPアドレスマッピングでは、接続先のポートは変更されません。
• Ruleの代わりにはならない：マッピング後の接続にも、現在のルーティングとポリシーが適用されます。
• 証明書の検証はなくならない：HTTPSでは、元のリクエストのホスト名に対応する証明書が引き続き検証されます。

ドメインを特定のサーバーに割り当てた後で証明書エラーが起きても、IPアドレスに到達できるだけでHostの設定が正しいとは限りません。そのサーバーが元のホスト名とTLSを正しく処理できる必要があります。アプリが独自に名前解決する場合や特定の接続方法を使う場合は、すべてのリクエストに同じローカルマッピングが適用されるとは限りません。実際の接続ログを確認してください。

5. URL Rewrite：リクエストURLを照合して指定のアクションを実行

[URL Rewrite]はURLの照合と書き換えを行うもので、「どの接続先にドメインを割り当てるか」を決める振り分け表ではありません。次の例では、HTTPからHTTPSへのリダイレクトを使って、正規表現・転送先URL・アクションコードの3要素を説明します。

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

^と$はそれぞれ照合の開始位置と終了位置を指定し、\.は文字としてのピリオドを表します。(.*)は後続の文字列をキャプチャし、転送先の$1は1つ目のキャプチャグループを参照します。302はリダイレクトのアクションです。ここで指定するアクションコードを、RuleのPROXYと混同しないでください。

トラブルシューティングでは、まず元のリクエストがHTTPか確認し、古いリダイレクトキャッシュも調べます。ブラウザーがHSTSによってHTTPSを直接使っている場合、HTTPルールが照合されないことがあります。処理対象が異なるため、Ruleの順番を変更しても解決しません。動作を確認できない書き換えルールは、いったん無効にして元のアクセス方法に戻してください。

6. 編集内容を反映する：保存・選択・接続の再確立

設定ファイルがConfigの一覧にあるだけでは、選択済みとは限りません。また、テキストを保存しても、既存の長時間接続が自動的に確立し直されるわけではありません。まず、現在動作している設定を複製してローカルにバックアップし、次の手順で一度に1項目ずつ検証してください。プラットフォームによってメニュー表示は異なる場合があるため、ここではHome、Config、Settingsの各画面の役割に沿って説明します。

1. 対象を確認：Configで現在選択されているファイルを探し、名前を控えてから編集画面を開きます。選択されていない別のファイルを誤って編集しないようにしてください。
2. 一度に1か所だけ変更：まずルールを1つ、またはキーと値の組み合わせを1つ変更します。セクション名と英語の句読点はそのままにしてください。FINALが重複していないか、ルールを誤ったセクションに記述していないかも確認します。
3. 保存して選択：編集内容を保存し、Configに戻って、そのファイルが現在の設定として選択されていることを確認します。構文エラーが表示された場合は修正し、有効な設定としてテストに進まないでください。
4. モードを確認：Home → Global Routingに戻り、Configを選択して、現在の接続項目が利用できることを確認します。
5. 新しい接続を確立：短時間の切断が許容できる場合は再接続し、テストするアプリからリクエストを再送します。接続が再利用されないよう、必要に応じて古いページを閉じるか、テストアプリを再起動してください。
6. 結果を確認：同じ宛先に再度アクセスし、適用されたルール、ポリシー、エラーの種類を確認します。「ページの表示が速くなった気がする」だけで設定の反映を判断しないでください。

リモート設定とローカル編集は分けて管理してください。リモートファイルを再ダウンロードすると、ローカルの変更が上書きされることがあります。また、Homeの接続サブスクリプションを更新しても、Configのルールが更新されるわけではありません。カスタムルールを継続して管理する場合は、独立したコピーを保存し、変更したフィールドと想定結果を記録してください。サブスクリプションの更新後は、設定ファイルが参照するポリシー名が引き続き存在することも確認します。

7. よくある質問：症状から確認する設定セクションを特定

.confを適切に管理するには、各セクションの役割を区別することが重要です。Generalは全般設定、Ruleはポリシー、Hostは名前のマッピング、URL Rewriteは条件に合致するリクエストURLを処理します。一度に変更する箇所を1つに絞り、元に戻せるコピーを保管すれば、設定変更と接続結果を対応づけて確認できます。