V2Rayのサブスクリプション更新・解析エラーの原因と対処法

サブスクリプション更新はどの段階で失敗する？

サブスクリプションリンクは、クライアントが複数のサーバー設定を取得するための入口です。ノードそのものでも、WebアカウントのログインURLでもありません。更新時には、クライアントがリンクにリクエストを送り、テキストを取得して、その中のノード情報をローカル設定に変換します。どの段階で失敗しても画面上は「更新失敗」と表示されることがありますが、対処法は原因によって異なります。

ログに接続タイムアウトが表示されたら、まず通信経路を確認します。サーバーからアクセス拒否が返された場合は、アカウントとリンクを確認してください。テキストを取得できているのに解析に失敗する場合は、形式を調べます。更新に成功しても接続できない場合は、その後の問題です。サーバーアドレス、ポート、プロトコル、伝送パラメーターを確認し、サブスクリプションURLをむやみに変えないでください。

• 更新がタイムアウトする：待機時間内にリクエストが完了していません。サブスクリプションの内容が正しいかどうかは、まだ判断できません。
• 解析に失敗する：応答内容からインポート可能なノードを認識できていません。Webページが返されたか、クライアントが対応していない形式の可能性があります。
• ノードが0件：実際に空の一覧が返された場合のほか、解析できない項目がすべてスキップされた場合や、画面で別のグループを表示している場合もあります。

既存のノードを残して、サブスクリプションリンクを確認

最初にすべてのサーバーを削除しないでください。クライアントによっては、更新時に該当グループの項目を置き換えることがあり、更新失敗時の動作もバージョンによって異なります。まず設定をバックアップしてください。使えるノードが残っている場合は、後でプロキシ経由の更新を試すために保管しておきましょう。バックアップにはサブスクリプションの認証情報やノードの接続情報が含まれることがあるため、信頼できる端末だけに保存してください。

1. 現在の状態を記録する

   クライアントのバージョン、サブスクリプショングループ名、更新前のノード数、エラーが発生した時刻を記録します。デスクトップ版v2rayNでは「ヘルプ」→「バージョン情報」からバージョンを確認できます。画面の項目名が異なる場合は、現在のクライアントに表示されている名称を確認してください。

2. URL欄を確認する

   v2rayNで「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、対象グループのサブスクリプションURLを編集します。URL全体が正しく貼り付けられていること、前後に空白や改行、全角引用符、チャットアプリが付けた説明文が混ざっていないことを確認してください。

3. リンクを再取得する

   サービス提供元のアカウントページで、サービスの有効期限とサブスクリプションのリセット状況を確認し、有効なリンクをコピーし直します。リセットすると古いURLが使えなくなることが多いため、パソコンとAndroid端末の両方でリンクを差し替えてください。

4. グループごとに更新する

   まず問題のあるグループだけを更新し、すべてのグループを同時に操作しないでください。現在のバージョンに「すべて更新」しかない場合は、ログに表示されたグループ名を見て結果を確認しましょう。別のグループの成功メッセージを、対象のサブスクリプションが復旧したと誤認しないようにしてください。

直接更新とプロキシ経由の更新

「ブラウザーでサブスクリプションURLを開ける」ことと「クライアントで更新できる」ことは、同じ確認ではありません。ブラウザーはシステムプロキシやキャッシュ、ログイン状態を使う一方、サブスクリプションのリクエストはクライアント独自の通信経路を使う場合があります。逆に、システムプロキシを有効にしても、更新リクエストが必ずプロキシ経由になるとは限りません。更新方法を明示して試してください。

v2rayNの「サブスクリプショングループ」メニューには通常、「すべてのサブスクリプションを更新（プロキシを使用しない）」と「すべてのサブスクリプションを更新（プロキシを使用）」の2つの項目があります。括弧の表記やグループ単位の操作名は、バージョンによって異なる場合があります。プロキシ経由の更新を試す前に、確実に使えるノードを選択してコアを起動し、該当する操作を実行してください。v2rayNGとv2flyNGでは、サブスクリプション設定や更新メニューを開き、使用中のバージョンにプロキシ経由の更新機能があるか確認します。デスクトップ版のメニュー名をそのまま当てはめないでください。

• 一度に変える条件は1つだけにします。まず直接更新を試し、次にプロキシ経由で更新して、それぞれのエラーを記録してください。
• ローカルプロキシのポートを変更した場合は、クライアントに現在表示されている値を確認してください。更新経路が古いポートを参照している場合は、設定も合わせて変更します。
• 自宅のネットワークとスマートフォンのテザリングを切り替えると、ネットワークの違いを切り分けられます。ただし、期限切れのサブスクリプショントークンが有効になるわけではありません。

HTTPステータスコードとよくあるエラー

