[Glossary]公式マニュアル · 用語ガイド

Shadowrocket 用語集

画面上の場所や設定の用途から用語を探せます。まず、表示されているものがスイッチ、プロトコル、ルールキーワードのどれかを確認し、次にパラメータを照合してください。同じ英語でも、表示される場所によって意味が異なる場合があります。

画面表示は英語のまま ルールキーワードは大文字・小文字を区別 例示ドメインは利用可能なサービスを示すものではありません

[Interface]

画面表示とスイッチ

画面名とルーティングモードを区別しましょう。Global Routingの「設定」「プロキシ」「直接接続」は、それぞれConfig、Proxy、Directに対応します。Configは設定ファイルを管理する画面を指す場合もあります。

Home
サーバー項目の確認、接続先の選択、接続の制御を行う画面です。リストに項目が表示されているのは情報が保存されていることを示すだけで、認証、名前解決、接続が成功したという意味ではありません。初めて使う場合は、選択中の項目を確認してから、接続スイッチとシステムに表示される接続状態を確認してください。
Global Routing
リクエスト全体のルーティング方法を決める設定です。Configは設定に従ってリクエストを処理し、Proxyはプロキシモード、Directは直接接続モードを使用します。サーバープロトコルを選択する設定ではありません。特定のルールが反映されないように見える場合は、まずConfigが選択されているかを確認し、その後ルールの順序を確認してください。
Config
Global Routingの選択肢として使われる場合は、現在の設定にあるルールと各種設定に従ってリクエストを処理します。画面名としては、設定ファイルを管理、選択、編集する場所を指します。そのため、「Configを読み込んだ」ことと「Configでルーティングしている」ことは同じではありません。ファイルを変更した後は、名前が似た別のコピーではなく、そのファイルが現在選択されていることを確認してください。
Proxy
Global Routingのプロキシモードでは、対象となるリクエストを現在のプロキシで処理します。システムや設定で指定された除外範囲も考慮してください。サーバーアドレス、パスワード、転送パラメータが自動で補われるわけではなく、選択したサーバーへの接続が保証されるわけでもありません。画面のProxyとルール内の大文字のPROXYは、それぞれの表示場所に応じて解釈してください。
Direct
Global Routingの直接接続モードでは、対象となるリクエストを現在のネットワークから接続先へ直接送信します。問題がプロキシ経由の場合に限られるかを比較するのに役立ちますが、切り替え後に接続できても、元のサーバーパラメータがすべて正しいとは限りません。直接接続も、現在のネットワーク、DNS、接続先サービスの状態に依存します。
Add Server
サーバー情報を手動で追加する画面です。操作前に、利用中のサービスから提供されたサーバーパラメータを用意してください。正しいプロトコルを選択し、SERVER、ポート、認証、転送関連の項目を順に入力します。同じ名前の項目でも、プロトコルが異なれば相互に置き換えられるとは限りません。保存できたことは項目が作成されたことを示すだけなので、その後に疎通テストを行ってください。
Connectivity Test
項目の疎通を確認するテスト機能です。結果はテスト方法、接続先アドレス、現在のネットワーク環境によって異なります。表示される所要時間は実際のダウンロード速度ではありません。テストに成功しても、すべてのウェブサイト、UDPリクエスト、長時間接続が正常に動作するとは限りません。調査時はテスト方法を記録し、実際のアクセス結果やLogとあわせて判断してください。

[Settings]

Settingsの項目

設定によって、名前解決、接続の開始、テスト、記録などの動作が変わります。ここでは各項目の概念を説明します。すべてのプラットフォームでメニューの場所や初期値が同じとは限りません。具体的な設定値は、使用中の画面や設定ファイルと照らし合わせてください。

