V2Ray 訂閱格式比較：Base64 訂閱、原生 JSON 與 vmess:// 分享連結轉換

一、訂閱網址、Base64 與 JSON 是不同層次的概念

貼到用戶端的訂閱網址通常是 HTTPS URL。用戶端連線後，才會取得節點清單或設定內容。網址結尾有沒有 .json，並不能決定內容格式；同一個介面也可能依請求參數或用戶端識別資訊回傳不同內容。排查時應查看實際回應，而不是只看檔名。

常見的 Base64 訂閱會先將多條分享連結逐行排列，再把整段 UTF-8 文字以 Base64 編碼。這不會把節點轉成另一種協定，也不具備保密功能。取得內容的人通常可以還原伺服器位址與驗證資訊，因此訂閱網址本身應視為憑證妥善保管。

二、vmess://：外層 Base64 與內層節點 JSON

常見的 VMess 分享格式是 vmess:// 加上一串 Base64 字串，解碼後會得到節點描述物件。以下展示解碼後的範例。網域和 UUID 僅用於說明結構，不能實際連線；v 的值 "2" 代表分享格式版本，不是核心版本。

{
  "v": "2",
  "ps": "VMess WS 範例",
  "add": "node.example.net",
  "port": "443",
  "id": "e7c3a416-5c9e-4f2b-9d81-73d14a9b8620",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "node.example.net",
  "path": "/gateway",
  "tls": "tls",
  "sni": "node.example.net"
}

這裡的 JSON 不是可直接交由核心執行的設定。它沒有完整的 outbounds 階層，欄位名稱也採用分享格式的簡寫。轉換成原生設定時，必須將 add 對應到伺服器位址，將使用者資訊放入相應協定的使用者陣列，再分別建立傳輸與 TLS 設定。

三、vless://：UUID、查詢參數與備註的界線

VLESS 分享連結通常採用 URI 結構，而不是將整份 JSON 包進 Base64。以下是 VLESS over TCP + TLS 的教學範例；不使用 REALITY，也未設定 Vision 流量控制。

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

• vless:// 後、@ 前的部分是 UUID；@ 後則是伺服器位址與連接埠。IPv6 位址寫入 URI 時必須加上方括號。
• encryption=none 表示 VLESS 本身不在這一層進行內容加密；本例仍透過 security=tls 使用 TLS 保護連線。
• type=tcp 指定傳輸類型，sni 指定 TLS 伺服器名稱。不同用戶端與核心版本對傳輸名稱的呈現方式可能不同。
• # 後方是顯示備註，%20 代表空格。備註不會參與伺服器端驗證。
• 只有在伺服器端、傳輸組合與核心都支援時，才能使用 flow=xtls-rprx-vision；不是所有 VLESS 連結都需要加上這個參數。

如果取得的是 REALITY 節點，還要逐項檢查連結中的 security=reality、pbk、sid、fp 與 sni。這些參數無法從 UUID 或伺服器位址推算，也不能透過「VMess 轉 VLESS」自動補齊。核心最終產生的欄位應以相應版本為準。

四、在本機解碼並重新編碼 Base64 訂閱

訂閱內容可能包含存取權杖與有效 UUID。處理實際內容時，建議使用本機文字工具或瀏覽器空白頁面的開發者工具，不要上傳到不明的轉換網站。以下函式只會轉換傳入的字串，不會發出網路請求，也不需要貼上訂閱網址。

