Shadowrocketのルールは「具体的な例外を先に、広い条件を後に、最後にFINAL」の順に並べ、Global RoutingでConfigを選んで確認します。既存のサービスやサブスクリプションがあり、設定ファイルを編集する方向けに、ルールの項目とポリシー、ドメイン・IPのマッチ結果を確認する方法を解説します。最後に、ルールにマッチしない場合、DNSの失敗、アウトバウンド接続の失敗を切り分けます。
1. まずConfigを有効にして、ルールの適用状況を確認
ルールを正しく書いても、使用中とは限りません。Configで選択中の設定ファイルを確認し、Homeに戻ってGlobal Routingを確認します。設定ファイルのルールで通信を振り分けるにはConfigを選びます。ProxyまたはDirectのままでは、アクセス結果から個々の設定ルールの正しさを判断できません。
- Proxy:すべての通信をプロキシ経由で処理します。Config内の個別ルールによる振り分けの確認には使いません。
- Direct:通信を直接接続で処理します。直接接続でアクセスできても、プロキシのポリシー設定が正しいとは限りません。
- Config:現在の設定ファイルに基づいて通信を振り分けます。この記事のテストではこのモードを使います。
- Scene:設定済みのシーン条件に従って動作します。問題を切り分ける際は、シーン切り替えによる変数を減らすため、まずConfigに固定してください。
Settings → On Demandでは、条件に応じた自動接続を設定します。ルールのマッチングを代替する機能ではありません。切断後に再接続される場合は、FINALを削除するのではなく、まずOn Demandの設定を確認してください。テスト中はネットワーク、設定ファイル、ルーティングモードを固定し、一度に変更する条件を1つにすると、問題を再現しやすくなります。
2. ルールの構文:マッチ条件と処理ポリシーを分けて確認
通常のルールは「タイプ、マッチ値、ポリシー」で構成され、各項目は半角カンマで区切ります。FINALにはマッチ値がなく、タイプとポリシーのみです。ルールは設定ファイルの[Rule]セクションに記述します。[General]やプロキシ項目のセクションには追加しないでください。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
| ポリシーの書き方 | 処理内容 | 確認事項 |
|---|---|---|
DIRECT | 対象に直接接続し、プロキシ経由のアウトバウンド接続は使いません。 | 現在のネットワークから対象に直接アクセスできるか。 |
REJECT | マッチした接続を拒否します。 | マッチ範囲が広すぎないか、ページ表示に必要なドメインまで誤って遮断しないか。 |
PROXY | PROXYという名前のポリシーに処理を委ねます。 | 同名のポリシーが存在するか、ポリシーグループで現在選択されているアウトバウンド接続が利用可能か。 |
ルール名とプロキシプロトコルは別の概念です。既存のアウトバウンド接続でShadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardのいずれを使っていても、DOMAIN-SUFFIXのマッチ条件は変わりません。プロトコルは接続を担い、ルールは接続をどのポリシーに渡すかを決めます。サブスクリプションの読み込み・更新も、「アウトバウンド一覧の更新」と「設定ルールの更新」を区別してください。
3. DOMAIN系ルール:完全一致、ドメインサフィックス、キーワード
ドメインルールにはhttps://、ページのパス、ポート番号を記述しません。たとえばhttps://api.example.com:8443/accountを対象にする場合、DOMAINのマッチ値はURL全体ではなくapi.example.comです。パスの/accountとポートの8443はドメイン項目に含まれません。
| ルール | マッチする対象 | マッチしない対象 |
|---|---|---|
DOMAIN,example.com,DIRECT | example.com | www.example.com |
DOMAIN-SUFFIX,example.com,DIRECT | example.com、api.example.com | notexample.com、example.com.other.test |
DOMAIN-KEYWORD,example,PROXY | example.com、myexample.net | ドメインにexampleを含まないリクエスト。ページのパスにその文字列が含まれていてもマッチしません。 |
DOMAIN-SUFFIXはドメインの階層に基づいてマッチし、任意の文字列の末尾を照合するものではありません。そのため、example.comはサブドメインにも適用されますが、notexample.comには適用されません。ログイン用のドメインだけをプロキシ経由にするならDOMAINを優先します。ドメイン全体とそのサブドメインに同じポリシーを適用する場合にDOMAIN-SUFFIXを使ってください。
[Rule]
DOMAIN,login.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
この順序では、ログイン用ドメインは最初のルールにマッチし、同じドメインのその他のサブドメインは2番目のルールにマッチします。サフィックスルールを先頭に置くと、ログイン用ドメインも先にDIRECTで処理されます。DOMAIN-KEYWORDは通常、マッチ範囲を制御しにくいため、追加前に同じ文字列を含む無関係なドメインを洗い出してください。一般的なキーワードをそのままREJECTに指定するのは避けましょう。
4. IP-CIDRとGEOIP:IPアドレスとネットワーク範囲でマッチ
IP-CIDRは、接続先のIPv4アドレスが指定したネットワーク範囲に含まれるかを判定します。192.168.0.0/16は192.168.0.0から192.168.255.255までを対象とし、192.168.1.10/32は単一のアドレスだけにマッチします。IPv6のネットワーク範囲には対応するIP-CIDR6ルールを使い、IPv4の例にそのまま記述しないでください。
[Rule]
IP-CIDR,192.168.1.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
- IP-CIDR:明確なLANアドレスや既知の接続先ネットワーク範囲に適しています。ネットワーク範囲は実際の環境に合わせて指定してください。例をすべてのLANに共通する一覧として扱わないでください。
- GEOIP:IPアドレスの位置情報データベースに基づいて地域を判定します。
GEOIP,CN,DIRECTは「中国語のサイトを直接接続する」という意味ではなく、ドメインのサフィックスで判定するものでもありません。 - no-resolve:このIPルールへのマッチ判定だけを目的としたドメインの能動的な名前解決を避けます。リクエストにドメイン名しかなく、利用可能な接続先IPがない場合、このルールはスキップされることがあります。
ドメイン名のリクエストをIPアドレス系ルールの判定対象にするには、通常、利用可能な接続先IPの情報が必要です。DNSに問題があると、その後のIP判定が想定どおりに行われない場合があります。マッチしない原因をすべてGEOIPデータの精度に帰結させないでください。同じドメインでもCDN、DNS応答、アドレスファミリーによって、実際の接続先IPが異なることがあります。
5. 上から順にマッチ:FINALは必ず最後に配置
通常のルールチェーンでは、リクエストは上から順に確認され、最初にマッチしたルールのポリシーが適用されます。その後の「より正確な」ルールは確認されません。具体的なルールが優先されるのは、手動で前に配置するためであり、アプリが精度に応じて自動で並べ替えるからではありません。
- 優先する具体的なドメイン、単一IP、明示的な拒否ルールを先に配置します。
- 続いて、ドメインサフィックス、範囲を確認したキーワード、接続先のネットワーク範囲を配置します。
- その後にGEOIPなど、適用範囲の広い条件を配置します。他のルールとの前後関係は、実際の要件に合わせて決めてください。
- 最後にFINALを1行置き、残りのリクエストの処理方法を指定します。
FINALはドメインやIPを追加で確認しません。そのため、FINAL,PROXYを先頭に置くと、後続の通常ルールはマッチする機会を失います。また、FINALは「エラー時に再試行する」ルールではありません。先行ルールにマッチした後、接続に失敗しても、自動的にFINALへ進んで別の経路を使うことはありません。
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
この例では、api.example.comはPROXY、www.example.comはDIRECTで処理され、trackingを含むその他のドメインはREJECTされます。ドメインルールに先にマッチしたリクエストは、接続先IPがGEOIPにも該当していても、別のポリシーに切り替わりません。最後まで他のルールにマッチしなかったリクエストだけがFINALに渡されます。
6. ルールが適用されない場合:設定、マッチ結果、アウトバウンド接続の順に確認
変更前に現在の設定ファイルのコピーを保存してください。変更後はConfigで選択中のファイルを確認し、Homeに戻ってGlobal RoutingがConfigになっていることを確かめてから、テスト接続を新たに確立します。既存の長時間接続は以前の接続状態を維持していることがあります。接続を維持したページを再読み込みするだけで、ルールが適用されていないと判断しないでください。
- ファイルを確認:同名のバックアップではなく、現在使用中の設定を編集したか確認します。リモート設定を更新した場合は、手動で加えた変更が残っているか再確認してください。
- 構文を確認:半角カンマ、ルールのセクション、ポリシー名を確認します。特にPROXYが現在の設定内に存在するか確認してください。
- 接続先を確認:リクエスト記録で実際のドメイン名またはIPアドレスを確認します。ページはログイン、画像、APIなど複数のドメインに同時にアクセスすることがあり、ブラウザーのアドレスバーに表示されるのはそのうちの1つだけです。
- マッチ結果を確認:記録されたポリシーとルール情報を照合し、前方にあるDOMAIN-SUFFIX、GEOIP、FINALが先にマッチしていないか確認します。
- アウトバウンド接続を確認:想定したポリシーにマッチしても失敗する場合は、DNS、接続先ポート、既存サービスの接続パラメーターを確認します。ドメインルールの範囲をむやみに広げないでください。
エラー:Connection refused
原因と対処:接続先または中間機器によって接続が明示的に拒否された可能性があります。ルールの構文エラーとは限りません。まず記録から実際に適用されたポリシーを確認し、次に接続先アドレス、待ち受けポート、既存のアウトバウンド設定を確認してください。LAN上のサービスでは、対象ポートのサービスが起動していることも確認します。
エラー:Connection timed out
原因と対処:制限時間内に接続できなかった状態です。ネットワーク経路、接続先への到達性、アウトバウンド接続の障害などが考えられます。まず適用されたポリシーを確認し、同じネットワークで既存サービスへの接続状況を調べてください。タイムアウトをDOMAIN-SUFFIXの記述ミスとすぐに決めつけないでください。
上記は接続層で発生する可能性のあるエラーメッセージで、失敗時に必ず表示されるものではありません。REJECTにマッチしてリクエストが遮断された場合は、まず意図した拒否かどうかを確認してください。誤って遮断している場合は、より範囲の狭い例外ルールを追加し、拒否ルールより前に配置します。すべての通信をDIRECTに変更するのは避けてください。
7. よくある質問と変更後の確認項目
DOMAIN-SUFFIXを追加したのに、特定のサブドメインがプロキシ経由になるのはなぜですか?
まずHomeでGlobal RoutingがConfigになっていることを確認し、次にConfigで使用中のファイルを確認します。その後、対象のサブドメインが前方のDOMAINルールや他のルールにマッチしていないか、記録された実際のリクエストドメインが指定したサフィックスに属しているかを確認してください。
FINALにはDIRECTとPROXYのどちらを指定すればよいですか?
分類されなかった通信をどこへ送るかによって異なります。残りの通信を既存のプロキシポリシーに渡す場合はFINAL,PROXY、直接接続する場合はFINAL,DIRECTを使います。前者ではPROXYが存在し、利用可能であることを確認してください。どちらもルールの末尾に配置します。
サブスクリプションを更新すると、手書きのルールは消えますか?
まず、何を更新するのかを区別してください。アウトバウンド接続のサブスクリプション更新と、リモート設定の更新は別の操作です。リモート設定全体を再取得すると、ローカルの変更が置き換えられることがあります。更新前にコピーを保存し、更新後はConfigでルールのセクションとポリシー名を確認してください。
同じドメインでも443番ポートだけをプロキシ経由にできますか?
DOMAINとDOMAIN-SUFFIXはポートを区別しません。ドメインの後ろに:443を付けるのは正しい書き方ではありません。この記事の例ではドメインまたはアドレスに基づいて通信を振り分けます。ポート条件が必要な場合は、対応するルールの機能と構文を別途確認してください。ドメイン項目を書き換えて実現することはできません。
- 使用する設定ファイルが選択され、Global RoutingがConfigに設定されている。
- ドメインルールにはスキーム、パス、ポートを含めず、項目は半角カンマで区切る。
- 具体的な例外を広いルールより前に置き、FINALを末尾に配置する。
- PROXYなどのポリシー名に対応する項目が現在の設定内に存在する。
- 接続を新たに確立した後、実際に適用されたポリシーが想定どおりである。
- 復元可能な設定ファイルのコピーを保存し、今回の変更内容とテスト対象を記録した。