Shadowrocket 公式マニュアル / 機能と設定

Shadowrocket 基本設定

まず通信モードを確認し、次に設定、サーバー、接続状態を確認します。

このページでは、各機能について「概要・場所・設定方法・注意点」を解説します。画面の場所は iPhone / iPad の一般的なレイアウトを基準にしています。Mac、Windows、Android、Linux も Shadowrocket に対応していますが、メニューの配置や利用できるシステム連携機能はプラットフォームによって異なる場合があります。実際の端末に表示される内容をご確認ください。

接続方法

Global Routing の3つのモード

概要:Global Routing は接続時にどの転送方式を使うかを決めます。設定に基づく分岐、プロキシ、直接接続は、それぞれ画面の Config、Proxy、Direct に対応します。プロトコルを選ぶ機能ではなく、サブスクリプション内のサーバーを自動的に利用可能にするものでもありません。モードを切り替える前に、選択中のサーバーと設定ファイルを確認してください。

場所と設定方法:Home で Global Routing を開き、使いたい項目を選んで戻ります。普段、既存のルールで通信を振り分ける場合は Config を選びます。問題がルールによるものか確認するときは、一時的に Proxy に切り替えて比較できます。ローカルネットワークから対象にアクセスできるか確認する場合は Direct と比較します。確認後は元のモードに戻し、一時的なテスト設定をそのまま使わないようにしてください。

画面上の項目処理方法使用する場面確認するポイント
Config · 設定現在有効な設定のルールとポリシーに従ってリクエストを処理します。ドメインやアドレスごとにアクセス経路を分けたい場合。設定が有効か、ルールの順序やポリシーの参照先が正しいか。
Proxy · プロキシクライアントの処理対象となる通信をプロキシ経由で処理します。ルール分岐による違いを一時的に切り分けたい場合。選択中のサーバーに接続できるか、プロトコルのパラメーターが一致しているか。
Direct · 直接接続選択中のプロキシサーバーを経由せず、直接接続します。基本ネットワークとの比較や、ローカルリソースへのアクセス確認。ローカルネットワークと接続先のサービスが正常に動作しているか。

注意点:Proxy を選んでも接続先に必ずアクセスできるとは限りません。また、Direct はシステムの接続スイッチをオフにすることではありません。接続が確立したか、リクエストがクライアントの処理対象になったか、どのポリシーが適用されたかは、それぞれ別の確認事項です。システム側の除外設定やアプリ独自の接続方法によって実際の処理範囲が変わる場合もあるため、リクエストの記録もあわせて確認してください。

マッチングと処理

ルールの種類とポリシー

概要:ルールは接続先を判定し、ポリシーはその処理方法を決めます。たとえば DOMAIN-SUFFIX はドメインのサフィックス条件を表し、PROXY はプロキシ経由で処理することを表します。モードの Proxy とルール内のポリシー PROXY は別物です。前者は全体の接続方式、後者は設定内の個別ルールの動作を指定します。

場所と設定方法:Config で現在有効な設定を開き、ファイルの編集画面またはルール一覧に進みます。まずバックアップを作成し、対象範囲が狭く例外性の高いルールを前に、広い範囲を対象とするルールを後ろに配置します。最後に、それまでに一致しなかったリクエストを FINAL で処理します。以下は構文を説明するためのドメイン例であり、接続先情報ではありません。

DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

この順序では、api.example.com は最初のルールに一致し、それ以降のサフィックスルールでは処理されません。それ以外で example.com のサフィックスに一致するドメインは2番目のルールが適用されます。ルールを書いただけでは、リクエストがそのルールに到達するとは限らないことがわかります。

キーワードマッチする対象使用上の注意
DOMAIN完全一致するドメイン。特定のホストに対する例外指定に使います。
DOMAIN-SUFFIXドメインのサフィックスとそのサブドメイン。完全なドメイン名より広い範囲に一致します。先行するルールの要件と重複しないか確認してください。
DOMAIN-KEYWORDドメインに含まれるキーワード。関係のないドメインにも一致する可能性があります。条件を絞ってください。
IP-CIDR / IP-CIDR6IPv4 / IPv6 のアドレス範囲。アドレスファミリー、マスク、ドメイン解決がマッチングに与える影響に注意してください。
GEOIPアドレスデータベースに登録された地域情報。データベース上の地域情報は、サービス運営者の所在地と同じとは限りません。
USER-AGENTルールで判定可能な User-Agent の内容。該当するフィールドを取得できる場合にのみ、マッチングできます。
FINALそれまでのルールに一致しなかったリクエスト。フォールバックとしてルールの末尾に配置します。

