公式マニュアル · 用語集

Shadowrocket 用語集

画面上の場所や設定の用途から用語を探せます。まず「どこで設定するか」を確認し、次に「何にマッチするか」「どう処理するか」を見分けましょう。英語表記は画面やルールファイルのまま掲載しています。

このページではShadowrocketの一般的な概念を解説します。各プラットフォームでの画面の場所は、実際のアプリで確認してください。サブスクリプションまたはサーバー情報をお持ちの場合は入門ガイドを、構文全体についてはルールリファレンスをご覧ください。

入手方法:iPhone / iPad版はApp Storeで$2.99の買い切りです。Mac(Appleシリコン・Intel)/ Windows / Android / Linux版は無料です。詳しくはダウンロードガイドをご覧ください。

画面とスイッチ

画面上の選択肢は現在の動作を決めます。タイトルケースの選択肢名と、大文字で表記されるルールポリシーを混同しないでください。

画面とスイッチ

Global Routing

通信全体の処理方法を決める項目です。主な選択肢はConfig、Proxy、Directです。Configでは現在の設定内のルールに従って通信先を決定し、ProxyとDirectでは全体の処理方向を切り替えます。ルールが機能しない場合は、まずConfigが選択されているか確認してください。

画面とスイッチ

Config

設定を管理する画面を指す場合と、Global Routingで選択する設定ベースの処理方法を指す場合があります。意味は表示場所によって異なります。設定画面でファイルを表示しただけでは、そのファイルが現在の設定として選択されたことにはなりません。Configを選んだ後、実際に有効な設定とRuleの内容も確認してください。

画面とスイッチ

Proxy

Global Routingで選択するプロキシ経由の処理方法です。通信全体をプロキシ経由にしますが、実際の動作はプラットフォームのネットワーク機構や設定にも左右されます。特定のプロトコルを指すものではなく、サーバー情報を自動で補う機能でもありません。画面上のProxyと、ルール末尾のPROXYは別の階層の項目です。

画面とスイッチ

Direct

Global Routingで選択する直接接続の処理方法です。問題がプロキシ経路に関係しているかを確認する際に使えます。Directを選んでもクライアントの接続スイッチはオフにならず、クライアントが引き続きネットワークを処理している場合があります。完全に停止した場合と比較するには、接続を別途オフにして、同じ接続先をテストしてください。

画面とスイッチ

On Demand

事前に設定した条件に応じて接続を開始し、手動操作を減らす仕組みです。接続を開始するタイミングを制御するもので、接続後の各リクエストの処理方法を決めるRuleとは役割が異なります。自動再接続の問題を調べる場合は、On Demandの条件とシステム上のVPN状態をあわせて確認してください。

画面とスイッチ

Connectivity Test

選択した経路で、特定のテスト条件下で接続できるかを確認します。結果はテスト方法、接続先、その時点のネットワーク状況によって変わるため、継続的なダウンロード速度を示すものではありません。テストに応答があってもWebページを開けない場合は、DNS、ルールの一致状況、接続先サービスの状態を引き続き確認してください。

プロトコル

プロトコルはクライアントとサーバー間の通信方法を定めます。名前が似ていたり同じポートを使ったりしても、パラメータを互換利用できるとは限りません。

プロトコル

Shadowsocks

クライアントとサーバー間のプロキシ通信を共通鍵暗号で保護するプロトコルです。設定時はサーバーアドレス、ポート、パスワード、暗号化方式をすべて一致させてください。UDPを利用できるかどうかは、サーバー設定と現在のネットワーク環境にも左右されます。

プロトコル

VMess

認証機能を備えたプロキシプロトコルです。接続情報には通常、ユーザー識別情報や通信関連の設定が含まれます。プロトコルパラメータ、通信方式、TLS設定はそれぞれ異なるため、サーバー側の設定に個別に合わせてください。認証に失敗した場合は、設定情報と端末の時刻を確認し、暗号化オプションをむやみに変更しないでください。

プロトコル

VLESS

認証と下位の通信保護を分けて扱うプロキシプロトコルです。名称だけで通信が暗号化されているとは判断できません。実際の保護方法は、組み合わせるセキュアな通信設定によって異なります。設定時はユーザー識別情報、通信方式、サーバーから提供されたセキュリティ情報を個別に確認してください。

プロトコル

Trojan

