ルールのマッチング
条件とポリシーを同じ行に記述します。
Shadowrocket は全プラットフォーム対応のルールベースプロキシクライアントです。既存のサーバー情報やサブスクリプションを読み込み、ルールに基づいて通信を振り分けます。iPhone / iPad 版は App Store で$2.99 の買い切り、Mac、Windows、Android、Linux 版は無料です。
現在のインストーラーのバージョン v2.2.92 · iPhone / iPad は $2.99 の買い切り、Mac、Windows、Android、Linux 版は無料です。
条件とポリシーを同じ行に記述します。
既存のリンクを使用します。以下はダミー値です。
接続するタイミングと通信ポリシーは別々に設定します。
CONFIGURATION
まず、3つの要素を区別します。サーバー情報は接続先を決め、設定ファイルはリクエストの経路を決め、接続スイッチはクライアントが通信を処理するかどうかを決めます。問題が起きたときは、この順に一つずつ確認すると、複数の設定を同時に変更するより原因を特定しやすくなります。
RULE ROUTING
Home の Global Routing で Config を選ぶと、クライアントは現在の設定ファイルにあるルールを上から順に確認します。特定のドメインに対する例外は、より広い範囲に一致するルールより前に記述します。前の条件に一致しなかったリクエストは、最後の FINAL に適用されます。接続動作を一時的に比較するには、Proxy または Direct に切り替え、プロキシ接続と直接接続の結果を確認します。比較後は Config に戻し、選択中のファイルを確認してください。戻し忘れると、ルールを保存していても、そのルールでテストしたことになりません。
ON DEMAND
Settings で On Demand を開き、接続を開始するネットワーク条件を確認します。オンデマンド接続で設定するのは接続を開始するタイミングであり、リクエストをプロキシ経由にするか直接接続にするかは Global Routing で決まります。まず現在のネットワークで手動接続できることを確認し、テスト対象のネットワークに切り替えて動作を確認してください。手動接続はできるのに自動接続が想定どおりに動かない場合は、条件が現在のネットワークに該当するか、システムで実際に有効になっている VPN 構成はどれかを確認します。サーバーの設定は、まず変更しないでください。
PROTOCOLS
Add Server でまず Type を設定し、既存サーバーの情報に合わせて Host、Port と選択したプロトコルに必要な項目を入力します。認証情報はタイプによって異なります。タイプを切り替えた後に項目が表示されなくなっても、情報が失われたわけではなく、現在のタイプでは不要な場合があります。入力後に接続できない場合は、プロトコル、ホスト、ポート、認証情報を一つずつ確認し、先頭や末尾に余分な空白がないかも調べてください。サーバー側の設定を推測するために、プロトコルを何度も切り替えるのは避けましょう。
SUBSCRIBE
既存のサブスクリプション URL がある場合は、Add Server で Subscribe を選び、サービス提供元から取得した URL を省略せずに貼り付けて保存します。Home に戻り、該当するグループが表示されること、使用予定の項目がリストに残っていることを確認してください。サブスクリプションの更新成功は、クライアントがリストを取得できたことを示すだけで、すべてのサーバーに接続できることを保証するものではありません。更新に失敗した場合は、URL が完全か、現在のネットワークが使えるか、リンクが置き換えられていないかを個別に確認します。トラブルのスクリーンショットを共有する際は、URL のクエリパラメーターと認証情報を隠してください。
CONFIG & DIAGNOSTICS
Config で選択中の設定ファイルを確認し、編集前に復元できるよう元の設定を保存しておきます。複数のデバイスを使う場合は、アプリ内の iCloud 設定を確認して同期対象を把握します。同期を設定のバックアップ代わりにしないでください。接続に問題がある場合は、Home の Connectivity Test でサーバーを確認し、続いて Data の通信量統計と Settings の Diagnostics を確認します。通信量が増えていても、リクエストがクライアントを通過したことを示すだけで、特定の宛先にどのルールが適用されたかは判断できません。
まず Global Routing が Config になっているかを確認し、次に Config で選択中の項目を確認します。両方とも正しい場合は、実際にアクセスしたホスト名を記録してください。アドレスバーに最後に表示されたドメインだけでは判断できません。ページの内容が別のホストから配信されていることがあります。対象のルールより前に、より広い範囲に一致する条件がないか、どのポリシーが未一致のリクエストに適用されるかを確認します。一度に変更するのは1か所だけにし、同じネットワークと同じ宛先で再テストしてください。そうすれば、変化がルールによるものか、ネットワークの切り替えによるものかを判別できます。
まず On Demand を一時的にオフにして、現在のネットワークで手動接続を試します。手動接続できたら On Demand を再び有効にし、同じデバイスで、接続を開始する条件が明確なネットワークに切り替えてください。切り替え前後の接続状態を記録し、サーバーやルールファイルは同時に変更しないでください。それでも接続が始まらない場合は、システムで現在有効になっている VPN 構成と、アプリ内の接続条件を確認します。手動接続も失敗する場合は、まず基本的な接続を復旧してから自動接続を確認してください。
通信の振り分け設定を変更せず、まずデバイス自体が正常にインターネットへ接続できることを確認し、次に Connectivity Test で選択中のサーバーをテストします。失敗したら Add Server に戻り、既存のパラメーターを照合してください。特に Type、Host、Port が同じサーバー情報に対応しているかを確認し、最後にプロトコルで必要な認証項目を調べます。テストに成功しても、すべての宛先にアクセスできるとは限りません。実際にアクセスして確認してください。
リストを更新できないのか、リストは更新できたものの特定のサーバーに接続できないのかを、まず切り分けます。前者は、サブスクリプション URL 全体、現在のネットワーク、サービス提供元が案内するリンクの状態を確認します。後者は、選択中の項目とサーバーの設定を確認してください。古いグループが残っている場合は比較用に保管し、URL を確認する前に削除する必要はありません。エラーメッセージを記録する場合は、エラー内容だけを残し、サブスクリプション URL、識別用パラメーター、サーバーの認証情報は隠してください。
App Store から復元されるのはクライアントであり、元のデバイスにあったすべての設定ではありません。アプリを開き直したら、サブスクリプショングループ、保存済みサーバー、Config で現在選択中の項目をそれぞれ確認します。以前 iCloud 関連の設定を有効にしていた場合は、同期対象の項目が新しいデバイスに届いているか確認してください。それ以外の内容は、保存しておいた設定や元の情報から復元します。まず手動接続を確認してから、オンデマンド接続の条件を戻してください。
PLATFORM DOWNLOADS
iPhone / iPad 版は App Store で $2.99 の買い切りです。Mac(Apple シリコン・Intel)、Windows、Android、Linux 版は無料で、インストーラーは当サイトのダウンロードページにある /dl/shadowrocket/ から入手できます。以下のリンクでは、デバイスに対応する選択肢が表示されます。カードを開いただけでインストールが始まることはありません。
購入前に製品ページと現在のアカウントのストアを確認してください。機種変更や再インストールの際は、購入時のアカウントで「購入済み」から探します。iPhone と iPad の両方で同じ購入を利用できます。システム要件は App Store の製品ページに記載された内容をご確認ください。
まず「この Mac について」を開き、表示されるチップまたはプロセッサの種類に合ったディスクイメージを選びます。ダウンロードページには2種類のバージョンが掲載されています。別の Mac に移行した場合は、新しいデバイスに表示される種類に合わせて選び直してください。
まずシステム情報で、デバイスとインストーラーのアーキテクチャが合っているか確認します。初回起動時にシステムの警告が表示された場合は、当サイトのダウンロードページから入手したことを確認し、インストール手順に従ってください。組織が管理するデバイスでは、あらかじめインストール権限を確認してください。
端末のアーキテクチャに合うファイルを選びます。アプリ内でダウンロードできない場合は、端末のブラウザーで開き直してください。
まずプロセッサのアーキテクチャを確認し、ディストリビューションのパッケージ管理方式に合った形式を選びます。AppImage を選ぶ場合は、インストール手順に従って実行権限を設定してください。パッケージを使用する場合は、パッケージマネージャーに表示される依存関係の案内を確認します。
FIRST CONNECTION
以下では iPhone / iPad の画面を例に説明します。事前に、利用できるサーバー情報またはサブスクリプション URL を用意し、プロキシを有効にしていない状態でデバイスが正常にインターネットへ接続できることを確認してください。こうしておくと、初回接続に失敗したときに、デバイス自体がネットワークに接続されていない可能性を切り分けられます。
サーバー情報が1台分だけある場合は、Home から Add Server を開き、Type を確認して各項目を入力し、保存してリストに戻ります。サブスクリプション URL がある場合は、Subscribe を使って読み込むと、サブスクリプションの内容からリストが作成されます。同じサーバー情報を重複して追加する必要はありません。保存後に SERVER グループを開き、テストに使うサーバーが選択されていることを確認します。手動追加した項目とサブスクリプションの項目は名前が似ている場合があるため、情報の入手元を手掛かりに選んでください。確認の際、URL や認証情報を公開する必要はありません。
Global Routing モードを選ぶルールに基づいてリクエストを処理する場合は、まず Config で現在のファイルを確認し、次に Home に戻って Global Routing を Config に設定します。問題がルールに関係するかを確認するには、同じネットワークで Proxy と Direct を選んで結果を比較してください。テスト中はモードだけを変更し、サーバー、設定ファイル、ネットワークは同時に切り替えないでください。ルールモードでのみ結果が異なる場合は、設定ファイルとルールのマッチ順を優先して確認します。テスト前のモードを記録し、終了後は普段の設定に戻してください。一時的な選択を以前の設定と取り違えないためです。
Home に戻り、接続スイッチをオンにします。システムから初めて VPN 構成の追加を求められた場合は、現在開いている Shadowrocket からの要求であることを確認し、システムの案内に従って許可してください。接続状態が変わったら、まず Connectivity Test を実行し、次に直接接続される想定の宛先と、プロキシ経由の想定の宛先へアクセスします。結果が想定と異なる場合は、ネットワークの種類、現在のモード、設定ファイル、エラーメッセージを記録してください。接続スイッチがオンになっただけで、目的の通信が確認できたと判断してはいけません。どちらの宛先にもアクセスできない場合は、一時的に接続を切り、同じ宛先を再テストして、通常のネットワーク接続にも影響があるかを確認します。
STORE VERIFICATION
Shadowrocket の App Store 製品ページを開き、開発者が Shadow Launch Technology Limited であることを確認します。次に、白地に青紫の縁取りがある公式アイコンと照合し、最後に製品ページのリンクに id932747118 が含まれていることを確認してください。検索結果には似た名前やアイコンが表示される場合があります。日本語の別称も購入の証明にはなりません。リストの概要だけでなく、製品の詳細ページで確認してください。開発者名とアプリ ID が同じ製品ページに記載されている必要があります。いずれかが一致しない場合は、このマニュアルで案内するアプリとして扱わないでください。
アプリが表示されるかどうかは、デバイスの言語やシステムの地域設定だけでなく、現在のアカウントで利用している App Store のストアフロントにも左右されます。検索しても見つからない場合は、まず製品ページでストアの提供状況に関する案内を確認します。次に Apple アカウントの「メディアと購入」を開き、アプリの入手に使用するアカウントと国または地域を確認してください。中国本土のストアでは、このアプリは提供されていません。米国向けの製品ページを開いても、アカウントのストアフロントは自動で切り替わりません。ストアで提供されているのにダウンロードできない場合は、デバイスの制限と互換性を確認します。iPhone / iPad のシステム要件は App Store の製品ページに記載された内容をご確認ください。表示の意味を詳しく確認するには、App Store ガイドを参照してください。
iPhone / iPad 版は米国 App Store で $2.99 の買い切りです。各ストアの価格は現地の表示をご確認ください。Mac、Windows、Android、Linux 版は無料です。同じ購入で iPhone と iPad の両方を利用でき、デバイスごとに購入する必要はありません。機種変更や再インストールの際は、購入時のアカウントで App Store にサインインし、「購入済み」から Shadowrocket を探して再ダウンロードします。再ダウンロードではなく価格が表示される場合、すぐに購入せず、購入時のアカウントとストアフロントを確認してください。再ダウンロードで復元されるのはアプリ本体です。既存のサブスクリプション、手動で追加したサーバー、ローカルルールは、それぞれの同期状況やバックアップの有無を確認してください。
アプリが正常に開いても、既存のサーバーが引き続き使えるとは限りません。反対に、サブスクリプションを一時的に更新できなくても、購入履歴に問題があるとは限りません。接続に問題がある場合は、アプリの入手、情報の読み込み、アクセス先の表示のどこで問題が起きているかを切り分けます。アプリの入手に関する問題はストアまたはインストール先を確認します。既存サービスの情報が変わった場合は、元のサービスの記録と照合してください。モードやルールに関する問題は、Home と Config で一つずつ確認します。
iPhone と iPad は App Store でアップデートを確認できます。システムの自動アップデート設定も利用できます。Mac、Windows、Android、Linux 版は当サイトのダウンロードページから対応するインストーラーを再度入手してください。ファイル名が似ていることだけで、バージョンや入手元を判断しないでください。アップデート前に使用中のモードと設定ファイルを記録し、必要なローカルバックアップを保存します。アップデート後はまず手動接続を試し、サブスクリプションの更新、ルールの振り分け、On Demand が想定どおり動くか確認してください。システムのインストール確認が表示された場合は、入手元を確認してから、ダウンロードページにあるプラットフォーム別のインストール手順を参照します。入手元が不明なファイルは許可しないでください。
READING NOTES
現在の問題に合わせてお読みください。ドメインに時々アクセスできない場合は名前解決の経路を、リンクの使い方がわからない場合はリンクの種類を確認します。振り分け結果だけが想定と異なる場合は、ルールの条件と適用順を調べてください。
システム DNS、カスタム DNS、DNS over HTTPS の3つについて、名前解決の経路と用途を解説します。ドメインの名前解決に問題があり接続できない場合の確認手順も紹介します。
ss://、vmess://、vless://、trojan:// の共有リンクの構造を解説し、単一リンクとサブスクリプション URL の読み込み方法や更新の仕組みを比較します。例はすべてダミー値です。
DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL がそれぞれ何に一致するか、ルールが上から順に適用される仕組み、PROXY / DIRECT / REJECT の書き方を解説します。