Official Manual / Defined Terms

Shadowrocketの用語解説

画面上の場所や設定の役割から用語を確認できます。画面表示や構文は英語のまま掲載し、日本語で意味や適用範囲、混同しやすい点を解説します。

モード・条件・動作を区別する

ProxyとPROXYは別の意味

Global RoutingのProxyはグローバルモードです。一方、ルール行末のPROXYは処理ポリシーです。前者は全体のルーティング方法を決め、後者はルールに一致したリクエストの処理方法を指定します。問題を調べる際は、まずモードを確認し、その後にルールの順序と最終ポリシーを確認してください。

この用語集は、サブスクリプションやサーバー情報をすでにお持ちであることを前提としています。クライアントの買い切り購入と接続サービスのプランは別です。サイトではサーバー情報やサブスクリプションを提供、販売、推奨していません。ShadowrocketはAppleプラットフォーム向けの有料アプリです。入手・購入については、先にApp Storeで正規アプリを確認する方法をご覧ください。

01 / Interface

画面とスイッチ

まず現在の画面を確認し、操作がサーバー情報、ルーティングモード、接続状態のどれを変更するのか見極めましょう。

画面とスイッチ

Home

登録済みサーバー、選択中のサーバー、接続状態の確認に使います。一覧に記録が表示されても、情報が保存されたことを示すだけで、接続が確立したとは限りません。初回は入門ガイドに沿って、読み込み、選択、システムの許可を順に進めてください。

画面とスイッチ

Add Server

登録済みサーバーの情報を手動で入力する画面です。まずプロトコルの種類を選び、対応する項目を入力します。アドレス、ポート、認証情報、通信方式、TLS設定は、お手元のサーバー情報に従ってください。表示名を変更しても、接続パラメータの誤りは解消されません。

画面とスイッチ

Global Routing

グローバルルーティングのモードを選択します。一般的な選択肢はConfig、Proxy、Directです。リクエスト全体の処理方法を決めるもので、サーバーのプロトコルを選ぶ項目ではありません。特定のルールを確認する前に、現在Configが選択されているか確かめてください。

画面とスイッチ

Config

Global RoutingのConfigは、現在有効な設定ファイル内のルールに従ってリクエストを処理します。同じリクエストでも、ルールの順序、名前解決の結果、ポリシーによって経路が異なる場合があります。このモード名は設定ファイルを管理するConfig画面と同じなので、手順を読む際は画面上の位置を確認してください。

画面とスイッチ

Proxy

Global Routingでリクエストをプロキシ経由で処理するモードです。現在のプロキシ接続が使えるか確認するときによく利用します。デバイス上のすべての通信が必ず同じ経路を通るとは限りません。システム通信や関連設定には処理範囲の制約があります。また、単一ルールで使う大文字のPROXYとも異なります。

画面とスイッチ

Direct

Global Routingでリクエストを直接接続で処理するモードです。Directの選択と接続スイッチをオフにする操作は異なります。前者はルーティング方法を、後者は接続状態を変更します。問題を調べる際は選択中のモードを記録し、モード変更による結果の変化をサーバーの変更と取り違えないようにしてください。

画面とスイッチ

On Demand

システムやアプリで設定した条件に応じて接続動作を開始する仕組みです。接続を試みるタイミングを決めるもので、サブスクリプションの有効性を判断したり、各ウェブサイトへのアクセスを常時確認したりする機能ではありません。有効にした後で接続が再確立される場合は、手動で何度も切断する前に関連条件を確認してください。

02 / Protocols

プロトコル

プロトコル名は通信方式を示すもので、速度のランクを表すものではありません。読み込み時は認証、通信方式、セキュリティ層の設定も確認してください。

プロトコル

Shadowsocks

プロキシプロトコルの一つです。一般的な設定項目にはサーバーアドレス、ポート、パスワード、暗号化方式があります。暗号化方式はサーバー側の設定と一致させてください。名前が似ていても別の方式に置き換えることはできません。追加の通信パラメータが指定されている場合は、それらも確認してください。パスワードだけを確認しても不十分です。

プロトコル

VMess

UUIDなどでユーザーを識別するプロキシプロトコルです。UUID、通信方式、TLSはそれぞれ別の項目です。一つが正しくても設定全体が揃っているとは限りません。接続できない場合は、デバイスの時刻が正確か、サーバーから指定されたパスとホスト名が合っているかも確認してください。

プロトコル

VLESS

UUIDでユーザーを識別するプロキシプロトコルです。ペイロード自体は暗号化しないため、実際の通信方式やセキュリティ設定と併せて理解する必要があります。種類名を変更するだけでVMessと相互に置き換えられるわけではありません。登録済みサーバーを追加する場合は、UUID、通信方式、サーバー名、関連するセキュリティ設定を資料に照らして一つずつ確認してください。

