この記事の概要

この記事は、Shadowrocketに自分で用意したサービス情報を追加し、ルールによる通信の振り分けを設定する方向けです。まず現在の設定ファイルとGlobal Routingを確認し、ドメイン条件、IP条件、最終的なフォールバック条件を区別しましょう。読み終えると、各ルールがどのリクエストに適用されるか、どこに記述すべきか、変更後にどの接続記録を確認すべきかが分かります。

1. 入手方法とルールの設定場所を確認する

まだインストールしていない場合は、全プラットフォームのダウンロードページでお使いのデバイスを選択してください。iPhone / iPad版はApp Storeから入手でき、価格は$2.99の買い切りです。開発元はShadow Launch Technology Limitedです。システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン / Intel)、Windows、Android、Linux版は無料です。この記事ではクライアントのルール設定のみを解説します。ノードやサブスクリプションの提供・販売・推奨は行っていません。以下の手順は、利用するサービスやサブスクリプションをすでにお持ちであることを前提としています。

ルールによる通信の振り分けは、設定ファイルの[Rule]セクションで行います。Homeで選択する接続は利用可能なプロキシ出口を指定し、Configで有効にする設定ファイルは振り分け条件を定義します。この2つは別々の選択項目です。サービス情報を追加しただけでは、ルール設定が有効になったことにも、現在のリクエストが必ずプロキシ経由になることにもなりません。

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

    Configを開き、現在有効な設定ファイルを確認して、まず複製を保存します。以降は複製したファイルの[Rule]だけを編集し、接続パラメータやほかの設定セクションはそのまま残します。問題があれば元に戻せます。

  2. プロキシ出口を確認する

    Homeに戻り、自分のサービス情報が追加済みで、必要なプロキシ出口を利用できることを確認します。ルール内のPROXYは処理方法を指定するもので、サービスのアドレス、ポート、認証情報を自動で作成するものではありません。

  3. 振り分け方法を選ぶ

    Home → Global Routing → Configで、設定ファイルに従って処理する方法を選択します。ProxyまたはDirectが選択されている場合は、アクセス結果だけで[Rule]の個々の行が適用されたかどうかを判断できません。

  4. 編集して動作を確認する

    Configに戻り、設定ファイルの編集画面を開いてルールを変更・保存します。有効になっている設定ファイルが同じであることを確認してください。その後、新しいリクエストを発生させ、接続記録で接続先、適用されたルール、処理方法を確認します。

2. ルールの書式:条件を先に、処理方法を後に記述

一般的なルールでは、項目を半角カンマで区切ります。条件を指定するルールの多くは種類,マッチする値,処理方法の形式です。FINALにはマッチする値がなく、処理方法を直接指定します。ドメインの値にhttps://、ページのパス、クエリパラメータ、ポート番号は含めません。たとえばhttps://example.com:8443/docsへのアクセスでも、ドメイン条件に指定するのはURL全体ではなくexample.comです。

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

上記は6種類の書式を示す例で、すべてをそのまま実際の設定に貼り付けることはおすすめしません。同じリクエストが複数の条件に一致する場合があり、先に記述したルールが後続のルールより優先されます。192.0.2.0/24は文書用の例示ネットワークであり、利用可能なサービスアドレスではありません。example.comとそのサブドメインも、構文の説明にのみ使用しています。

6種類
この記事で解説する主なマッチキーワード
3種類
処理方法の例:PROXY / DIRECT / REJECT
最終行
FINALは、それ以前のルールに一致しなかったリクエストを処理

判定の流れ:一致したルールを確認してから出口を確認

ルール変更後は、新しいリクエストがどの行に一致したかをまず確認します。処理方法が正しい場合は、その処理方法に対応する接続が利用可能かを確認してください。ウェブページが開くかどうかだけで、ルールの適用を判断しないでください。

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

この3種類は、マッチ対象となるドメイン名をもとに判定しますが、適用範囲は異なります。DOMAINは完全一致、DOMAIN-SUFFIXは指定したドメインとそのサブドメインに一致します。DOMAIN-KEYWORDはドメイン内の文字列で判定し、ドメイン階層を境界としません。条件を限定したい場合は、範囲が明確な記述を優先しましょう。