DNS
ドメイン名をIPアドレスに変換する仕組みで、多くの接続を開始する前に必要です。名前解決の失敗とプロキシ認証の失敗は別の問題であり、通常、プロキシのパスワードを変更しても名前解決エラーは解消しません。確認時は、名前解決サーバー、DNSリクエストの経路、応答されたアドレスが想定どおりかをそれぞれ調べてください。複数の設定を同時に変更すると比較できなくなるため、一つずつ確認しましょう。
On Demand
設定した条件に応じて接続を開始する仕組みです。「どんな状況でも常に接続を維持する」という意味ではありません。トリガー条件、システムの状態、ネットワークの変化によって実際の動作が変わります。手動で切断した後に再接続するかどうかも、現在の設定に基づいて確認してください。変更後は、該当するWi-Fi、モバイル通信、ネットワーク切り替えの各状況でテストし、スイッチがオンかどうかだけで判断しないでください。
Ping
設定やテストの説明で、疎通確認に関連する項目を指すことがあります。具体的な意味は、現在のテスト方法によって異なります。ミリ秒で表示される結果をすべて同じICMP往復時間とみなしたり、帯域幅に換算したりしないでください。項目を比較するときは、テスト方法、接続先、ネットワーク環境をできるだけそろえてください。
Log
接続の問題を調べる際に利用する記録で、名前解決、接続の確立、認証、プロトコルネゴシエーションのどの段階で問題が起きたかを切り分けるのに役立ちます。まず障害を再現してから、発生時刻に近い記録を確認してください。過去のエラーを現在の原因と取り違えないようにしましょう。共有する前に、サブスクリプションURL、認証情報、サーバーの非公開情報、個人のアクセス状況を特定できる内容を削除してください。
iCloud同期
対応するAppleデバイス間で、アプリがサポートするデータをiCloud経由で同期します。同期できる範囲は、現在のアプリ設定によって異なります。接続状態をリアルタイムに引き継ぐ機能ではなく、復元できることを確認済みの独立したバックアップの代わりにもなりません。機種変更後は、サーバー項目、選択中の設定、同期状態を一つずつ確認してください。確認が終わる前に旧デバイスのデータを削除しないようにしましょう。

[Protocol]

プロトコル

プロトコル名は接続方式を識別するためのもので、サービスの品質や初期設定を示すものではありません。以下は、利用者がすでにサーバー情報を持っていることを前提に説明しています。読み込み後も、プロトコル、認証、セキュリティ層、転送方式が一致しているか確認してください。

Shadowsocks
プロキシプロトコルの一つです。一般的な設定項目は、サーバーアドレス、ポート、パスワード、暗号化方式です。暗号化方式とパスワードはサーバー側の設定に合わせる必要があります。名前を変更しただけではプロトコルの動作は変わりません。既存の設定に追加の転送パラメータが含まれている場合は、その内容も元の情報と照合してください。アドレスとポートだけをコピーしても、設定が完了したとは限りません。
VMess
ユーザーIDなどを使って認証するプロキシプロトコルです。一般的な設定には、転送方式やTLSの設定も含まれます。サーバーアドレス、ユーザーID、トランスポート層のパラメータはそれぞれ役割が異なり、互いに置き換えることはできません。接続できない場合は、端末の時刻が正確かどうかも確認し、元の設定情報と照らし合わせながら項目ごとに調べてください。
VLESS
プロキシプロトコルの一つです。ユーザーID、転送方式、セキュリティ層の設定を個別に確認する必要があります。VLESSという名称だけからTLSの有無を判断したり、別の転送方式のパスやHostをそのまま流用したりしないでください。読み込み後に項目は表示されるものの接続できない場合は、元の設定にある認証情報と転送関連の項目を優先して照合してください。
Trojan
通常TLSで通信を保護するプロキシプロトコルです。パスワード、サーバーアドレス、ポート、SNIなどを確認してください。SNIはTLSハンドシェイクでサーバー名を示すための情報で、接続先アドレスと常に同じとは限りません。利用中のサービスから提供されたパラメータに従って入力してください。証明書エラーが発生した場合は、名前、システム時刻、証明書の設定を確認してください。Allow Insecureを通常の解決策として使わないでください。
HTTP / SOCKS5
異なる2種類のプロキシプロトコルで、認証、接続先への接続方法、転送機能が異なります。HTTPプロキシはCONNECTでトンネルを確立できますが、プロトコル名だけでクライアントとプロキシサーバー間の通信が暗号化されているとは判断できません。追加時は、サーバーがどちらのプロトコルを提供しているかを確認し、認証方式と別途TLSが必要かどうかを照合してください。
WireGuard
鍵認証を使用し、UDPで通信するトンネルプロトコルです。設定には鍵、エンドポイント、アドレス、ルーティングなどの情報が必要です。鍵の項目を一般的なユーザー名やパスワードと同じように扱わないでください。秘密鍵を公開スクリーンショットやログに含めることも避けてください。調査時は、エンドポイントのドメイン名だけでなく、UDPの到達性、鍵のペア、トンネル内のアドレスとルーティングも確認しましょう。
Hysteria2
QUICベースのプロキシプロトコルです。接続の確立とデータ転送には、現在のネットワークでUDPが利用できることが必要です。読み込み時は、サーバー側の認証、ポート、TLSなどの設定を一致させてください。プロトコル名だけでは具体的なパラメータを補えません。あるネットワークで失敗し、別のネットワークでは正常な場合は、ネットワーク環境も含めて調べてください。パスワードを何度も変更するだけで原因を判断しないようにしましょう。

