Shadowrocketのサブスクリプション更新に失敗・ノードが空になる場合の確認手順

1. 更新失敗とノードが空の状態を切り分ける

サブスクリプションの更新は、URLへのアクセス、応答内容の取得、内容からのノード解析という3段階で行われます。いずれかで失敗すると、Homeに目的のノードが表示されないことがありますが、対処方法は異なります。既存ノードが残っていて更新時にエラーが出る場合は、まずリクエストが成功しているかを確認します。初回登録後にノードが1つも表示されない場合は、応答内容がノード用のサブスクリプションかどうかも確認してください。

「更新成功」と「ノードに接続できる」は別の状態です。前者はサブスクリプションへのリクエストと解析が完了したことを示します。後者はノードのアドレス、ポート、認証情報、利用中のネットワークにも左右されます。ここでは一覧を取得できない問題を先に解決し、一覧が戻った後で接続テストを行います。

2. URLの完全性とサブスクリプションの種類を確認する

サブスクリプションURLはノード一覧を取得するためのアドレスで、アカウントのログインページやプロバイダーのトップページではありません。コピーする際は、利用中のプロバイダーが用意したサブスクリプションのコピー機能を使い、プロトコル、ドメイン、パス、疑問符以降のクエリパラメーターを確認します。チャットアプリ上の改行、末尾の句点、引用符、省略表示などによって、見た目が似たURLでも別のアドレスになることがあります。

https://example.com/sub?token=xxxx

上記は形式の例であり、実際に使えるサブスクリプションではありません。実際のURLはパスやパラメーター名が異なる場合があるため、例に合わせて書き換えないでください。特に ? 以降を削除したり、&、=、パーセントエンコードされた文字を手動で置き換えたりしないでください。認証情報はパスに含まれている場合もあり、必ずしも token という名前ではありません。

1. URLをコピーし直す

   利用中のプロバイダーのアカウントページから、Shadowrocket向けのサブスクリプションURLをコピーし直します。形式を選べる場合は、プロバイダーのShadowrocket向け案内に従ってください。アカウント管理ページのURLをコピーしないようにしましょう。

2. サブスクリプションの種類を確認する

   Homeの右上にある「+」から追加画面を開き、TypeでSubscribeを選択します。単一ノードの共有情報と、複数ノードを取得するサブスクリプションURLは用途が異なります。WebページのURLを、特定プロトコルのサーバーアドレスとして入力しないでください。

3. URL欄を確認する

   URL欄に完全なリンクを入力し、前後に空白、改行、余分な句読点がないか確認します。見分けやすい名前を付けてもかまいませんが、認証情報を丸ごと名前に記載しないでください。

4. 保存して更新する

   保存後にHomeへ戻り、サブスクリプションを更新します。プルダウンで更新する場合は対象サブスクリプションの結果を確認し、そのグループ内にノードが表示されるかを見てください。原因を調べている間はこのサブスクリプションだけを変更し、ほかのソースを同時に調整しないようにします。

3. 応答結果からプロバイダー側の状態を確認する

エラーメッセージにHTTPステータスコードが含まれている場合は、原因を絞り込む手がかりになります。以下は各ステータスコードの一般的な意味であり、すべてのバージョンで同じエラーメッセージ全文が表示されるとは限りません。画面に一般的な失敗表示しかない場合は、実際の文言を記録し、該当リクエストの結果を利用中のプロバイダーに確認してください。

アカウントが有効か、通信量を使い切っていないか、現在のプランに利用可能なノードが含まれているかも確認します。プロバイダーによって、エラーコード、説明文、空の一覧など応答方法は異なります。ブラウザーでURLを開いてログイン画面、セキュリティ確認画面、アカウント案内が表示される場合、ステータスコードが200でもノードとして解析できる内容ではありません。また、ブラウザーで内容を確認できても、アプリのリクエストに同じ応答が返るとは限りません。

• 応答本文が空：サブスクリプションのAPIに一時的な問題がないか、現在のアカウントにノードが割り当てられているか確認します。
• HTMLページが返る：コピーしたURLが、ログイン操作を必要とするWebページではなく、サブスクリプションのエンドポイントか確認します。
• テキストは読めるが解析できない：Shadowrocketに対応した形式で出力されているかプロバイダーに確認し、異なる設定形式を混在させないようにします。

4. タイムアウト時はリクエスト経路を確認してから更新タイミングを見直す

