この記事は、利用中のプロバイダーから発行されたサブスクリプションURLをお持ちの方を対象としています。まず「リクエスト失敗」「内容を解析できない」「取得は成功したが有効な項目がない」の違いを確認し、SubscribeのURL、プロバイダーから返された内容、更新タイミングを順にチェックします。最後に、条件を一つずつ変えてネットワークを確認します。既存の設定は残し、まだ使える項目を先に削除しないでください。
1. まず、どの段階で失敗しているか確認する
Shadowrocketのサブスクリプション更新では、指定したURLから内容を取得し、対応するノード情報をHomeの項目に変換します。サブスクリプションURLを保存できても、サーバーから有効な内容が返されたとは限りません。また、サーバーから成功応答があっても、解析可能なノードが含まれているとは限りません。
現在の状況を記録します。追加直後にエラーが出るのか、更新が終わらずタイムアウトするのか。既存の項目は残っているものの更新に失敗するのか、新しく作ったサブスクリプショングループが空のままなのかも確認してください。以前の項目が残っていても、過去にデータを保存したことが分かるだけで、今回の更新成功を意味しません。ノードに接続できても、サブスクリプションURLが現在も有効とは限りません。
ポイント:状況を記録してから設定を変更
エラーの文面と操作時刻を記録してから、手動で一度更新します。サブスクリプションをすぐ削除したり、設定を切り替えたり、アプリを再インストールしたりすると、どの変更が結果に影響したのか分からなくなります。
2. Subscribeに保存したURLを確認する
サブスクリプションURLは、ご自身が利用しているプロバイダーから取得してください。アカウントのログインページ、注文ページ、ウェブページの共有URLでは代用できません。以下はURLの構成例で、インポートには使えません。パスとクエリパラメーターが一体となって認証に使われる場合があるため、ドメインだけをコピーしないでください。
https://example.com/sub?token=xxxx
-
URLをそのままコピー
ご自身のプロバイダーのアカウントページにあるサブスクリプションのコピー機能を使い、Shadowrocket向けと明記された形式を選びます。スクリーンショットからURLを読み取ったり、ページタイトルまで一緒にコピーしたりしないでください。
-
追加先を確認
Homeの右上にある「+」を選び、TypeをSubscribeに設定して、完全なURLをURL欄に入力します。すでに登録済みの場合は、同じグループを何度も作らず、まず既存の項目を確認してください。
-
URLの前後を確認
先頭の
https://や末尾のパラメーターが、コピー元と一致するか確認します。URLの外側に付いた空白、改行、引用符は取り除いてください。パラメーター内の文字はそのまま残し、?、&、=やパーセントエンコードを勝手に削除・変更しないでください。 -
保存して更新
保存後にHomeへ戻り、リストを下に引いて更新します。処理が完了するまで待ち、対象のグループに項目が表示されるか確認してください。連続してリクエストを送らず、今回の結果を記録します。
単一ノードのURIとサブスクリプションURLは別のものです。ss://、vmess://、trojan://などで始まる単一の情報は、それぞれに対応した方法でインポートしてください。HTTPサブスクリプションURLとしてSubscribeのURL欄に入力することはできません。逆に、サブスクリプションページのURLをプロトコルのサーバーアドレスとして使うこともできません。
サブスクリプションURLにはアカウントのトークンが含まれることがあります。URL全体を公開コメントやスクリーンショットに載せたり、オンラインのデコードツールに入力したりしないでください。問い合わせる際はドメインとエラー情報を残し、パス内のキーや認証情報をすべて伏せてください。
3. HTTPステータスと応答内容を切り分ける
エラーメッセージやプロバイダーのログにHTTPステータスが含まれている場合は、その値から状況を絞り込みます。以下は標準のHTTP応答ステータスであり、すべてのシステムでShadowrocketに同じ文言が表示されるとは限りません。ステータスコードがない場合は実際のメッセージを記録し、「URLの期限切れ」と決めつけないでください。
エラー:401 Unauthorized
原因:サーバーが求める認証に失敗しています。トークンの期限切れや入力漏れ、認証方式の不一致などが考えられます。
対処:ご自身のプロバイダーのアカウントページに戻り、現在のサブスクリプションURLをコピーし直してください。同じステータスが返る場合は、そのトークンに必要な権限があるかプロバイダーに確認します。
エラー:403 Forbidden
原因:サーバーがリクエストを拒否しています。アクセス方針、アカウント権限、セキュリティ上のブロックなどが考えられます。このステータスだけでプランの期限切れとは判断できません。
対処:発生時刻、ネットワークの種類、エラーメッセージ全文を記録し、該当リクエストをプロバイダーに確認してください。制限を回避しようとして何度も更新しないでください。
エラー:404 Not Found
原因:リクエストしたパスが見つかりません。URLの途中切れ、古いURLの無効化、サーバー側によるリソースの非公開化などが考えられます。
対処:アカウントページに表示されているパスとパラメーターを一つずつ照合してください。APIのパスを推測で変更せず、新しいURLでも失敗する場合はプロバイダーに確認します。
200 OKは、HTTPレベルでリクエストが成功したことを示すだけです。応答本文がログインページ、セキュリティ確認ページ、メンテナンスのお知らせ、または空の内容である可能性もあります。ブラウザーで開けても、クライアントがノードを生成できるとは限りません。また、ブラウザーにはアカウントのCookieが保存されている場合がありますが、サブスクリプションのリクエストはログイン済みのウェブセッションと同じではありません。
- 応答本文が
<!DOCTYPE html>または<html>で始まる場合は、サブスクリプションデータではなくウェブページを取得していないか確認してください。 - プロバイダーが複数の出力形式を案内している場合は、Shadowrocket向けの形式を選んでください。ファイルの拡張子だけを変更して形式を変換しようとしないでください。
- Base64でテキストをエンコードしているサブスクリプションもあります。エンコードは暗号化ではなく、内部の情報が正しい形式であることも保証しません。元の内容を第三者サイトに渡さないでください。
- 応答が空、または説明文だけでノード情報がない場合は、Global Routingを変更する前に、アカウントで利用可能な項目とサーバー側の出力を確認してください。
4. プロバイダーの状態と更新タイミングを確認する
サブスクリプショングループが空になる原因として、サーバー側でアカウントに利用可能な項目が割り当てられていない、またはサブスクリプションの出力にアカウントページの状態がまだ反映されていないことが考えられます。アカウント残高、プランの状態、デバイス制限、サブスクリプション権限はそれぞれ別の項目です。ご利用のプロバイダーの案内を確認してください。Shadowrocketの一覧が空であることだけでは、いずれの状態も判断できません。
- アカウントを確認:ご自身のプロバイダーのページにログインし、サービスの状態、有効期限、利用可能な項目の有無を確認します。アカウントページも空の場合は、まずプロバイダーに問い合わせてください。
- URLの変更を確認:サブスクリプショントークンをリセットした直後は、以前のURLが無効になっている可能性があります。Homeに保存したURLと新しいURLを照合してください。ドメインが同じかどうかだけでは判断できません。
- サーバー側の処理を待つ:プランの変更やサービスの復旧直後は、プロバイダーが案内する処理時間を待ってから更新してください。操作を確定すれば、すべてのAPIに即座に反映されるとは限りません。
- リクエスト制限を確認:
429 Too Many Requestsが返された場合は、連続更新を停止します。応答にRetry-Afterが含まれていれば、その指示に従って待ちます。記載がない場合は、更新可能な間隔をプロバイダーに確認してください。
数秒おきに更新することをトラブル対処の手段にしないでください。頻繁なリクエストでレート制限がかかると、形式の問題にアクセス制限まで重なるおそれがあります。古い項目がまだ使える場合は、新しいサブスクリプションの内容が有効と確認できるまで残しておき、あとで重複を整理してください。
ポイント:アカウントページも空なら、まずサーバー側の状態を確認
アカウントページに利用可能な項目がない、またはプロバイダーからサブスクリプションAPIのデータがまだ生成されていないと確認された場合、プロトコル、ルール、DNSを切り替えてもノードは追加されません。まず有効な情報がAPIから返ることをプロバイダーに確認してもらい、その後Homeから更新してください。
5. 条件を一つずつ変えてネットワークと接続状態を確認する
タイムアウト、ドメイン名の名前解決失敗、TLSエラーはそれぞれ発生する段階が異なります。タイムアウトは接続が確立しない場合だけでなく、応答が返り終わらない場合にも発生します。証明書エラーでは、システム時刻、接続先ドメイン、サーバー証明書を確認してください。証明書の検証を無効にして解決しようとせず、条件を一つだけ変えて結果を比較します。
-
現在の状態を記録する
Wi-Fiとモバイル通信のどちらを使用しているか、Homeの接続スイッチの状態、Global Routingの現在の選択肢、実際のエラーメッセージを記録します。DNSとルールを同時に変更しないでください。
-
接続するネットワークを切り替える
同じサブスクリプションURLと同じ接続状態のまま、Wi-Fiとモバイル通信を切り替え、それぞれ一度ずつ更新します。片方のネットワークだけで失敗する場合は、そのネットワークのログイン認証、DNS、アクセス制限を優先して確認してください。
-
自動接続を確認する
手動で接続を切っても再び自動接続する場合は、Settings → On Demandで接続条件が有効か確認してください。現在の設定を記録し、一時的に自動接続を停止してテストした後、元に戻します。
-
接続前後を比較する
利用可能なノードがすでにある場合に限り、切断時と接続時の更新結果を比較します。インポートに成功していないサブスクリプションを使って接続することはできません。また、サブスクリプションのリクエストが必ず選択中のノード経由で送信されるとは限りません。
Global RoutingのConfig、Proxy、Direct、Sceneは、トラフィックの処理方法に関係する設定であり、ウェブページをノードに変換する機能ではありません。Config内のDOMAIN-SUFFIX、GEOIP、IP-CIDR、FINALはルールキーワードで、サブスクリプション解析を修復するスイッチではありません。一覧が空の場合は応答内容を先に確認し、その後、必要に応じてルールや通信経路を調べてください。
プロバイダーのトップページを開けても、そのウェブページに現在アクセスできることが分かるだけです。サブスクリプションAPI、リダイレクト先、認証パラメーターがすべて有効である証明にはなりません。比較テストでは、同じサブスクリプションリクエストの結果を記録してください。
6. プロバイダーへの問い合わせが必要な場合と伝える情報
新しいURLでも認証エラーが続く、アカウントページには項目があるのにAPIの応答が空、またはプロバイダー指定の形式でも解析できない場合は、ご自身のプロバイダーに問い合わせてください。何度もローカルの項目を削除するより、APIの権限、応答内容、形式の互換性、リクエストログを確認してもらう方が効果的です。
- 日時:サーバーログと照合できるよう、発生日、具体的な時刻、タイムゾーンを伝えます。
- 操作:HomeでSubscribeを追加して初めて更新した際のエラーか、既存のサブスクリプションを手動更新した際のエラーかを説明します。
- 状況:エラーメッセージを一字一句そのまま残し、既存の項目が残っているか、対象グループを展開したか、一覧が空のままかを伝えます。
- 利用環境:OSの種類、ネットワークの種類、接続状態、条件を一つずつ変えたテストの結果を伝えます。他のアプリのアカウント情報は不要です。
- 情報の保護:公開の場では、ドメインを伏せ字にした情報とエラーのスクリーンショットだけを共有してください。トークンを提出する必要がある場合は、プロバイダーが指定した非公開のサポート窓口を利用します。
修復後はHomeに戻り、手動で一度更新して対象グループに項目が表示されることを確認してから、既存の項目を選んで接続をテストします。項目の表示と接続の成功は別々の確認項目です。前者はサブスクリプションの取得と解析を確認し、後者はノードのアドレス、ポート、プロトコル設定、現在のネットワークにも左右されます。項目が表示されているのに接続できない場合は、接続のトラブル対処に進み、サブスクリプションを作り直す必要はありません。
この記事は、ご自身でプロバイダーを利用し、サブスクリプションをお持ちであることを前提としています。当サイトではノードやサブスクリプションの提供・販売・推奨は行っていません。クライアントの入手と接続サービスは別のものです。クライアントの買い切り購入と接続プランは別々に扱われます。