公式マニュアル / 用語集

Shadowrocketの用語とルールキーワード

用途に応じて画面上の用語、プロトコル、設定の概念を確認できます。変更対象が接続全体のモード、照合条件、実行ポリシーのどれなのかを見分けてから、該当画面で操作してください。Proxyを含む名称でも、同じ階層の項目とは限りません。

画面上の用語は英語表記 ルールは上から順に照合 既存のサブスクリプションまたはサーバー情報が前提
画面とスイッチ

画面の入口と接続全体のモード

モードは設定に基づいて接続を振り分けるかどうかを決め、接続スイッチは接続を確立するかどうかを決めます。それぞれ個別に確認してください。

画面とスイッチ

Home

サーバー項目、現在の選択内容、接続スイッチを確認する主な画面です。リストに項目があっても、情報が保存されていることを示すだけで、接続が確立したとは限りません。初めて使うときは、選択中のサーバーを確認してから接続スイッチを操作し、システムの通知と実際の接続結果も確認してください。

画面とスイッチ

Global Routing

接続全体の処理方法を選ぶモードです。設定、プロキシ、直接接続は、それぞれConfig / Proxy / Directに対応します。ルールが適用されない場合は、まずConfigが選択されているか確認し、その後ルールの内容を確認してください。モードを変更してもサーバー設定は自動修正されず、接続確認の代わりにもなりません。

画面とスイッチ

Config

Global Routingのモードとして選択すると、現在有効な設定内のルールに基づいてポリシーが選択されます。設定ファイルを管理するConfig画面と同じ名称ですが、意味は文脈によって異なります。このモードを選んだ後、どの設定が有効か、想定するRuleが含まれているかも確認してください。

画面とスイッチ

Proxy

Global Routingのプロキシモードです。主に現在選択中のプロキシで接続を処理するため、Configモードとの比較や切り分けに使えます。プロトコルの種類ではなく、現在のサーバーが利用できることを保証するものでもありません。Proxyでは接続できてConfigでは失敗する場合、サーバー情報をすべて入力し直す前に、適用されたルールとポリシーの選択を確認してください。

画面とスイッチ

Direct

Global Routingの直接接続モードです。現在のネットワークから接続先へ直接接続します。ルールに記載される大文字のDIRECTとは階層が異なり、前者は接続全体のモード、後者は個々のルールで実行されるポリシーです。比較テストでは接続先とローカルネットワークを変えずに試すと、違いがどの階層で生じたかを判断しやすくなります。

画面とスイッチ

On Demand

設定したネットワーク条件に応じて接続動作を開始する機能です。Wi-Fiとモバイル通信の切り替えなどに利用できます。接続するタイミングを決める機能であり、ドメインごとにPROXYまたはDIRECTを選ぶものではありません。手動で切断しても再び接続される場合は、スイッチを繰り返し操作するだけでなく、On Demandの条件と現在のネットワークを確認してください。

画面とスイッチ

Connectivity Test

接続状態を確認する診断機能です。結果はテスト方法、接続先、現在のネットワークによって変わります。レイテンシはテスト時の応答時間を示すもので、継続的な通信速度とは異なります。また、テストに成功してもすべてのWebサイトにアクセスできるとは限りません。タイムアウトが発生した場合は、プロトコル設定、システム時刻、実際の接続結果をあわせて確認してください。

プロトコル

サーバーとの接続方式

プロトコルは、クライアントとサーバーが共通して使用する通信方式です。既存のサーバー情報を使う場合は、アドレスとポートだけでなく、プロトコル、認証、トランスポートの設定もまとめて確認してください。

プロトコル

Shadowsocks

共有鍵と暗号化方式を使うプロキシプロトコルです。接続する双方で互換性のある設定が必要です。入力時はサーバーアドレス、ポート、パスワード、暗号化方式を確認してください。追加のトランスポート設定を使う場合も、元の情報と一致させる必要があります。名称が似ているからといって暗号化方式を置き換えないでください。設定が一致しないと接続に失敗することがあります。

プロトコル

VMess

ユーザー識別情報などを使って認証するプロキシプロトコルで、複数のトランスポート方式と組み合わせて使用できます。アドレスとポートに加え、ユーザー識別情報、トランスポートの種類、TLS関連の設定も確認してください。既存のサブスクリプションを正常に読み込める場合は、手動で変更してHostやパスなどの関連項目を見落とす前に、読み込み結果と元の情報を照合してください。

プロトコル

VLESS

比較的シンプルな認証方式を採用するプロキシプロトコルです。認証方式とトランスポートのセキュリティは分けて考えてください。VLESS自体は通信全体の暗号化を保証せず、実際の接続には対応するセキュリティとトランスポートの設定も必要です。VMessの項目をVLESSに変更してすべての設定をそのまま使うのではなく、ユーザーが持っているサーバー情報を基準にしてください。

