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

一、訂閱網址、編碼與節點設定屬於不同層級

「V2Ray 訂閱」並非嚴格統一的檔案格式。用戶端會先連線至訂閱 URL，再解析伺服器回傳的內容。常見內容是多行分享連結，或將這些連結整段以 Base64 編碼；有些服務也會直接回傳 JSON。網址以 HTTPS 開頭，只能表示取得內容的方式，無法保證內容一定能由特定匯入工具辨識。

JSON 本身只是語法，並不代表特定設定類型。包含 add、id、net 等欄位的 VMess 分享物件，即使通過 JSON 語法檢查，也不能直接當成完整的 Xray 設定執行。反過來說，把完整設定編碼成 Base64，也不會自動變成用戶端支援的節點訂閱。

二、Base64 訂閱：先解碼，再逐行解析

傳統節點訂閱常以換行符號串接多個分享連結，再將整段 UTF-8 文字編碼。用戶端取得內容後，會先還原文字，再逐行辨識協定。VMess 也可能在單一連結內再包一層 Base64，因此「外層訂閱解碼成功」不代表「內層節點欄位有效」。

1. 取得內容：確認收到的是訂閱資料，而非登入頁面、存取限制說明或伺服器錯誤頁面。
2. 判斷外層格式：如果內容已以分享連結開頭，先當成純文字處理，不要直接重複解碼。
3. 解碼：還原外層 Base64 後，確認是否得到每行一個連結的文字。
4. 解析節點：辨識每行使用的協定，再檢查伺服器位址、連接埠、使用者識別碼與傳輸參數。

標準 Base64 常見字元包括 +、/，結尾可能有 =。有些來源使用 URL 安全變體中的 - 和 _，或省略結尾的填充字元。不同匯入工具的容錯能力不一；不能只因為「沒有等號」就判定訂閱損毀，也不能把整段 Base64 當成 URL 百分比編碼處理。

// 本機 JavaScript 範例：輸入為已取得的多行分享連結文字。
// TextEncoder / TextDecoder 用來保留中文節點名稱。
function encodeSubscription(text) {
  const bytes = new TextEncoder().encode(text);
  let binary = "";
  for (const byte of bytes) {
    binary += String.fromCharCode(byte);
  }
  return btoa(binary);
}

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

這段程式碼只會轉換文字，不會連線取得訂閱，也不會驗證節點是否可連線。解碼失敗時，先檢查內容是否遭截斷，或是否混入說明文字；即使解碼成功，仍須交由支援相應協定的用戶端解析。瀏覽器直接以中文呼叫 btoa() 可能會發生錯誤，因此範例會先轉換成 UTF-8 位元組。

三、VMess 與 VLESS 分享連結：逐一對應欄位

常見的 vmess:// 分享格式，是在協定前綴後附上一個以 Base64 編碼的 JSON 物件。以下是編碼前的物件，屬於常見的分享慣例，並非完整的核心設定。網域與 UUID 僅用於說明結構，不能直接作為可用節點。

{
  "v": "2",
  "ps": "VMess WS 範例",
  "add": "node.example.org",
  "port": "443",
  "id": "2d1e7e18-49f4-4ab7-8b63-c929d11c5e29",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "node.example.org",
  "path": "/proxy",
  "tls": "tls",
  "sni": "node.example.org"
}

v 是分享物件的格式標記，不是用戶端版本；ps 是備註；add 和 port 是連線目標；net、host、path 描述傳輸層。此處的 aid 值為零，不能據此推論 VLESS 也有同名參數。不同分享格式可能省略欄位，匯入後請回到節點編輯頁面核對。

VLESS 分享連結通常採用 URI 結構：使用者識別碼位於 @ 前，伺服器與連接埠位於其後，查詢參數用來描述傳輸與安全設定，# 後方則是備註。以下與後文的 JSON 使用相同的範例參數。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=node.example.org&path=%2Fproxy&sni=node.example.org#Example-WS

• security=tls 表示傳輸安全層使用 TLS；encryption=none 是 VLESS 參數，兩者並非互相衝突的設定。
• type=ws 對應 WebSocket；path=%2Fproxy 解碼後為 /proxy。
• host 是 WebSocket 要求標頭中的主機資訊，sni 則用於 TLS 伺服器名稱；兩者可能相同，但不能任意互換。
• IPv6 位址在 URI 中必須加上方括號；備註含有空格、中文或特殊符號時，應依 URI 規則編碼。

