公式マニュアル · 初回利用

Shadowrocket の使い方
サブスクリプションの追加と初回接続

「追加 → ルーティング → 接続 → 確認 → トラブル対処」の順に進めます。まず再現可能な接続を確認し、その後にルールや自動接続の設定を調整してください。一度に複数の項目を変更すると、原因の特定が難しくなります。

01 · Add Server:既存情報を追加する

Shadowrocket を開いたら、まず Home を表示し、接続スイッチはまだオンにしないでください。初回利用時は、一覧にサーバーが表示されていない場合があります。手元の情報に応じて、いずれかの方法で追加します。サーバー一覧を更新できる URL は通常サブスクリプションとして追加し、個別サーバーのアドレス、ポート、認証情報は手動で入力します。サブスクリプション URL とサーバーアドレスは別の項目です。サーバーアドレス欄にサブスクリプション URL 全体を入力しないでください。

サブスクリプション URL がある場合:Subscribe を選択

  1. Home で右上のプラスをタップし、Add Server を開きます。Type をタップし、種類の一覧から Subscribe を選んで入力画面に戻ります。
  2. 既存のサブスクリプション URL を URL にすべて貼り付けます。Remarks の入力が必要な場合は、一覧で区別しやすい名前を付けます。名前は識別用であり、接続設定には影響しません。
  3. 保存して Home に戻り、サブスクリプションの読み込みを待ちます。サブスクリプション名が追加されただけでなく、該当するグループにサーバー項目が表示されていることを確認します。項目が表示されたら、初回接続に使うサーバーを選びます。

貼り付けた後、URL の前後に空白や改行がないか確認してください。コピー時に説明文が混入していないかも確認します。読み込みに失敗した場合は、まずネットワークが使えることを確認し、URL が完全で有効かを調べます。サブスクリプションの取得とプロキシサーバーへの接続は別の処理です。一覧を更新できても、一覧内のすべてのサーバーに接続できるとは限りません。一時的に一覧を更新できなくても、保存済みの情報をすぐにすべて削除する必要はありません。

個別のサーバー情報がある場合:プロトコルに合わせて入力

同じく Home のプラスから Add Server を開き、Type で資料に記載されたプロトコル(Shadowsocks、VMess、VLESS、Trojan など)を選択します。まずサーバーアドレスとポートを入力し、次にパスワード、UUID、その他の認証項目を1つずつ確認します。必要な項目はプロトコルによって異なります。アドレスが同じだからといって、別のプロトコルの設定をそのまま使うことはできません。大文字・小文字、ハイフン、トランスポート設定は、手元の情報と一致させてください。

資料に TLS、SNI、Host、Path、トランスポート方式が含まれている場合は、該当する設定を開いてそれぞれ入力します。サーバーアドレスは接続に使用されます。SNI と Host は異なる段階で識別に使われることがあるため、どちらもドメイン名に見えても置き換えないでください。記載されていない設定を推測で補わず、意味がわからない項目は保存してテストする前にサービス提供元へ確認してください。

対応する QR コードや共有リンクがある場合は、Scan QR Code またはクリップボードからの読み込みも利用できます。QR コードの読み取りにはカメラの許可が必要です。クリップボードから読み込む場合は、システムの案内に従って確認してください。どの方法でも、追加後に項目を開き、Type、アドレス、ポートを確認します。サーバーリンク、QR コード、サブスクリプション URL には認証情報が含まれることがあります。公開したり、公開の掲示板へ送ったりしないでください。

この手順の完了条件:Home の一覧にサーバー項目が表示され、そのうち1つが選択されていること。追加しただけでは、まだ接続は始まっていません。複数のサブスクリプションの整理、更新、バックアップについてはサブスクリプションとサーバー管理マニュアルをご覧ください。初回利用では、続けてルーティングのモードを選びます。

02 · Global Routing:通信の処理方法を選択

Home に戻り、Global Routing を開きます。ここではクライアントが処理する接続の扱いを決めます。サーバーの追加や、誤った認証情報の修正を行う画面ではありません。基本モードはConfig / Proxy / Directの3つです。切り替える前に、サーバーの動作確認なのか、接続先ごとのルール振り分けなのか、目的を決めてください。