プロトコル

Trojan

通常はTLS接続内でプロキシデータを転送し、パスワードで認証します。確認時は、接続アドレス、TLS検証に使うサーバー名、パスワードを区別してください。それぞれ役割が異なります。証明書の検証に失敗した場合は、サーバー名、システム時刻、サーバー証明書を優先して確認し、検証を無効にする方法を通常の解決策にしないでください。

プロトコル

Hysteria2

QUICベースのプロキシプロトコルで、接続状況はネットワークがUDPに対応しているかどうかに左右されます。認証情報、TLSパラメータ、サーバーから指定された関連オプションをそろえて入力してください。ネットワークを切り替えると結果が大きく変わる場合は、まずネットワークごとの差を記録してから切り分けてください。プロトコル名だけで速度や安定性を判断することはできません。

プロトコル

WireGuard

公開鍵と秘密鍵を使い、接続先の設定とあわせて暗号化トンネルを構築するプロトコルです。パスワードだけを入力するサーバー項目とは、設定の構成が異なります。鍵、エンドポイント、トンネル関連の設定をまとめて確認してください。公開鍵を通常のパスワード欄に入力してはいけません。秘密鍵は機密情報です。設定の一部や診断記録を共有する前に、秘密鍵を隠してください。

ルールキーワード

照合条件とフォールバックルール

ルールの種類は「何を条件に照合するか」を示し、末尾のポリシーは「一致した後にどう処理するか」を示します。以下のアドレスとドメインは構文の例であり、サーバーやサブスクリプションの提供元ではありません。

ルールキーワード

DOMAIN

ドメインを完全一致で照合します。例:DOMAIN,example.com,PROXY。このルールはexample.comに一致しますが、サブドメインまで自動的に含むわけではありません。ドメイン全体を対象にする場合はDOMAIN-SUFFIXを検討し、より上にあるルールが先に一致しないか確認してください。

ルールキーワード

DOMAIN-SUFFIX

指定したドメインとそのサブドメインに一致します。例:DOMAIN-SUFFIX,example.com,PROXY。ドメイン階層の境界に基づいて照合し、似た文字列がどこかに含まれるかを検索するものではありません。同じドメイン範囲に共通のポリシーを指定する場合に便利です。特定のサブドメインを例外にする場合は、より詳細なルールを先に配置してください。

ルールキーワード

DOMAIN-KEYWORD

ドメイン名に指定した文字列が含まれるかどうかで照合します。例:DOMAIN-KEYWORD,ads,REJECT。文字列が完全なドメイン階層を構成する必要はないため、意図しないドメインにも一致することがあります。短いキーワードを使う場合は特に、文字列が似ているだけのドメインまで対象になっていないか、照合記録を確認してください。

ルールキーワード

GEOIP

IP地理データベース上の地域分類に基づいて照合します。例:GEOIP,CN,DIRECT。データベースの分類はデバイスの実際の所在地を示すものではなく、サイト運営者の所在地も表しません。接続先がCDNを利用している場合や名前解決の結果が変わった場合は、照合結果も変わることがあります。切り分け時は実際の接続先IPを確認してください。

ルールキーワード

IP-CIDR

IPv4アドレスとプレフィックス長でネットワーク範囲を指定し、接続先アドレスを照合します。例:IP-CIDR,192.168.0.0/16,DIRECT。スラッシュの後の数字はネットワーク範囲を表し、サーバーのポート番号ではありません。ローカルネットワーク向けのルールを作成する前に実際のネットワーク範囲を確認し、意図しない接続まで対象にしないようにしてください。

ルールキーワード

IP-CIDR6

IPv6アドレス範囲を対象にする照合キーワードです。例:IP-CIDR6,2001:db8::/32,DIRECT。このアドレスはドキュメント用の例です。IPv4とIPv6は別々に確認してください。IPv4ルールがあっても、IPv6接続に一致するとは限りません。同じドメインでも処理結果が異なる場合は、実際に使われているアドレスの種類を確認してください。

ルールキーワード

USER-AGENT

User-Agent情報を取得できる場合に、その内容に基づいて照合するルールキーワードです。すべてのアプリで利用できる識別方法ではなく、暗号化されたリクエスト内の関連情報が常に見えるとは限りません。ルールに一致しない場合は、まずリクエストから利用可能な情報を取得できるか確認し、その後で条件が正しいか判断してください。

ルールキーワード

FINAL