[Rule]

ルールキーワード

ルールは通常、上から順に照合され、最初に一致したルールのポリシーが適用されます。各行では、照合タイプ、条件、ポリシーの順に確認してください。ドメインルールとIPルールでは、照合に必要な情報が異なります。

DOMAIN
指定したドメイン名に完全一致させるルールキーワードです。例:DOMAIN,example.com,DIRECT。このルールはwww.example.comには自動で適用されません。こちらは別のドメインです。単一の完全なドメイン名だけにポリシーを適用したい場合は、対象範囲が明確なこの照合方法を検討してください。
DOMAIN-SUFFIX
ドメインの末尾を基準に、指定したドメインとそのサブドメインに一致させます。例:DOMAIN-SUFFIX,example.com,PROXY。example.comとapi.example.comには適用されますが、任意の文字列を含むドメインに一致するわけではありません。特定のサブドメインを例外にする場合は、対象範囲の広いこのルールより前に、より具体的なルールを配置してください。
DOMAIN-KEYWORD
ドメイン名に指定した文字列が含まれるかどうかで照合します。例:DOMAIN-KEYWORD,example,PROXY。完全一致やドメイン末尾のルールより広い範囲に一致し、関連のないドメインにも適用される可能性があります。使う前に、文字列で照合したいのか、特定のドメインとそのサブドメインを対象にしたいのかを確認してください。
IP-CIDR
IPv4ネットワーク範囲で接続先アドレスを照合します。CIDR表記のスラッシュ以降の数字は、ネットワークプレフィックスの長さです。たとえばIP-CIDR,192.168.0.0/16,DIRECTは、このプライベートアドレス範囲に適用するポリシーを指定できます。ウェブサイト名ではなくIPアドレスを判定するため、リクエストに照合可能なアドレス情報があるかどうかも判定に影響します。
IP-CIDR6
IPv6ネットワーク範囲で接続先アドレスを照合します。IPv6アドレスに対応したプレフィックス表記を使います。IPv4のIP-CIDRルールがIPv6に自動で適用されることはありません。そのため、同じ接続先でもアドレスファミリーによって異なるルールに一致することがあります。「同じドメインなのに適用されるポリシーが変わる」場合は、名前解決結果に含まれるIPv4とIPv6の両方を確認してください。
GEOIP
IP位置情報データベース上の割り当て情報をもとに接続先アドレスを照合します。例:GEOIP,CN,DIRECT。データベース上の情報は、ユーザーの所在地、ウェブサイトの言語、運営者の所在地を示すものではありません。実際のサーバー配置の変更が反映されるまで時間差が生じる場合もあります。特定のドメインに安定した処理を適用したい場合、そのドメインの接続動作をGEOIPだけで判断しないでください。
FINAL
前のルールに一致しなかったリクエストに最終ポリシーを指定します。通常、ルール一覧の末尾に配置します。たとえばFINAL,PROXYは、残りのリクエストをPROXYで処理することを示します。最初のルールから照合し直すという意味ではありません。多くのリクエストがFINALに一致する場合は、前のルールの対象範囲や順序、想定した設定ファイルが選択されているかを確認してください。
PROXY / DIRECT / REJECT
ルールでよく使われるポリシー識別子です。プロキシポリシーに渡す、直接接続する、リクエストを拒否することをそれぞれ示します。ルールに一致した後の処理を表すもので、ShadowsocksやVLESSのようなプロトコル名ではありません。PROXYが実際にどの接続先を使うかは、現在のプロキシ選択と設定によって異なります。REJECTは明示的な拒否であり、それによる接続失敗をサーバーへの到達不能と取り違えないでください。

