Shadowrocket 公式マニュアル / 使い方ガイド
Shadowrocket
読み込み・接続・確認
iPhone / iPad の画面を例に、5つの手順で初回接続を行います。まずサーバーへの接続を確認し、次にルールによるリクエストの処理を確認します。
利用可能なサーバー項目がすでにある場合は、手順2から進められます。インストールがまだの場合は、先にダウンロードと初回起動の説明をご覧ください。システムのインストール警告とアプリ内の接続エラーは、別の問題として扱ってください。
STEP 01 / IMPORT
サーバーの追加またはサブスクリプションの読み込み
手元の情報の種類を確認してから、適切な入口を選びます。個別のサーバー情報には通常、プロトコルの種類、サーバーアドレス、ポート、パスワードまたは認証情報が含まれます。サブスクリプションリンクは複数のサーバー項目を取得するためのもので、構成ファイルにはルール、ポリシー、その他の設定が含まれる場合があります。これらは用途が異なるため、リンクの見た目だけで判断できません。手元のサービス情報にある説明を確認し、構成ファイルのアドレスをサーバーアドレス欄に入力したり、ウェブページの案内用アドレスをサブスクリプションアドレスとして使ったりしないでください。
Add Server で手動入力
Shadowrocket を開いて Home に進み、右上の追加ボタンから Add Server を開きます。まず既存サーバーと同じプロトコルを選び、アドレス、ポート、認証情報を順に入力します。プロトコルによって表示される項目が異なるため、先に種類を選んでから入力してください。項目の意味がすぐに分からない場合でも、名前の似たプロトコルに変更して保存しないでください。異なるプロトコルのパラメーターは互換性がありません。
入力時は、サーバーアドレスに余分な空白が入っていないか、ポート番号がすべて入力されているか、パスワードや認証情報の大文字・小文字が保持されているかを確認します。サービス情報にトランスポート方式、TLS、サーバー名、パスが指定されている場合は、元の説明に従って入力してください。アドレスとパスワードだけでは不十分な場合があります。保存後に Home に戻り、SERVER リストに新しい項目が表示されていることを確認します。この時点では保存が完了しただけで、サーバーに接続できることはまだ確認されていません。
Subscribe で既存のサブスクリプションを読み込む
サブスクリプションリンクをお持ちの場合は、Config ページで Subscribe に対応する操作を開き、案内に従ってリンク全体を貼り付けて取得します。リンクにはクエリパラメーターが含まれることが多いため、ドメインだけでなく全体をコピーしてください。チャットメッセージに含まれる説明文は一緒に貼り付けないでください。クリップボードへのアクセスを求められた場合は、読み込む情報がクリップボードにあることを確認してから許可してください。
取得後、Home に戻り、SERVER リストにサブスクリプションに対応するサーバー項目が表示されているか確認します。Config に構成ファイルが追加されても、Home に選択可能なサーバーが表示されない場合は、まず読み込んだ情報の種類を確認してください。「ファイルをダウンロードした」ことを「サーバーを読み込んだ」ことと同じだと判断しないでください。画面レイアウトによって入口の位置は多少異なる場合があります。操作対象がサーバーのサブスクリプションか構成ファイルかを確認することが重要です。
QR コードと読み込み後の確認
サーバーの QR コードをお持ちの場合は、Home のスキャン機能から Scan QR Code を利用できます。初回はシステムの案内に従ってカメラへのアクセスを許可し、読み取り後に解析されたプロトコルとアドレスを確認してから追加します。QR コードとサブスクリプションリンクには認証情報が含まれることがあるため、公開フォーラムに投稿したり、トラブル調査用のスクリーンショットに全体を写したりしないでください。読み込み後は、次の手順に進むための項目を一つ選択します。同じサブスクリプションを何度も読み込む必要はありません。重複項目が増えると、後の確認が難しくなります。
この手順の完了条件は、Home に想定したサーバーがあり、種類と必要なパラメーターを確認できることです。サブスクリプションリンクを認識できない、更新後に項目が空になるといった問題は、5番目の手順で取得の流れに沿って調べます。入口の違いについては4種類の読み込み方法もご覧ください。
STEP 02 / ROUTING
Global Routing モードを選択
サーバー項目を追加したら、次にリクエストの処理方法を決めます。Home に戻り、Global Routing を開いて現在の選択を確認します。3つのモードはConfig / Proxy / Direct です。これらはリクエストの処理方法を制御するもので、接続品質の違いではなく、サーバー自体のプロトコルや認証パラメーターを変更するものでもありません。
Config:現在の構成に従って処理
Config を選択すると、リクエストは現在有効な構成のルールに従って処理されます。Config を開き、ファイル一覧に構成があることだけでなく、実際に選択されているファイルを確認してください。ローカルへのダウンロードと現在の構成としての設定は別の操作です。有効になっていない別のファイルを編集しても、使用中のルールは変わりません。初回は用途を理解している既存の構成を選び、まず元の内容を保ってください。多数のルールを同時に変更すると、問題の原因を判断しにくくなります。
ルールは通常、上から順に照合され、一致したルールのポリシーが適用されます。PROXY は該当するプロキシポリシーで処理し、DIRECT は直接接続、REJECT は拒否を示します。末尾の FINAL は、それ以前のルールに一致しなかったリクエストを処理します。ポリシーが実際にどこへ振り分けるかは現在の構成で確認してください。「Config を選択した」だけで「すべてのリクエストが現在のサーバーを経由する」とは限りません。
Proxy:まずサーバー経由の経路を確認
Proxy は、範囲を明確にした接続確認に適しています。同じネットワーク上でサーバーを一つ選び、対象を一つ決めてテストします。Proxy ではアクセスできて Config ではできない場合、サーバー情報をすぐに入力し直すのではなく、構成ファイル、ルール、ポリシーの振り分け先を確認してください。テスト後は、普段の用途に応じたモードに戻し、一時的な確認状態をそのままにしないでください。
Direct:ローカルネットワークの結果を切り分け
Direct を選択すると、通常のリクエストは選択中のプロキシサーバーに渡されません。基本ネットワークとプロキシ経由の経路を比較するのに役立ちますが、これだけでリモートサーバーの状態は判断できません。対象リクエストをプロキシ経由にする想定でも、Direct が選択されていると、接続スイッチがオンでも直接接続の結果になる場合があります。選択したモードを記録し、以降の確認でも条件を明確にしてください。
どこから始めればよいか分からない場合は、まず Proxy で既存サーバーが対象リクエストを処理できるか確認し、その後 Config でルールを確認します。ここで構成全体を作成する必要はありません。各設定項目の用途はGlobal Routing の設定説明、プロトコルパラメーターの意味はプロトコルリファレンスをご覧ください。
STEP 03 / CONNECT
サーバーを選択して接続スイッチをオン
Home に戻り、SERVER リストから使用するサーバーを明示的に選択します。「読み込んだばかりの項目」が「現在選択されている項目」とは限りません。リスト上の選択マークを確認してください。サーバーが複数ある場合は、まず一つに決めて確認を完了し、その間は別のサーバーに切り替えないでください。接続結果を特定のパラメーターに対応づけやすくなります。
接続前に Connectivity Test でテスト結果を確認できます。応答時間が表示されても、そのテスト条件で応答があったことを示すだけで、すべてのウェブサイト、アプリ、リクエストが成功するとは限りません。タイムアウトした場合も、テスト方法と実際のアクセス結果を合わせて判断してください。テスト結果は調査範囲を絞るためのものであり、次の手順で行うページ表示の確認の代わりにはなりません。数値の大小だけを比較し、サーバーが実際のリクエストを処理できるか確認しないことは避けてください。
サーバーと Global Routing を確認したら、Home の接続スイッチをオンにします。初回接続時は、VPN 構成の追加を許可するかシステムから確認されます。操作中のアプリを確認して許可し、システムの指示に従ってデバイスのパスコードなどの認証を完了します。この許可はシステムのネットワーク接続構成を作成するためのもので、サーバーのパスワードとは別の情報です。デバイスのパスコードを Add Server に入力しないでください。
許可が完了したら Home に戻り、スイッチがオンのままか、システムの接続状態がどうなっているかを確認します。スイッチがすぐオフに戻る場合は、構成エラー、権限の案内、別の接続の使用状況を確認してください。短時間に何度もオン・オフを切り替えないでください。他の実行中の VPN 接続を終了してから Shadowrocket に戻り、再度試すことができます。システム接続の切り替えによる誤判定を避けるため、テスト状態を一つに保ってください。
接続スイッチがオンのままでも、クライアントが接続状態になったことを示すだけです。リモート認証の成功や、対象リクエストが想定どおりに振り分けられたことまでは保証しません。この時点では DNS、ルール、プロトコルパラメーターを変更せず、現在の条件を保って次の手順で実際のリクエストを確認します。サーバーを変更する必要がある場合は、変更前の項目と状況を記録してから、同じ確認手順をもう一度行ってください。
STEP 04 / VERIFY
実際のアクセスとルールの結果を確認
確認する点は3つです。スイッチがオンか、対象にアクセスできるか、対象が想定したポリシーを通っているかです。システムの VPN 表示だけでは、システム接続が何らかの状態で有効になっていることしか確認できません。ページが開いただけでは、その対象がもともと直接接続できた可能性もあります。実際のアクセス結果を、現在の Global Routing、選択中のサーバー、リクエスト記録とあわせて判断してください。
特定のリクエストを再実行
ブラウザーで、アクセス権があり正常時の状態が分かっているページを開き、再読み込みして結果を待ちます。すでに読み込み済みのページやアプリのキャッシュだけを見るのではなく、新しいリクエストを発生させてください。初回の確認では、同じネットワーク、同じサーバー、同じ対象を使い、ページが正常に表示されたか、長時間待機したか、明確なエラーが出たかを記録します。結果によって調査の方向は異なります。
Data でリクエストの経路を確認
Shadowrocket に戻り、Data で今回のアクセスに対応するリクエスト記録または接続情報を確認し、発生時刻と対象ドメインから該当項目を探します。データ量の変化だけでなく、実際に適用されたポリシー、表示されるルールの一致結果、サーバーの振り分け先を確認してください。デバイスのバックグラウンドでもリクエストが発生する場合があるため、総通信量が増えただけではテスト対象がプロキシを経由した証明になりません。
Config 使用時に記録が DIRECT で、想定が PROXY の場合は、現在有効な構成のルールを確認します。まず対象ドメインがルールと一致しているか、次にそれより前に一致する項目がないか、最後にポリシーの振り分け先を確認してください。一つのページから複数のドメインへリクエストが送られることがあり、トップページの文書、画像、API が同じルールに一致するとは限りません。ページのアドレスに対応するルールだけを変更しても、すべてのサブリクエストが変わるとは限りません。
一度に一つの条件を変えて範囲を絞る
Config でアクセスに失敗する場合は、サーバーを同じままにして、一時的に Proxy に切り替え、同じリクエストを再実行します。Proxy では成功し Config では失敗する場合は、ルールと現在の構成を優先して確認します。どちらでも失敗する場合は、サーバーパラメーター、ネットワーク接続、対象自体を確認します。比較後は想定するモードに戻し、もう一度アクセスを確認してください。ネットワーク、サーバー、構成を同時に変更すると、正常に戻ってもどの変更が効果をもたらしたか分からなくなります。
完了条件は、対象に想定どおりアクセスでき、リクエスト記録のポリシーも期待した内容と一致することです。問題を他の人に説明する場合は、必要な対象の状況、モード、エラーメッセージだけを記録し、サーバーの認証情報とサブスクリプションリンクは伏せてください。ルールの順序についてはカスタムルールと FINAL のフォールバックをご覧ください。
STEP 05 / TROUBLESHOOT
問題が起きた段階ごとに確認
問題が起きたら、まずどの段階で止まったかを確認します。サブスクリプションを読み込めない、サーバーテストに失敗する、スイッチがオンのままにならない、スイッチは正常でも対象にアクセスできない、といった状況に分けます。段階の異なる問題に同じ対処を当てはめないでください。特にタイムアウトが発生しただけで、すべての構成を削除したりアプリを再インストールしたりしないでください。比較条件が失われ、無効なサーバー情報も修復されません。
基本ネットワークとサブスクリプションの取得
まず接続を一時的にオフにし、デバイスの Wi-Fi またはモバイル通信自体が利用できるか確認します。ログインが必要なネットワークでは、先にログインを完了してください。基本ネットワークに問題がなければ、サブスクリプションリンクが完全か、まだ有効か、取得時にエラーが返されていないかを確認します。読み込み後の項目が空の場合は、サービス情報に変更がないか、返された内容が引き続き対応形式かを確認してください。更新に失敗しても、既存の利用可能な項目はそのまま残し、何度も追加して重複を増やさないでください。
サブスクリプションの更新は新しいサーバーリストを取得する操作で、Connectivity Test は項目の接続状況をテストする操作です。両者は別の操作です。更新に成功してもサーバーがタイムアウトする場合は、サーバーを引き続き確認してください。更新に失敗しても古い項目で接続できる場合、すべての接続が使えなくなったとは限りません。更新の入口と失敗原因についてはサブスクリプションの手動・自動更新についてをご覧ください。
サーバーのタイムアウトまたは認証失敗
Add Server の編集画面に戻り、手元のサービス情報に基づいてプロトコル、アドレス、ポート、認証情報を一つずつ確認します。次に TLS、サーバー名、トランスポート方式、パスを確認してください。任意に見える項目でも、サーバー側で必要とされているものを省略しないでください。システム時刻が大幅にずれている場合は、正しい時刻に戻してからテストします。時刻のずれが証明書や認証の判定に影響することがあります。必要に応じて、利用権限のある別のネットワークで同じサーバーを試し、ローカルネットワークの違いを切り分けます。
テストに繰り返し失敗する場合は、すでに利用しているサービスの提供元に、サーバーの状態やパラメーターに変更がないか確認してください。状況とエラーメッセージを伝え、リンク全体や認証情報を公開しないでください。明確な根拠なしにパスワードを変更したりプロトコルを切り替えたりせず、利用可能な組み合わせを無作為に探さないでください。詳しい確認手順はサーバーのタイムアウトと接続失敗のチェックリストをご覧ください。
スイッチは正常でもアクセス結果が想定と異なる
まず Global Routing で誤って Direct を選んでいないか確認し、次に Config で現在有効なファイルを確認します。Proxy は正常で Config に問題がある場合は、「対象リクエスト → 最初に一致するルール → ポリシーの振り分け先」の順に確認してください。特定の対象だけに問題がある場合は、その対象のドメイン解決とリクエスト記録を確認し、すぐに DNS 設定全体を変更しないでください。変更前の値を記録し、一度に一項目だけ変更して同じリクエストを再実行します。
ページの文書は開くのに画像や API が失敗する場合は、ページ全体を一つの接続として扱わず、失敗したリソースのドメインを個別に確認してください。システムの許可が完了していない場合は、先に許可を処理します。スイッチが安定しているのにリモートから応答がない場合は、サーバーとリクエスト経路を確認してください。複数の設定を同時に変更するより、問題の層を正確に特定するほうが復旧しやすく、再現可能な結果も残せます。
テストを終了して利用可能な状態を保つ
接続が復旧したら、現在のサーバー、Global Routing、有効な構成が、継続して使う予定の組み合わせになっていることを確認し、問題の切り分けだけを目的に加えた一時的な変更は元に戻します。接続が不要なときは Home に戻ってスイッチをオフにします。次回はサーバーの選択を確認してからオンにしてください。よくある入口や権限の問題についてはFAQ、プロトコル項目の詳細についてはプロトコルリファレンスをご覧ください。初回接続時にすべての詳細設定を一度に変更する必要はありません。