この記事は、利用中のプロバイダーから取得したサブスクリプションをお持ちのShadowrocketユーザー向けです。「内容を取得できない」「取得した内容がサブスクリプションではない」「サブスクリプションに利用可能な項目がない」の3つに分けて、URL、プロバイダーの状態、更新タイミング、ネットワーク経路を確認します。確認中は既存の記録を残し、一度に変更する条件は1つだけにしてください。最後に認証情報を含めず状況をまとめ、端末側で調整する問題か、利用中のプロバイダーに対応を依頼する問題かを判断します。
1. リクエスト失敗・解析失敗・一覧が空の状態を見分ける
サブスクリプションのリンクにノード情報が常に保存されているわけではありません。更新時、クライアントはURLにアクセスしてサーバーから内容を取得し、対応するサーバー項目をローカルの一覧に反映します。どの段階で失敗しても更新エラーに見えることがありますが、対処方法はそれぞれ異なります。
まずHomeで対象のサブスクリプションが折りたたまれていないか確認し、別のグループのノード数を対象の結果と取り違えていないか確認します。次に、更新時に表示されたメッセージをそのまま記録してください。以下の症状から問題の段階を特定できます。「空」というだけでサブスクリプション全体を削除するのは避けましょう。
- しばらく待ってもタイムアウトする:まず現在のネットワークからサブスクリプションのドメインにアクセスできるか確認します。リンクの有効期限切れとは限りません。
- すぐに解析エラーが表示される:応答は受信できていても、ログインページやエラーページ、未対応の形式が返されている可能性があります。
- 更新完了後も対象グループが空:プロバイダーが実際にサーバー項目を返しているか、アプリ内の表示状態に問題がないか確認します。
- 項目はあるが接続できない:サーバーへの接続段階の問題です。サブスクリプションの解析だけの問題ではありません。
画面の説明はiPhone / iPadのHome、Config、Settingsを例にしています。Mac、Windows、Android、Linuxでも「リクエスト・応答・解析・表示」の順に問題を特定できます。ただし、モバイル版のプルダウン操作がデスクトップ版にもあるとは限りません。対象のサブスクリプションの操作メニューから更新してください。
2. URL全体を確認する:管理ページのアドレスを使わない
利用中のプロバイダーのサブスクリプション管理ページに戻り、専用のコピー機能でURLを取得し直します。コピーした内容は端末内だけで確認し、先頭部分、ドメイン、パス、クエリパラメーターが欠けていないかチェックしてください。ブラウザーのアドレスバーに表示されるアカウントのトップページ、注文ページ、ログインページは、通常クライアントが読み込むサブスクリプションのURLではありません。
https://example.com/sub?token=xxxx
上記は構造を説明するためのダミー値であり、インポートには使えません。実際のURLに含まれるtokenなどの項目は、アクセス認証情報に相当する場合があります。ランダムな文字列に見えても削除しないでください。また、別のプロバイダーのパラメーター名を自分のURLに当てはめないでください。
- 先頭や末尾にスペース、改行、引用符、日本語の句読点が混ざっていないか確認します。チャットアプリ上の改行はURLの一部ではない場合があります。実際に貼り付けてから確認してください。
https://が途中で欠けていないか確認します。パスの大文字・小文字、?以降のパラメーター、&の区切りは変更しないでください。- 文字列に
&が含まれている場合は、元のページからコピーし直してください。確認せずにURL全体を一括置換したり、デコードしたりしないでください。 - プロバイダーが複数の出力形式を提供している場合は、Shadowrocket対応と明記されたサブスクリプション形式を選びます。Webページの共有URLやConfigファイル全体のURLを、同じ形式のものとして扱わないでください。
3. プロバイダーからの応答を確認する:ステータスコードと空の応答を分けて対処
ブラウザーでページが開けても、そのURLをサブスクリプションとして使えるとは限りません。ログイン済みのブラウザーはCookieを保持している一方、サブスクリプションのリクエストには同じログイン状態が引き継がれない場合があります。サーバーから認証ページが返されることもあります。HTTPステータスが200でも、本文がHTMLであればクライアントが解析できるサーバーデータとは限りません。
以下のカードでは、エラー詳細やプロバイダーからの回答に表示されるHTTP標準応答を説明しています。Shadowrocketにこれらのメッセージが必ず同じ文言で表示されるという意味ではありません。
HTTP 401 Unauthorized
原因と対処:有効な認証情報がないか、認証情報の有効期限が切れています。プロバイダーのページから有効なサブスクリプションURLをコピーし直し、アカウントの状態を確認してから対象のサブスクリプションを更新してください。
HTTP 403 Forbidden
原因と対処:サーバーが現在のリクエストを拒否しています。アカウント権限、接続元の制限、アクセス方針などが原因の可能性があります。発生時刻とネットワークの種類を記録し、利用中のプロバイダーに確認してください。クライアントのルールを変更しても、サーバー側の権限制限は解除できません。
HTTP 429 Too Many Requests
原因と対処:リクエスト回数の上限に達しています。連続して更新するのはやめてください。応答にRetry-Afterが含まれている場合はその指示に従い、ない場合はプロバイダーが案内する更新間隔を空けて再試行します。
HTTP 503 Service Unavailable
原因と対処:サーバーが一時的にリクエストを処理できない状態です。利用中のプロバイダーのメンテナンス情報を確認し、時間をおいて再試行してください。ローカルのサブスクリプションを削除して追加し直しても、サーバー障害は解決しません。
判断のポイント:本文の種類を確認してからローカル設定を調整する
プロバイダーが応答内容はログインページ、認証ページ、または空の本文だと確認した場合は、まずサブスクリプションの出力をプロバイダー側で修正してもらいます。ローカルでプロトコルを切り替えたりルールの順序を変更したりしても、こうした応答がサーバー項目に変わることはありません。
4. 更新タイミングを見極める:古い項目を残し、一度に1つずつ確認
アカウントプランの変更、サブスクリプション認証情報のリセット、プロバイダーによる項目の変更後は、管理ページとサブスクリプションのエンドポイントに結果が反映されるタイミングが異なる場合があります。何度も続けて更新すると結果を判断しにくくなり、回数制限にかかる可能性もあります。プロバイダーの案内に従って待ち、「最後に試した時刻」と「最後に成功を確認した時刻」を分けて記録してください。
- 現在の状態を記録:元のサブスクリプション名、現在の項目数、エラー内容を記録します。古いノードがまだ使える場合は、グループ全体を削除したり、アプリのデータを消去したりしないでください。
- 新しいURLへの切り替えを確認:認証情報をリセットした場合は、端末内のサブスクリプションURLも置き換えたことを確認します。古いURLのまま何度更新しても、同じエラーが繰り返されます。
- 対象のサブスクリプションだけを更新:Homeで該当するサブスクリプションを見つけて更新します。プルダウンで更新する場合は、どのサブスクリプションへのリクエストが実行されたか確認し、別のサブスクリプションの結果を混同しないようにしてください。
- 完了を待ってから比較:対象グループに項目が表示されたか、数に変化があったか、同じエラーが出たかを確認します。次の条件を変更するのは、1回の操作が完了してからにしてください。
「何度もインポートし直す」ことを、最初に試す修復方法にしないでください。同じ名前のグループが複数作成され、古い項目と新しい項目が共存したり、どの更新が成功したか分からなくなったりすることがあります。記録を作り直す必要がある場合は、有効なURLを保存したことを確認し、削除するサブスクリプショングループを特定してから操作してください。
5. ネットワークを切り替えて確認する:サブスクリプションの取得とノード接続を分ける
サブスクリプションURLにアクセスできることと、特定のノードに接続できることは別の条件です。ノードに接続できてもサブスクリプションのドメインにアクセスできるとは限らず、サブスクリプションを更新できてもすべてのノードに接続できるとは限りません。テストでは同じサブスクリプションURLを使い、Wi-Fiとモバイル通信のどちらか一方だけを切り替えてください。
| 確認結果 | 優先して確認する項目 | 次の手順 |
|---|---|---|
| Wi-Fiでは失敗し、モバイル通信では成功 | Wi-Fiの認証状態、DNS、外部接続の制限 | まずネットワーク認証を完了し、失敗したネットワーク環境を記録します。サブスクリプションの内容はまだ変更しないでください。 |
| どちらのネットワークでも401が返る | サブスクリプションの認証情報とアカウント権限 | 有効なURLをコピーし直し、利用中のプロバイダーに認証を確認 |
| どちらのネットワークでも解析エラーが出る | 応答本文と出力形式 | エンドポイントから実際に返される内容をプロバイダーに確認 |
| 更新は成功するが、接続できない | サーバーアドレス、ポート、接続パラメーター | 接続の問題として調べ、サブスクリプションURLの変更を繰り返さない |
テスト中に接続スイッチが何度も自動でオンになる場合は、Settings → On Demandでオンデマンド接続の条件を確認し、現在の設定を記録してください。機能を理解したうえで一時的に変更し、テスト後に元に戻します。On Demandは接続を開始する条件を制御する機能で、サブスクリプション本文を解析するための設定ではありません。
Global RoutingのProxy、Direct、Config、Sceneはルーティングの動作を制御するもので、サブスクリプションのデータ形式とは関係ありません。無効な内容を修正するためにDOMAIN-SUFFIX、GEOIP、IP-CIDR、FINALを書き換えないでください。ネットワーク経路を調整する必要があるかどうかは、実際のリクエスト結果をもとに判断します。
- 証明書またはTLSのエラーが出た場合は、まずシステムの日付と時刻、プロバイダーのドメインの状態を確認します。問題を隠すために証明書検証を無効にしないでください。
- 公衆Wi-Fiでは、ブラウザーでネットワーク認証を完了する必要がある場合があります。認証ページはサブスクリプションの応答ではありません。
- スクリーンショットや記録には、自分で実施したテストの結果を使ってください。テストしていない場合、「ネットワークを切り替えれば必ず成功する」と結論づけないでください。
6. ノードがまだ表示されない場合:項目を確認して問い合わせ内容をまとめる
対象グループを展開済みで、更新時にネットワークエラーもないのにサーバー項目が表示されない場合は、そのサブスクリプションにエクスポート可能なノードが実際に含まれているか、プロバイダーに確認してください。アカウントの期限切れ、プラン未反映、サーバー側のフィルター設定、出力エラーなどにより内容が空になることがあります。具体的な原因は、アカウントと応答内容を確認したうえでプロバイダーが判断する必要があります。
プロトコル名が同じでも、すべての出力をそのままインポートできるとは限りません。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardでは接続パラメーターが異なります。項目の先頭にあるプロトコル名だけを別のものに置き換えたり、ポートを推測して書き足したりしないでください。Shadowrocket用としてプロバイダーが提供する有効な出力を取得してください。
- 症状を伝える:タイムアウト、解析エラー、更新後に対象グループが空になる、といった状況を説明し、認証情報を隠したエラー画面を添付します。
- 利用環境を伝える:端末のプラットフォーム、システム情報、Wi-Fiまたはモバイル通信の別、別のネットワークでも再現するかを伝えます。
- 発生時刻を伝える:最後に正常に更新できた時刻、障害の発生時刻、タイムゾーンを伝えると、プロバイダーがログを確認しやすくなります。
- 確認してほしい内容を明確にする:「クライアントの不具合ですか」と聞くだけではなく、HTTPステータス、ログインページへのリダイレクトの有無、応答形式、実際の項目数を確認してもらいます。
7. サブスクリプション更新に関するよくある質問
同じURLをブラウザーで開くと内容が見えるのに、インポートに失敗するのはなぜですか?
表示されている内容がサーバーデータかWebページかを確認してください。ログインフォーム、認証メッセージ、アカウント画面が表示されても、サブスクリプションが正常だとは判断できません。Webページのソース全体をHomeに貼り付けないでください。クライアントが実際に取得できるサブスクリプション出力を、利用中のプロバイダーに確認してください。
古いサブスクリプションを削除して、もう一度追加すれば直りますか?
まず削除しないでください。対象のグループ名とエラーを記録し、元のURLが有効か確認してから、一度だけ更新します。記録に誤りがあると確認できた場合や、作り直す必要がある場合に限って該当グループを削除し、まだ使える古い項目まで一緒に消さないようにしてください。
更新したばかりなのに新しいノードがありません。何度もプルダウン更新すべきですか?
連続して更新する必要はありません。まずプロバイダーの管理ページに新しい項目が表示されているか確認し、案内された更新間隔を空けてください。429が表示された場合は再試行を中止します。時間をおいても空のままなら、発生時刻、対象グループ、ネットワークのテスト結果をプロバイダーに伝えて確認してください。
ノードは表示されているのにWebページを開けません。解析失敗に該当しますか?
同じ段階の問題ではありません。まずHomeで選択中のサーバーを確認し、Global Routingの現在のモードと接続結果をチェックしてください。Configを使用している場合は、実際に有効になっている設定も確認します。サブスクリプションの項目が表示された後に何度もインポートし直しても、サーバーへの接続やルールのマッチングの問題は通常解決しません。
Shadowrocketの入手と使い方ガイド
iPhone / iPad版はApp Storeで2.99米ドルの買い切りです。Mac(Appleシリコン / Intel)/ Windows / Android / Linux版は無料です。入手方法は2種類あります。iPhone / iPadのシステム要件はApp Storeの掲載情報をご確認ください。ダウンロードページでお使いの端末を選ぶか、初回のインポートと接続手順をご覧ください。