公式ガイド · 用語一覧
Shadowrocket 用語ガイド
画面、プロトコル、設定に関する用語を解説します。画面上のProxyは通信モードの一つで、ルール末尾のPROXYは個別ルールの処理ポリシーです。
画面とスイッチ
サーバーの選択、接続状態、通信モードを区別しましょう。それぞれ、使用する接続先、接続の有効・無効、プロキシに送るリクエストを決めます。
- Home
- サーバー一覧、選択中の項目、接続スイッチを確認する画面です。サーバー横の選択マークは、どの項目を選んだかを示すだけで、接続が確立したことを意味しません。Webページが開かない場合は、まず選択した項目を確認し、次にスイッチとテスト結果を確認してください。
- Global Routing
- 通信の処理方法を選びます。
Config(設定)は現在の設定に従って処理し、Proxy(プロキシ)はプロキシモード、Direct(直接接続)は直接接続モードを使います。ルールが適用されるか確認するには、まずConfigモードになっていることを確認してください。モードを切り替えても、登録済みサーバーのプロトコルは変わりません。
- Config
- ナビゲーションに表示される場合は、設定ファイルを管理する画面を指します。
Global Routing内では、現在の設定に従って通信を処理するモードを指します。ルールを変更しても期待した結果にならない場合は、選択中のファイルと使用中のモードをそれぞれ確認してください。
- On Demand
- デバイスがネットワークを切り替えたときなど、設定した条件を満たすと接続を開始します。接続を試みるタイミングを決めるもので、接続後に特定のドメインがプロキシ経由か直接接続かを決めるものではありません。接続をオフにしても自動で再びオンになる場合は、
On Demandの状態と起動条件を確認してください。
- Add Server
- サーバー情報を把握している場合に、サーバーを手動で追加します。情報に基づいてプロトコルを選び、アドレス、ポート、プロトコルで必要な認証パラメータを確認してください。項目を保存しただけでは接続されません。項目を選択して接続を確認してください。
プロトコル
プロトコルによって、クライアントとサーバー間の通信方法が決まります。プロトコルは登録済みのサーバー情報に基づいて選択してください。アドレスとポートが同じでも、異なるプロトコルを互換利用できるとは限りません。
- Shadowsocks
- 暗号化した通信の中継を主な用途とするプロキシプロトコルです。手動入力する場合は、アドレス、ポート、暗号化方式、パスワードをサーバー側の設定と一致させてください。アドレスとポートだけでは、暗号化方式や認証情報の誤りを特定できません。
- VMess
UUIDでユーザーを識別するプロキシプロトコルです。UUIDは接続に使うユーザーを識別するもので、サーバーアドレスではありません。通信方式、パス、TLSパラメータも指定されている場合は、それぞれ照合してください。アドレスとポートだけを基に補完しないでください。
- VLESS
- プロキシプロトコルと通信のセキュリティを分けて扱い、接続の保護は実際に設定されたセキュリティ層に依存します。
VMessと同じくUUIDを使う場合がありますが、項目が似ていても互換性があるとは限りません。既存の項目を複製する場合、プロトコル名だけを変更して他のパラメータを流用しないでください。
- Trojan
- TLS上で通信するプロキシプロトコルで、通常はパスワードで認証します。サーバーアドレスは接続先を指定し、TLSサーバー名は証明書が対応するホスト名を示します。両者が異なる場合もあります。証明書名の不一致が発生した場合は、まず登録済み情報の該当項目を確認してください。
- HTTP / SOCKS5
- 異なる2種類のプロキシ方式です。HTTPプロキシは
CONNECTでトンネルを確立でき、SOCKS5では独自の接続・認証ネゴシエーションを行います。ユーザー名とパスワードが必要かどうかは、サーバー側の設定によります。方式名だけでは、プロキシサーバーまでの通信が暗号化されているかは判断できません。
- WireGuard
- UDPで通信する暗号化トンネルプロトコルで、鍵を使って接続先を識別します。接続先のアドレスとポートに加え、トンネルアドレスやトンネル経由を許可するアドレス範囲も接続性に影響します。公開鍵と秘密鍵は用途が異なります。トラブル調査時は、秘密鍵をログやスクリーンショットに貼り付けないでください。
- Hysteria2
- QUICベースのプロキシプロトコルで、サーバーまでのUDP通信経路が必要です。同じ設定があるネットワークでは使えて別のネットワークではタイムアウトする場合、ネットワーク環境も確認してください。1回のテストだけで、すべてのデバイスでの速度や消費電力を判断することはできません。
ルールキーワード
ルールキーワードはリクエストを照合し、ポリシーは一致したリクエストを処理します。ルールを確認するときは、ドメイン全体、ドメインのサフィックス、宛先IPのどれを照合するか確認し、次にルールの順序を確認してください。
- DOMAIN
- ドメイン名全体に完全一致します。条件が
example.comの場合、www.example.comには一致しません。特定のホスト名だけを対象にする場合は、完全一致を使うと同じサイトの他のサブドメインへの影響を避けられます。
- DOMAIN-SUFFIX
- 指定したドメインとそのサブドメインに一致します。たとえば同じ条件で
example.comとdocs.example.comを対象にできます。ドメイン階層に基づいて照合するもので、任意の文字列を含むかどうかの判定ではありません。ルール条件にはドメイン名を指定し、URLのスキームやパスは含めないでください。
- GEOIP
- 地理情報IPデータベースによる宛先アドレスの分類結果に基づいて照合します。Webサイトの言語やドメインのサフィックスでは判定しません。サービスが複数のアドレスに名前解決され、アドレスによって分類が変わる場合もあります。ルールの一致結果を調べる際は、その接続で使われた宛先アドレスを確認してください。
- IP-CIDR / IP-CIDR6
- IPv4とIPv6のアドレス範囲をそれぞれ照合します。スラッシュの後の数字はプレフィックス長です。IPv4のアドレス範囲だけを指定しても、同じサービスのIPv6アドレスは対象になりません。ルールが一致しない場合は、実際の接続で使われたアドレスの種類を確認してください。
- FINAL
- それより前のルールに一致しなかったリクエストに適用するフォールバックポリシーで、通常はルールの最後に配置します。リクエストがフォールバックポリシーで処理された場合は、まず前の条件が実際の宛先を対象としているか確認してください。フォールバックポリシーを変更すると、他の未一致リクエストにも影響します。
サブスクリプションと設定
サーバー項目は接続に使い、設定ファイルはルールなどを保存します。既存のサブスクリプションの読み込み、設定の有効化、デバイス間でのアプリデータ同期は、それぞれ別の操作です。
- Subscribe
- ユーザーが所有するサブスクリプションURLからサーバー一覧を読み込みます。更新時は、配信元の内容変更に応じて項目が増減する場合がありますが、更新は通信ルールの切り替えとは異なります。サブスクリプションURLにアクセス情報が含まれる場合があるため、調査用の情報を送る前に必ず隠してください。
- SERVER
- サーバー項目を整理・表示するための画面上のラベルです。項目名は識別用の文字列にすぎません。実際の接続はアドレス、ポート、プロトコル、認証情報などのパラメータで決まります。同じ名前で表示されていても、同じサーバーを使っているとは限りません。
- 設定ファイル
[Rule]セクションでリクエストの照合条件と処理ポリシーを記述するなど、ルールを含む設定を保存するファイルです。ファイルを読み込んでも、それが選択されたことや、Global RoutingがConfigに切り替わったことにはなりません。既存のファイルを変更する前に原本を保存しておくと、内容の確認や復元に役立ちます。
- iCloud同期
- アカウントとシステム設定の条件を満たすと、iCloud経由でデバイス間のアプリデータを同期します。機種変更時のApp Store購入済み項目はアプリの購入履歴であり、設定のバックアップではありません。同期後は、新しいデバイスで設定やサーバー項目が実際に表示されるか確認してください。
ポリシーと診断
適用されたポリシーはリクエストの処理方法を示し、テスト結果は1回の確認が完了したかどうかを示します。スイッチがオンになっていることや遅延が表示されることだけでは、特定のWebサイトにアクセスできるとは限りません。
- PROXY
- 一致したリクエストをプロキシ経由で処理するルールポリシーです。ルールに一致しても、該当サーバーが利用可能とは限らず、宛先サービスが応答したことも確認できません。トラブル調査では、ポリシーの一致、サーバーへの接続、宛先サービスの応答を分けて確認してください。
- DIRECT
- 一致したリクエストをプロキシ経由にせず、デバイスの現在のネットワークから直接送信します。
Global RoutingのDirectモードと表記が似ていますが、DIRECTルールの影響は一致したリクエストに限られます。直接接続も、現在のネットワークとドメインの名前解決状況に左右されます。
- REJECT
- 条件に一致するリクエストを拒否し、別のポリシーで再試行することはありません。Webサイトの画像、ログイン、その他の機能が拒否されたドメインを使っている場合、トップページが開いても関連機能が失敗することがあります。まず照合範囲を狭めてから、影響を受けた機能を再テストしてください。
- DNS
- ドメイン名をアドレスなどのレコードに変換します。名前解決の結果は宛先IPに依存するルールに影響します。名前解決に成功しても、宛先サービスへの接続が成功したとは限りません。一部のドメインだけに問題がある場合は、まず名前解決エラーの有無を確認し、次に適用されたルールを確認してください。
- Connectivity Test
- 現在のネットワーク環境で指定したテストを完了できるか確認します。1回のテストに成功しても、すべてのWebサイトにアクセスできることや、特定のルールが適用されたことの証明にはなりません。結果を比較する際は、サーバー、テスト対象、ネットワーク環境をできるだけ揃えてください。
- 遅延
- 1回の測定で記録された所要時間です。ネットワーク、テスト対象、測定方法によって変わります。同じ条件での比較には使えますが、遅延が小さくても帯域幅が大きいとは限らず、長時間の接続が安定するとも限りません。タイムアウトした場合は、まずテストが応答を受け取れたか確認してから所要時間を比較してください。