注意点:PROXY はプロキシ経由、DIRECT は直接接続、REJECT は一致したリクエストの拒否を意味します。拒否ルールによってページ表示に必要なリソースまでブロックされる場合があります。ページの一部が表示されないときは、すぐにサーバーを変更せず、まず一致したルールの記録を確認してください。独自のポリシーを参照する場合は、設定内で定義された名前と一致させる必要があります。ルールの詳しい順序はカスタムルールと FINAL の解説をご覧ください。

サーバーの種類

複数のプロトコルとパラメーター

概要:プロトコルはクライアントとサーバー間の通信方法を定めます。Shadowrocket の Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 は、それぞれ異なるサーバー設定に対応します。名称だけで、どのネットワークでも特定の方式が速い、または省電力だと判断することはできません。

場所と設定方法:Home から Add Server を開き、手元のサーバー情報に合った種類を選びます。既存の項目を編集する場合は、まず種類を確認し、アドレス、ポート、認証情報、サービス側で指定されたトランスポートや TLS の設定を順に照合してください。サブスクリプションからの読み込みで各項目が自動入力される場合も、クライアントが認識した種類と元の情報が一致しているか確認しましょう。種類によって表示される項目が異なるのは正常です。別のプロトコルのパラメーターをそのまま入力しないでください。

注意点:ポート番号が同じでもプロトコルが同じとは限らず、TLS を有効にしても証明書やホスト名の要件が満たされるとは限りません。テストを成功させるために証明書の検証をむやみに緩めず、まずサーバー名、システム時刻、サーバー側から提供されたパラメーターを確認してください。各項目の意味と設計上の考慮点はプロトコルリファレンスをご覧ください。認証情報を含むスクリーンショットやログを共有する場合は、事前に機密情報を削除してください。

サーバー情報の管理

Subscribe とサーバーリスト

概要:Subscribe は、登録済みのサブスクリプションからサーバー情報を読み込む機能です。Add Server ではサーバー情報を個別に入力します。サーバーリストは「どの接続先を使うか」を管理するもので、ルールを含む完全な設定ファイルとは別です。サブスクリプションの更新に成功しても、情報の取得と解析が完了したことを示すだけで、リスト内のすべての項目で接続できるとは限りません。

場所と設定方法:Config から Subscribe 関連の項目を開き、ご自身のサービス提供元から入手したサブスクリプション URL を入力します。名前を確認して更新し、Home に戻ってリストを確認してください。サーバーを個別に追加する場合は Add Server、QR コードがある場合は Scan QR Code を使います。クリップボードから読み込む前に、ご自身のサーバー情報であることを確認してください。保存後は、項目の種類と数が想定どおりか確認しましょう。

既存のリストを管理するときは、手動で追加した項目とサブスクリプションのグループを用途がわかる名前で区別すると便利です。新しい項目をテストしてから、古い項目を削除するか判断してください。サブスクリプションから追加されたサーバーの設定を直接変更すると、次回の更新で上書きされることがあります。個別の変更を残す必要がある場合は、項目の取得元と更新時の動作を確認し、一時的な変更を永続的に保存されたものと誤解しないようにしてください。

注意点:サブスクリプション URL には認証情報が含まれることが多いため、機密情報として扱い、公開の質問サイトやログに貼り付けないでください。更新に失敗した場合は、現在のネットワーク、URL の完全性、サービスの有効性、応答の形式を順に確認します。リスト全体を何度も削除しないでください。関連画面の操作手順はサブスクリプションの読み込み方法をご覧ください。

設定ファイル

Config の保存と有効化

概要:Config では設定ファイルを管理します。ファイルにはルール、DNS の動作、ローカルマッピングなどを含めることができます。ファイルを保存すること、有効にするファイルを選ぶこと、分岐モードを Config に切り替えることは、関連していますが別々の操作です。「設定を変更したのに反映されない」ときは、この3点を個別に確認してください。

場所と設定方法:Config を開き、現在どのファイルが有効になっているかを示す表示を確認してから編集します。変更前にコピーを保存し、一度に変更する動作は1つに絞りましょう。たとえば、まず特定のドメインルールを変更し、保存して有効化されたことを確認してから、同じ接続先でテストします。設定を読み込む場合は、読み込む内容がサーバーのサブスクリプションか設定ファイルかを区別してください。URL の見た目だけで判断しないようにしましょう。

