公式マニュアル 機能と基本設定

Shadowrocket 機能と設定

まずGlobal Routingを確認し、次にConfigとサーバーを確認します。接続のオン/オフ、ルールの一致、オンデマンド接続はそれぞれ別の仕組みです。トラブルシューティングでは一度に変更しないでください。

Home · 接続とルーティング Config · ルールと設定 Settings · 動作と診断

Home / Global Routing

3つのルーティングモード

Config、Proxy、Directは、それぞれ設定ファイル、プロキシ、直接接続を表します。全体の通信処理方式を決めるもので、接続スイッチやルール行に指定するポリシーとは異なります。

画面上の表示通信の処理方法使用する場面最初に確認すること
Config · 設定ファイル現在有効な設定ファイル内のルールに基づいてポリシーを決定します。ドメインやIPアドレス範囲などの条件で、通常の通信を振り分ける場合。Configで意図したファイルが選択されているか、ルールとFINALがそろっているか。
Proxy · プロキシ全体のルーティング方式としてプロキシ経由を使用します。実際の適用範囲はシステムやアプリの処理範囲によって異なります。一時的にプロキシ経由でテストし、ルールの一致が原因かどうかを切り分ける場合。選択したサーバーに接続できるか、認証、DNS、接続先サービスが正常か。
Direct · 直接接続全体のルーティング方式として直接接続を使用し、プロキシサーバーを経由しません。現在のネットワークから接続先へ直接アクセスできるかテストする場合。ローカルネットワーク、DNS、接続先に到達できるか。

設定場所と確認方法

HomeでGlobal Routingを開き、現在の設定を控えてからテストするモードを選択します。Configを使う場合はConfigを開き、準備したファイルが実際に有効になっていることを確認してください。リストにファイルをダウンロードしただけでは有効になりません。その後Homeに戻り、サーバーを選択して接続をオンにします。同じ接続先で設定変更の前後を比べ、条件をそろえてください。

ProxyではアクセスできるのにConfigではできない場合は、一致したルールとそのポリシーを確認します。これは原因を絞る手がかりであり、ルールの誤りを断定するものではありません。Directでもアクセスできない場合は、まず現在のネットワークと接続先の状態を確認してください。DirectはシステムのVPN設定をオフにする意味ではありません。クライアントによる接続処理を完全に停止するには接続スイッチを使い、On Demandが再接続を引き起こさないかも確認してください。

画面によってはSceneが表示される場合があります。Sceneはシーンに応じた設定に使うもので、この節で扱う基本の3モードには含まれません。トラブルシューティングでは、まずモードを一つに固定し、シーン切り替えの条件を同時に加えないようにしてください。

Config / [Rule]

ルールの種類と実行ポリシー

ルールは「どのリクエストに一致するか」、ポリシーは「一致した後にどう処理するか」を定義します。Configモードではルールを上から順に評価し、最初に一致した時点で処理を終了します。キーワードの長さに応じて自動的に並べ替えられることはありません。

具体的な条件を先に、フォールバックを最後に

DOMAINは完全一致するドメインを対象とします。DOMAIN-SUFFIXは指定したドメインとそのサブドメインに一致します。DOMAIN-KEYWORDはドメイン内のキーワードで判定するため、通常はより広い範囲に一致します。IP-CIDRとIP-CIDR6は、それぞれIPv4とIPv6のアドレス範囲を指定します。GEOIPはIPの位置情報データに基づいて判定します。結果はデータベースや名前解決の過程に左右されるため、Webサイトの所在地を証明するものではありません。

USER-AGENTは取得可能なUser-Agent情報を対象にします。すべてのアプリのリクエストに適用されるとは限らず、アプリを特定する汎用的な方法として扱うべきではありません。FINALはフォールバックルールで、それ以前のルールに一致しなかったリクエストを処理します。前の方に置くと、後続のルールが評価されません。

ルールの記述例

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