以下の数字はHTTPステータスコードであり、クライアントのバージョン番号ではありません。クライアントログの表現は、OSや言語、通信ライブラリによって異なります。文言が例と完全に一致するかではなく、ステータスコード、例外の種類、失敗した段階を確認してください。

429 Too Many Requestsが表示された場合は、連続したリクエストを止め、サーバーが指定する時間だけ待ってください。500や503の場合は、サーバー側の状態を確認します。タイムアウト時間を延ばすと遅いリクエストが完了する場合はありますが、間違ったURL、認証拒否、解析できない内容は解決できません。

リクエスト成功後に解析エラーが出る場合：応答形式を確認

HTTPの200はリクエストの成功を示すだけで、応答本文が有効なサブスクリプションであることまでは保証しません。サーバーからログインページ、アクセス案内、メンテナンス告知、空文字列が返る場合もあります。ブラウザーで何か表示されても、それがノード情報なのかWebページなのかを確認し、Webページを無理にサブスクリプションとしてインポートしないでください。

Base64はエンコード方式であり、暗号化方式ではありません。サブスクリプション全体がBase64エンコードされている場合もあれば、個々の共有リンクにエンコード済みのパラメーターが含まれる場合もあります。手動で再エンコードやデコードをしたり、文字を書き換えたりすると、元の形式が壊れることがあります。内容を確認する必要がある場合は、信頼できるローカル環境だけで行い、サブスクリプションのテキストを公開デコードサイトに送信しないでください。

• VMess：一般的な共有形式は、vmess://にエンコードされたパラメーターを続けたものです。テキストが途中で切れていると、必要な項目を復元できない場合があります。
• VLESS：一般的な共有形式はvless://のリンクです。クエリパラメーターに含まれる伝送設定やセキュリティ設定も構成の一部なので、サーバーアドレスだけを残してはいけません。
• クライアント用サブスクリプション：完全なコア設定とノード共有リストは別の入力形式です。特定のプロトコルを実行できても、すべてのサービス提供元のサブスクリプション形式を解析できるとは限りません。

ノードが0件になる場合とクライアントの互換性

v2rayNはデスクトップクライアントです。v2rayNGはXrayコア、v2flyNGはv2flyコアを使用します。コアの機能とクライアントのインポート機能の両方が結果に影響します。コアは設定を実行できるかどうかを、クライアントはサブスクリプションの項目をローカルのノードに変換できるかどうかを左右します。名前にV2Rayが含まれていても、3つのクライアントがすべてのパラメーターに同じように対応するとは限りません。

たとえば、Xray固有の機能を使うVLESS + REALITY設定がサブスクリプションに含まれている場合、v2flyNGでも同じ設定をそのまま使えるとは限りません。Xrayを使う場合でも、クライアントとコアのバージョンがサービス提供元の指定するフィールドに対応しているか確認してください。使用端末に合った安定版に更新し、対応する形式のサブスクリプションを取得するほうが、伝送やセキュリティのパラメーターをむやみに削除するより確実です。

1. グループのフィルターを確認：更新後に検索キーワードを消し、対象のサブスクリプショングループに切り替えます。ノードが画面上のフィルターで非表示になっていないか確認してください。
2. 全件失敗か一部失敗かを確認：本来複数のノードがあるのに一部しかインポートされない場合は、スキップされた項目のプロトコルや伝送方式を確認してください。サブスクリプション全体が期限切れだとすぐに判断しないでください。
3. 実際のバージョンを記録：問題を報告する際は、クライアントとコアのバージョンをそれぞれ伝えてください。「最新版」とだけ書いても、互換性の違いを特定できません。
4. 元のパラメーターを保持：UUID、サーバーポート、伝送パス、サーバー名などはサーバー側の設定と一致している必要があります。インポート時の警告を消すために値を書き換えると、その後の接続に失敗するおそれがあります。

サブスクリプション更新のよくある質問と問い合わせ時の情報

ここまでの手順でも復旧しない場合は、「サブスクリプションが使えない」とだけ伝えるのではなく、再現できる条件を添えて問い合わせてください。クライアント側の解析問題とサーバー側の認証問題を分けて説明すると、メンテナーやサービス提供元が対応箇所を判断しやすくなります。

• 端末のOS、クライアント名とバージョン、コアのバージョン。
• エラーの発生時刻、対象グループ、直接更新とプロキシ経由の更新それぞれの結果。
• HTTPステータスコードまたは例外メッセージの原文と、応答内容がWebページ、空のテキスト、ノード一覧のどれか。
• 更新前後のノード数、すべてのグループで失敗するかどうか、最近サブスクリプションをリセットしたか。
• 機密情報を伏せたログの一部。サブスクリプションURL全体、トークン、UUID、ノードの認証情報は必ず隠してください。