V2Rayのサブスクリプションを解析できない・インポート後に一覧が空になる原因と確認方法

1. 既存ノードを残し、失敗した段階を切り分ける

サーバーをすべて削除したり、何度も再インストールしたりするのは避けましょう。サブスクリプションの更新は通常、URLへのアクセス、応答本文の読み込み、本文からノード一覧への変換という3段階で行われます。どの段階で失敗しても一覧が空に見えることがありますが、対処方法はそれぞれ異なります。

クライアントのバージョン、エラーが発生した時刻、グループ名、ログの全文を記録します。バージョンは「ヘルプ」→「バージョン情報」または設定画面で確認してください。メニュー名はバージョンによって異なる場合があります。問い合わせ時は「最新版」だけでなく、正確なバージョン番号を伝えましょう。利用できるノードがある場合は、クライアントのバックアップまたはエクスポート機能でローカルに保存してください。ファイルに認証情報が含まれる可能性があるため、公開しないでください。

2. サブスクリプションURLとグループ設定を確認する

サブスクリプションURLは複数のノードを取得するための入口であり、サービス提供元のトップページでも、個別ノードのサーバーアドレスでもありません。vmess://やvless://で始まるものは、通常は単一ノードの共有リンクです。クリップボードからノードをインポートする機能を使ってください。HTTPまたはHTTPSのURLもアカウントページの場合があるため、先頭の文字だけでサブスクリプションだと判断しないでください。

1. URLをコピーし直す

   サービス提供元のアカウントページでサブスクリプションの項目を開き、使用するクライアントに合った形式を選んでコピーし直します。ブラウザーのアドレスバーに表示されたアカウントページのURLや、チャットのプレビューで途中までしか表示されていないリンクをコピーしないでください。

2. URL全体を確認する

   ローカルのテキストエディターで、先頭や末尾の空白、改行、余分な引用符がないか確認します。クエリパラメーターの&、=、%などはそのまま残してください。トークンを手作業で「整形」したり、URLデコードを繰り返したりしないでください。

3. サブスクリプショングループを確認する

   v2rayNの一般的なデスクトップ画面を例にすると、「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、対象グループを追加または編集して、名前とサブスクリプションURLを入力し保存します。現在のバージョンで画面構成が異なる場合は、同名のグループ管理機能を探してください。サブスクリプションURLをサーバーアドレス欄に入力しないでください。

4. 対象グループだけを更新する

   メイン画面に戻り、保存したグループを選択して、「サブスクリプショングループ」から現在のサブスクリプションを更新します。最初の切り分けでは対象グループだけを更新し、他のグループのエラーログが混ざらないようにしましょう。追加されたノード数とエラー全文を記録してください。

サービス提供元がサブスクリプショントークンをリセットしている場合、古いURLを開いて案内ページが表示されても、ノード情報は取得できなくなっている可能性があります。その場合は、ブラウザーで新しいURLを試すだけでなく、グループに保存したURLを差し替えてください。アカウントの期限切れ、通信量の上限、デバイス制限がサブスクリプションの取得に影響するかどうかは、提供元の仕様によります。アカウントページで確認しましょう。

3. 更新リクエストの経路を確認する：直接接続かプロキシ経由か

ブラウザーでページを開けても、クライアントがサブスクリプションを更新するときに同じネットワーク経路を使っているとは限りません。ブラウザーはシステムプロキシを使う一方、クライアントの更新機能は直接接続する設定になっていることがあります。逆に、更新時にプロキシを選んでいても、ローカルコアが起動していない、または接続中のノードが使えない場合はリクエストに失敗します。

• 使える既存ノードがある場合：既存ノードを選択して接続できることを確認してから、v2rayNの「サブスクリプショングループ」メニューで「プロキシ経由」を含む現在のサブスクリプション更新項目を選びます。
• 使えるノードがない場合：まず「プロキシを使用しない」を含む更新項目を試します。現在のネットワークからサブスクリプションのドメインに接続できない場合は、提供元に予備のURLを問い合わせるか、そのURLにアクセスできるネットワークに切り替えてください。
• プロキシ経由の更新がすぐ失敗する場合：コアが起動しているか、ローカルのリスニングポートが開いているか、更新機能が使用するポートが現在の設定と一致しているかを確認してください。
• 特定のネットワークだけで失敗する場合：信頼できる別のネットワークで一度だけ再試行し、ローカルDNS、ネットワークのアクセス制限、サーバー側の障害を切り分けます。複数の設定を同時に変更しないでください。

ローカルプロキシのポート番号に共通の固定値はありません。10808はよくある設定例のひとつですが、現在のクライアント設定に表示されるリスニングポートを確認してください。手動でプロキシを設定してテストする場合、HTTPプロキシとSOCKSプロキシを任意に入れ替えることはできません。システムプロキシを使ってテストした場合は、終了後に元の設定へ戻し、他のアプリにテスト用設定が残らないようにしてください。