example.comとexample.netは説明用ドメインです。以下はルールの順序を示す例であり、既存の設定を置き換えるための完全なファイルではありません。

PROXY、DIRECT、REJECT

PROXYはプロキシ経由、DIRECTは直接接続、REJECTは該当するリクエストの拒否を意味します。ルールにPROXYを指定しても、サーバー情報が自動で補われるわけではありません。必要なサーバーやポリシーが有効に選択されていることを確認してください。REJECTはブロック対象が明確な場合に使います。範囲を広げすぎると、ページ内の認証、画像、APIまで利用できなくなる可能性があります。

Configで現在のファイルを開き、[Rule]セクションを確認して、ルールの種類、マッチ条件、ポリシー、順序を一つずつ見直します。変更前に元のファイルを保存し、一度に変更する条件は一つにします。接続先へ再度アクセスしてログを確認し、ルールの一致結果を確かめてください。一つのドメインを直すために、範囲の広いキーワードルールを先頭に移動しないでください。

ルールと設定のリファレンスを見る

Home / SERVER / Add Server

Subscribeとサーバーの管理

サーバー項目には接続パラメーターを保存します。Subscribeはご自身が利用するSubscribeから項目を更新する機能で、Configはルールなどの設定を管理します。相互に関係しますが、それぞれの役割は異なります。

Subscribe:一括追加と更新

Homeの追加メニューからAdd Serverを開き、Subscribeを選んで、ご自身のSubscribe URLを入力します。保存後に更新し、SERVERに項目が実際に作成されたことを確認してください。Subscribe URLにはアクセス認証情報が含まれることが多いため、公開スクリーンショットやチャット、診断情報に載せないでください。

更新に失敗した場合は、URLに空白や改行が入っていないか、パラメーターが無効になっていないかを確認し、現在のネットワークからURLにアクセスできるかを調べます。更新が完了しても、取得したすべてのサーバーに接続できるとは限りません。Subscribeで管理される項目は、次回の更新で再作成されることがあります。手動で変更した内容は別途記録してください。

Add Server:手動入力とQRコード読み取り

個別のサーバーパラメーターがある場合は、Add Serverで該当するプロトコルを選び、実際の情報に従ってアドレス、ポート、認証情報、通信オプションを入力します。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardでは各項目の意味が異なります。プロトコル名だけを変更し、前の項目のパラメーターをそのまま残さないでください。

Scan QR Codeは情報の入力方法であり、情報の提供元や接続可否を検証するものではありません。読み取り後もプロトコル、アドレス、重要なパラメーターを確認してください。QRコードに機密情報が含まれている場合もあります。保存後はConnectivity Testを実行し、続けてその項目を選んで実際のアクセスをテストしてください。「追加済み」と「接続成功」は別です。

追跡できる形でリストを整理

見分けやすい名前を付け、名前にパスワードを書かないでください。Subscribeから生成された項目と手動で追加した項目を区別し、削除前にConfigから参照されていないか確認します。サーバーのテストに成功しても接続先にアクセスできない場合は、Global Routing、ルール、DNS、接続先サービスを確認してください。同じ内容を何度も削除して再追加するのは避けましょう。初回接続までの手順はクイックスタートをご覧ください。

Settings / On Demand

ネットワーク条件に応じた接続

On Demandは、設定した条件に合致したときにシステムがVPN接続を開始する機能です。「いつ接続するか」を決めるものであり、「特定のドメインをどの経路にするか」を決めるものではありません。Wi-FiやCellularなどの条件と、Global Routingや[Rule]はそれぞれ別の階層にあります。有効にする前に、現在のConfigとサーバーが正常に動作することを確認してください。

SettingsでOn Demandを探し、画面に表示される条件と動作を確認してから、明確な利用シーンに合わせて設定します。Wi-Fi名を条件にする場合は、実際のネットワーク名を確認し、似た名前だけで判断しないでください。初めて設定する際は再現しやすい条件を一つだけ使い、期待どおりに動作することを確かめてから他の条件を追加します。

