公式マニュアル・用語集
Shadowrocket 用語集
画面上の表示位置を手がかりに用語を探し、プロトコル、照合条件、適用されるポリシーを区別しましょう。英語表記はそのまま掲載しています。各項目の見出し横にあるリンクから直接移動できます。
Global Routing
DOMAIN-SUFFIX
FINAL
画面表示とスイッチ
まず、用語が画面のどこに表示されているかを確認しましょう。Global Routingのモード、Config画面、構成ファイル内のポリシーは、それぞれ異なる設定項目です。
- Home
- サーバー一覧、選択中のサーバー、接続スイッチを確認するメイン画面です。一覧に項目が表示されているのは情報が追加されたことを示すだけで、接続成功を意味しません。初めて使うときは、選択中のサーバー、Global Routingのモード、接続状態を順に確認し、インポート完了と通信確認を混同しないようにしてください。
- Global Routing
- トラフィック全体の処理方法を決めるGlobal Routingの設定です。モードはConfig(構成ファイル)、Proxy(プロキシ)、Direct(直接接続)の3種類です。構成ファイルのルールを適用するにはConfigを選びます。トラブル時は現在のモードを記録し、Proxyのままルールを変更したのに保存されていないと誤解しないようにしましょう。
- Config
- Global Routingでは、Configは現在の構成ファイルに従ってトラフィックを処理するモードを指します。画面メニューのConfigは構成管理を開き、構成ファイルの確認や選択に使用します。文書内での意味は表示位置から判断してください。Config画面を開く操作と、ルーティングモードにConfigを設定する操作は、関連していますが別々です。
- Proxy
- Global Routingのプロキシモードです。処理可能なトラフィックを選択したプロキシ経路に通します。プロキシ経路が利用できるかを一時的に確認する際に役立ちますが、ルールの順序確認に代わるものではありません。ここでのProxyは全体のモードを指し、ルール末尾に大文字で記述するPROXYとは適用階層が異なります。
- Direct
- Global Routingの直接接続モードです。トラフィックを宛先へ直接接続します。トラブルの切り分けでは比較条件として使えますが、直接接続が正常でも、プロキシサーバーのアドレス、認証情報、トランスポート設定が正しいとは限りません。比較後は必要なモードに戻し、構成ルールを確認してください。
- On Demand
- アプリやシステムが提供する条件に応じて接続を開始する設定です。接続するタイミングを指定するもので、特定のドメインにPROXYとDIRECTのどちらを適用するかを決めるものではありません。設定後は実際にネットワーク条件が変わる状況で確認してください。手動で切断した後の挙動も、現在のオンデマンド条件に基づいて判断します。
- Connectivity Test
- 現在のネットワークとテスト方法でサーバーが応答するかを確認します。結果は遅延時間や失敗として表示されることがあります。遅延は1回のテストで応答にかかった時間であり、ファイルの転送速度や、すべての宛先への接続可否を保証するものではありません。異常が続く場合は、テスト対象、サーバーパラメーター、システム時刻を確認してください。
プロトコル
プロトコルはクライアントとサーバー間の通信方法を定めます。既存のサーバー情報に基づいて種類を選び、名称、ポート番号、遅延から設定を推測しないでください。
- Shadowsocks
- プロキシプロトコルの一つです。一般的な設定項目はサーバーアドレス、ポート、パスワード、暗号化方式です。暗号化方式はサーバー側の設定と一致させてください。似た名称の項目があっても、任意に置き換えることはできません。プラグインや追加オプションの指定がある場合も、各項目を確認してください。アドレスとパスワードだけ入力して設定が完了したと判断しないようにしましょう。
- VMess
- プロキシプロトコルの一つです。通常、ユーザーID、サーバーアドレス、ポートを設定します。接続にはトランスポート方式、パス、Host、TLSなどの設定も必要になる場合があります。詳細は手元のサーバー情報を確認してください。インポート後に各項目が引き継がれているか確認できますが、公開されている例の値を自分の設定に上書きしないでください。
- VLESS
- プロキシプロトコルの一つです。名称はVMessに似ていますが、同じ種類として置き換えて使うことはできません。サーバー情報に基づいて認証情報、トランスポート方式、安全性の設定を確認してください。アドレスとポートだけをコピーして設定することはできません。利用できるトランスポートの選択肢は、アプリ内で実際に提供されている設定を確認してください。
- Trojan
- TLSを使用するプロキシプロトコルです。アドレス、ポート、パスワードに加え、証明書の検証に使うホスト名も確認してください。接続先アドレスと証明書のホスト名は異なる役割を持つ場合があるため、一致していないという理由だけで変更しないでください。証明書エラーが発生した場合は、ホスト名、証明書の有効性、端末の時刻を確認します。
- Hysteria2
- QUICベースのプロキシプロトコルです。接続には現在のネットワークがUDPを実際にサポートしている必要があります。アドレスと認証情報が正しくても、ネットワーク環境によってタイムアウトすることがあります。切り分けでは現在のネットワーク、サーバー側の状態、プロトコルパラメーターを分けて確認し、1回のタイムアウトだけでパスワードの誤りと判断しないでください。
- WireGuard
- 鍵ベースのトンネルプロトコルです。ローカル鍵、ピアの公開鍵、ピアのアドレス、トンネルアドレスなどを設定します。それぞれの項目には役割があり、サーバーアドレスだけでは完全な設定を再現できません。秘密鍵は機密情報です。スクリーンショットを共有したり、調査資料を送ったりする前に必ず隠し、公開設定例に記載しないでください。
- HTTP / SOCKS5
- 異なる2種類のプロキシプロトコルです。サーバーが実際に提供する種類を選んでください。ポート番号が同じでもプロトコルが同じとは限りません。ユーザー名やパスワードが必要か、どの種類のトラフィックに対応するかも、それぞれ確認します。HTTPプロキシという名称だけでは、クライアントとプロキシサーバー間の通信がTLSで暗号化されるとは限りません。
ルールキーワードとポリシー
ルールは通常、照合タイプ、照合する値、ポリシーで構成されます。まず一致するかを確認し、その後に一致した場合の処理を確認してください。プロトコル名をルールタイプと混同しないようにしましょう。
ルールの記述例
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
1行目は指定したドメインサフィックス、2行目はIPv4のプライベートネットワーク範囲に一致し、最後の行がそれまでのルールに一致しなかったトラフィックを処理します。これは構文の例であり、すべての端末で使える完全な構成ではありません。
- [Rule]
- 構成ファイルでルールを記述するセクションです。角括弧はセクション名を示し、ドメインの照合条件ではありません。ルールは通常、上から順に確認され、一致するとそのルールのポリシーが適用されます。広い範囲を対象とするルールより先に、具体的なルールを記述してください。ルールを適用するには、Global RoutingでConfigを選び、該当する構成ファイルを選択している必要があります。
- DOMAIN
- 完全一致したドメインに適用されるルールタイプです。例:
DOMAIN,example.com,PROXY。指定したドメインだけが対象で、すべてのサブドメインが自動的に含まれるわけではありません。www.example.comなどのサブドメインも対象にするには、必要に応じて個別の完全一致ルールを追加するか、DOMAIN-SUFFIXを使用します。
- DOMAIN-SUFFIX
- ドメインのサフィックスに基づいて照合するルールタイプです。
DOMAIN-SUFFIX,example.com,PROXYは、指定したドメインとそのサブドメインに適用できます。ここにはドメインを指定し、完全なURL、プロトコルのプレフィックス、ページのパスは入力しません。任意の位置に含まれる文字列を検索する方式ではなく、ドメインの境界に基づいて照合します。
- DOMAIN-KEYWORD
- ドメイン名に含まれるキーワードで照合するルールタイプです。例:
DOMAIN-KEYWORD,example,PROXY。キーワードが短いほど、関係のないドメインまで対象になる可能性があります。簡単に書けるからといって、正確なルールの代わりに使わないでください。誤った振り分けが発生した場合は、キーワードの範囲とルール一覧内の位置を確認します。
- GEOIP
- IPアドレスの地理情報データベースに基づいて照合します。例:
GEOIP,CN,DIRECT。判定基準はIPアドレスの割り当て情報であり、ウェブページの言語、運営者名、ドメインのサフィックスではありません。分散型サービスでは、名前解決されたIPアドレスやデータベースの記録によって判定結果が変わることがあります。接続ログも合わせて確認してください。
- IP-CIDR / IP-CIDR6
- IPv4およびIPv6のネットワーク範囲を照合します。スラッシュ以降の数字はプレフィックス長で、ポート番号ではありません。例:
192.168.0.0/16は単一サーバーではなく、ネットワーク範囲を表します。IPv4の範囲だけを設定してもIPv6の宛先は対象になりません。問題の切り分けでは、接続に使われているアドレスの種類を確認してください。
- FINAL
- それまでのルールに一致しなかった場合に適用するフォールバックルールです。通常、ルール一覧の末尾に記述します。
FINAL,PROXYは残りのトラフィックをプロキシ経由で処理する設定で、プロキシ接続に失敗した後に自動で直接接続するという意味ではありません。FINALを早い位置に置くと、後続のルールが確認されないことがあります。
- PROXY
- ルールで使用するプロキシポリシーです。一致したトラフィックをプロキシ経由で処理します。処理の方向を指定するだけで、サーバーアドレス、パスワード、プロトコルパラメーターを補完するものではありません。大文字のPROXYはルールポリシーを指します。先頭のみ大文字のProxyは、Global Routingの全体モードを指す場合があります。
- DIRECT
- ルールで使用する直接接続ポリシーです。一致したトラフィックを、そのプロキシサーバーを経由せずに宛先へ接続します。宛先への接続が保証されるわけではなく、現在のネットワーク、DNS、宛先サービスの状態に左右されます。特定のローカルアドレスを直接接続する場合は、正しいネットワーク範囲を確認し、適切な位置に具体的なルールを記述してください。
- REJECT
- ルールで使用する拒否ポリシーです。一致したリクエストをブロックします。プロキシが利用できない場合の修復方法ではなく、誤って設定すると、通常アクセスできる宛先にも接続できなくなります。アプリの一部のコンテンツが表示されない場合は、範囲が広すぎる、または順序が早すぎるREJECTルールが関連ドメインに一致していないか確認してください。
購読と構成ファイル
サーバー一覧では接続先を指定し、構成ファイルではトラフィックの処理方法を指定します。両者は関連することがありますが、一方を更新しても他方が更新されるとは限りません。
- Subscribe
- 購読の追加や更新に関する用語です。ユーザー自身が所有する購読URLからサーバー項目を読み込みます。購読を更新すると項目数、名称、パラメーターが変わることがありますが、ルールを含む構成ファイルの更新とは異なります。購読URLには認証情報が含まれる場合があるため、公開しないでください。更新できない場合は、URL全体が正しいか、現在も有効かを確認します。
- Server / Add Server
- Serverはサーバー設定の項目を指します。Add Serverはサーバーを追加する画面への入口です。サーバー名は識別しやすくするためのラベルで、接続に影響するのはプロトコル、アドレス、ポート、認証情報などの項目です。手動で追加する場合は手元のサーバー情報に従い、保存後にテストして実際の接続も確認してください。
- Configuration File
- 構成ファイルです。共通設定、ルール、ホストマッピング、書き換え設定をセクションごとに記述します。一般的なセクション名は[General]、[Rule]、[Host]、[URL Rewrite]です。サーバー一覧とは別のデータです。編集前に元の構成を保存し、変更後は使用中のファイルを確認してください。未選択の複製だけを編集してしまうことがあります。
- [Host]
- 構成ファイルでホスト名のマッピングを指定するセクションです。特定のドメインに名前解決結果を指定できます。手動マッピングによって、ドメインが古いアドレスを使い続ける場合があります。ドメインにアクセスできないときは、DNSサーバーだけでなくマッピングも確認してください。他の環境の設定をそのままコピーせず、必要な場合は用途と元に戻す方法を記録します。
- [URL Rewrite]
- 構成ファイルでURL書き換えルールを記述するセクションです。ルールに一致したリクエストのURLを変更または処理します。[Rule]でPROXY、DIRECT、REJECTを選ぶ振り分けの仕組みとは異なり、相互に置き換えることはできません。暗号化されたリクエストで確認できる範囲は、接続方式や関連設定によって異なります。任意のURLをそのまま書き換えられるとは限りません。
システムとインストール
ドメインの名前解決、システムの許可、アプリの入手を区別しましょう。システム上でトンネルが確立されても、すべてのサーバーや宛先サービスが利用可能だと確認されたわけではありません。
- DNS
example.comのようなドメイン名をIPアドレスに変換する仕組みです。名前解決の失敗とプロキシサーバーへの接続失敗は別の問題なので、分けて確認してください。構成のdns-server = systemは、システムのDNSを使用する指定です。DNSを変更した後は、キャッシュや[Host]マッピングの影響も確認してください。
- VPN Configuration
- ネットワークトンネルの確立に必要なシステム設定の許可です。初回接続時にシステムの確認画面で許可を求められる場合があります。構成の追加を許可したことは、アプリに必要な権限を与えたことを示すだけで、リモートサーバーの認証成功を保証しません。許可後も接続できない場合は、サーバーパラメーター、Global Routing、接続ログを順に確認してください。
- Purchased
- App Storeの購入済み項目です。元のアカウントで購入したアプリを探し、ストアのルールに従って再ダウンロードできます。iPhone / iPadを買い替えたり、再インストールしたりする場合は、購入時のアカウントを使用していることと、アプリを引き続きダウンロードできることを確認してください。項目が見つからない場合は、購入履歴とアカウントの国または地域を確認し、検索結果だけで再購入が必要だと判断しないでください。
- インストールの許可
- インストーラーを初めて実行した際、システムのブロック通知を確認して続行する操作です。ファイルの入手先が当サイトの/dl/であることを確認してから行ってください。Windowsでは表示に従って「詳細情報 → 実行」を選択します。Macでは「プライバシーとセキュリティ」で「このまま開く」を確認します。Androidでは使用するブラウザーに不明なアプリのインストールを許可します。その他の警告やLinuxの実行権限についてはインストールの許可に関する説明をご覧ください。システムの保護機能全体を無効にすることは避けてください。