V2Rayのサブスクリプション形式を解説：Base64、ネイティブJSON、vless://共有リンクの相互変換

3つの形式：URL、ノード一覧、完全な設定

「V2Rayのサブスクリプション」は単一のファイル形式を指すものではありません。一般にサブスクリプションURLはHTTPSのURLで、クライアントがアクセスするとノード一覧を取得します。レスポンスは共有リンクを1行ずつ並べたテキストの場合もあれば、その一覧をBase64でエンコードしたものの場合もあります。URLは取得・更新に使い、レスポンスの内容はノードを記述します。両者は置き換えられません。

Base64はエンコード方式であり、暗号化ではありません。デコードできれば、通常はサーバーアドレスや認証情報も確認できます。サブスクリプションURL、デコードしたノード一覧、完全な設定を公開の場に貼り付けないでください。URL内のトークンを使うと他人が更新情報を取得し続けられる場合もあります。パスワードのように見えなくても公開は禁物です。

v2rayNとv2rayNG：適切な読み込み方法を選ぶ

v2rayNはデスクトップクライアント、v2rayNGはXrayコアを使用するAndroidクライアントです。どちらも一般的なサブスクリプション機能はノード一覧を対象としています。対応するプロトコルやパラメーターは、クライアントとコアのバージョンによって異なります。「JSONに対応している」からといって、サブスクリプション更新機能で任意のJSONを読み込めるわけではありません。

1. サブスクリプショングループを作成

   v2rayNのメイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加してサブスクリプションURLを入力します。ここに入力するのはURLです。Base64の本文全体を貼り付けないでください。

2. ノードを更新

   「サブスクリプショングループ」メニューに戻り、「すべてのサブスクリプションを更新（プロキシを使用しない）」を選びます。既存のプロキシ経由でアクセスする必要がある場合は、「プロキシを使用して更新」に相当する項目を試してください。画面によって表記や句読点が異なる場合があります。

3. 単一リンクをテスト

   v2rayNでは「サーバー」→「クリップボードからURLを一括インポート」を選択します。v2rayNGではメイン画面の「+」→「クリップボードからインポート」を選びます。プロトコルリンクだけをコピーし、引用符や説明文は含めないでください。

4. Androidでサブスクリプションを設定

   v2rayNGのメイン画面右上のメニューから「サブスクリプショングループの設定」を開き、「+」でURLを追加して保存します。メイン画面に戻り、メニューから「サブスクリプションを更新」を実行してください。バージョンによってメニュー名が異なる場合は、グループ設定と更新の機能を目印にしてください。

v2flyNGはv2flyコアを使用するため、Xray向けの拡張パラメーターをそのまま流用できるとは限りません。特にREALITYや特定のフロー制御などは、コアの対応状況を事前に確認してください。この記事のフィールド変換例はXray向けであり、異なるコア間の互換性を保証するものではありません。

Base64のデコードと再エンコード：外側の形式だけを変換

一般的なBase64形式のサブスクリプションは、各ノードのリンクを1行ずつ並べたUTF-8テキスト全体をエンコードして作成します。そのため、正しくデコードできれば通常はJSONではなくリンク一覧が表示されます。提供元がリンク一覧を平文で返す場合は、再度デコードする必要はありません。

Macでは、まずBase64形式のサブスクリプション本文をコピーし、ターミナルで次のコマンドを実行します。コマンドはクリップボードの内容を読み取り、ターミナルに出力するだけで、サブスクリプションURLへアクセスするものではありません。出力には認証情報が含まれるため、ターミナル画面を共有しないよう注意してください。

pbpaste | base64 -D

逆に変換する場合は、共有リンクをローカルのテキストファイルに1行ずつ保存してから、ファイルをエンコードします。次のコマンドは、現在のディレクトリにnodes.txtがあることを前提とします。生成されるのは静的なテキストファイルであり、クライアントから更新できるサブスクリプションURLではありません。

base64 -i nodes.txt -o subscription.txt