4. ステータスコードとよくあるエラーを読み解く

次の3種類のステータスコードはHTTPリクエストの結果を示すもので、ノードの速度測定結果ではありません。数値はプロトコル上の意味を示しており、本サイトでの実測値ではありません。特に、200が返ってもサーバーから何らかの内容を正常に受信したというだけで、有効なサブスクリプションとは限りません。

ログの文言はクライアントのバージョンやOSによって異なります。以下はネットワークリクエストでよく見られるエラー文またはその一部です。ログに内部例外も記録されている場合は、末尾の1行だけでなく内部の原因もあわせて確認してください。

応答の先頭に<!DOCTYPE html>、ログインフォーム、人間確認ページなどが含まれている場合、クライアントが取得したのはノード一覧ではなくウェブページです。ブラウザーはログイン状態を利用して認証を通過できても、単体のクライアントには同じCookieがありません。ログイン後のページURLではなく、クライアント用のサブスクリプション取得URLを使ってください。

5. 形式・文字コード・ノードの互換性を確認する

「V2Rayサブスクリプション」が、どのクライアントでも使える共通ファイル形式を指すとは限りません。内容は、1行ごとの共有リンク、Base64でエンコードされたリンクの一覧、特定クライアント向けの完全な設定ファイルなどさまざまです。JSON設定、YAML設定、共有リンクの一覧は用途が異なり、拡張子の変更や再エンコードだけでは相互変換できません。

VMess共有リンクに含まれるエンコードデータと、VLESS共有リンクのURI構造は異なります。サブスクリプション全体のエンコード、個々のリンク内部のエンコード、URLのパーセントエンコードもそれぞれ別のものです。何度もデコードしたり、文字を手作業で補ったり、トークン内部の半角記号を全角に変えたりすると、正常なデータを壊すおそれがあります。長いテキストを手作業で修正するより、元の内容を取得し直してください。

• 文字化けしているがインポートできる場合：まずノード名だけが文字化けしているか確認します。名前の表示異常だけで、サーバーアドレス、ポート、認証情報が壊れているとは限りません。
• 一部のノードだけインポートされる場合：読み込まれなかったノードのプロトコル、通信方式、関連パラメーターを確認し、クライアントと選択中のコアが対応しているか調べてください。
• 同じサブスクリプションでも別のクライアントでは失敗する場合：v2rayNGはXrayコア、v2flyNGはv2flyコアを使用します。対応するパラメーターの範囲が完全に同じとは限りません。v2rayNでは、現在選択しているコアも確認してください。
• クライアントを更新して再テストする場合：まず現在の設定をバックアップし、ダウンロードページからOSに合ったバージョンを選んでください。クライアントの更新で形式への対応が改善することはありますが、サーバーが返すエラーページは修正できません。

6. 更新成功なのに一覧が空：表示状態を確認してから解析を調べる

「成功」と表示されても、リクエストが終了しただけで、ノードが追加されたとは限りません。まず画面で選択中のグループを確認し、検索欄を空にして、フィルターが有効になっていないか調べます。同じ名前のグループが複数ある場合は、対象グループに識別しやすい名前を一時的に付け、Aグループの更新ログとBグループの一覧を混同しないようにしましょう。

1. 更新前後の件数を記録する：対象グループのノード数と、ログに表示されたインポート件数をそれぞれ記録します。画面では0件でもログにインポート済みと表示される場合は、グループとフィルター条件を優先して確認してください。
2. 応答本文が空かどうかを確認する：今回の応答をローカルで確認し、内容を公開しないでください。応答が空ならサーバーとアカウントの状態を確認します。内容があるのにインポート件数が0の場合は、形式を調べてください。
3. 単一リンクで問題を切り分ける：安全に完全な共有リンクを取得できる場合は、クライアントの「クリップボードからインポート」機能でテストします。単一リンクはインポートできるのに全体を読み込めない場合は、サブスクリプション全体の形式や、ノード以外のテキストの混入を確認してください。
4. 実際の接続を確認する：インポートに成功したらノードをひとつ選び、実際の接続テストを行ってから、アプリがプロキシ経由でアクセスできることを確認します。一覧が戻ったのは解析が復旧したことを示すだけで、すべてのリモートノードが使えるとは限りません。

失敗するたびにすぐ更新を繰り返さないでください。短時間に何度もリクエストすると頻度制限がかかり、元の形式の問題とは別にアクセスできなくなるおそれがあります。ログに429が表示されたら、リクエストを止め、サーバーの案内に従って待ってから再試行してください。待ち時間の案内がない場合は、提供元に制限のルールを確認しましょう。

7. サブスクリプションのトラブル対処：よくある質問と復旧確認