サブスクリプションURLの取り込み方法:v2rayN と v2rayNGの入口と一般的な形式
v2rayNのデスクトップ版「サブスクリプショングループ」とv2rayNGの「サブスクリプション設定」への取り込み方法を紹介し、Base64形式と単一ノード共有リンクの違い、取り込み後の更新とノード確認について説明します。
サブスクリプションURLを取得済みで、どの画面に貼り付ければよいか分からない方に適した記事です。v2rayNとv2rayNGでグループを作成し、ノードを取得して利用する設定と、ログ・遅延テスト・実接続による確認方法を説明します。
まずサブスクリプションURLと単一ノード共有リンクを区別する
サブスクリプションURLは特定のノードそのものではなく、クライアントが定期的に取得するリモートリソースです。サーバーから返される本文には通常、複数のノード情報が含まれており、クライアントが解析して同じサブスクリプショングループに登録します。ノード名、サーバーアドレス、ポート、通信パラメータが変更されても、グループを更新するだけで反映でき、ローカル設定を一つずつ編集する必要はありません。
単一ノード共有リンクは一つの設定だけを表します。一般的な先頭部分には vmess://、vless://、trojan://、ss:// があります。このような内容はクライアントの「クリップボードから取り込む」またはスキャン取り込みを使い、サブスクリプションURLとして保存しないでください。単一ノードリンクをサブスクリプション設定に誤って入力すると、更新失敗、解析不能な応答、更新後もノード数が0件になるといった問題が起こります。
リモートサブスクリプションURL
- 内容の範囲
- 1件または複数のノード
- 取り込み先
- サブスクリプショングループまたはサブスクリプション設定
- その後の管理
- サブスクリプションを更新
- 代表的な応答
- HTTP 200とテキスト本文
サーバー側でノード一覧をまとめて変更する運用に適しており、クライアントには取得先とグループ情報が保存されます。
単一ノード共有リンク
- 内容の範囲
- 単一ノード設定
- 取り込み先
- クリップボードから取り込む
- その後の管理
- 再取り込みまたは手動編集
- プロトコル識別子
- VMess、VLESS、Trojan、SS
一時的に単一設定を追加する用途に適しており、リモート更新可能なサブスクリプショングループは自動作成されません。
Base64形式のサブスクリプション本文
- 外側の形式
- 連続したエンコード文字列
- デコード結果
- 複数行の共有情報
- 処理場所
- クライアントが自動解析
- 手動操作
- 通常は自分でデコードする必要はありません
「Base64サブスクリプション」は本文のエンコード方式を指すもので、新しいプロキシプロトコルを意味するものではありません。
構造化されたサブスクリプション本文
- 外側の形式
- JSONまたはクライアント対応形式
- ノード数
- 応答内容によって決まる
- 対応範囲
- クライアントとコアに依存
- 異常時の症状
- 未対応形式または項目不足
ブラウザーでURLを開けても、その本文が現在のクライアントで認識できる形式とは限りません。
- URLが
http://またはhttps://で始まる場合は、通常まずサブスクリプションURLとして扱います。 - プロトコル識別子で始まり、単一の設定だけを示す内容は、単一ノード共有リンクとして扱います。
- 非常に長いエンコード文字列はサブスクリプション本文の可能性があるため、「サブスクリプションURL」入力欄に直接貼り付けないでください。
- QRコードにはサブスクリプションURLが含まれる場合も、単一ノードリンクが含まれる場合もあります。スキャン後は実際の内容を確認して種類を判断してください。
v2rayNデスクトップ版でサブスクリプションを取り込む
v2rayNはWindows、macOS、Linuxのデスクトップ環境で利用できます。バージョンによって入口が「サブスクリプショングループ」「サブスクリプショングループ設定」など異なる場合がありますが、基本手順は同じです。まずグループとリモートURLを保存し、その後に手動で更新を実行します。設定画面にURLを保存しただけでは、メイン一覧にノードが自動表示されるとは限りません。
-
グループを開く
v2rayNを起動し、メイン画面上部から「サブスクリプショングループ」→「サブスクリプショングループ設定」を開きます。設定項目がサイドバーにある場合は、同じ名前のサブスクリプショングループ項目を選択してください。
-
サブスクリプションを新規作成
「追加」または「+」をクリックし、識別しやすいグループ名を別名欄に入力します。URL欄には
https://またはhttp://で始まるサブスクリプションURLを完全に貼り付けてください。URLの前後に空白や改行を残さないでください。 -
コアを確認する
使用中のコアを確認する場合は、「設定」→「パラメータ設定」→「Core タイプ」の順に開きます。VLESSやRealityなどの設定は通常、対応するバージョンのXrayコアで処理する必要があります。VMessなども、取得したサブスクリプションの通信方式に選択中のコアが対応していることを確認してください。
-
グループを保存する
グループが有効になっていることを確認して保存します。メイン画面に戻った時点で新しいノードがまだ表示されなくても、保存に失敗したとは限りません。まだリモートへのリクエストを実行していない可能性があります。
-
すべて更新
「サブスクリプショングループ」→「すべてのサブスクリプションを更新」を開きます。初回の取り込みでは、まずプロキシを使わずに更新してみてください。現在のネットワークから既存の設定を経由しないとURLにアクセスできない場合は、プロキシ経由の更新に切り替えます。
-
アクティブに設定
更新完了後、メイン一覧でノードを一つ選択し、Enterキー、右クリックメニュー、または画面の「アクティブサーバーに設定」から有効化します。その後、システムプロキシまたはTUNモードを設定してください。
更新後はまずステータスバーやログを確認します。成功時には、サブスクリプション更新完了、新規設定数、一覧更新などの記録が表示されます。失敗時には、タイムアウト、名前解決失敗、証明書エラー、HTTPステータス異常、形式解析失敗などが表示されることがあります。ノード名が表示されたことは本文の解析を示すだけで、そのノードで接続できることを保証するものではありません。
v2rayNのシステムプロキシとサブスクリプション取り込みは別々の工程です。サブスクリプションはリモート設定を一覧に登録し、システムプロキシはシステムプロキシ設定を利用するアプリをローカルの待ち受けポートへ接続します。ターミナルの通信がシステムプロキシに従うかは各プログラムの設定によります。ブラウザーに接続できても、すべてのコマンドライン通信が同じ経路を通るとは限りません。
v2rayNG Android版でサブスクリプションを取り込む
v2rayNGはXrayコアで設定を処理します。初回接続時には、システムからVPN接続の許可を求められます。この許可はローカルのVpnService経路を確立するためのもので、サブスクリプションURLを取得できるかどうかとは別の問題です。先にサブスクリプションの追加と更新を済ませ、ノードを選択してから接続を開始すると、問題がリモートURL、設定解析、実際の接続のどこで起きているかを切り分けやすくなります。
-
設定を開く
v2rayNGのメイン画面でメニューを開き、「サブスクリプション設定」または「サブスクリプショングループ設定」を選択します。メニュー名はバージョンによって多少異なります。メイン画面の手動設定編集入口は選ばないでください。
-
URLを追加する
右上の「+」をタップし、サブスクリプションの備考と完全なURLを入力します。備考はローカルで識別するためだけのもので、「日常用グループ」や「予備グループ」などと入力できます。サーバーから返される内容は変わりません。
-
グループを有効にする
サブスクリプションが有効になっていることを確認して保存します。複数のサブスクリプションがある場合は個別に有効化できます。更新時、クライアントは有効な項目を順番にリクエストします。
-
更新を実行する
メイン画面に戻り、右上のメニューから「サブスクリプションを更新」を選択します。完了通知が表示されたら、ノード数とグループ名を確認してください。更新中に何度もタップしないでください。
-
設定を選択する
ノードをタップして現在の設定にし、遅延テストまたは接続テストで到達性を確認します。テスト結果が空の場合は、同じサブスクリプションを繰り返し追加せず、ログを確認してください。
-
接続を開始する
メイン画面の接続ボタンをタップし、初回起動時はシステムの指示に従ってVPN接続を許可します。ステータスバーに接続中の表示が出てから、対象アプリを開いて実際のアクセス結果を確認してください。
両端末で同じサブスクリプションを使う設定
デスクトップ版 v2rayN
- 「サブスクリプショングループ設定」でリモートURLを保存
- 更新後にアクティブサーバーを選択
- 用途に応じてシステムプロキシまたはTUNを有効化
- ログでリクエストとコアの起動結果を確認
Android版 v2rayNG
- 「サブスクリプション設定」で同じリモートURLを保存
- 更新後に現在の設定を選択
- VpnService接続の許可を確認
- 必要に応じてアプリごとのプロキシ範囲を設定
両端末で同じサブスクリプションを利用できますが、更新履歴、現在のノード、ルーティング設定は各端末に個別保存されます。選択状態が端末間で同期されることはありません。
端末で厳しい省電力設定が有効な場合は、v2rayNGをバックグラウンド実行の許可対象に追加してください。省電力制限は初回取り込みを妨げないことが多い一方、画面消灯後の通信を停止し、次回更新のタイムアウトや接続中断を招くことがあります。アプリごとのプロキシ設定はサブスクリプション内容を変えず、接続後にどのアプリをローカルVPN経路へ通すかだけを決めます。
v2flyNGとv2rayNGは役割が異なります。v2flyNGはv2flyコア、v2rayNGはXrayコアを使用します。同じサブスクリプション内の基本的なVMess設定はどちらでも認識できる場合がありますが、特定のフロー制御、Reality、または一方のコアだけが対応する項目では互換性が異なることがあります。サブスクリプションの解析後も、各ノードのプロトコル、通信方式、コアの対応範囲を確認してください。
更新後にノードが本当に使えるか確認する方法
サブスクリプションの取り込みには、少なくともURLリクエストの成功、本文形式の解析、コアによるノード設定の読み込み、対象先への接続確立という4段階があります。どこか一つで失敗しても、最終的には「使えない」としか見えないことがあります。段階ごとに確認すれば、削除と再追加を繰り返すより効率的に原因を切り分けられます。
- グループを確認:新しいノードが想定したサブスクリプショングループに表示され、ノード数が0件ではなく、名前が解読不能な長いエンコード文字列になっていないことを確認します。
- プロトコルを確認:個別設定の詳細を開き、プロトコル、サーバーポート、通信方式、TLS、SNI、serverNameなどの項目が正しく入力されているか確認します。
- 遅延を確認:クライアントの遅延テストを実行します。タイムアウトはテスト経路から応答がなかったことを示すだけなので、ネットワーク到達不能、ハンドシェイク失敗、テスト方式の制限をログと合わせて判断してください。
- コアのログを確認:現在のノードを起動してログを確認します。ポートの競合、未対応の設定項目、DNS解決、TLSハンドシェイク、ルーティングの一致に注目してください。
- ローカル入口を確認:デスクトップでは、システムプロキシがクライアントの実際の待ち受けポートを指していることを確認します。画面にローカル混合ポートとして
10808と表示されている場合、アプリ側も同じポートを使う必要があります。他の端末の古い値をそのまま使わないでください。 - 実際の通信を確認:現在の経路でのアクセスが必要な対象を開き、クライアントのログに新しい接続と対応するアウトバウンドが記録されるか確認します。接続ボタンの色だけでは、実際の通信がプロキシを通っているとは判断できません。
遅延値だけでノードの品質を判断することはできません。サーバーによってはクライアントの探測方式に応答しなくても、実際のTCPまたはTLS接続は確立できる場合があります。逆に遅延テストが速くても、すべてのプロトコル項目が正しいとは限りません。テスト結果、コアのログ、対象サイトへのアクセスを合わせて確認し、結果が一致してから日常用設定として利用してください。
確認の順番
1. サブスクリプションを更新:HTTPリクエストと解析結果を確認
2. ノードを選択:プロトコルと通信項目が揃っているか確認
3. コアを起動:ローカルポートが待ち受け状態か確認
4. アクセスを実行:接続がどのアウトバウンドに入ったか確認
5. ルーティングを確認:対象が誤って直結または遮断されていないか確認
よくある取り込み失敗と対処法
最も多い問題は、クライアントに「取り込み」機能がないことではなく、URLの種類、コピーした内容、リクエスト環境が想定と合っていないことです。まず元のサブスクリプション項目を残し、エラー情報を確認してください。すべての設定をすぐに削除すると、元のグループ名、更新方法、エラー発生時の情報が失われ、かえって切り分けに手間がかかります。
更新をクリックするとサブスクリプション内容が空になる場合は?
まずURL全体をコピーし直し、先頭や末尾に空白、改行、日本語の句読点が混ざっていないか確認します。次に同じネットワークからURLへアクセスして内容が返ることを確認してください。リクエストが成功しても本文が空なら、リモート側に現在設定がない可能性があり、クライアントがノードを生成することはできません。
ブラウザーでは開けるのに、クライアントで解析に失敗するのはなぜ?
ブラウザーでページを受信できるのは、ネットワークリクエストに応答があったことを示すだけです。返された内容がログインページ、エラー表示、HTML文書、または現在のクライアントに対応しないサブスクリプション形式である可能性があります。クライアントログの応答ステータスと解析エラーを確認し、管理画面のURLではなくサブスクリプションURLを取得していることを確認してください。
取り込み後にノードが1件しかないのはなぜ?
リモート本文がもともと1件だけの場合もあれば、単一ノード共有リンクを貼り付けている場合もあります。保存先を確認してください。サブスクリプションURLはサブスクリプション設定に、単一ノードリンクはクリップボード取り込みで登録します。グループ更新ログに解析結果が1件と明記されている場合は、サーバーから実際に返された内容を基準にしてください。
更新後も古いノードが消えないのは正常?
まず古いノードが同じサブスクリプショングループに属しているか確認します。手動で取り込んだノードは通常、サブスクリプション更新では削除されません。他のグループのノードにも影響しません。バージョンによっては古い設定を保持、上書き、削除する項目があるため、サブスクリプショングループ設定で更新方針を確認してください。
TLS証明書エラーが出たらサブスクリプションを再追加すべき?
まず端末の日付、時刻、タイムゾーンを確認し、次にサブスクリプションのドメイン名と証明書名が一致しているか確認します。時刻のずれは証明書の有効期限判定に影響します。同じURLを再追加しても、システム時刻、名前解決、証明書チェーンの問題は解決せず、重複したグループが増えるだけです。
サブスクリプション更新は成功したのに、すべてのノードで接続に失敗する場合は?
リクエストと解析の段階はおそらく完了しているため、ノード設定と接続ログを確認します。コアの種類、プロトコル項目、サーバーポート、SNI、通信経路、ルーティング規則を確認してください。異なるノードで同じローカルポート競合エラーが出る場合は、まず端末側の待ち受け競合を解消します。
- タイムアウトが表示される:ネットワークを切り替えて再試行し、DNS解決を確認します。プロキシ経由とプロキシなしの両方で更新結果を比較してください。
- 認証エラーが表示される:サブスクリプションURLが有効か確認し、リダイレクトや途中で切れた内容をWebブラウザーのアドレスバーからコピーしないようにしてください。
- 形式エラーが表示される:単一ノードリンク、QRコードの文字列、WebページのソースコードをサブスクリプションURL欄に入力していないか確認してください。
- ノードが重複する:同じグループを重複して作成していないか、手動取り込みとサブスクリプション取り込みで同名の設定を同時に残していないか確認してください。
- 更新後すぐに古い一覧へ戻る:別のグループを操作していないか、クライアントがバックアップ設定を再読み込みしていないか確認してください。
サブスクリプション、グループ、ルーティングの関係
サブスクリプショングループはノードの取得元と一括更新を管理し、ルーティング規則は接続をどのアウトバウンドへ送るかを決めます。サブスクリプションを更新しても、「直結」「プロキシ」「ブロック」などの規則は自動調整されず、ユーザーが設定したドメインやIPの振り分けも置き換わりません。取り込み後も特定の対象が直結される場合は、ノードの更新を繰り返すのではなく、ルーティングの一致順を確認してください。
用途ごとに「日常」「テスト」「予備」など、分かりやすいグループを残すことをおすすめします。同じURLで似た名前の項目を複数作らないようにしてください。更新前後のノード数は記録しても、件数の増加を品質向上と同一視しないでください。実際の選択は、プロトコルの互換性、接続ログ、現在のネットワーク環境を基準にします。
日常の更新とトラブル対処を分けて実行する
日常のメンテナンス
- 安定したグループ名を維持する
- 必要に応じてサブスクリプションを更新する
- 更新後にアクティブノードを抜き打ち確認する
- 検証済みの予備設定を1件残す
異常時の対処
- まず更新ログとコアのログを読む
- リクエスト、解析、接続の各段階を区別する
- ローカルポートとルーティング規則を確認する
- 一度に変更する項目は一つだけにする
サブスクリプション、ノード、コア、ローカルプロキシ、ルーティングは連続している一方、それぞれ独立した工程です。順番に確認すれば、問題がどこにあるかをすばやく絞り込めます。
サブスクリプションURLは個人の接続設定の一部として扱い、公開ページに掲載したり、不要な相手に転送したりしないでください。端末を変更する場合は、新しい端末のクライアントでサブスクリプショングループを作り直します。URLが変更された場合は、提供元から案内された新しいURLに置き換えてから、完全な更新を実行してください。
取り込み完了後、v2rayNユーザーはシステムプロキシまたはTUN設定を、v2rayNGユーザーはVpnServiceとアプリごとのプロキシ範囲を引き続き確認してください。サブスクリプション更新は設定を取得するだけで、どのアプリ、ドメイン、IPをプロキシ経由にするかは決めません。工程を分けて理解しておくと、「ノードはあるのに通信が経由しない」問題も切り分けやすくなります。