通常TLS上で動作するプロキシプロトコルです。認証情報と証明書の検証が、接続の成否に影響します。サーバーアドレスとTLS検証用の名前は、異なる役割を持つ場合があります。手元の接続情報に従って設定してください。証明書エラーが発生した場合は、名前、証明書の有効期限、端末の時刻を確認します。

プロトコル

Hysteria2

QUICベースのプロキシプロトコルです。下位の通信にUDPを使うため、パケットロス、帯域幅、ネットワーク制限の影響を受けます。遅延が大きい環境で必ず速くなるとは限りません。同じネットワークで実際の性能を比較してください。ハンドシェイクがタイムアウトする場合は、まずUDP通信が可能かを確認し、その後に認証情報とTLSパラメータを確認します。

プロトコル

WireGuard

UDPベースで、鍵ペアを使って通信相手を識別するトンネルプロトコルです。サーバーエンドポイントに加え、ローカルアドレス、相手側の公開鍵、許可するルーティング範囲を正しく設定してください。ハンドシェイクが成立しても通信できない場合は、ルーティングとDNSを確認します。秘密鍵は機密情報のため、公開スクリーンショットに含めないでください。

プロトコル

HTTP / SOCKS5

よく使われる2種類のプロキシプロトコル名で、Webアドレスのプレフィックスを選ぶ話ではありません。基本プロトコルだけでは、クライアントからプロキシサーバーまでの通信が暗号化されるとは限らず、保護の有無は追加のセキュリティ層によって決まります。SOCKS5でUDPを転送するには、サーバーとクライアントの双方が対応している必要があります。

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

ルールの前半でマッチ条件を指定し、末尾で処理ポリシーを指定します。以下のドメイン名やネットワーク範囲は構文説明用であり、接続情報ではありません。

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

Rule

マッチ条件と処理ポリシーを記述する設定部分です。テキスト上のセクション名は通常[Rule]と表記します。ルールは数が多いほど優先されるわけではなく、上から順に評価され、最初に一致したものが適用されます。通常は具体的な条件を広い条件より前に置き、末尾にFINALを設定します。

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

DOMAIN

完全なドメイン名に一致します。たとえばDOMAIN,example.com,DIRECTです。このルールはwww.example.comなどのサブドメインには自動で一致しません。特定のホスト名だけ経路を変更したい場合は、広いキーワードより完全一致のほうが確認しやすくなります。

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

DOMAIN-SUFFIX

指定したドメインとそのサブドメインに一致します。たとえばDOMAIN-SUFFIX,example.com,PROXYです。ドメインのサフィックス関係に基づいてマッチし、任意の文字列を含む条件とは異なります。同じドメイン階層のリクエストを共通のポリシーで処理する場合、ルールの重複を減らせます。

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

DOMAIN-KEYWORD

ドメイン名に指定したキーワードが含まれるかを確認します。たとえばDOMAIN-KEYWORD,ads,REJECTです。短いキーワードは意図しないドメインにも一致することがあるため、この例だけですべてをブロックできるわけではありません。誤って一致する場合は条件を絞るか、前により具体的な例外ルールを追加してください。

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

GEOIP

対象IPが使用中の地理情報データベースで分類されている地域に基づいてポリシーを選びます。Webページの言語や端末の地域は基準になりません。データベースの分類とサービスの実際の設置場所が異なる場合があり、ドメインの名前解決結果にも影響されます。特定のサービスに明確な要件がある場合は、より具体的なドメインルールも確認してください。

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

IP-CIDR / IP-CIDR6

IPv4とIPv6のネットワーク範囲をそれぞれマッチ条件に使います。スラッシュの後の数字はネットワークプレフィックス長です。たとえばIP-CIDR,192.168.0.0/16,DIRECTは、プライベートIPv4ネットワーク範囲を表します。IPv4ルールを設定しても、同じサービスのIPv6アドレスに一致するとは限りません。

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

FINAL

先行するルールに一致しなかった場合に適用する最終ポリシーです。たとえばFINAL,PROXYです。前に置くと後続の条件が評価されなくなるため、通常はRuleセクションの末尾に記述します。PROXYとDIRECTのどちらを設定するかは、利用目的に応じて決めてください。

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

PROXY

ルールに一致したリクエストを、現在選択中のプロキシまたは設定済みのプロキシポリシーで処理することを示します。これは処理結果であり、サーバーアドレスやShadowsocksなど特定のプロトコルを指定するものではありません。実際に使われる接続を確認するには、現在のサーバー選択と設定内のポリシーとの関係も確認してください。

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