プロトコル

Trojan

通常はTLSと組み合わせ、パスワードで認証するプロキシプロトコルです。パスワードのほか、接続先アドレス、TLSのサーバー名、証明書が一致しているか確認してください。証明書の検証に失敗した場合は、検証を無効にするのではなく、まずサーバー名とデバイスの時刻を確認してください。

プロトコル

Hysteria2

QUICをベースとし、通信にUDPを使用するプロキシプロトコルです。接続の確立や実際の動作は、UDPの到達性、ネットワークの混雑、サーバーのリソース、各種パラメータの一致状況によって変わります。プロトコル名だけで低遅延や高スループットが保証されるわけではなく、実際のネットワーク環境でのテストが必要です。

プロトコル

WireGuard

公開鍵と秘密鍵で通信相手を識別するVPNプロトコルです。パスワードやUUIDを中心とするプロトコルとはパラメータの構成が異なります。エンドポイント、鍵、トンネルアドレス、ルーティング範囲を、手元の設定に合わせて確認してください。秘密鍵は機密情報です。調査用の情報を共有する際は削除してください。

03 / Match & Policy

ルールキーワードとポリシー

ルールの前半は照合条件、末尾は処理動作を示します。キーワードの大文字・小文字やカンマの構造を保ち、変更前に現在の設定をバックアップしてください。

ルールキーワードとポリシー

Rule

ルールはリクエストの特徴と処理ポリシーを関連付けます。設定ファイルでは通常、[Rule]セクションに記述します。一般に上から順に照合され、前のルールが後続ルールの適用機会に影響します。結果を確認する際は、ドメインの有無だけでなく条件、順序、ポリシーも確認してください。

ルールキーワードとポリシー

DOMAIN

指定したドメインに完全一致します。たとえばDOMAIN,example.com,DIRECTのように記述します。この条件はwww.example.comなどのサブドメインを自動的には含みません。ドメインとサブドメインの両方を対象にする場合は、DOMAIN-SUFFIXの照合範囲を理解してから書き方を選んでください。

ルールキーワードとポリシー

DOMAIN-SUFFIX

指定したドメインとそのサブドメインに一致します。たとえばDOMAIN-SUFFIX,example.com,PROXYのように記述します。ドメインのサフィックス境界で判定されるため、文字列がどこかに含まれるだけでは一致しません。特定のサブドメインに別のポリシーを適用する場合は、範囲の広いルールより前に個別ルールを置いてください。

ルールキーワードとポリシー

GEOIP

宛先IPの地理情報データベース上の分類結果に基づいて照合します。分類結果はデータベースの更新、アドレスの割り当て、名前解決の結果によって変わる場合があります。サーバーの物理的な所在地をリアルタイムに測定するものではありません。ドメインルールとGEOIPの結果が異なる場合は、ルールの順序と実際の宛先IPを併せて確認してください。

ルールキーワードとポリシー

IP-CIDR

IPv4アドレス範囲に一致します。たとえばIP-CIDR,192.168.0.0/16,DIRECTのように記述します。スラッシュ後のプレフィックス長はアドレス範囲を指定するもので、サーバーのポートではありません。IPv6アドレス範囲にはIP-CIDR6を使います。設定時はアドレスファミリーを区別し、IPv4のルールをそのまま流用しないでください。

ルールキーワードとポリシー

FINAL

それ以前のルールに一致しなかった場合に適用するフォールバックルールです。たとえばFINAL,DIRECTのように記述します。通常はルール一覧の末尾に置きます。途中に置くと、後続のルールが照合されない場合があります。FINALの後に指定したポリシーは、分類されていないリクエストの行き先を決めるもので、設定全体のすべてのリクエストに適用されるわけではありません。

ルールキーワードとポリシー

PROXY

ルール行で使うプロキシポリシーの識別子です。一致したリクエストを対応するプロキシ経由で処理します。サーバーを作成したり、不足している認証情報や通信パラメータを補ったりするものではありません。Global RoutingのProxyモードとは異なり、PROXYは個別ルールの処理結果です。現在のモードと選択中のプロキシを併せて確認してください。

ルールキーワードとポリシー

DIRECT

ルール行で使う直接接続ポリシーの識別子です。一致したリクエストをプロキシサーバー経由で転送しません。ただし、ローカルネットワーク、接続先サービス、関連する名前解決設定の影響は受けるため、直接接続でも失敗する場合があります。DIRECTはShadowrocketを終了することでも、ほかのルールを無効にすることでもありません。

ルールキーワードとポリシー

REJECT