おすすめの確認手順

  1. まず手動で接続し、現在のConfigで必要な接続先にアクセスできることを確認します。
  2. On Demandの条件を一つ設定し、他の設定は変えずに保ちます。
  3. 該当するWi-FiまたはCellularに切り替え、システムの接続状態を確認します。
  4. 次に条件に合わないネットワークへ切り替え、実際の動作を確認します。

システムのスケジュール、ネットワークの切り替え、アプリの状態は接続開始のタイミングに影響します。秒単位で動作するタイマーとして扱わないでください。

手動で切断しても再接続される場合は、システムのVPN設定をすぐに削除せず、まずOn Demandの条件を確認してください。通常の接続トラブルを調べる際は、条件を記録して一時的にオンデマンド接続をオフにし、手動接続のテスト後に元へ戻します。ネットワークを頻繁に切り替える場合は、認証ページにも注意してください。ログインが必要なWi-Fiでは、先にネットワーク側の接続手続きを完了します。

Data

通信量の確認で知っておきたいこと

Dataでは、クライアントが記録した範囲の通信量を確認できます。Dataを開いたら、表示中の集計範囲、方向、期間を確認してください。画面によって集計方法が異なる場合があります。アップロードとダウンロードの数値は通信の有無を確認する手がかりになりますが、合計値だけでページが完全に読み込まれたかは判断できません。また、クライアントの統計を通信事業者の請求情報と同一視しないでください。

テスト前に表示値を記録し、対象を一つに絞って操作した後、数値の変化を確認します。バックグラウンド同期、システムリクエスト、再試行、プロトコルのオーバーヘッドでも通信量が発生します。コンテンツを再生しながら別のWebサイトをテストすると、数値の変化を原因ごとに分けにくくなります。新しい基準で観察する場合は、古いデータを記録してから現在の画面にあるリセット機能を使ってください。リセット後に削除済みのローカル統計を復元することはできません。

DataはSubscribeの利用枠確認には使えません。ご自身が利用するサービスの容量、有効期限、精算方法は、提供元のアカウント情報で確認してください。クライアントに表示される通信量は、サーバー側の残り利用量を保証するものではありません。通信量が異常に増えた場合は、リクエストログで発生源を確認し、テスト範囲を絞ります。Global Routingを変更したまま長期間使う方法で対処しないでください。

Settings

よく使う設定の確認

設定項目の表示や選択肢は、現在のシステムとアプリ画面によって異なります。変更前の値を記録してください。関連する機能が設定ファイルで制御される場合はConfigも確認し、画面上の一箇所だけを変更して終わらないようにします。

DNS:名前解決と接続を切り分ける

概要:DNSはドメイン名をIPアドレスに変換します。結果は後続のIPルールや接続経路に影響する場合があります。名前解決に成功してもサーバーのポートが利用できるとは限りません。また、接続失敗の原因が必ずDNSとは限りません。

設定場所と方法:SettingsでDNS関連の設定を探すとともに、現在のConfigの[General]セクションに名前解決の設定があるか確認します。利用中のネットワークに合わせてリゾルバーと関連項目を確認し、一度に変更するのは一項目にして、同じドメインで再テストしてください。

注意点:DNSを手当たり次第に変更しても、あらゆる問題が解決するわけではありません。ネットワーク内のドメイン、認証ページ、IPv6にはそれぞれ異なる要件がある場合があります。キャッシュの影響で変更がすぐ反映されないこともあります。変更前後の名前解決結果を記録すると、違いを確認しやすくなります。

Test Method:テスト結果の意味を理解する

概要:Test MethodはConnectivity Testで使用する測定方法を決めます。方法によって測定する通信経路の段階が異なるため、方法を考慮せずに結果を直接比較することはできません。

設定場所と方法:SettingsでTest Methodを開き、選択できる方法とテスト対象を確認します。選択内容を記録してからHomeに戻り、Connectivity Testを実行してください。複数のサーバーを比較する場合は、同じ方法と対象を使い、ネットワーク条件もできるだけそろえます。

