この記事は、Homeで接続できる状態になり、Configで.confファイルを読んだり編集したりする方向けです。接続情報と設定ファイルを区別したうえで、General、Rule、Host、URL Rewriteの書式と適用条件を確認し、最後に一項目ずつ変更して問題を切り分けます。例では予約ドメインと文書用アドレスを使用しており、接続設定としては利用できません。
.conf・接続情報・Global Routingの違い
Shadowrocketの.confは、全体設定や振り分けルールなど、リクエスト処理の設定を記述するテキストファイルです。サーバーのサブスクリプションとは別のものです。Homeの接続情報はサーバーへの接続方法を指定し、Configで有効になっているファイルはトラフィックを処理する条件を指定します。利用中のサブスクリプションはご利用のサービス提供元から入手してください。当サイトではノードやサブスクリプションを提供・販売・推奨していません。
「ルールを変更したのに変化がない」場合は、まずHome → Global Routingを確認してください。Proxy、Direct、Config、Sceneはそれぞれ異なるルーティングモードです。この記事のRule例を検証するには、Configを選び、Configで有効になっているファイルが編集したファイルと同じであることを確認します。Proxyは個々の振り分けルールの検証には使えず、Directもプロキシのルールを確認するのに適した状態ではありません。Sceneを使う場合は、そのシーンで実際に適用される設定も確認してください。
設定ファイルを確認する手順は、次の5段階に分けられます。これは問題を切り分けるための順序であり、クライアント内部のすべての処理モジュールが常にこの順で動作するという意味ではありません。特に、URL RewriteとDNSやルール判定の関係を、すべてのリクエストに当てはまる単純な処理順として捉えないでください。
.confの基本構造:セクション名、イコール、半角区切り文字
セクション名は半角角括弧で囲み、たとえば[General]と記述します。GeneralとHostでは一般にキー = 値を使い、Ruleではルールの種類、マッチ対象、ポリシーを半角カンマで区切ります。URL Rewriteでは各ルール固有のスペース区切り形式を使います。あるセクションの書式を別のセクションにそのまま流用しないでください。
以下は構造を確認するための最小限の例です。example.comをPROXYに、それ以外のリクエストをDIRECTに振り分け、Hostに文書用アドレスのマッピングを追加しています。PROXYの利用には、使用可能な接続情報が別途必要です。192.0.2.10は文書用の予約アドレスであり、このマッピングを使って公開サイトにアクセスできるか確認することはできません。実際に使う前に、例として追加したHostの行を削除してください。
# Structure example; documentation addresses only.
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Host]
demo.example.com = 192.0.2.10
[URL Rewrite]
# Add rewrite rules only when needed.
- テキストエディターで
.confを保存してください。ファイル名が実際には.conf.txtになったり、リッチテキスト形式が混入したりしないようにします。 [ ]、=、,は半角のまま使用し、日本語の記号に置き換えないでください。セクション名URL Rewriteの間にはスペースが入ります。- コメントは独立した行に記述し、先頭に
#を付けることをおすすめします。どの項目の末尾にも説明文を追加できるとは限りません。 - 同じセクションにまとめて記述し、セクション名やキーの重複による管理上の混乱を避けてください。上書きの挙動が不明な場合は、内容を統合してからテストします。
General:全体設定であり、サーバー設定ではない
[General]では、DNS関連の設定など全体の動作を指定します。例のdns-server = systemは、システムのDNS設定を使用する指定です。プロキシサーバーを指定するものではなく、DNS問い合わせが特定のプロキシ接続を経由する保証もありません。実際の名前解決経路は、接続方式やその他のDNS設定、アプリ自身が名前解決を行うかどうかによっても異なります。
まずは内容を理解している少数の項目だけを設定し、問題の状況に応じて追加してください。内容を把握していないGeneralの設定をまとめて既存ファイルに上書きすると、名前解決、IPv6、トラフィックの除外動作が同時に変わり、もともとの問題を再現しにくくなることがあります。「全体設定」という名称だけを理由に、サーバーのパスワード、WireGuardの鍵、TLS関連の接続パラメーターをこのセクションに入力しないでください。
Generalの確認項目
- セクション名
[General]- 項目の形式
キー = 値- DNSの例
dns-server = system- 確認ポイント
- 項目名のスペル、重複キー、既存のDNS設定
全体設定は一度に一項目だけ変更し、変更前の値を記録してください。
Ruleの確認項目
- セクション名
[Rule]- ドメインルール
DOMAIN-SUFFIX,example.com,PROXY- フォールバックルール
FINAL,DIRECT- 確認ポイント
- 上から順に判定し、最後にポリシーを指定
ルールの種類がマッチ条件を決め、末尾のポリシーが処理方法を決めます。
接続の開始条件とリクエストの振り分けも区別してください。Settings → On Demandではオンデマンド接続の条件を設定します。これはGeneralの振り分けルールとは別のものです。「手動で切断したのに再接続する」場合は、FINALを何度も変更するのではなく、On Demandの条件とシステムのVPN状態を確認してください。
Rule:上から順に判定し、FINALは最後に配置
[Rule]は最もよく編集するセクションです。ルールは上から順に判定され、一致すると対応するポリシーが適用されます。「より具体的な」ルールを探して判定を続けることはありません。そのため、具体的なドメインや明確なアドレスを指定するルールは、範囲の広いルールより前に置きます。フォールバックとなるFINALは末尾に配置してください。
| キーワード | 例 | 一致条件 |
|---|---|---|
DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,PROXY | example.comとそのサブドメインに一致します。この文字列を含む任意のドメインに一致するわけではありません。 |
IP-CIDR | IP-CIDR,192.0.2.0/24,DIRECT,no-resolve | 指定したIPv4ネットワークに一致します。no-resolveは、このルールの判定時にドメイン名の解決を積極的に行わない指定です。 |
GEOIP | GEOIP,CN,DIRECT | Webページの言語やドメイン名の文字列ではなく、IPアドレスのデータベースに基づいて接続先の地域を判定します。 |
FINAL | FINAL,PROXY | それ以前のルールに一致しない場合、PROXYポリシーを適用します。 |
たとえば、次の例では特定のドメインをアドレスルールや地域ルールより前に置いています。DIRECTは直接接続、PROXYは対応するプロキシ選択を表します。これらはShadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardなどのプロトコル名ではありません。プロトコル名を汎用ポリシーとしてそのまま記述しないでください。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
no-resolveは「すべてのDNSを無効にする」という意味ではありません。関連するIPルールの判定時に、ドメイン名を積極的に名前解決するかどうかを指定するものです。リクエストがもともとIPアドレス宛ての場合や、接続先アドレスがすでに分かっている場合は、アドレスルールに一致することがあります。逆に、クライアントが接続先のIPアドレスしか認識していない場合、ブラウザーのアドレスバーに表示された文字列をもとに、すべてのDOMAIN-SUFFIXルールが一致するとは限りません。
- まずConfigで有効なファイルを確認し、次にHome → Global RoutingでConfigを選択してください。
- 検証する具体的な条件を範囲の広い条件より前に置き、FINALは1つだけ末尾に配置してください。
- 対象のリクエストをもう一度実行し、リクエストログで接続先、マッチしたルール、実際に適用されたポリシーを確認してください。接続スイッチがオンかどうかだけで判断しないでください。
- ドメインルールに一致しない場合は、リダイレクト後のドメインも含め、実際のリクエスト先ドメインを確認してから、ルールの順序と名前解決情報を調べてください。
Host:ローカルの名前解決マッピングとリクエストの書き換えは別
[Host]では、指定したホスト名を特定のIPアドレスにマッピングできます。一般的な書式は左側にドメイン名、右側にアドレスを記述する形式です。例:demo.example.com = 192.0.2.10。ここにhttps://、URLのパス、:443は記述しないでください。ホスト名とアドレスの対応を指定するものであり、完全なアクセスURLではありません。
[Host]
demo.example.com = 192.0.2.10
api.example.com = 198.51.100.20
上記の2つのアドレスはいずれも説明用です。実際の設定には、利用する権限があり、対象のサービスを実際に提供しているアドレスを入力してください。Hostはブラウザーのアドレスバーに表示されたドメインをIPアドレスに置き換えるものではなく、HTTP HostやTLS SNIを自動で変更するものでもありません。マッピング先のサーバーに対象ドメイン用の証明書がない場合、HTTPSで証明書エラーが発生することがあります。
- アドレスとポートは別:HTTPSの一般的なポートは
443、HTTPは80ですが、Hostマッピング自体にポートを変更する機能はありません。 - マッピングとルーティングは別:Hostは名前解決の結果を決め、Ruleは接続ポリシーを決めます。マッピングを追加してもDIRECTが指定されるわけではありません。
- キャッシュと新しい接続は別:変更後はリクエストを再実行してください。必要に応じて対象アプリを終了してから再度開き、既存の接続が以前のアドレスを使い続けないようにします。
- 名前解決の経路は別:アプリが暗号化DNSや固定IPを独自に使う場合、ここで設定したローカルマッピングが使われないことがあります。画面に変化がないという理由だけで、書式の誤りと判断しないでください。
URL Rewrite:URLに一致した後で書き換えを実行
[URL Rewrite]が処理するのはリクエストURLであり、ドメイン名とIPアドレスのマッピングではありません。次の例では正規表現でHTTPアドレスに一致させ、/old/で始まるパスを/new/にリダイレクトします。各行はマッチ式、転送先、302の順で記述し、項目をスペースで区切ります。
[URL Rewrite]
^http://example\.com/old/(.*)$ http://example.com/new/$1 302
式の中で^は先頭、$は末尾を表し、\.はドメイン内のピリオドを文字として扱います。(.*)は後続の内容をキャプチャし、転送先の$1は最初のキャプチャ結果を参照します。このルールでは、http://example.com/old/helpの転送先はhttp://example.com/new/helpになります。これは書式を説明するための例であり、例示したサイトに該当ページがあることを示すものではありません。
リダイレクトは後続のリクエスト動作にも影響する場合があります。ログイン、決済、アップロード、APIリクエストでは、302がすべてのリクエストメソッドに対して透過的に置き換わるわけではありません。まず管理下にあるテスト用アドレスで、マッチ範囲、転送先URL、クエリパラメーター、リクエストメソッドを確認してから、実際の用途で使うか検討してください。
- ドメイン内のピリオドをエスケープし忘れないでください。正規表現のピリオドは、任意の1文字に一致します。
- ホスト名を限定せずに汎用的なパスだけを指定すると、他のドメインにも影響するため避けてください。
- 転送先が同じルールに再び一致しないようにしてください。リダイレクトループを防ぐためです。
- Ruleの
DOMAIN-SUFFIX構文をURL Rewriteに記述しないでください。また、パスの書き換えをHostマッピングで代用しないでください。
Configで安全に編集:バックアップ・有効化・再テスト
リモート設定、接続用サブスクリプション、ローカルコピーは分けて管理してください。接続用サブスクリプションを更新すると、通常はHomeの接続情報が更新されます。一方、リモートの.confを更新すると、設定ファイルの内容が置き換わることがあります。リモートファイルに手動で追加したルールが、次回更新後も自動で残るとは限りません。
- 変更前の状態を保存:Configで現在有効なファイルを見つけ、完全なコピーを保存してから、現在のGlobal Routingモードも記録します。バックアップには機密情報が含まれる場合があるため、公開しないでください。
- 編集するセクションを特定:そのファイルの編集画面からテキストを開き、General、Rule、Host、URL Rewriteのうち、正しいセクションを変更していることを確認します。
- 一項目ずつ変更:一度に追加するルールは1つ、変更するキーも1つにします。まず狭いマッチ範囲で検証し、DNS、ルーティング、書き換えを同時に変更しないでください。
- 保存して有効化:Configに戻り、対象ファイルが選択されていることを確認します。画面に再読み込みや再接続の案内が表示された場合は、その指示に従い、HomeでGlobal Routingも確認してください。
- 再テストして元に戻す:対象のリクエストを新たに実行し、マッチしたルール、エラーの種類、接続先を記録します。問題が起きた場合はバックアップファイルに切り替え、同じリクエストを再テストしてください。
テスト記録には、「接続先はapi.example.com、想定した一致条件はDOMAIN-SUFFIX、実際はFINALが適用された」のように具体的な事実を書き、「ネットワークが使えない」だけで済ませないでください。すべての接続先に接続できない場合は、まずHomeで選択中の接続先とサービス提供元の情報を確認します。特定の種類のドメインだけに問題がある場合は、Rule、DNS、Hostを確認します。特定のパスだけがリダイレクトされる場合は、まずURL Rewriteを確認してください。
よくある質問:ファイルを保存できても、結果が期待どおりにならないのはなぜ?
Ruleを変更したのに、すべて同じポリシーで処理されるのはなぜですか?
まずHome → Global RoutingでConfigが選択されているか確認し、次にConfigで対象ファイルが有効になっていることを確認してください。その後、Ruleの早い位置にFINALがないか、より範囲の広いルールが対象ルールより前にないかを調べます。ファイルを保存しただけでは、そのファイルが適用されたことにはなりません。
Hostにアドレスを設定したのに、HTTPSで証明書の不一致が表示されるのはなぜですか?
マッピング先のサーバーが元のドメインに対する有効な証明書を提供しているか確認してください。HostはTLS検証に使うドメインを変更せず、サーバー証明書を設定する機能もありません。そのマッピングをいったん削除して接続を再試行し、問題が解消するか確認してください。
URL Rewriteが反応しません。プロキシルールを追加する必要がありますか?
実際のURLのプロトコル、ホスト名、パス、クエリパラメーターが式に一致するか確認してください。HTTPSのパスは暗号化された内容の可視性やMITMの条件にも左右されます。PROXYルールを追加しても、これらの条件を代替できません。まず管理下のHTTPテスト用アドレスで式を検証してください。
更新後にカスタムルールが消えたのはなぜですか?
まず、更新したのがHomeの接続用サブスクリプションか、Configのリモートファイルかを確認してください。リモート設定全体が置き換えられた場合は、バックアップからローカルコピーを復元し、必要な変更を再適用します。次回の更新前には差分を比較し、検証済みのローカルファイルをそのまま上書きしないでください。
.confを読むうえで重要なのは、各セクションの役割を区別することです。Generalは全体の動作、Ruleは順番に基づくポリシー選択、Hostはローカルマッピング、URL Rewriteは条件に一致したURLの処理を担当します。変更を一つのセクション、一つの項目、一つのリクエストに絞れば、設定全体を何度も読み込んで試行錯誤するのではなく、どの設定が結果に影響したのか判断できます。
Shadowrocketのダウンロード・設定ガイド
iPhone / iPad版はApp Storeから入手でき、価格は2.99米ドルの買い切りです。Mac(Appleシリコン/Intel)、Windows、Android、Linux版は無料です。iPhone / iPadのシステム要件はApp Storeの掲載内容をご確認ください。アプリの入手と接続サービスは別です。サブスクリプションはご利用のサービス提供元から入手してください。