同じドメインの例で見る3種類のマッチ範囲
ルール例マッチする対象適用範囲
DOMAIN,example.com,PROXY example.com api.example.comは含まれないため、別途ルールが必要です。
DOMAIN-SUFFIX,example.com,DIRECT example.com、api.example.com、img.api.example.com ドメインの境界に沿って判定します。任意の文字列の末尾を比較するものではありません。
DOMAIN-KEYWORD,api,REJECT api.example.com、myapi.example.com ドメイン内のどこかにキーワードが含まれていれば一致するため、無関係なリクエストにも適用される可能性があります。

特定のAPIドメインだけをプロキシ経由にする場合は、キーワードルールよりDOMAIN,api.example.com,PROXYのほうが確認しやすくなります。同じドメインのすべてのサブドメインを直接接続する場合は、DOMAIN-SUFFIX,example.com,DIRECTを使用できます。キーワードルールは、異なるドメイン階層にまたがる同一文字列をマッチさせる必要がある場合に適しています。短い語に一致しただけで、サービスの提供元を判断しないでください。

4. GEOIPとIP-CIDR:接続先のIPアドレスで判定

GEOIP,CN,DIRECTは、接続先IPの地域データベース上の判定結果に基づいてマッチさせるルールです。ここでのCNは地域コードです。ウェブページの内容、ドメインの末尾、アカウントの地域、現在のデバイスの所在地を判定するものではありません。CDN、DNSの応答結果、データベースの違いによって、同じドメインでもIPの判定結果が変わる場合があります。

IP-CIDRは、指定したIPv4アドレス範囲にマッチします。192.0.2.0/24はネットワークプレフィックスが先頭24ビットで、192.0.2.0から192.0.2.255までのアドレス範囲を対象とします。IPv4アドレスを1つだけ指定する場合は/32を使えます。マスクの数値が大きいほど、一般にマッチ範囲は狭くなります。名前解決で一度得たIPアドレスを、ウェブサイトのすべてのアドレスとして固定的に扱わないでください。

IP-CIDR,192.0.2.8/32,DIRECT,no-resolve
IP-CIDR,192.0.2.0/24,PROXY,no-resolve
GEOIP,CN,DIRECT

この独立した例では、接続先が192.0.2.8なら単一IPアドレスのルールに先に一致し、192.0.2.20なら下のネットワーク範囲ルールに一致します。/24を先頭に置くと、単一IPの例外ルールは適用されません。no-resolveを使うかどうかは振り分けの設計に応じて決めてください。一般的な高速化スイッチとして使うものではありません。

5. FINALとルールの順序:例外、範囲指定、最後にフォールバック

ルールは通常、上から順に判定され、最初に一致したルールの処理方法が適用されます。すべての一致結果を集めてから「最も具体的な」ルールを選ぶわけではありません。そのため「具体的なルールを優先する」とは、記述順を工夫するという意味であり、システムが自動で並べ替えるという意味ではありません。FINALは前のルールに一致しなかったリクエストを処理するため、ルール一覧の最後に置きます。

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

この例では「個別ドメインの例外 → ドメイン範囲 → IP条件 → フォールバック」の順に整理しています。あらゆる環境で必須となる固定テンプレートではありません。実際に使う前に、地域による直接接続が本当に必要か、どのルールにも一致しない通信をPROXYに渡してよいかを確認してください。既存の設定でポリシーグループ名を使っている場合は、その名前を維持し、グループの定義を確認してください。存在しない名前に置き換えないでください。

  1. blocked.example.comは1行目のREJECTに一致して拒否されるため、後続のドメインサフィックスルールは判定されません。
  2. api.example.comは2行目でPROXYに渡されます。example.comのサブドメインであっても、後続ルールによって直接接続に変更されることはありません。
  3. www.example.comは3行目に一致し、DIRECTによって現在のネットワークから直接接続されます。
  4. ドメイン条件やIP条件に一致しないその他のリクエストは、最終的にFINAL,PROXYで処理されます。

DIRECTを選んでも、必ず接続できるわけではありません。選択中のプロキシ出口を使わないという意味です。PROXYを選んでも、接続先に必ず到達できるわけではありません。現在のプロキシと接続先のサービスに依存します。REJECTは一致したリクエストを明示的に拒否します。ブラウザーで接続エラーが表示された場合は、すぐにプロトコルの設定を変更せず、まずルールの想定どおりの動作か確認してください。