DIRECT

リクエストをプロキシサーバーに転送せず、直接接続することを示します。このルールに一致したリクエストの経路だけを決めるもので、設定内のほかのリクエストまで直接接続に切り替えるものではありません。接続先自体に到達できない場合、DIRECTに変更してもアクセスが回復するとは限りません。

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

REJECT

一致したリクエストを拒否します。接続させたくない通信を明示する場合によく使われます。特定のドメインを拒否すると、画像表示、ログイン、そのドメインに依存するほかの機能にも影響することがあります。ページの一部が表示されない場合は、条件を変更する前に一致したルールの記録を確認してください。

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

サーバー情報、サーバーリスト、ルールファイルはそれぞれ役割が異なります。インポート前に内容の種類を確認し、更新後は実際に選択されている項目も確かめてください。

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

Subscribe

サブスクリプションを追加・管理する画面です。サブスクリプションURLは利用中のサービス提供元から入手してください。サブスクリプションにはサーバーリストが返される場合も、設定内容が返される場合もあり、URLの見た目だけでは判断できません。更新操作はリモートの内容を再取得するもので、サービスの有効期間を延長するものではありません。

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

Add Server

サーバー1台分の接続情報を手動で入力する画面です。サーバーはプロキシ接続の接続先となるリモートエンドポイントで、「ノード」と呼ばれることもあります。先に対応するプロトコルを選び、手元の情報に従ってアドレス、ポート、認証情報を入力してください。表示名は端末内で識別するためのラベルです。名前を変更しても接続先は変わりません。

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

設定ファイル

General、Rule、Hostなどの設定をまとめ、ネットワークの処理方法を記述するテキストです。サーバーリストは利用できる接続先を示し、設定ファイルはリクエストの名前解決、マッチ、処理方法を定める場合があります。両者を同じ種類のデータとして扱わないでください。設定を変更する前に元のファイルを保存しておくと、比較や復元に役立ちます。

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

URL Rewrite

URLの書き換えやリダイレクト動作を記述する設定部分です。Ruleによるリクエストの経路選択とは役割が異なります。ルールの適用結果は、マッチ式、リクエスト形式、参照可能な範囲によって変わるため、ドメイン名が同じというだけでは判断できません。HTTPSの内容を扱う場合はTLSの境界も理解してください。通常の経路振り分けのために証明書設定を変更する必要はありません。

ネットワークとDNS

名前解決、接続の確立、データ転送はそれぞれ別の段階です。いずれかのテストに成功しても、ほかの段階の確認にはなりません。

ネットワークとDNS

DNS

ドメイン名をIPアドレスなどのレコードに変換する仕組みで、多くのドメインへのアクセスに先立って行われます。DNSの応答があっても対象ポートに接続できるとは限らず、サーバーの遅延が正常でもサービスのドメインが正しく名前解決されているとは限りません。調査時は、問い合わせの成否、返されたアドレス、その後のルールによる処理をあわせて確認してください。

ネットワークとDNS

レイテンシ

テストでリクエストを送信してから応答を受け取るまでの時間です。通常はミリ秒で表示され、意味はテスト方法によって異なります。レイテンシが低くても帯域幅が大きいとは限らず、すべての接続先Webサイトの応答が速くなるわけでもありません。結果を比較する際は、テスト対象、ネットワーク、方法をそろえ、実際の利用状況もあわせて確認してください。

ネットワークとDNS

TCP

順序が保証された信頼性の高いバイトストリームを提供し、確認応答、再送、輻輳制御によってネットワークの変化に対応するトランスポートプロトコルです。接続が確立しても、パケットロスや帯域の競合によって転送が遅くなる場合があります。アプリがTCPを使う場合、別の通信方式のテスト結果は手がかりにすぎず、アプリの実際の動作を直接示すものではありません。

ネットワークとDNS

UDP

データグラム単位で転送する方式です。UDP自体はデータの到達や順序を保証しませんが、上位プロトコルで信頼性を補うことができます。QUICとWireGuardはいずれもUDPを利用するため、UDPを単に信頼性のない用途専用と考えるのは適切ではありません。TCPでは接続できるのにUDPがタイムアウトする場合は、ネットワーク経路とサーバーの待ち受け状態を分けて確認してください。

用語を操作手順に沿って確認するには入門ガイドをご覧ください。設定の構成やルールの順序を調べるにはルールリファレンスをご覧ください。