[Profile]

サブスクリプションと設定

サーバー項目は接続先を表し、設定ファイルは処理ルールを記述します。両者を混同しないでください。このサイトでは、利用者がすでに持っているサブスクリプションやサーバー情報の管理方法を説明します。接続先やサブスクリプションの提供、販売、推奨は行いません。

Subscribe
利用者がすでに持っているサブスクリプションURLからサーバー項目を取得・更新する機能です。URLは利用中のサービス提供元から取得してください。リンクにアカウントを特定する情報やアクセス権限を含むパラメータが入っている場合があるため、機密情報として管理し、公開しないでください。サブスクリプションの更新は通常、そのサブスクリプションが管理する項目を更新します。ルール設定全体や手動編集した内容まで同期されたとは限りません。
SERVER
サーバーアドレスの入力欄です。通常はドメイン名またはIPアドレスを入力し、別途指定するポートや認証情報とあわせて使用します。欄に完全なURLを入力するよう明示されていない限り、サブスクリプションURL、ウェブページのURL、パス付きURLをサーバーのドメイン名として入力しないでください。サーバー項目には通常、プロトコルなどの情報も必要です。SERVERの値だけでは接続を確立できません。
設定ファイル
[General]や[Rule]などの設定とルールを記述し、リクエストの処理方法を定めるファイルです。読み込んだだけでは、そのファイルが選択されたことにも、Global RoutingがConfigになっていることにもなりません。編集前に復元可能なコピーを保存してください。変更後は、ファイルを保存できたかだけでなく、対象のリクエストが想定どおりのルールに一致するかを確認しましょう。
URL Rewrite
条件に応じてリクエストURLを書き換えたり、対応する処理を実行したりする仕組みです。リクエストの接続経路を決めるルーティングルールとは別の層で動作します。DOMAIN-SUFFIXルールに一致しただけで自動的に有効になるわけではありません。HTTPSの通信内容を処理できるかどうかは、適用条件や証明書の信頼設定などにも左右されます。ルールの提供元と適用範囲を理解したうえで有効にしてください。通常の接続問題を解決するために、むやみに書き換えルールを追加しないでください。
購入済み項目
App Storeでアカウントの購入履歴を確認する画面です。Shadowrocketの購入履歴と再ダウンロードの可否を確認できます。iPhone / iPad版はApp Storeで$2.99の買い切りです。どちらのデバイスでも同じ購入アカウントの購入履歴を利用できます。Mac、Windows、Android、Linux版は無料です。再ダウンロードする際は、ストアで現在使用しているアカウントが購入時のアカウントと一致していることを確認し、ストアページに表示される利用可否を基準にしてください。

用語がわかっても接続できない場合は、よくある質問を参考に、名前解決、認証、ルール照合の問題を切り分けてください。設定を変更する場合は、Settings設定ガイドで項目を一つずつ確認してください。