Shadowrocketのルール構文入門:DOMAIN-SUFFIX・GEOIP・IP-CIDR・FINALのマッチ順序と使い方

DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINALのマッチ対象と適用順を、すぐ使えるルール例とともに解説します。

この記事の概要

この記事は、Shadowrocketに利用中のサービスをすでに追加しており、Configを編集する方向けです。まずGlobal Routingとルールのポリシーを確認し、ドメイン・IP・最終ルールの違いを把握してから、最小限のルールでマッチ結果を検証します。重要なのは、接続先のサイト名から経路を推測するのではなく、「リクエストがどの行の条件に一致し、その行でどのポリシーが指定されているか」を確認することです。

1. Global RoutingがConfigを使用しているか確認する

ルールが記述されていても、現在の接続で使われているとは限りません。Homeでは既存の接続やサブスクリプションを管理し、Configでは設定ファイル、Settingsではアプリの設定を管理します。確認を始める前に、HomeでGlobal Routingを開いてConfigが選択されていることを確認し、Configで有効なファイルを確認してください。以下ではiPhone/iPadの画面を例に説明します。

Global Routingの選択肢確認ポイント
Proxyグローバルプロキシとして通信を処理します。Config内の個別ルールによる振り分け結果の検証には使いません。
Directグローバル直結として通信を処理します。ルールを編集しても、Configに切り替えたことにはなりません。
Config現在の設定にあるルールに基づいて接続ポリシーを決定します。この記事のルール検証は、この状態が前提です。
Scene設定済みのSceneに応じてルーティング動作が切り替わります。問題を調べるときは、現在のSceneで実際に使われている設定を先に確認してください。

Settings → On Demandで制御するのは、条件に応じてVPN接続を確立するかどうかです。ドメインごとにDIRECTとPROXYを選ぶルールではありません。テスト時は、まず接続が確立していることを確認してからルールのマッチ結果を調べてください。そうしないと、「トンネルが未接続」であることを「FINALが機能していない」と誤認するおそれがあります。

リクエストがトンネルに入る 宛先情報を取得する ルールを順に確認する マッチしたポリシーを選択する 宛先への接続を確立する

2. ルールはタイプ・条件・ポリシーで構成される

一般的なルールでは、各項目を半角カンマで区切ります。通常は、ルールタイプ、マッチ条件、適用するポリシーの順です。ルールによっては追加パラメータも指定できます。FINALは例外で、個別のマッチ条件はなく、その後にポリシーを記述します。全角カンマは使わず、ブラウザーのアドレスバーに表示される完全なURLをドメイン条件としてそのまま指定しないでください。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

ここでいう[Rule]は、設定内のルールセクションです。すでに存在する場合は、同じ名前のセクションをファイル末尾に追加し続けるのではなく、既存のルールセクションにルールを追加してください。上記はルール部分のみの例で、設定全体に必要なほかの項目は含まず、プロキシ接続も自動では作成されません。

3. DOMAIN・DOMAIN-SUFFIX・DOMAIN-KEYWORDの違い

ドメインルールが確認するのは接続先のホスト名であり、URLのパスやクエリパラメーターではありません。たとえばhttps://api.example.com:443/v1/statusにアクセスする場合、ドメイン条件にはapi.example.comを指定し、https://、ポート443、/v1/statusは含めません。これら3種類のドメインルールでは、ポートはマッチ条件に使われません。

ルール例マッチ範囲範囲の例
DOMAIN,api.example.com,PROXYホスト名がapi.example.comと完全に一致する場合のみマッチします。www.example.comにもx.api.example.comにもマッチしません。
DOMAIN-SUFFIX,example.com,PROXYexample.com自体と、そのすべてのサブドメインにマッチします。api.example.comにはマッチしますが、notexample.comにはマッチしません。
DOMAIN-KEYWORD,example,PROXYホスト名にexampleという文字列が含まれるかを確認します。notexample.comにもマッチする可能性があり、サフィックスルールより範囲が広くなります。

「ベースドメインとすべてのサブドメイン」を対象にする場合は、通常DOMAIN-SUFFIXを使います。*.example.comと書く必要はありません。サブドメインの範囲を示すために、ここでアスタリスクを使う必要はありません。特定のAPIホストだけ例外にする場合は、DOMAINを先に記述し、対象範囲の広いDOMAIN-SUFFIXを後に記述してください。

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