それまでのルールに一致しなかった接続に、最終的なポリシーを指定します。例:FINAL,PROXY。通常はRule一覧の末尾に置き、ドメインやネットワーク範囲の条件を追加する必要はありません。FINALを具体的なルールより前に配置すると、後続のルールが照合されなくなる場合があります。設定を確認するときは順序も重要です。

ポリシーと判定順序

ルールに一致した後の処理

大文字のPROXY、DIRECT、REJECTはルールのポリシーです。Global Routingの画面上のモードと混同しないでください。

ポリシーと判定順序

PROXY

ルールに一致した接続をプロキシ経由で処理します。実際の接続先は、現在選択中のプロキシと設定によって異なります。PROXYは処理の方向を示すだけで、サーバーアドレス、認証情報、利用可能性を保証するものではありません。ログにPROXYの一致が記録されても接続できない場合は、選択中のサーバー、プロトコル設定、接続状態を確認してください。

ポリシーと判定順序

DIRECT

ルールに一致した接続を、プロキシサーバーを経由させず接続先へ直接つなぎます。DNSを省略するという意味ではなく、現在のローカルネットワークから必ず接続できるという意味でもありません。直接接続に失敗し、プロキシ経由なら接続できる場合は、ルールの順序だけで原因を説明しようとせず、ローカルネットワーク、名前解決の結果、接続先の状態を確認してください。

ポリシーと判定順序

REJECT

ルールに一致した接続を拒否します。明確に不要なリクエストを遮断する場合に使います。接続先のタイムアウトとは異なり、REJECTはポリシーによる明示的な拒否です。通常の機能に影響が出た場合は、まず一致した拒否ルールを特定し、条件を絞るか例外を調整してください。すべてのルールを一度に削除するのは避けてください。

ポリシーと判定順序

最初に一致したルール

ルールは上から順に確認され、最初に条件を満たしたルールで接続ポリシーが決まります。通常、それ以降のルールは選択に使われません。ルールが「より詳細」であっても自動的に優先されるわけではなく、配置順も重要です。実際の設定では、明確な例外を先に置き、次に範囲を指定するルールを並べ、最後にFINALで補完します。

サブスクリプションと設定ファイル

情報の取得元、設定、名前解決

サーバー情報は「どこに接続するか」を、設定は「どのように処理するか」を示します。読み込みが完了した後も、現在の選択内容、有効な設定、実際の接続状態を確認してください。

サブスクリプションと設定ファイル

サブスクリプション

URL経由で、ユーザーがすでに持っているサーバー項目を取得・更新する方法です。リンクはユーザー自身がサービス提供元から取得します。サブスクリプションURLにはアクセス情報が含まれる場合があるため、機密情報として扱い、公開スクリーンショットに表示しないでください。サーバー一覧の更新とConfig内のルール更新は別の操作です。それぞれ確認してください。

サブスクリプションと設定ファイル

Subscribe

サブスクリプションの追加元を登録するときに使う種類です。URL欄には、アカウント管理ページではなく、ユーザーがすでに持っている完全なサブスクリプションURLを入力します。例:https://example.com/sub?token=xxxx。形式を示すだけのため、接続には使えません。保存後、想定したサーバー項目が追加されているか、コピー時に空白が入ったりクエリパラメータが欠けたりしていないか確認してください。

サブスクリプションと設定ファイル

Config設定ファイル

接続動作とルールをまとめた設定テキストです。一般的なセクションには[General]、[Rule]、[Host]、[URL Rewrite]があります。セクションごとに役割が異なるため、ルールは該当する場所に記述し、ファイル末尾に任意で追加しないでください。読み込み後は現在有効な設定を確認し、変更前に元の設定を保存しておくと比較や復元に役立ちます。

サブスクリプションと設定ファイル

DNS

ドメイン名をIPアドレスに変換する仕組みです。多くのネットワーク接続を確立する前に行われます。名前解決の成否や返されるアドレスは接続先に影響し、IPベースのルール判定にも関係する場合があります。ドメインに接続できないときは、複数の設定を一度に変更せず、名前解決の問題とプロキシ接続の問題を分けて確認してください。

サブスクリプションと設定ファイル

URL Rewrite

条件に応じてリクエストURLを処理する設定項目です。接続先を選ぶRuleとは役割が異なります。書き換えが有効になるかどうかは、リクエストが条件を満たすか、必要な情報を処理できるかによって変わります。暗号化されたリクエストをすべて書き換えられるとは限りません。直接接続かプロキシ経由かだけを変更する場合は、書き換えルールを追加するのではなく、まずRuleを確認してください。

順番に操作する必要がある場合は、使い方ガイドをご覧ください。ルールの結果が想定と異なる場合は、まず現在の設定と一致記録を保存してから、項目ごとに調整してください。