• デコードに失敗した場合は、誤ってコピーした引用符、コードフェンス、ウェブページの案内文が含まれていないか確認してください。HTTPエラーページもサブスクリプション本文ではありません。
• 標準Base64とURLセーフ形式では使用する文字が異なります。後者では-や_が使われ、末尾のパディングが省略されることもあります。すべてを標準Base64として処理しないでください。
• vmess://の一般的な共有形式には、JSONをエンコードしたデータが含まれています。サブスクリプション全体をデコードした後にこの形式が見えても正常です。すべての行をさらに一括でデコードする必要はありません。
• vless://は通常、URIのフィールドとクエリパラメーターを使います。VMess内部のJSON構造をそのままVLESSリンクの解析に使わないでください。

vless://からJSONへ変換：フィールドごとに対応付け

以下ではTCP + TLSの最小構成を例に、各フィールドの対応を示します。サーバーのドメイン名は説明用、UUIDは形式の例で、実際には接続できません。利用時はサービス提供元から、対応するアドレス、ポート、UUID、TLSパラメーターを入手してください。ドメイン名だけを置き換えても使えるとは限りません。

vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=node.example.com#Example-TLS

これらの数値は設定の説明用で、速度測定の結果でも、すべてのクライアントの初期値でもありません。リモートポートとローカルの待ち受けポートは接続の両端にあるため、同じ値である必要はありません。以下はフィールドの説明用に作成したXray設定で、待ち受けアドレスはローカルのループバックアドレスに限定しています。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "node.example.com",
            "port": 443,
            "users": [
              {
                "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "tcp",
        "security": "tls",
        "tlsSettings": {
          "serverName": "node.example.com"
        }
      }
    }
  ]
}

WebSocket、gRPC、REALITY、Visionを使う場合は、パス、サービス名、公開鍵、短縮ID、フィンガープリント、flowなど、該当するフィールドも対応付ける必要があります。TCPの例にflow=xtls-rprx-visionを追加するだけで変換が完了するわけではありません。トランスポート方式、サーバー設定、コアの対応状況を合わせて確認してください。

JSONから共有リンクへ変換：引き継がれない情報

逆変換では、まず対象のアウトバウンドを特定し、プロトコル、サーバー、ユーザー、トランスポートの設定を確認します。上のJSONにはVLESSのアウトバウンドが1つだけあるため、対応するリンクに変換できます。サーバーやユーザーが複数含まれる場合は、それぞれ個別にリンクを作成する必要があります。1つのURIで複数のオブジェクトを表すことはできません。

1. 対象のprotocol: "vless"を確認し、vnext内のアドレス、ポート、ユーザーUUIDを読み取ります。
2. トランスポートのネットワーク方式とセキュリティ種別を、それぞれtypeとsecurityに設定し、プロトコルに必要なクエリパラメーターを追加します。
3. クエリパラメーターの値とノード名はパーセントエンコードします。たとえばパス/edge?x=1は%2Fedge%3Fx%3D1と記述し、疑問符が誤って解析されるのを防ぎます。
4. サーバーアドレスがIPv6の場合、URI内のアドレスは角括弧で囲みます。アドレス全体をコロンで分割しないでください。
5. 対象のクライアントに再度読み込み、ノードの編集画面で各項目を確認してから実際に接続をテストしてください。

リンクを正常に読み込めても、クライアントは独自のシステムプロキシ、TUN、DNS、ルーティング設定を使用します。元のJSONにある「中国本土の通信は直接接続し、それ以外はプロキシ経由」といったルールは、VLESSノードを1つ読み込んだだけでは引き継がれません。システムプロキシはどのアプリのリクエストをクライアントに渡すかを決め、ルーティングルールは受け取ったリクエストの接続先アウトバウンドを決めます。両者は異なるレイヤーの設定です。

読み込み失敗・接続失敗を段階ごとに切り分ける

まず、サブスクリプションへのリクエスト、本文の解析、ノード表示後の接続のどの段階で問題が起きるか確認します。ノードが表示されるなら、少なくとも一部の形式解析は成功していますが、UUIDやTLSパラメーター、接続先サーバーが正しいとは限りません。