Config:現在の設定にあるルールを使う

Config は現在有効な設定ファイルに基づいて接続を振り分けます。ルールによる振り分けを利用する場合に適しています。下部の Config ページを開き、使用する設定が保存済みで、選択されていることを確認してください。ファイルを一覧に読み込んだだけでは、有効になっているとは限りません。設定によってポリシーやルールが異なるため、Home でサーバーを選んだだけで、すべてのリクエストがそのサーバーを通るとは判断できません。

ルールは通常、上から順に照合され、一致した時点で該当するポリシーが使われます。PROXY はプロキシポリシーで処理し、DIRECT は直接接続し、REJECT は拒否します。FINAL はそれ以前のルールに一致しなかった接続を処理します。初回利用時にすぐルールを編集する必要はありません。まず、有効な設定ファイルの用途を確認してください。用意した設定がない場合は、内容のわからないファイルを切り分けの出発点にしないでください。

Proxy:プロキシ接続を確認する

Proxy はクライアントが処理するトラフィックをプロキシポリシーに渡し、選択したサーバーへの接続を一時的に確認する場合に使えます。「グローバルモード」と呼ばれることもありますが、アプリがすべてのシステム制限を回避したり、デバイス上のあらゆる通信を処理したりするという意味ではありません。テストではサーバーとアクセス先を固定してください。このモードでアクセスでき、Config に戻すと失敗する場合は、サブスクリプションの再読み込みを繰り返すのではなく、設定とルールを優先して確認します。

Direct:接続先に直接アクセスする

Direct はクライアントが処理するリクエストをプロキシサーバー経由にせず、接続先へ直接アクセスさせます。ネットワークの状態を比較する際には使えますが、プロキシサーバーの動作確認には使えません。既存サーバーをテストする場合は、誤って Direct が選択されていないか確認してください。短時間の比較が終わったら、Global Routing を予定しているモードに戻し、次の手順へ進みます。

この手順の完了条件:現在 Config、Proxy、Direct のどれを選んでいるかを把握し、Config を使う場合は有効な設定ファイルも確認できていること。初回接続の状況を把握しやすくするため、接続の自動化はデフォルトのままにし、On Demand の調整はまだ行わないでください。

03 · Home:スイッチをオンにして許可する

Home に戻り、選択中のサーバーと Global Routing をもう一度確認してから、上部の接続スイッチをオンにします。初回接続時は、iPhone / iPad に VPN 構成の追加を求めるシステムの案内が表示されます。この案内は Shadowrocket がシステムのネットワーク経路を作成するための許可であり、サブスクリプションを読み込む案内ではありません。また、サーバーへの接続が確認済みという意味でもありません。操作が、起動したばかりの Shadowrocket によるものだと確認したうえで許可し、デバイスのパスコードまたは生体認証を完了してください。

許可後に Shadowrocket に戻り、スイッチと接続状態を確認します。以前に許可を取り消していた場合は、接続スイッチをもう一度オンにしてシステムの案内に従ってください。すべてのサーバーを先に削除する必要はありません。システムの案内が再表示されない場合は、「設定 → 一般 → VPNとデバイス管理」で VPN 構成を確認してから、アプリに戻って再試行します。デバイスが管理ポリシーの制限を受けている場合、利用者自身で権限を変更できないことがあります。デバイス管理の指示に従ってください。

デバイス上で別の VPN 接続が動作している場合は、Shadowrocket をテストする前に接続を終了し、接続の切り替わりによる影響を避けてください。トラブル対処中に複数のネットワークツールを何度もオン・オフしないでください。スイッチをオンにしてすぐオフになる、システム構成が削除される、バックグラウンドの自動接続条件が作動する、といった現象はそれぞれ異なる問題です。実際に起きた内容を記録し、まとめて「サブスクリプションが無効」と判断しないでください。