この順序では、api.example.comは1行目にマッチしてPROXYを使います。www.example.comは1行目にマッチせず、2行目にマッチしてDIRECTを使います。2行目を先頭に移動すると、api.example.comも先にDIRECTにマッチするため、後続の完全一致ルールでポリシーを変更できません。

4. IP-CIDR・GEOIP・no-resolveの役割

IP-CIDRはIPアドレスが属するネットワーク範囲でマッチし、GEOIPはIPの地理情報データベース上の地域情報でマッチします。対象はIP情報であり、Webページの言語、アカウントの地域、ドメインの登録地ではありません。ドメインが複数のIPアドレスに解決されたり、複数地域にまたがるコンテンツ配信ノードを利用したりすることもあります。そのため、GEOIPの結果をそのままサイトの所在地域とみなすことはできません。

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

宛先がドメインで、判定に使えるIPアドレスがまだない場合、no-resolve付きのIPルールは、自身のマッチ判定のために追加の名前解決を要求しません。そのため、「ドメインが最終的にプライベートIPへ解決された」ことと、「no-resolve付きルールが必ず先にマッチする」ことは同じではありません。既知の内部ドメインを確実に処理するには、IPルールより前にDOMAINまたはDOMAIN-SUFFIXの条件を追加できます。

5. 上から順に最初のルールを適用し、FINALは末尾に置く

Configで通常のルールを処理する場合、記述順に確認し、最初にマッチしたルールでポリシーが決まります。「より精密なルールが自動的に優先される」と考えないでください。DOMAINはDOMAIN-SUFFIXより精密でも、前に書かれたサフィックスルールを飛び越えません。順序は設定を作成する人が明示的に決める必要があります。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

この例では、順に完全一致の例外、ドメイン範囲、明示的に拒否する宛先、LANアドレス、地域別IP、最後のフォールバックを指定しています。これは順序を示すための例であり、すべてのネットワークに推奨する設定ではありません。利用中のサービスやローカルリソースに別のポリシーが必要な場合は、独自の条件を残し、ルール同士の範囲の重なりを個別に確認してください。

テスト対象想定されるマッチ結果の説明
api.example.com1行目のDOMAINPROXY。後続のexample.comサフィックスルールは確認されません。
www.example.com2行目のDOMAIN-SUFFIXDIRECT。GEOIPの判定を待つ必要はありません。
blocked.example.net3行目のDOMAIN-SUFFIXREJECT。接続を拒否する動作はルールの意図どおりです。
192.168.1.204行目のIP-CIDRDIRECT。宛先IPが指定されたネットワーク範囲内にあります。
前のルールにマッチしなかった宛先FINALPROXY。前のルールに問題があったことを意味するものではありません。

FINALはルール一覧の末尾に置いてください。前に置くと、それ以降のルールが通常どおりマッチ判定に参加できません。既存の設定を編集する場合は、すでにあるFINALを探し、新しいルールをその前に挿入してください。ルールの種類ごとにFINALを追加する必要はありません。

6. 変更を最小限にしてルールの動作を確認する

DNS、接続パラメーター、ポリシーグループ、大量のルールを同時に変更すると、問題の原因を特定しにくくなります。まず現在の設定を複製してから、判別しやすいドメインルールを1つだけ追加してください。ルールが決めるのはアウトバウンドポリシーです。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardなどの接続パラメーターは既存サービスの設定で決まり、不足しているパラメーターをルール編集で補うことはできません。

  1. 現在の設定をバックアップする

    Configを開き、まず現在の設定ファイルを複製するか、バックアップを書き出してから、使用中のファイルを編集します。[Rule]だけのサンプルを完全な設定ファイルと誤認して、元のファイルに上書きしないでください。

  2. ルールを1つ追加する

    [Rule]内の既存のFINALより前に、対象のルールを追加します。たとえば特定のホストをテストする場合はDOMAINを使い、条件にはホスト名だけを指定します。前方に同じドメインを対象とするルールがないかも確認してください。

  3. 現在のルーティング設定を確認する

    保存後、Configでそのファイルが有効になっていることを確認し、Home → Global Routing → Configの順に開いてください。もともとSceneを使っていた場合は、Sceneによる自動切り替えの影響を解除してから、1回ずつ検証してください。

  4. 新しい接続を確立する

    対象のページやアプリを閉じてから再度アクセスし、必要であればVPNを切断して接続し直してください。既存の長時間接続では、接続開始時のポリシーが引き続き適用される場合があります。同じページを更新するだけでは、すべてのルールが再評価されたか判断できません。

  5. 接続ログを確認する

    接続ログで宛先ホスト、宛先IP、マッチしたルール、最終ポリシーを確認してください。まず想定したルールにマッチしたかを確かめ、その後、選択した接続で宛先にアクセスできるかを調べます。Webページが開くかどうかだけで判断しないでください。

