この記事は、利用できるサービス情報をすでに持ち、Shadowrocketの設定ファイルを読んだり編集したりする方を対象としています。まず4つの設定セクションを見分け、確認可能なルールやマッピング例で照合の仕組みを理解します。最後に、バックアップ、編集、有効化、検証の順で作業します。例は構文の説明用で、既存設定をそのまま置き換えるための完全な設定ではありません。
まず利用プラットフォームを確認し、サービス情報と設定ファイルを区別する
Shadowrocketの入手先は全プラットフォームのダウンロードページで確認できます。iPhone / iPad版はApp Storeで2.99米ドルの買い切りです。開発元はShadow Launch Technology Limitedで、システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン / Intel)、Windows、Android、Linux版は無料です。以下ではHome、Config、Settingsなどの画面表示を使って操作箇所を説明します。具体的な配置は各プラットフォームの画面でご確認ください。
サービス情報は「どのサーバーに接続するか、どのプロトコルや認証パラメータを使うか」を定め、設定ファイルは「通信をどのように処理するか」を定めます。利用中のサブスクリプションに含まれるサーバー項目と、Configで有効にする.confは別のものです。サブスクリプションを更新しても設定が切り替わるわけではなく、設定を選択しても利用可能なサーバーが追加されるわけではありません。この記事は、利用者が自身のサービス事業者とサブスクリプションを用意していることを前提とし、ノードやサブスクリプションの提供・販売・推奨は行いません。
.confの基本構造:セクション名、キーと値、ルール行
.confはテキスト形式の設定ファイルです。角括弧内の名前がセクションを示し、次のセクション名が現れるまでの行がそのセクションに属します。セクションごとに構文は異なります。[General]と[Host]ではキーと値の形式が一般的で、[Rule]ではカンマ区切りの項目を使い、[URL Rewrite]では照合式、転送先、アクションを記述します。あるセクションの記述を別のセクションへそのまま移すことはできません。
[General]
dns-server = system
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
[Host]
example.com = 192.0.2.10
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
ファイルを読むときは、まずセクション名を探し、次に各行の区切り文字を確認します。ルール内のカンマは半角の英語カンマを使い、正規表現のバックスラッシュがエディターで置き換えられないよう注意してください。問題の切り分け中は、変更理由を独立したコメント行に記録するのが安全です。行末に自由にコメントを追加できるとは限りません。また、拡張子が同じでも、別形式の設定をそのまま読み込めるとは限りません。
[General]:全般設定とサイトごとの振り分けは別
[General]には、DNS解決に関する設定など、全体の動作に影響する項目を記述します。例のdns-server = systemは、システムDNSを使うよう指定する設定です。アプリの現在の既定動作を示すものではなく、あらゆるネットワーク環境に適するとも限りません。システムのネットワーク自体で名前解決できない場合、システムDNSを選ぶだけでは上流の障害は解消しません。
- まず問題の箇所を切り分ける:ドメイン名からアドレスを取得できない場合はDNSを確認します。アドレスを取得できても接続がタイムアウトする場合は、ルーティング、サーバーポート、通信条件を確認してください。
- 関係する項目だけ変更する:特定のドメインが誤ったポリシーに振り分けられる問題を解決する際、DNS、IPv6、複数のルールを同時に変更しないでください。どの変更が影響したのか特定しにくくなります。
- 有効な設定を確認する:Configで保存したテキストが、現在有効になっている設定であることを確認してください。同じ名前の別ファイルを編集しても、使用中の設定は自動で変わりません。
- 値を推測しない:見慣れないキーがあれば、まず設定項目の詳細で用途と適用条件を確認してください。キー名から真偽値を推測したり、別形式の設定をそのまま流用したりしないでください。
Settingsの動作オプションも個別に確認が必要です。たとえばSettings → On Demandは条件に応じて接続を開始する機能であり、example.comがどのRuleに一致するかを定義するものではありません。手動で切断した後に接続が再確立される場合は、まずOn Demandの有効状態と条件を確認し、Ruleセクションを削除しないでください。
[Rule]:上から順に照合し、該当するポリシーを適用
[Rule]の基本は「照合条件 + 処理先」です。通常のルールは上から順に評価され、一致すると対応する処理先が適用されます。そのため、より具体的な例外は、広範囲に一致するルールより前に記述するのが一般的です。DIRECTは直接接続、REJECTは拒否、PROXYはプロキシポリシーを表します。独自のポリシー名を使う場合は、現在の設定内に該当する定義があることを確認してください。任意の名前を指定することはできません。
| キーワード | 例 | 照合内容 |
|---|---|---|
DOMAIN | DOMAIN,example.com,DIRECT | ドメインがexample.comと完全一致する場合に照合します。サブドメインは含みません。 |
DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,PROXY | example.comとそのサブドメインに一致します。任意の文字列の末尾一致ではありません。 |
DOMAIN-KEYWORD | DOMAIN-KEYWORD,example,REJECT | ドメイン名にexampleを含むリクエストに一致します。想定より広い範囲が対象になる場合があります。 |
IP-CIDR | IP-CIDR,192.0.2.0/24,DIRECT | 接続先のIPv4アドレスのネットワーク範囲で照合します。ここでは文書用の例示ネットワークを使用しています。 |
GEOIP | GEOIP,CN,DIRECT | IP位置情報データベースで識別された地域を基準に照合します。Webページの内容には依存しません。 |
FINAL | FINAL,PROXY | それまでのルールに一致しなかった通信を処理します。通常はルールの末尾に置きます。 |
たとえば、example.comは直接接続し、その他のサブドメインはプロキシを使う場合、まずDOMAIN,example.com,DIRECTを記述し、その後にDOMAIN-SUFFIX,example.com,PROXYを記述します。順序を逆にすると、ルートドメインが先にサフィックスルールに一致し、後続の完全一致ルールでは処理できません。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,PROXY
ドメインルールとIPルールでは、照合の基準が異なります。IPルールは名前解決に関係する場合があり、具体的な動作は関連オプションにも左右されます。「IPアドレスがある地域に分類される」ことを「ドメインがその地域に登録されている」ことと混同しないでください。また、検証対象のルールより前にFINALを置かないでください。効果を判断する際は、Webページが開くかどうかだけで推測せず、実際の照合情報を確認してください。
Global Routing:Configによる振り分けが有効か確認
ファイルの構文が正しいのにルールが期待どおり動作しない場合は、まずHome → Global Routingで現在のモードを確認してください。Configを選択すると、その設定内のRuleによる振り分けを検証できます。ProxyとDirectは通信全体の処理方法を切り替えるもので、個々のルールのテストには代用できません。
Config
推奨現在有効な設定のルールに従って通信を振り分けます。一致したルールの処理先は、PROXY、DIRECT、REJECT、または定義済みポリシーです。
用途:この記事のRule例とルールの順序を検証する。
Proxy
通信をプロキシ経由で処理します。同じドメインルールに基づいてプロキシと直接接続を選ぶ方式ではありません。利用可能なプロキシ接続が必要です。
用途:Configの振り分けが問題に関係しているか比較して確認する。
Direct
通信を直接接続で処理します。直接接続でWebサイトが開いても、プロキシ設定が正しいことやRuleに一致したことの証明にはなりません。
用途:ローカルネットワークから接続先へ直接アクセスした場合の状態を確認する。
Scene
シーンの条件に応じて設定を適用します。結果を判断する前に、現在適用されているシーンとその設定を確認してください。編集したファイルだけを見て判断することはできません。
用途:シーンの条件をすでに設定しており、環境に応じて切り替えて使う。
[Host]:名前解決先を指定する設定。ポートや認証は扱わない
[Host]はローカルのドメイン名マッピングに使います。example.com = 192.0.2.10は、その名前を指定したアドレスに対応づける記述です。Webサイトをプロキシ経由にする設定でも、サーバーポートを変更する設定でもありません。ここでの例示アドレスは実際のサービスには使えません。実際にマッピングする場合は、利用権限のあるサービスまたは管理対象ネットワークから提供された情報を使用してください。
HostマッピングとRuleによる振り分けを区別する
Hostは名前とアドレスを扱う
- ドメイン名に対応するアドレスを指定します。
- マッピングにURLパスやログイン情報は記述しません。
- アドレスが変わったら、古いマッピングが有効か確認します。
Ruleは通信ポリシーを扱う
- リクエストを直接接続、プロキシ、拒否のどれで処理するかを指定します。
- DOMAIN-SUFFIXはサブドメインも対象にできます。
- ルールの順序により、どの条件が先に処理されるかが決まります。
アドレスとポリシーの両方を変更する場合は、HostとRuleをそれぞれ確認してください。Hostを追加するだけでは、通信の振り分けは設定できません。
HTTPSでは、証明書に記載されたドメイン名も検証されます。ドメインを任意のアドレスにマッピングしても、そのアドレス上の証明書が有効になるわけではありません。マッピング後に証明書名の不一致、別サイトへの接続、継続的なタイムアウトが発生した場合は、証明書エラーを無視して問題を隠すのではなく、まずマッピングを取り消してサービスのアドレスを確認してください。独自の名前解決機能を使うアプリが、このマッピングに必ず従うとも限りません。
[URL Rewrite]:リクエストURLを照合して書き換える
[URL Rewrite]はURLを扱うもので、サーバーのプロトコルを選択する設定ではありません。次の行は正規表現でhttp://example.com/から始まるURLに一致させ、パスを維持したままHTTPSのURLへ転送し、302リダイレクトを使います。式中の\.は文字としてのピリオド、(.*)は残りのパスを捕捉し、$1は最初の捕捉グループを参照します。
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
- 照合範囲を確認する:先頭の
^は照合開始位置を指定します。この例は他のサブドメインにも、すでにHTTPSを使っている元のURLにも一致しません。 - リダイレクトを理解する:
302は一時的なリダイレクトを表します。クライアントは転送先URLに対して次のリクエストを送ります。バックグラウンドで接続先IPだけを変更する機能ではありません。 - DNSと混同しない:Hostは名前に対応するアドレスを変更し、URL RewriteはリクエストURLの処理方法を変更します。設定される段階が異なります。
- 確認できる範囲に注意:暗号化されたHTTPSリクエストの完全なパスを読み取ったり書き換えたりするには、通常、HTTPS復号に関する追加条件が必要です。ルールを1つ記述しただけで、暗号化された内容を取得できるわけではありません。
変更と検証:一度に変更するのは1項目
初めて変更する際は、元に戻せるコピーを先に保存してください。完全な設定には、この記事で扱わない別のセクションやリモート参照が含まれる場合があります。4つのセクションだけを解説しているからといって、ほかの内容をすべて削除しないでください。以下の手順は、現在接続できている設定を前提に変更範囲を絞るもので、サービス一式を新たに構築する手順ではありません。
-
設定をバックアップする
Configを開いて現在有効な設定を探し、その項目のエクスポートまたは共有機能でコピーを保存します。ファイル名と現在のGlobal Routingモードも記録してください。
-
項目を1つ編集する
Configで対象設定の編集画面を開き、1つのセクション内の項目を1つだけ変更します。Ruleをテストする場合は、まず完全一致のDOMAINルールを1つ追加し、DNSやHostは同時に変更しないでください。
-
有効化を確認する
保存後にConfigへ戻り、変更したファイルが選択されていることを確認します。次にHome → Global RoutingでConfigを選択し、ProxyまたはDirectの状態でルールの効果を判断しないようにしてください。
-
新しいリクエストを送る
対象アプリの既存接続を終了してから、新しいリクエストを送信します。利用可能な接続ログで、対象ドメインと実際に適用されたポリシーを確認してください。確立済みの長時間接続では、以前の処理結果が引き続き使われる場合があります。
-
記録して元に戻す
変更した行、一致結果、エラーの状況を記録します。結果に問題がある場合はバックアップに戻し、同じテストをやり直してください。未検証の設定を重ねて追加しないでください。
利用中のサブスクリプションも更新する必要がある場合は、別の操作として行ってください。更新が完了したことを確認し、Homeで選択中のサーバーがまだ利用可能であることを確認してから設定をテストします。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardの接続パラメータは、それぞれのプロトコルとサーバー側の設定に関わります。FINAL,PROXYを追加しても、パスワード、ポート、認証情報の誤りは修正されません。
よくある症状と確認項目
設定を保存したのに、example.comに新しいルールが適用されないのはなぜですか?
Configで有効になっているファイル、Home → Global RoutingがConfigになっているか、対象ルールより前に広範囲に一致するルールがないか、リクエストが古い接続を使っていないかを順に確認します。実際のリクエストがサブドメインの場合、DOMAIN,example.com,DIRECTだけでは一致しません。想定する範囲に応じて、ドメイン完全一致またはDOMAIN-SUFFIXを選んでください。
Hostを追加した後、遅延は正常なのにWebページが開かない場合は?
追加したマッピングをまず削除し、同じ接続先に新しいリクエストを送ってください。サーバーの遅延テストと、対象Webサイトの名前解決は別のテストです。遅延が正常でも、Hostのアドレスが正しいこと、対象サービスが待ち受けていること、証明書が一致することは確認できません。この記事の192.0.2.10は説明用の例示アドレスです。残しておくと、該当するアクセスは例示アドレスに向かいます。
リモート設定を更新したら、ローカルの変更が消えたのはなぜですか?
リモートの内容を更新すると、インポートや管理方法によってはローカルファイルが置き換わることがあります。残しておきたい変更は、事前に別のコピーを保存し、差分を記録してください。更新後は項目ごとに確認します。ローカルで追加したRuleがリモートの内容と自動で統合されるとは限りません。また、認証情報を含む設定ファイル全体やサブスクリプションURLを公開しないでください。
4つのセクションをすべて記述する必要はありますか?
形式を整えるためだけに、空のセクションや関係のない設定を追加する必要はありません。固定のマッピングがなければHostをそのまま追加する必要はなく、書き換えが不要ならURL Rewriteも追加しません。具体的な目的に必要な項目だけを残し、現在有効な設定に基づいて既定の動作を確認してください。この記事の断片を汎用的な既定設定として使わないでください。
Shadowrocketの入手方法と基本チュートリアル
iPhone / iPad版はApp Storeで2.99米ドルの買い切りです。Mac(Appleシリコン / Intel)/ Windows / Android / Linux版は無料です。ダウンロードページでデバイスを選び、チュートリアルに従ってご自身のサービス情報を読み込んでください。設定ファイルは設定や通信の振り分けを管理するもので、接続プランは含まれません。