注意点:テストに成功しても、すべてのWebサイトにアクセスできるとは限りません。特定のテストに失敗しただけで、認証情報の誤りとは断定できません。表示値を小さくするために方法を何度も変更せず、実際の接続先へのアクセスも確認し、エラー内容と合わせて判断してください。

Today Widget:ショートカットと状態確認

概要:Today Widgetは、システムのウィジェットからアプリの機能へすばやくアクセスするためのものです。実際に使える形式は、システムの対応状況によって異なります。操作の入口であり、独立したルーティング設定ではありません。

設定場所と方法:SettingsでToday Widget関連の項目を確認し、システムのウィジェット管理画面で追加できるかを確かめます。現在のシステムで可能な方法で設定した後、ショートカットを一度実行し、Homeで接続状態と選択中のサーバーを確認してください。

注意点:ウィジェットの表示には更新間隔があるため、古い表示だけで現在の接続状態を判断しないでください。項目が表示されない場合は、システムの対応状況とアプリの設定項目を確認します。他のデバイスと同じ場所にあるとは限らないため、無理に探さないでください。

iCloud:同期は完全なバックアップではありません

概要:iCloud関連機能は、条件を満たすデバイス間でアプリが対応するデータを同期します。同期範囲は画面の説明を確認してください。サーバーの認証情報、設定ファイル、すべてのSettingsが完全に同期されるとは限りません。

設定場所と方法:まずシステムのiCloud権限とアカウントの状態を確認し、次にSettingsでアプリ内の同期項目を確認します。切り替える前に現在の設定を保存し、別のデバイスでファイル名の表示だけでなく、必要な内容が届いているか確認してください。

注意点:ネットワーク、空き容量、同期の競合によって結果が変わる場合があります。データを削除する前に、他のデバイスへの影響を確認してください。同期は独立したバックアップの代わりにはなりません。書き出したファイルや設定にサーバーの認証情報が含まれる場合があるため、保存や共有の際はアクセス範囲を制限してください。

Settings / Diagnostics

診断と変更を最小限にしたトラブルシューティング

Diagnosticsでは、名前解決、接続、認証、ルールの経路などの問題を切り分けるための情報を収集・確認できます。Settingsで該当する項目を開き、利用できるツールと出力内容の説明を読んでから、問題を再現してください。ツールや表示内容はプラットフォームによって異なる場合があります。特定のツールがないことを、アプリに接続機能がないという意味に捉えないでください。

明確な接続先を一つ決めて調べます。Wi-FiかCellularか、Global Routingの設定、選択中のサーバー、現在のConfig、失敗の状況を記録してください。まず基本のネットワークを確認し、次にサーバーへの接続と認証、DNSと一致したルールの順に確認します。最後にOn Demandなどの自動動作を元に戻します。一度に変更する変数は一つにし、各テストの結果を記録して、複数の変更によって原因が分からなくなるのを防ぎます。

たとえばProxyでは接続できるのにConfigでは失敗する場合は、サーバーを変えずに、そのドメインが範囲の広いルールに先に一致していないか、適用されたポリシーが意図どおりかを確認します。どちらのモードでも失敗する場合は、FINALを何度も移動するのではなく、サーバーのパラメーター、現在のネットワーク、接続先の状態を調べます。ルール、サーバー、システムネットワークの問題には、それぞれ異なる根拠が必要です。

診断情報を共有する前に、Subscribe URL、認証情報、個人のドメイン、デバイス情報、アクセス履歴が含まれていないか確認し、必要に応じて伏せてください。再現手順、関連するエラー、必要最小限のルールだけを共有します。トラブルシューティングの助言を得るために設定ファイル全体を公開しないでください。問題が解決したら、一時的なテスト設定を元に戻し、普段使うConfigとOn Demandの条件を再確認してください。

設定ファイルの構成とルールの一致条件を見る
Shadowrocket 全プラットフォーム版のダウンロード