6. ルールが想定どおりに適用されないときの確認順

動作確認では、一度に変更する条件を1つにして、新しい接続を開始してください。ブラウザーの既存の長時間接続は、接続開始時の経路を引き続き使用することがあります。ルールを保存したあと画面を更新するだけでは、新しい接続として判定されるとは限りません。テスト対象、現在のGlobal Routing、有効な設定ファイル、一致した行、最終的な処理方法を記録しておくと、構文の問題と接続の問題を切り分けやすくなります。

DOMAINを設定したのに、なぜサブドメインがプロキシ経由にならない?

リクエスト先がapi.example.comで、ルールにはexample.comだけを指定していないか確認してください。ドメインとそのサブドメイン全体が必要な場合はDOMAIN-SUFFIXを使います。特定のサブドメインだけが必要な場合は、該当するDOMAINルールを追加し、広い範囲のルールより前に記述してください。

ルールを追加したのに、なぜすべてのリクエストが直接接続になる?

まずHome → Global Routingを開き、DirectではなくConfigが選択されていることを確認します。次にConfigで、実際に有効なファイルを確認してください。有効になっていない複製を編集しても、現在の接続の振り分けは変わりません。

サブスクリプションを更新したら、ローカルルールが元に戻ったのはなぜ?

まず、Homeで行うサービスのサブスクリプション更新と、Configで行うリモート設定ファイルの更新を区別してください。前者は主にサービス項目を更新しますが、後者は設定内容を置き換える場合があります。ローカルルールを長期間保持するには、独立した複製を保存し、更新前後の[Rule]を比較してください。唯一の設定ファイルを直接、繰り返し編集するのは避けましょう。

On Demandを有効にすれば、ルールが自動的に使われる?

Settings → On Demandでは、条件に応じて接続を開始する動作を設定します。Global Routingの振り分け設定に代わるものではありません。接続が開始された後も、現在のモードと設定ファイルを確認してください。「接続済み」であることだけでは、特定のルールに従って処理されたとは限りません。

接続記録に想定したルールが表示されたら、次にトランスポート層を確認します。以下は接続診断に表示されることがあるエラーの原文であり、[Rule]の構文エラーを示す固定メッセージではありません。システムによって表示内容が異なる場合があるため、直接接続先とプロキシ出口のどちらでエラーが起きたかを踏まえて判断してください。

エラー:Connection refused

原因:接続先のホストまたは中間の機器によって明示的に拒否されています。ポートでサービスが待ち受けていない可能性があります。対処:まず適用された処理方法を確認し、自分のサービスのアドレス、ポート、稼働状態を確認してください。DIRECTに一致している場合は、プロキシの設定だけでなく直接接続先も確認します。

エラー:Operation timed out

原因:接続または読み書きが、制限時間内に完了しませんでした。このメッセージだけでは、ルール、DNS、ネットワーク経路のどれが原因か特定できません。対処:接続先と適用された処理方法を記録し、ドメインの名前解決と選択した出口をそれぞれ確認してから、サービスポートを確認してください。複数のルールやプロトコル設定を同時に変更しないでください。

7. 設定を保存する前の最低限のチェックリスト

ルールファイルは、数を増やせば管理しやすくなるわけではありません。重複するサフィックス、短すぎるキーワード、早すぎるフォールバックルールは、後から例外を確認しにくくします。変更後は少なくとも「ドメインを限定した例外」「同じサフィックスを持つ別のサブドメイン」「どのルールにも一致しないドメイン」の3種類を選び、処理方法を確認してください。IPルールを含む場合は、接続先アドレスと名前解決の結果も個別に確認します。

ルールは3つのグループに分けて覚えると便利です。DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORDは「ドメインが条件に一致するか」を判定します。GEOIP、IP-CIDRは「接続先IPが条件に一致するか」を判定します。FINALは「その他のリクエストをどう処理するか」を指定します。この3つの役割と上から順に判定する仕組みを理解してから複雑なルールを追加すると、問題発生時に該当する行を特定しやすくなります。