HomeでSubscribeを更新すると、主に既存のサブスクリプションから提供される接続情報が更新されます。現在のConfigのルールが、編集した内容に自動で書き換わるわけではありません。一方、リモート設定を再ダウンロードすると、その設定ファイルの内容が置き換わることがあります。編集前に、対象がサブスクリプション、リモート設定、ローカル設定の複製のどれなのかを確認してください。

7. 接続エラーとルールの問題を切り分ける

以下は接続ログに表示されることがあるネットワークエラーの原文であり、ルールパーサーが常に出すメッセージではありません。まずログに記録された最終ポリシーを確認してください。REJECTにマッチした場合、プロキシサービスへの接続に失敗した場合、宛先サーバーに接続を拒否された場合では、それぞれ対処方法が異なります。エラーメッセージだけでは、DOMAIN-SUFFIXの書き方に問題があるとは判断できません。

エラー:Connection refused

原因と対処:接続先から拒否されました。該当アドレスのポートでサービスが待ち受けていない場合によく発生します。ログを見て、拒否されたのがプロキシサーバーか宛先サーバーかを確認し、利用中のサービスのアドレスとポートを見直してください。ドメインルールをGEOIPに変更しても、ポートの誤りは解消されません。

エラー:Operation timed out

原因と対処:制限時間内に接続が完了しませんでした。選択中のアウトバウンド、宛先サービス、現在のネットワークが原因となる場合があります。まずマッチしたポリシーを確認し、同じ宛先とネットワーク条件で、変更する項目を1つに絞ってテストしてください。ルール全体を一度に並べ替えないでください。

DOMAINを書いたのに、サブドメインに適用されないのはなぜですか?

DOMAINはホスト名が完全一致した場合のみマッチします。example.comとapi.example.comの両方を対象にするには、DOMAIN-SUFFIX,example.com,PROXYに変更してください。そのうえで、先にマッチするルールがないか確認します。

ルールを一番下に置いたのに、機能しないのはなぜですか?

現在使用中のConfigで[Rule]を開き、FINALを探します。判定に使いたいルールをFINALより前に移動し、さらに前にあるDOMAIN-SUFFIXまたはDOMAIN-KEYWORDが同じ対象に先に一致しないか確認してください。

Proxyに切り替えるとアクセスできるなら、ルールの書き方が間違っていますか?

わかるのは、2つのルーティング設定でアウトバウンドの結果が異なるということだけです。Home → Global Routing → Configに戻り、対象がDIRECTまたはREJECTにマッチしているか確認してください。意図しない条件にマッチしている場合は、その条件か順序を調整します。直結ルールをすべて削除する必要はありません。

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

まず、HomeのSubscribeとConfigの設定ファイルを区別します。Configに戻って、有効なファイルとその[Rule]の内容を確認してください。接続情報のサブスクリプションを更新してもルールファイルは更新されず、Global Routingが自動的にConfigへ切り替わることもありません。

Shadowrocketの入手方法と基本ガイド

iPhone/iPad版はApp Storeで2.99米ドルの買い切りです。開発元はShadow Launch Technology Limitedです。システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン/Intel)・Windows・Android・Linux版は無料です。ダウンロードページではプラットフォームごとの入手方法を案内し、基本ガイドでは利用中のサービスの追加方法と接続確認を説明します。

Shadowrocketを全プラットフォーム向けにダウンロード