タイムアウトは、制限時間内にリクエストが完了しなかったことを示すだけで、URLの期限切れを直接意味するものではありません。まず現在のWi-Fiまたはモバイル通信でほかのWebサイトにアクセスできるか確認します。公共Wi-Fiでネットワークへのログインが必要な場合は、先に認証を済ませてください。同じサブスクリプションを別のネットワークで一度更新すると、ローカルネットワークの制限かサブスクリプションサーバーの問題かを切り分けやすくなります。

サブスクリプションのリクエスト経路は、ノードの接続テストと完全には同じではありません。Settings → Subscribe のUpdate via Proxyは、サブスクリプション更新をプロキシ経由で送信するかどうかを切り替えます。この設定が役立つ可能性があるのは、利用可能なノードがすでにあり、接続が確立し、リクエストがサブスクリプションのエンドポイントまで届く場合です。初回登録で一覧が完全に空のときは、まだ存在しないノードを使って更新することはできません。

接続スイッチをオフにしてもすぐオンに戻る場合は、Settings → On Demandに自動接続の条件が設定されていないか確認します。この機能は接続するタイミングを制御するもので、誤ったURLを正しいサブスクリプションに修正するものではありません。調査時は元の設定を記録し、条件をそろえてテストする必要がある場合に限って一時的にオフにし、完了後に戻します。また、Global Routingを何度も切り替えて解決を試みないでください。Proxy、Direct、Config、Sceneは通信の処理方法であり、サブスクリプション形式を変換する設定ではありません。

5. ノードが空の場合はグループと応答内容を確認する

更新後にHomeへ戻り、更新したサブスクリプショングループを表示しているか確認します。折りたたまれたグループを展開し、検索条件もクリアしてください。グループが閉じていたり検索語が残っていたりすると、「ノードが表示されない」だけで、実際にサブスクリプションからノードが返されていないとは限りません。ほかのサブスクリプションは正常で1つだけ空の場合は、そのグループの取得元を優先して調べ、すべてのサブスクリプションを同時にリセットしないようにしましょう。

• グループはあるが内容が空：応答にノードが含まれているか確認してください。通信量情報、期限の案内、空の内容だけが返っていないか、プロバイダーに問い合わせます。
• 一部のノードだけ表示される：サブスクリプション側のフィルター条件、プロバイダーの出力範囲、表示されない項目の形式が対応しているか確認します。
• ノードは表示されるが接続できない：一覧の取得と接続の問題を切り分けられました。次に対象プロトコルのアドレス、ポート、認証情報を確認します。
• 更新後に既存の一覧よりノード数が減った：プロバイダーがノード構成を変更した可能性を確認します。ノード数が減っただけでクライアントの解析エラーと決めつけないでください。

6. 再登録の前に記録しておく情報

再登録は、端末に保存された古いURLや誤った項目の修正には役立ちますが、プロバイダー側のAPI障害は解決できません。古いサブスクリプションを削除する前に、完全なURLを再取得できることを確認し、手動で追加したノード、既存グループ名、現在選択中のノードを記録します。サブスクリプションに使えるノードが残っている場合は、接続を一緒に失わないよう、元の項目を優先して残してください。

1. エラー内容を記録：実際のメッセージ、発生時刻、利用ネットワーク、更新リクエストがプロキシ経由だったかを記録します。「使えない」だけでは情報が不足します。
2. 現在のURLを確認：利用中のプロバイダーのアカウントページからコピーし直します。古いチャット履歴に保存したURLは使わないでください。
3. アカウントからの出力を確認：アカウントが有効で、エンドポイントが復旧しており、このURLから少なくとも1つの利用可能なノードが返されることを確認します。
4. 新しい項目を個別に検証：再追加が必要な場合は、Home →「+」→ Type → Subscribeで見分けやすい名前を付け、更新テストを1回だけ行います。
5. 検証後に整理：新しい項目でノードを展開でき、接続テストも想定どおりであることを確認してから、無効と確認できた古いサブスクリプションを削除します。名前が同じという理由だけで一括削除しないでください。

復旧しない場合は、上記の記録を利用中のプロバイダーに伝え、問題が「リクエストのタイムアウト」「HTTPエラー」「リクエスト成功後も一覧が空」のどれかを説明してください。初期調査には、URL全体が写ったスクリーンショットよりもこうした情報が役立ちます。認証情報の変更が必要な場合は、プロバイダーが提供する安全なサポート窓口を利用してください。

7. よくある質問