四、原生 JSON：除了節點參數，還包含執行環境

原生 Xray 設定描述整個程序的運作方式。入站決定本機應用程式從何處連入，出站決定要求如何傳送至伺服器，路由與 DNS 則決定分流及解析方式。以下是用來對照欄位的最小設定，採用 VLESS、WebSocket 與 TLS；範例位址不提供實際服務。

{
  "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.org",
            "port": 443,
            "users": [
              {
                "id": "2d1e7e18-49f4-4ab7-8b63-c929d11c5e29",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "node.example.org"
        },
        "wsSettings": {
          "path": "/proxy",
          "headers": {
            "Host": "node.example.org"
          }
        }
      }
    }
  ]
}

這兩個連接埠的用途不同。10808 綁定本機迴路位址，只是範例設定，不代表每台裝置的實際值；443 是遠端監聽連接埠，必須與伺服器設定一致。如果本機已有程序監聽相同位址與連接埠，啟動第二份設定可能會失敗。

• 連結轉 JSON：將節點參數對應至一個出站，再明確補上入站、DNS 與路由；連結通常不包含這些本機設定。
• JSON 轉連結：從可轉換的節點出站擷取參數；若有多個出站，通常須分別處理，不能預設合併成單一節點。
• 保留策略：routing、dns、入站監聽與記錄設定，通常不會隨單一節點分享連結一併移轉。
• 核心相容性：Xray 與 V2Fly 支援的欄位和協定能力有所不同；v2rayNG 使用 Xray，v2flyNG 使用 V2Fly，不能只因兩者都接受 JSON，就認定設定通用。

五、v2rayN 與 v2rayNG：選擇正確的匯入入口

用戶端介面名稱可能隨版本與介面語言而異。以下依常見的簡體中文選單說明；操作前，先確認剪貼簿內容是訂閱 URL、單一節點連結，還是完整 JSON。尤其不要將 HTTPS 訂閱網址當成一般節點連結匯入。

v2rayN：分開匯入訂閱群組與單一節點

1. 新增訂閱群組

   在主畫面依序選擇「訂閱分組」→「訂閱分組設定」，再於清單中選擇「新增」，填寫備註和訂閱網址後儲存。網址中的查詢參數必須完整保留。

2. 更新訂閱

   返回「訂閱分組」選單，選擇更新目前或所有訂閱；如果選單提供透過代理或不透過代理的選項，請依目前網路的實際連線狀況選擇，再查看更新記錄。

3. 匯入單一節點

   複製完整的 vmess:// 或 vless:// 連結，在主視窗選擇「伺服器」→「從剪貼簿匯入批次 URL」，常見快捷鍵為 Ctrl+V。

4. 確認連線參數

   開啟節點編輯視窗，確認位址、連接埠、UUID、傳輸類型、路徑與 TLS 伺服器名稱。匯入成功只表示解析完成，不代表能連上伺服器。

v2rayNG：訂閱群組與剪貼簿匯入

• 訂閱網址：開啟右上角選單 →「訂閱分組設定」→「+」，填寫備註和 URL；儲存後返回主畫面，從選單執行「更新訂閱」。
• 分享連結：複製一條或多行連結，在主畫面選擇「+」→「從剪貼簿匯入」，接著確認節點數量與備註。
• 完整 JSON：使用目前版本提供的自訂設定匯入入口，不要以一般節點編輯表單取代。Android 的執行方式不同於桌面本機 SOCKS 使用情境，不能直接照搬桌面入站設定，就假定能接管應用程式流量。

六、轉換方式：依需要保留的內容選擇

「轉換成功」至少包含三種標準：文字可解碼、用戶端可匯入、連線行為符合預期。即使前兩項都通過，仍可能遺失路由、DNS、指紋或傳輸擴充參數。先確認移轉目標，通常比急著尋找轉換按鈕更能節省排查時間。

移轉後先查看記錄是否有設定解析或監聽錯誤，再選擇一個節點確認實際連線。桌面版也要檢查系統代理或應用程式內代理是否指向正確的入站；Android 則須確認連線服務已啟動，並依系統提示授予 VPN 介面權限。測速有結果與瀏覽器流量確實經過代理，是兩種不同的驗證方式。

七、匯入與轉換常見問題