公式ガイド · 入門
Shadowrocket
サブスクリプションの追加と接続手順
既存のサーバー情報をHomeに保存し、Global Routingを選択してから接続し、実際のリクエストを確認します。このページでは、再現可能な接続確認を一度行うことを目指します。設定ファイル全体を事前に理解しておく必要はありません。
完了した手順はスキップできます。問題が起きた場合は、最後に正常と確認できた手順に戻ってチェックしてください。OSのバージョンによって項目の位置が異なる場合があります。画面上の英語名を目印に機能を確認してください。
STEP 01 · Home / Add Server / Subscribe
サーバーを追加、または既存サブスクリプションを追加する
Shadowrocketを開いたら、まずHomeを表示します。ここでは保存済みのサーバーを確認し、接続先を選択して接続スイッチを操作します。まだ接続は開始しないでください。リストに項目がない場合は先に追加し、すでに項目がある場合も、自分の有効なサブスクリプションに由来するものか確認します。サブスクリプションは複数のサーバー情報を取得するためのリンクで、個別サーバーは1つの接続情報です。それぞれ入力方法が異なります。
サブスクリプションリンクがある場合:Subscribeを使用
Homeで右上の追加ボタンをタップしてAdd Serverを開き、Typeを開いてSubscribeを選択します。サブスクリプションリンク全体をURLに貼り付け、必要に応じて識別しやすいメモを入力し、右上の保存ボタンをタップします。貼り付けたリンクの前後に空白、改行、チャットの文章が入っていないか確認してください。ドメインだけをコピーしたり、疑問符以降のパラメーターを削除したりしないでください。パラメーターにはサブスクリプションの認証情報が含まれる場合があり、一部が欠けると内容を取得できないことがあります。
保存後、Homeに戻ってサブスクリプションの読み込みを待ちます。通常は該当するサブスクリプショングループとサーバー項目が表示されます。項目をタップし、選択マークが使用するサーバーに付いていることを確認します。サブスクリプション名が表示されても、内部にサーバーがなければ追加は完了していません。まず取得結果を確認してください。更新が必要な場合は、そのサブスクリプション項目の更新操作を使用します。操作メニュー内に表示される場合があるため、更新後にリストが変わったか確認してください。
更新のたびに同じサブスクリプションを新規作成しないでください。同じグループが複数あると、その後の選択やトラブル対処が複雑になり、古い項目を誤って使うこともあります。更新するとサービス事業者から新しい情報が読み込まれ、サブスクリプション内で手動編集した項目が上書きされる場合があります。変更内容を個別に残す必要がある場合は、保存方法を確認してから更新してください。
個別サーバー情報がある場合:Typeに合わせて入力
個別のサーバーパラメーターを受け取った場合も、Add Serverから始めます。ただし、TypeではSubscribeではなく、サービス事業者から指定されたプロトコルを選びます。サーバーアドレス、ポート、認証情報、およびプロトコルで必要なその他の項目を順に入力します。たとえばUUID、TLS、Server Nameが必要な場合は、元の情報と1つずつ照合してください。異なるプロトコルの項目を流用したり、アドレスの見た目からプロトコルを推測したりしないでください。
保存後、Homeに戻り、追加した項目を選択します。QRコードを受け取っている場合はScan QR Codeから追加できますが、認識後にTypeとアドレスを確認してください。サブスクリプションURL、QRコード、認証情報にはアクセス資格情報が含まれる場合があるため、スクリーンショットを公開したり転送したりしないでください。この手順が終わったら、「次に接続するサーバーはどれか」を明確にしてから、ルーティングを選択します。
STEP 02 · Global Routing / Config
Global Routingモードを選択する
サーバーはプロキシ接続先を決め、Global Routingはリクエストの処理方法を決めます。HomeでGlobal Routingを開き、Config、Proxy、Directの3つのモードを確認します。このチュートリアルでは、基本的な確認にこの3つを使います。画面にほかの選択肢が表示されても、まずは今回の作業範囲に集中し、すべての機能を同時に設定する必要はありません。
Config:現在のルールに従って処理
適切な設定ファイルがある場合は、通常Configを選択します。次にConfigを開き、ファイルがリストにあるだけでなく、使用するファイルが実際に有効になっていることを確認してください。サブスクリプションの追加とConfigは別の機能です。サブスクリプションは主にサーバー情報を更新し、ConfigはルールやDNSなどの動作を制御します。サブスクリプションの追加に成功しても、必要なルールが用意されたことにはなりません。
ルールは通常、上から順に照合され、最初に一致したルールでリクエストのポリシーが決まります。たとえば次の例では、指定したドメインにPROXYを使用し、それ以外はFINALで処理します。これは照合方法の説明用で、既存ファイルの代わりにそのまま使える完全な設定ではありません。また、PROXYには実際の設定で有効なポリシーが必要です。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Proxy:選択中のプロキシ経路を確認
適切なConfigがまだない場合や、ルールが問題の原因かどうか調べる場合は、一時的にProxyを選択して、選択したサーバー経由のリクエストをテストできます。これは問題を自動修復する設定ではなく、誤った認証情報を補うものでもありません。システム自身の通信やシステムの制限を受けるリクエストは対象外となる場合があります。このモードが端末上のすべてのパケットを例外なく処理すると考えないでください。
Direct:ローカルネットワークとの比較
Directではリクエストが直接通信するため、現在のWi-Fiやモバイルネットワーク自体が正常かどうかを確認できます。プロキシサーバーの検証には使いません。Directでページにアクセスでき、Proxyではできない場合は、プロキシ経路を調べる理由があります。どちらでもアクセスできない場合は、すぐに設定全体を作り直すのではなく、接続先、ローカルネットワーク、DNSなども確認してください。
今回選択したモードを記録しておきます。最初のトラブル対処では、ルールの変更、サーバーの切り替え、モードの変更を同時に行わないでください。どの変更が結果に影響したか判断できなくなります。ルール構成と設定の詳細は設定リファレンスを参照してください。ここでは現在のサーバーとルーティングモードを確認し、接続を開始します。
STEP 03 · Home / VPN
スイッチをオンにしてシステムの接続状態を確認する
Homeに戻り、サーバーの選択マークとGlobal Routingをもう一度確認します。問題がなければ、画面上部の接続スイッチをオンにします。初回起動時は、iPhoneまたはiPadにVPN構成を追加するシステムメッセージが表示されます。内容を読み、Shadowrocketから開始した操作であることを確認して許可し、システムの指示に従って端末を認証します。これはシステムネットワークトンネルを確立するための許可で、サブスクリプションを追加する手順ではありません。
以前に許可を取り消した場合は、アプリに戻って接続を再開してください。サブスクリプションを追加し直して解決しようとしないでください。システムの許可が完了していない場合、Homeに複数のサーバーが表示されていても、接続済みとは判断できません。確認画面を完了したらShadowrocketに戻り、スイッチがオンのままか、接続状態が更新されたかを確認します。必要に応じてシステム設定でVPNの状態も確認し、アプリの表示と照合してください。
スイッチをオンにした直後にオフになる場合は、アプリまたはシステムにエラーの説明が表示されていないか確認します。別のVPN接続がシステムの通信経路を使用中でないか調べ、必要なら別の接続を停止してからShadowrocketで再試行してください。状況を記録せずにシステム構成を削除しないでください。次回の接続で再認証が必要になる場合があり、問題の切り分け要因も増えます。
手動で切断した後に接続が繰り返し再開される場合は、On Demandが有効になっているか、ほかにシステムの自動接続条件が設定されていないか確認します。入門時はこれらの設定を記録し、関連する自動接続条件を一時的に無効にして、手動接続を一度テストしてください。「アプリから接続を開始した」場合と「システムが条件に応じて再接続した」場合を区別でき、スイッチが反応していないと誤解しにくくなります。
スイッチがオンのままでも、接続処理が動作状態になったことを示すだけで、選択したサーバー、名前解決、ルールが期待どおりであるとは限りません。すぐに複数のサーバーを切り替えず、同じサーバーを使って以下のテストを行い、接続状態と実際のアクセス結果を分けて記録してください。
STEP 04 · Connectivity Test
サーバー、アクセス結果、ルールを個別に確認する
接続後、まずConnectivity Testを実行して、選択したサーバーのテスト結果を確認します。テスト項目はHomeのツールまたは操作メニューにある場合があります。画面上でテスト方法を選択できる場合は、複数のサーバーを比較するときに同じ方法を使ってください。テストの成功は、そのテスト条件下で期待する応答を受け取ったことを示します。すべてのWebサイト、プロトコル、アプリで検証が完了したことを意味するものではありません。
テスト結果がネットワークの応答だけを示す場合、認証やプロキシ経由の完全なアクセスが正常だとは判断できません。テスト方法が異なれば、確認できる通信経路の範囲も異なる場合があります。そのため次にブラウザーを開き、現在のルーティングに合った、アクセス可能と確認済みのページを開きます。ページを再読み込みするかリクエストを再送信し、以前表示したページやキャッシュを今回の接続結果と取り違えないようにしてください。
Configを確認するときは、「ページを開けること」と「ルールどおりに通信すること」を区別します。ページが開けても、PROXYではなくDIRECTに一致した可能性があります。アプリのリクエスト記録またはLogを開き、先ほどアクセスしたドメインを見つけて、適用されたルールと最終ポリシーを確認してください。該当するリクエストが記録にない場合は、時刻、ドメイン、現在の接続が一致しているかを確認します。ページの表示速度だけで経路を判断しないでください。
Proxyの確認では、同じサーバーと同じページを使い、接続前後のアクセス結果を比較します。Directは基本ネットワークの確認に使います。モードごとに確認する目的が異なるため、すべてのモードで同じ結果を求める必要はありません。VPNを示すステータスバーのアイコンだけで判断しないでください。システムのアイコンはトンネルの状態を示しますが、個々のリクエストに適用されたポリシーを示すものではありません。
最後に通常利用時の状態を再確認します。トラブル対処のために一時的にProxyへ変更した場合は、使用予定のConfigに戻し、対象へのリクエストを再送信して記録を確認します。現在の設定ファイル名、サーバー名、Global Routingの選択、テスト結果を記録しても構いませんが、認証情報は公開記録に書かないでください。通常のモードに戻した後も期待どおりに動作すれば、入門手順は完了です。
STEP 05 · 失敗した段階を特定
よくある失敗と次に確認する項目
まず、どの手順で失敗したかを確認してから変更内容を決めます。「サブスクリプションを更新できるか」「サーバーをテストできるか」「接続スイッチがオンのままか」「対象へのリクエストが成功するか」の4項目を記録することをおすすめします。一度に変更するのは1項目だけにし、同じ対象を再テストしてください。正常に戻ったら、診断のために行った一時的な変更を元に戻します。何度も再インストールするより、役立つ情報を残しやすくなります。
サブスクリプションに内容がない、または更新に失敗する
まずサブスクリプションの編集画面でURLが完全か、TypeがSubscribeか、リンクの有効期限が切れていないかを確認します。ログインページ、説明文、空の内容が返された場合、アプリはそれをサーバーリストとして使用できません。パラメーターを推測せず、サービス事業者にサブスクリプションURLと返される形式を確認してください。サブスクリプションの取得は接続前に行われます。「更新に失敗した」ことを「すべてのサーバーが利用できない」ことと同一視しないでください。
サーバーリストがあり今回の更新だけ失敗した場合は、既存のグループを残し、以前の項目がまだ動作するかを確認してから、サブスクリプション取得の問題かサーバー接続の問題かを判断します。トラブル相談のために完全なサブスクリプションURLを公開しないでください。エラーの状況、発生した段階、確認済みの項目を伝えると役立ちます。サブスクリプションにアクセス資格情報が含まれる場合は、機密情報として扱ってください。
サーバーテストに失敗する、または接続後にアクセスできない
アドレス、ポート、プロトコル、認証情報を1つずつ確認します。TLSを有効にした項目では、該当する名前とサーバー側の要件が一致しているかも確認してください。理由なくポートだけを変更して試さないでください。サブスクリプションから作成した情報の場合は、サブスクリプションが正しく更新されたかを先に確認し、サーバーの状態をサービス事業者に問い合わせてください。Wi-Fiとモバイルネットワークの切り替えは比較に使えますが、切り替えるたびにテストを再実行し、以前の結果を流用しないでください。
Directでもすべての接続先にアクセスできない場合は、Wi-Fiのログインが必要か、ネットワーク自体が接続されているかなど、ローカルネットワークを先に確認します。スイッチがオンのままにならない場合は、システムのVPN許可と接続の競合を確認してください。スイッチは正常でもリクエストに失敗する場合は、サーバー、名前解決、ポリシーを確認します。問題の段階を分けることで、システム権限の問題に対してルールを変更するような誤った対処を避けられます。
一部のページやアプリだけが失敗する
同じ対象を使い、Configと一時的なProxyの結果を比較します。Proxyでは正常でConfigでは失敗する場合は、実際に適用されたルール、ポリシーの指定先、ルールの順序を確認します。ドメインへのアクセスだけが失敗し、ほかのリクエストは正常な場合は、DNSの記録と設定を確認してください。1つの現象だけでDNSパラメーターをすべて置き換えたり、バックアップなしでConfig全体を上書きしたりしないでください。
DNS、On Demand、Log、設定の復元などの詳細な操作は、設定リファレンスを参照してください。症状別の説明はよくある質問にあります。トラブル情報を共有する前に、サブスクリプションURL、パスワード、UUIDなどの機密情報を隠し、画面上の英語表記、エラーテキスト、操作手順を残してください。
完了後は使用可能なサーバーとConfigを維持し、その後は設定を1項目ずつ変更してください。サブスクリプションを更新するときは既存のグループを更新し、ルールを変更するときは現在の設定を保存します。変更するたびに「接続状態 → Connectivity Test → 実際のリクエスト → 適用されたポリシー」の順で確認してください。