注意点:リモート設定を更新すると、ローカルの内容が置き換わる場合があります。継続的に独自の変更を加える前に、上書きされる範囲を確認してください。設定内の General、Rule、Host、URL Rewrite はそれぞれ役割が異なり、ルールファイルにサーバーアドレスだけが記載されているとは限りません。提供元が不明な設定ファイルで現在のファイル全体を上書きしないでください。特に DNS、マッピング、アドレス書き換えに影響する箇所は確認が必要です。詳しくは設定ファイルの各セクションの役割をご覧ください。

自動接続の条件

On Demand によるオンデマンド接続

概要:On Demand は、システムが対応するネットワーク条件に応じて接続を開始します。ネットワークを切り替えるたびに接続スイッチを手動で操作する手間を減らす機能です。「いつ接続を試みるか」を設定するもので、接続後の通信をどう振り分けるかを決める Global Routing の代わりにはなりません。また、すべてのリモートサービスが正常かどうかを判定する機能でもありません。

場所と設定方法:アプリの Settings で On Demand を探し、現在のプラットフォームで表示される条件に従って、Wi-Fi、モバイル通信、特定のネットワークに関する動作を設定します。まず手動接続が正常に動作することを確認してから有効にし、対象ネットワークへの接続時、ネットワークからの切断時、画面ロック後に再利用するときの各状況をテストしてください。システムによる接続設定の確認が求められた場合は、表示内容を読んで承認してください。

注意点:複数の条件を同時に変更して、一度だけテストするのは避けてください。接続をオフにした後、再び接続される場合は、まず On Demand が再接続を実行していないか確認し、次に他のシステム自動化設定を調べます。バックグラウンド処理、ネットワーク権限、省電力の仕組みはシステムごとに異なるため、ある端末での動作タイミングをすべてのプラットフォームに当てはめないでください。

通信量の記録

Data の統計と確認範囲

概要:Data ではクライアントが記録した通信量を確認できます。操作によってデータ転送が発生したか、接続の前後で大きな変化があったかを判断する際に役立ちます。表示される値はクライアント独自の集計であり、接続サービスのアカウントにおける請求記録ではありません。また、システムが計測するモバイル通信量の代わりにもなりません。

場所と設定方法:Data を開き、表示されている集計範囲と分類を確認してから、アップロードとダウンロードの変化を見ます。特定の操作を調べる場合は、まず現在の数値を記録し、不要なバックグラウンド通信を止めて、テスト対象を1つだけ開き、操作前後の変化を比較してください。統計をリセットする機能がある場合は、必要な記録を保存してから実行します。数値をリセットしても接続の問題は解決しません。

注意点:プロトコルのオーバーヘッド、集計開始時点、バックグラウンド通信、処理対象の範囲によって、クライアントとシステムの記録には差が生じます。接続スイッチがオンでも一時的に数値が増えない場合は、処理対象となるリクエストがない可能性があります。通信量が増えていても、ページ内のすべてのリソースが読み込まれたとは限りません。接続先へのアクセス結果とリクエスト記録をあわせて確認してください。

よく使う設定

Settings の基本項目

Settings にはアプリの動作や一部のシステム連携オプションがまとめられています。以下の項目は、実際の画面に表示される場合に確認してください。現在のプラットフォームに表示されない項目を、別の端末のスクリーンショットと同じ場所で探す必要はありません。変更前の値を記録しておくと、問題が起きたときに元へ戻せます。

DNS:名前解決と接続を分けて確認

概要と場所:DNS はドメイン名を IP アドレスに変換します。関連項目は Settings の DNS 設定と、設定ファイル内の DNS 関連項目で確認できます。名前解決に成功しても接続先のポートに到達できるとは限らず、サーバーに接続できてもすべてのドメインが正常に名前解決できるとは限りません。

設定方法と注意点:まず、有効な設定ファイルで DNS の動作が指定されているかを確認し、次に全体設定を確認します。2か所を同時に変更すると、どちらの変更が反映されたのか判断できなくなります。現在のネットワークやサービスの設定要件に合った名前解決方法を使い、変更後に対象へ再接続してください。一部のドメインだけ失敗する場合は、名前解決のエラー、ルールの一致先、接続エラーを切り分けます。すべての問題を DNS が原因だと決めつけないでください。IPv6 の設定も、ローカルネットワークの実際の対応状況とあわせて確認しましょう。