VPN の表示やシステム上の接続状態が示すのは、ネットワーク経路が該当する段階まで確立したことだけです。すべての接続先にアクセスできる証明にはなりません。経路の確立後も、認証エラー、サーバーへの到達不能、DNS の異常によってリクエストが失敗することがあります。スイッチがオンのままでも、ここで終わりにせず、次の手順で実際のアクセスを確認してください。

後から On Demand を使う場合は、手動での接続と切断が正常に動作してから設定してください。自動起動の条件は、接続を開始または再開するタイミングに影響します。初回の切り分けでは手動操作にしておくと、サーバーの問題と接続条件の変化を見分けやすくなります。システムの案内について詳しくはVPN 構成の追加とシステム権限についてをご覧ください。

この手順の完了条件:システムの許可が完了し、接続スイッチがオンのままで、すぐにエラーが表示されないこと。続けて実際のリクエストで接続経路とルールを確認し、スイッチの切り替えを繰り返さないでください。

04 · Connectivity Test:動作結果を確認する

選択したサーバーとルーティングのモードはそのままに、まず Home の Connectivity Test でサーバーに到達できるか確認します。テスト結果は問題の切り分けに使うもので、通信速度を保証するものではありません。結果が表示されれば、そのテスト方法で応答を受け取れたことを示します。timeout は、今回のテストが制限時間内に完了しなかったことを示します。テスト方法と実際のアプリのリクエストでは接続経路が異なる場合があるため、一度の結果だけですべての用途を判断できません。

次にブラウザーを開き、普段使っていてアクセス可能なページを再読み込みします。キャッシュ済みのページだけを見るのではなく、新しいリクエストで確認してください。まず通常の Web ページをテストし、その後、ログインが必要な機能や追加のアクセス条件がある機能を確認します。あるページだけ失敗し、他のページは正常な場合は、失敗した接続先の状況を記録し、接続全体が使えないとすぐに判断しないでください。テスト中にネットワーク、サーバー、設定を同時に変更すると、結果を比較しにくくなります。

Data で今回のリクエストを確認する

Shadowrocket に戻って Data を開き、直前の操作に関連する接続記録があるか確認します。表示されている接続先、ポリシー、エラー情報を参考に判断してください。Config を使っている場合、一部のリクエストが DIRECT になるのはルール上正常なことがあります。「すべてのリクエストが PROXY を通ること」を成功の条件にしないでください。記録に REJECT が表示される場合は、サーバーを何度も変更する前に、現在の設定が意図的に拒否していないか確認します。

想定した記録が見つからない場合は、ブラウザーが実際に新しいリクエストを送信したか、接続スイッチがオンのままか、現在の Global Routing がどのモードかを確認します。トラフィックの記録があっても、リクエストが処理されたことを示すだけです。完了したかどうかはページの表示結果と合わせて判断してください。トラブル対処の情報を共有する前に、サーバーアドレス、サブスクリプション URL、認証情報、個人アカウントに関連する情報を隠し、必要な状態とエラー文言だけを残してください。

1回の比較でサーバーとルールを切り分ける

Config で失敗する場合は、一時的に Proxy に切り替え、サーバーと接続先を変えずに再試行します。Proxy では正常で Config では失敗する場合は、設定ファイルの選択、ルールの順序、DNS 設定を優先して確認します。どちらのモードでも失敗する場合は、ネットワークとサーバー情報を続けて確認してください。比較後は、当初使用する予定だったモードに戻します。テスト中に設定を切り替えたまま、実際の設定を忘れないようにしてください。

この手順の完了条件:接続スイッチがオンであることだけでなく、実際のリクエストと記録から接続結果を説明できること。ルールによる振り分けが必要な場合は、PROXY になる想定の接続先と DIRECT になる想定の接続先をそれぞれ確認します。実際の一致結果は現在の設定に基づいて判断し、Web サイトの所在地から推測しないでください。

05 · 失敗した段階ごとに確認する