function decodeBase64Utf8(input) {
  let text = input.trim().replace(/\s+/g, "")
    .replace(/-/g, "+").replace(/_/g, "/");
  text += "=".repeat((4 - text.length % 4) % 4);
  const bytes = Uint8Array.from(atob(text), ch => ch.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

function encodeBase64Utf8(input) {
  const bytes = new TextEncoder().encode(input);
  let binary = "";
  for (const byte of bytes) binary += String.fromCharCode(byte);
  return btoa(binary);
}

const demoLink =
  "vless://[email protected]:443" +
  "?encryption=none&security=tls&type=tcp&sni=node.example.net#Example";

const subscription = encodeBase64Utf8(demoLink + "\n");
console.log(subscription);
console.log(decodeBase64Utf8(subscription));

這段程式碼支援常見的 Base64URL 字元替換，並會補上結尾填充。UTF-8 轉換是為了正確處理中文備註；直接對中文呼叫 btoa() 可能會出錯。執行前請先看懂程式碼，也不建議將實際憑證留在公用裝置的主控台紀錄中。

1. 取得訂閱的回應本文後，先確認內容是否已以 vmess:// 或 vless:// 開頭。若是明文連結，就不必再解碼外層。
2. 如果內容是 Base64，先解碼一次，再依換行拆分。移除空行即可，但不要刪除 URI 內的有效字元，也不要改動區分大小寫的路徑。
3. 對每條 vmess:// 移除前綴後，分別呼叫解碼函式，再用 JSON.parse() 檢查物件結構。
4. 若要還原成清單訂閱，請用換行符號串接完整的分享連結，再呼叫編碼函式。不要編碼介面上顯示的節點名稱。

如果回應以 <!DOCTYPE html> 開頭，請先檢查登入狀態、網址是否過期，或介面是否回傳錯誤頁面。即使解碼後是合法 JSON，也要進一步判斷它是錯誤訊息、節點陣列還是完整的核心設定。Base64 解碼成功，只能證明內容可以還原，不代表一定能連線。

五、將分享連結整理成 Xray 原生 JSON

以下將前述 VLESS TLS 範例整理成最小執行設定，方便查看各層結構。它會在本機 127.0.0.1:10808 建立 SOCKS 入站，並連線至範例網域的 443 連接埠。該位址沒有可用服務，設定僅供欄位比對；實際執行前須替換成伺服器提供的參數。

{
  "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.net",
            "port": 443,
            "users": [
              {
                "id": "e7c3a416-5c9e-4f2b-9d81-73d14a9b8620",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "tcp",
        "security": "tls",
        "tlsSettings": {
          "serverName": "node.example.net",
          "allowInsecure": false
        }
      }
    }
  ]
}

本例沒有另外撰寫 routing，預設會透過第一個出站處理請求，也未提供分流規則集或系統代理設定。啟動 SOCKS 監聽連接埠，不代表系統中的所有應用程式都會自動使用它。若 10808 已被桌面用戶端占用，請先停止重複執行的執行個體或更改連接埠。

「原生 JSON」也不代表能跨核心通用。Xray 與 V2Fly 共用部分設定結構，但協定功能與欄位演進並不完全相同。例如，含有 REALITY 的 Xray 設定不能只更改檔名就交給 V2Fly 使用。轉換工具應清楚標示輸入格式、輸出核心與參數涵蓋範圍。

六、v2rayN 匯入：分別處理訂閱網址與剪貼簿連結

以下以 v2rayN 7.x 繁體中文介面的常見選單為參考，不同小版本的標點與入口位置可能有所調整。先確認手上的內容是 HTTPS 訂閱網址、單一分享連結，還是完整設定檔，再選擇相應入口。將網頁網址貼到節點匯入視窗，常會出現「沒有有效內容」之類的結果。

1. 新增訂閱網址：開啟「訂閱群組」→「訂閱群組設定」，新增群組，填入備註及服務提供者給的訂閱 URL，儲存後選取該群組。
2. 取得節點清單：在「訂閱群組」選單中選擇更新目前訂閱的功能。若可直接連線，先使用不經代理的方式更新；若直連逾時但現有代理可用，再選擇透過代理更新。
3. 匯入單一連結：複製完整的 vmess:// 或 vless://，選擇「伺服器」→「從剪貼簿匯入批次 URL」。多條連結請逐行排列，並保持每條連結完整。
4. 匯入完整設定：在伺服器選單中找到自訂設定匯入入口，選取本機 JSON 檔案並指定所需核心。不要預期系統會自動將它拆解成可逐項編輯的一般節點。
5. 檢查實際運作狀況：將節點設為目前使用項目並重新載入，查看記錄是否出現設定解析、連接埠占用或 TLS 交握錯誤，再實際發出網頁請求。

手動匯入的節點通常只是當下的快照。服務提供者日後更換位址或 UUID，不會自動更新已複製的連結；更新訂閱則可能覆蓋該群組中的節點。需要長期保留的手動修改，建議放在獨立群組，避免與訂閱管理的項目混在一起。

七、訂閱解析與格式轉換常見問題

完成格式轉換後，應依序確認：內容能解析、欄位能對應、核心能啟動、請求能通過。保留原始訂閱或設定作為參照，只修改副本。更多欄位結構請參閱設定大全，協定名稱與傳輸術語可對照術語表。