Test Method:テスト方法の選択

概要と場所:Test Method は Settings にある接続テスト関連の項目で、テストに使う方法を選択します。方法によって確認する通信経路の段階が異なるため、表示結果を混同して比較しないでください。

設定方法と注意点:現在の画面で選択できる方法から1つを選び、サーバーリストに戻って Connectivity Test を実行します。複数のサーバーを比べる場合は、テスト方法、ネットワーク、テスト対象を統一してください。テスト結果はその時点の条件で得られた観測値であり、継続的な通信速度を保証するものではありません。テストに成功しても、実際に必要な接続先へアクセスして確認してください。

Today Widget:システムのショートカット

概要と場所:Today Widget はシステムウィジェットに関するショートカット設定です。対応する項目がある端末では、Settings から確認できます。アプリを操作する入口であり、サーバーやルールを新しく作成する機能ではありません。

設定方法と注意点:まずアプリ内で正常に接続できることを確認し、システムのウィジェット管理機能から利用可能なウィジェットを追加します。操作後に表示が同期されない場合は、何度もクリックするのではなく、アプリを開いて実際の接続状態を確認してください。ウィジェットの対応状況や更新タイミングはシステムによって異なります。現在のシステムに表示される内容をご確認ください。

iCloud:同期範囲とローカルコピー

概要と場所:iCloud の設定項目がある Apple デバイスでは、Settings で同期設定を確認し、システム側でアプリの iCloud 利用が許可されていることも確認してください。この機能はシステムアカウントと権限に依存するため、すべてのプラットフォームで使える同期方法ではありません。

設定方法と注意点:有効にする前にローカルの設定ファイルをバックアップし、画面に記載された同期範囲を確認してください。サーバー、設定、システムの接続権限、現在の接続状態がすべて一緒に移行するとは限りません。端末を変更した後は、サーバーリスト、有効な設定、接続の許可を個別に確認してください。複数の端末で同時に編集する場合は、同期が完了したことを確認し、古いコピーで新しい内容を上書きしないようにしましょう。

トラブルの切り分け

Diagnostics と確認手順

概要と場所:Diagnostics はネットワークや接続の問題を調べるための機能です。現在のプラットフォームで利用できる診断項目を Settings から探してください。サーバーリストの Connectivity Test では接続テストを実行できます。診断記録は原因を特定するための手がかりであり、誤ったプロトコル設定や無効になったサービス情報を自動修正する機能ではありません。

設定方法:最初から多くの設定を変更する必要はありません。サーバーとテスト対象を1つずつ決め、以下の順に操作します。各手順の結果を記録してから次に進むと、複数の変更が同時に起きたことを1つの原因と誤認しにくくなります。

  1. 基本ネットワークを確認する。端末が現在のネットワークに接続する前に認証を必要とするか、システム時刻が正しいかを確認します。必要に応じて、別の利用可能なネットワークでも比較してください。
  2. サーバーをテストする。Test Method を統一し、Connectivity Test を実行します。すべて失敗する場合は、まずネットワークとサブスクリプションの有効性を確認してください。一部だけ失敗する場合は、該当する項目を優先して確認します。
  3. プロトコルの設定項目を確認する。サーバー名だけで判断せず、アドレス、ポート、認証情報、トランスポート、TLS の各設定を確認してください。
  4. ルール分岐の影響を切り分ける。現在のモードを記録し、Config と Proxy を短時間切り替えて比較した後、元の設定に戻します。結果に違いがあれば、ルールとポリシーの参照先をさらに確認してください。
  5. 個別のリクエストを確認する。診断記録またはリクエストログで、取得できる接続先、名前解決、ポリシー、エラー情報を確認します。一部のページリソースだけが読み込まれない場合は、該当するドメインを個別に調べてください。
  6. 直近の変更を元に戻す。最後に変更した DNS、ルール、設定ファイルのバックアップを復元し、同じ接続先でテストします。原因の切り分けに、すべての設定の初期化を使わないでください。

注意点:ログにはサーバーアドレス、アクセス先、認証に関する情報が含まれる場合があります。外部に共有する前に、機密情報を一つずつ削除してください。あるテストで遅延が低かったとしても、その条件での結果を示すだけで、実際のダウンロード速度やすべてのアプリの使用感を保証するものではありません。接続失敗の詳しい確認方法は接続タイムアウト時の確認手順をご覧ください。