V2Ray 訂閱格式解析：Base64 訂閱、原生 JSON 與分享連結轉換教學

先分清訂閱網址、回應本文與節點設定

格式如 https://sub.example.com/list?token=demo 的網址，只負責讓用戶端取得內容，不能光看網址就判斷回傳格式。本文中的網域、UUID 與參數皆為結構示例，不提供可用連線。實際訂閱網址中的權杖通常具有存取權限，分享網址可能因此洩漏整組節點。

傳統 V2Ray 訂閱通常會將多條分享連結逐行串接，再對整段文字進行 Base64 編碼。有些服務也會直接回傳未編碼的連結清單，或依用戶端的請求回傳不同內容。因此，瀏覽器開啟的結果不一定與用戶端更新時取得的內容相同。

v2rayN 與 v2rayNG 的匯入方式

兩款用戶端都能管理常見的 VMess、VLESS 分享連結及傳統連結訂閱，但「能辨識文字」不代表目標核心一定支援其中所有參數。介面名稱會隨版本改變，以下依功能入口說明，避免把訂閱網址貼到單一節點欄位。

v2rayNG 使用 Xray 核心；v2flyNG 使用 V2Fly 核心。即使 JSON 語法正確，也不能據此認定兩種核心都支援其中的安全機制或設定欄位。尤其使用 VLESS、REALITY 等組合時，應先確認目標核心的支援能力，再進行格式轉換。轉換格式無法增加協定支援。

解碼 Base64 訂閱：先檢查外層，再逐行查看

第一步是確認取得的是回應本文，而不是錯誤頁面。若本文開頭是 <!DOCTYPE html>、登入提示或 API 錯誤訊息，就不是待解碼的訂閱內容。只改副檔名或反覆匯入，無法解決驗證過期或服務端回傳錯誤的問題。

1. 將回應本文存成文字檔並保留原始檔。刪除複製時一併帶入的說明文字，不要把 URL 當成 Base64 本文。
2. 若本文已以 vmess:// 或 vless:// 開頭，請先當作明文連結清單處理，不要再解碼整段本文。
3. 若本文是一長串編碼字元，先進行一次外層 Base64 解碼，再依換行拆分並移除空白行。
4. 逐行檢查協定前綴。若某行是 vmess://，後面還可能有一層 VMess 分享資訊編碼；這不代表整份訂閱需要不斷重複解碼。

以下程式碼僅用於在本機空白頁面的開發人員工具主控台處理已取得的文字，不會向訂閱網址發出請求。先執行函式定義，再以 decodeSubscription(prompt("貼上訂閱回應本文")) 呼叫。請勿在不受信任的網頁主控台處理真實憑證。

function decodeSubscription(input) {
  const raw = String(input ?? "").trim();
  if (!raw) throw new Error("本文為空");
  if (/^(vmess|vless):\/\//i.test(raw)) return raw;

  let encoded = raw.replace(/\s/g, "")
    .replace(/-/g, "+").replace(/_/g, "/");
  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) {
    throw new Error("內容不符合 Base64 字元規則");
  }
  encoded = encoded.replace(/=+$/, "");
  if (encoded.length % 4 === 1) {
    throw new Error("編碼長度異常，請確認是否複製完整");
  }
  encoded += "=".repeat((4 - encoded.length % 4) % 4);
  const bytes = Uint8Array.from(atob(encoded), c => c.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

將分享連結轉成 Base64：逐行串接後編碼

若要將明文清單轉成傳統 Base64 訂閱本文，順序是「每行一條連結 → UTF-8 位元組 → Base64」。這只會產生靜態本文，不會自動建立可更新的訂閱服務。將結果存成本機檔案，也不代表用戶端已取得可存取的訂閱 URL。

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

function encodeSubscription(links) {
  const text = links.map(item => item.trim()).filter(Boolean).join("\n");
  const bytes = new TextEncoder().encode(text);
  let binary = "";
  for (const byte of bytes) binary += String.fromCharCode(byte);
  return btoa(binary);
}

const encoded = encodeSubscription([link]);
console.log(encoded);
console.log(decodeSubscription(encoded) === link);

中文備註也會納入編碼內容，因此不宜直接對含中文的字串呼叫 btoa。先使用 TextEncoder 轉成 UTF-8 位元組，可避免字元超出範圍。最後一行的往返比較結果應為 true；這只能確認編碼過程未改變示例文字，無法驗證節點是否可連線。

以上數字是協定編碼規則與設定示例，不是測速結果，也不是所有用戶端版本的預設值。Base64 並非壓縮；忽略尾端填充時，編碼後長度約為原始位元組數的四分之三的倒數，也就是增加約三分之一。

分享連結與原生 JSON：欄位對應不等於完整移轉

以剛才的 VLESS 連結為例，主機與連接埠會填入出站伺服器設定，UUID 會填入使用者設定，security=tls 對應 TLS，sni 對應 TLS 的伺服器名稱。以下是 Xray 格式的單一出站物件，不是可直接執行的完整設定檔，必須放入完整設定的 outbounds 陣列。

{
  "tag": "proxy",
  "protocol": "vless",
  "settings": {
    "vnext": [
      {
        "address": "node.example.com",
        "port": 443,
        "users": [
          {
            "id": "11111111-1111-4111-8111-111111111111",
            "encryption": "none"
          }
        ]
      }
    ]
  },
  "streamSettings": {
    "network": "tcp",
    "security": "tls",
    "tlsSettings": {
      "serverName": "node.example.com"
    }
  }
}

若要組成可執行的設定，還須明確設定本機入站、出站選擇及必要的路由。例如，假設本機 SOCKS 監聽位址為 127.0.0.1:10808，使用該代理的應用程式也必須填入這個位址與連接埠。遠端的 443 不能填成本機代理連接埠；兩者分別位於連線的兩端。

VMess 常見的分享格式，是在 vmess:// 後接上以 Base64 編碼的分享物件。物件中的 add、port、id、net、path 等欄位屬於分享格式約定，並非核心原生設定的頂層欄位。將解碼後的物件直接存成執行設定，通常會因結構不符而失敗。

轉換後驗證：分別確認更新成功與連線成功

訂閱更新成功只代表用戶端取得並解析部分或全部內容，不代表所有節點都能使用。建議保留原訂閱群組，將轉換結果匯入獨立的測試群組；先驗證一個節點，再批次處理。手動匯出的靜態連結也不會保留原訂閱的更新關係。

1. 核對記錄：比較轉換前後的節點數量，檢查是否有空白行、重複記錄或不支援的協定遭到略過。
2. 核對欄位：開啟節點編輯介面，檢查位址、連接埠、UUID、傳輸方式、路徑、SNI 與安全機制；不要只確認備註是否相同。
3. 核對執行狀況：選取測試節點並查看核心記錄。設定解析錯誤、驗證失敗與連線逾時應分別排查。
4. 核對應用程式連線：確認系統代理或應用程式代理指向實際的本機監聽連接埠，再檢查路由是否將測試請求送往預期的出站。