ルールに一致したリクエストを拒否します。たとえばDOMAIN,example.com,REJECTのように記述します。リクエストを処理するもので、ページ上の表示要素を削除する機能ではありません。また、同じドメインで提供されるすべてのコンテンツを個別に判別できるわけではありません。条件が広すぎると、ログインや画像など、正常な機能にも影響する場合があります。

04 / Subscription & Config

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

サーバー情報は接続先を示し、設定ファイルは処理方法を定めます。同じ資料から両方を読み込む場合でも、それぞれの役割を分けて確認してください。

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

Subscribe

ユーザーがすでに持っているサブスクリプションURLからサーバー情報を読み込み、更新する仕組みです。読み込める内容は、URLから返される形式によって異なります。更新に成功しても、読み込みや解析が完了したことを示すだけで、すべてのサーバーに接続できるとは限りません。サブスクリプションURLには認証情報が含まれる場合があるため、公開しないでください。アプリの購入状態とサブスクリプションの有効性は別々です。

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

Server

接続に使うサーバー設定のまとまりで、通常はアドレス、ポート、プロトコル、認証情報を含みます。表示名だけでは、実際の所在地、利用可能な状態、通信品質は判断できません。問題を調べる際は、名前から設定を推測せず、お手元の元情報と各項目を照合してください。

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

設定ファイル

処理オプションやルールを保存するテキストファイルです。一般的なセクションには[General]、[Rule]、[Host]、[URL Rewrite]があります。サーバーサブスクリプションとは別のもので、サーバーを読み込んだ後も、どの設定ファイルが使われているか確認してください。編集前に復元用のコピーを保存し、同じ名前の別ファイルではなく、現在有効なファイルを編集していることを確かめましょう。

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

Scan QR Code

QRコードから対応するサーバー情報やサブスクリプション情報を読み込む画面です。QRコードはデータを格納する手段にすぎず、読み込めるかどうかは内部の内容や形式によります。画像であれば何でも接続情報として認識されるわけではありません。読み込み後は種類と重要な項目を確認し、パスワードやサブスクリプションの認証情報を含むQRコードを共有しないようにしてください。

05 / Settings & Diagnostics

設定項目

テスト値、ログ、同期はそれぞれ異なることを確認する機能です。設定を変える際は一度に一項目だけ変更し、変更前後の状態を記録してください。

設定項目

Settings

アプリの設定をまとめて管理する画面です。実際の項目はデバイス上の画面で確認してください。アプリ全体の設定と設定ファイル内のパラメータは異なる階層にあり、名前が似ていても同じ範囲に適用されるとは限りません。変更前に現在の値を記録してください。設定の引き継ぎ関係が分からない場合は、操作前にSettingsの設定項目ガイドを確認しましょう。

設定項目

DNS

ドメイン名をIPアドレスに変換する仕組みです。設定内のdns-server = systemは、システムの名前解決サーバーを使うことを示します。名前解決の成功とウェブサイトへの接続成功は別の段階です。その後もルール、接続、接続先サービスの影響を受ける場合があります。DNS設定を変更する前に、問題が名前解決と接続確立のどちらで起きているか確認してください。

設定項目

Connectivity Test

指定した方法で到達可能性を調べるツールです。結果はテスト対象と方法に照らして判断してください。表示される所要時間はダウンロード速度ではなく、アプリのすべての通信が正常に動作する保証にもなりません。比較する際はネットワークとテスト条件を揃え、テストに失敗した場合は実際のリクエストとログも照合してください。

設定項目

Log

接続、名前解決、ルール処理の手がかりを確認するログです。問題を調べる際は、まず操作を一度だけ明確に再現し、時刻と宛先をもとに該当する記録を探してください。異なるリクエストの結果を混同しないように注意しましょう。ログにはアクセス先のドメイン、サーバーアドレス、認証情報が含まれる場合があります。外部に共有する前に機密情報を削除してください。

設定項目

URL Rewrite

マッチ式と指定したアクションに従ってURLを処理する設定機能です。通常は[URL Rewrite]セクションに記述します。リクエストのルーティングを決めるRuleとは役割が異なり、同じ照合方法で置き換えることはできません。暗号化されたリクエストで確認できる情報や追加設定の要否は、実際の操作によって異なります。すべてのリクエスト内容を読み取れると考えないでください。

設定項目

iCloud同期

条件を満たすデバイス間で、アプリが対応するデータをiCloud経由で同期します。システムアカウント、iCloudのアクセス権、アプリ内の設定を併せて確認してください。同期は変更履歴をすべて保存するバックアップではなく、誤って削除した内容も同期される場合があります。デバイスを変更する前に必要な設定を別途保存し、新しいデバイスでサーバー情報と有効な設定を確認してください。