まず、どの段階で失敗したかを具体的に把握します。Subscribe の内容が読み込まれない、サーバーが timeout になる、スイッチがオンの状態を維持できない、特定のページだけ開かない、といった現象はそれぞれ別の段階で起きています。現在の設定を残すか必要なバックアップを取ってから、一度に1項目だけ調整し、同じテストを繰り返してください。削除して再インストールすることから始めないでください。再インストールしてもサーバー側の設定は修正されず、診断に必要な情報を失う可能性もあります。

ネットワーク、サブスクリプション、設定値を確認する

  1. ネットワーク:接続を切り、Wi-Fi またはモバイル通信で通常のアクセスができることを確認します。Web 認証が必要なネットワークでは、先に認証を完了してください。比較のためにネットワークを一度切り替える場合は、切り替え前後の結果を記録します。
  2. 追加結果:Home にサーバー項目が表示され、そのうち1台が選択されていることを確認します。Subscribe の更新に失敗した場合は、URL が完全で有効か確認してください。サブスクリプション名が表示されたことだけで、読み込みが完了したと判断しないでください。更新中に何度も続けて送信しないでください。
  3. アドレスと認証情報:サーバーの編集画面を開き、Type、アドレス、ポート、パスワードまたは UUID を手元の情報と照らし合わせます。コピー時に入った空白や文字の不足、誤ったプロトコルの選択は、接続失敗の原因になります。
  4. トランスポート設定:TLS、SNI、Host、Path、トランスポート方式も確認します。エラーを消すために証明書検証を安易にオフにしないでください。まずドメイン、証明書の要件、サーバーの設定情報が一致しているか確認します。

Connectivity Test が継続して timeout になる場合は、同じネットワークで別の既存サーバーを選んで比較します。1台だけ失敗する場合は、そのサーバーの設定と状態を優先して確認します。複数台で同時に失敗する場合は、現在のネットワークと共通設定も確認してください。詳しい確認手順はサーバーのタイムアウトを確認する順序をご覧ください。

ルーティング、時刻、システム権限を確認する

一部の接続先だけが失敗する場合は、Global Routing が想定したモードになっているか確認し、Config で有効なファイルを確認します。広い範囲に一致するルールが先にあると、後にある個別ルールより先に適用されることがあります。FINAL は最後の処理に使います。初回利用時は、テストしながら大量のルールを追加しないでください。まず Proxy と Config の比較でルール振り分けの問題かどうかを確認し、その後カスタムルールと照合順序をお読みください。

TLS や証明書に関するエラーが表示される場合は、デバイスの日付、時刻、タイムゾーンも確認してください。時刻のずれは証明書の有効期間の判定に影響するため、パスワードだけ確認しても解決しないことがあります。DNS に関する現象は、失敗した接続先と Data の記録を合わせて判断してください。すべての設定を一度に変更しないでください。アプリが接続できても特定のサービスが失敗する場合は、そのサービスのアカウント状態、アクセス条件、サーバー障害が原因のこともあります。

スイッチがすぐオフに戻る場合や、システムで VPN が何度も切り替わる場合は、VPN 構成が残っているか、別の接続が動作しているか、On Demand に自動接続の条件が設定されているか確認します。デバイスが組織の管理下にある場合は、その管理ポリシーで接続が許可されているか確認してください。許可に関する問題はシステム設定で対処します。サブスクリプションを作り直したり、サーバーのパスワードを変更したりする必要はありません。

ここまで確認しても原因がわからない場合は、最小限の情報を記録します。ネットワークの種類、使用プロトコル、Global Routing のモード、Connectivity Test の結果、失敗した手順、正確なエラー文言をまとめてください。サブスクリプション URL 全体や認証情報は添付しないでください。設定やサーバーの状態はサービス提供元へ確認してください。クライアントの設定やよくあるシステムの問題についてはよくある質問もご覧ください。

確認後に記録しておく項目:接続できるサーバー、現在のルーティングモード、有効な設定ファイルを記録し、必要な情報をバックアップしてからサブスクリプションの更新や On Demand を調整してください。QR コードやクリップボードからの追加、複数のサブスクリプションの整理、削除、バックアップの詳しい手順はサーバー管理マニュアルにまとめています。初回接続時にすべての設定を一度に完了する必要はありません。