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

先釐清三種格式：訂閱網址不是節點設定

結論：先確認取得的內容，再選擇匯入方式。以 https:// 開頭的訂閱網址只是取得內容的入口；回應本文才會決定用戶端收到的是 Base64 節點清單、明文分享連結，還是其他格式。直接對網址本身進行 Base64 解碼，不會得到伺服器設定。

Base64 不具保密功能。訂閱網址中的存取權杖、節點 UUID 和分享 QR Code 都可能讓他人取得連線權限。排查問題時請使用本機編輯器，不要將真實內容貼到線上解碼網站；提供記錄檔給他人前，也應移除這些識別資訊。

Base64 訂閱解碼：分別處理外層清單與內層節點

常見的兩層結構如下：先解碼外層 Base64，取得多筆 vmess:// 連結；再選取其中一筆，移除前綴並再次解碼，才會得到節點 JSON。不能對所有輸入一律解碼兩次。若訂閱本文已直接以分享連結開頭，外層就不需要解碼。

1. 取得回應本文

   使用本機工具檢視訂閱回傳的內容。如果看到登入頁面、驗證碼或錯誤頁面，請先處理存取問題；HTML 頁面不是節點清單，即使請求成功也不代表訂閱可用。

2. 辨識外層格式

   如果本文直接出現 vmess:// 或 vless://，請逐行讀取。若內容是連續的編碼字串，可嘗試進行 Base64 解碼；若以 { 或 [ 開頭，請先按 JSON 格式檢查。

3. 分離節點列

   將解碼結果依換行拆分，移除每行前後空白並篩除空行。不要把多筆連結合併成一筆，也不要更動連結內的字元。

4. 解析單筆連結

   針對本文所述的 VMess v2 格式，移除 vmess:// 前綴後進行解碼，再解析 JSON。若內容不是這種結構，請確認分享格式的來源，不要硬套欄位。

以下函式可在本機瀏覽器主控台使用，支援標準 Base64 與常見的 URL 安全字元，會補上省略的尾端填充，並以 UTF-8 還原中文備註。執行前請先閱讀程式碼。函式不會傳送網路請求，也不會自動讀取剪貼簿。

function decodeBase64Utf8(input) {
  let value = input.trim().replace(/\s+/g, "");
  value = value.replace(/-/g, "+").replace(/_/g, "/");

  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(value)) {
    throw new Error("輸入包含非 Base64 字元");
  }

  value = value.replace(/=+$/, "");
  if (value.length % 4 === 1) {
    throw new Error("Base64 長度不完整");
  }

  value += "=".repeat((4 - value.length % 4) % 4);
  const binary = atob(value);
  const bytes = Uint8Array.from(binary, char => char.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

function readSubscription(body) {
  const text = body.trim();
  const decoded = /^(vmess|vless):\/\//i.test(text)
    ? text
    : decodeBase64Utf8(text);

  return decoded.split(/\r?\n/)
    .map(line => line.trim())
    .filter(Boolean);
}

function readVmess(link) {
  const value = link.trim();
  if (!value.startsWith("vmess://")) {
    throw new Error("需要 vmess:// 連結");
  }
  return JSON.parse(decodeBase64Utf8(value.slice(8)));
}

readSubscription 僅示範「明文連結清單或其 Base64 編碼」這一種訂閱格式，並非通用訂閱解析器。遇到其他結構時請停止操作，並查看服務提供者的格式說明。Base64 解碼成功只表示內容可讀，不代表節點有效或帳號仍有使用權限。

解析 vmess://：分享欄位如何對應原生設定

以下是用於說明結構的 VMess v2 節點物件。example.com 是文件專用的示例網域，UUID 也僅供示範，無法用來連線至代理伺服器。欄位 v 的值 "2" 代表分享格式版本，不是用戶端或核心版本。

{
  "v": "2",
  "ps": "文件範例",
  "add": "example.com",
  "port": "443",
  "id": "00000000-0000-4000-8000-000000000001",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.com",
  "path": "/ws",
  "tls": "tls",
  "sni": "example.com"
}

VMess 與 VLESS 是不同的通訊協定。vless:// 常見格式是包含使用者資訊、主機、連接埠與查詢參數的 URI，不能照搬「移除前綴後將 Base64 解碼成 JSON」的流程。將連結前綴從 VMess 改成 VLESS，也不會完成協定轉換；伺服器必須支援相應協定與身分設定。

轉成原生 JSON：除了節點，也要補齊入站設定

原生設定並不是將解碼後的節點 JSON 換個檔名。以下提供 Xray 常見的 VMess、WebSocket、TLS 完整範例：本機提供 SOCKS 入站，出站使用上方的示範節點。實際欄位仍須依照安裝的核心版本確認；這不代表所有 V2Fly 版本都接受相同設定。

{
  "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": "vmess",
      "settings": {
        "vnext": [
          {
            "address": "example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000001",
                "alterId": 0,
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "example.com",
          "allowInsecure": false
        },
        "wsSettings": {
          "path": "/ws",
          "headers": {
            "Host": "example.com"
          }
        }
      }
    }
  ]
}

此範例未加入分流規則，預設會將流量交由第一個出站處理。它也不會自動設定系統代理；應用程式必須明確使用 127.0.0.1:10808 的 SOCKS 服務。127.0.0.1 會將監聽範圍限制在本機，排查問題時不應直接改成對所有網路介面開放的位址。

• 先檢查連接埠。若現有用戶端已占用 10808，第二個核心可能無法啟動。可以停止重複執行的執行個體，或同步修改本機入站與應用程式的代理連接埠。
• 維持憑證驗證。範例保留 allowInsecure: false。遇到憑證錯誤時，請檢查系統時間、伺服器名稱與憑證鏈，不要直接關閉驗證。
• 區分設定的適用範圍。透過用戶端匯入自訂設定時，系統代理、TUN 與內建路由是否繼續生效，取決於匯入模式；不要假設它與一般節點模式相同。

反向轉換：分享連結只能帶走部分設定

若要從單一 VMess 出站產生分享連結，需先從原生設定擷取伺服器、使用者與傳輸欄位，組成前述的 v2 分享物件，再以 UTF-8 編碼成 Base64，最後加上 vmess:// 前綴。不能直接將整份原生設定編碼後加上此前綴，因為產生的格式不符合常見的節點匯入慣例。

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

function createVmessLink(share) {
  return "vmess://" + encodeBase64Utf8(JSON.stringify(share));
}

function createBase64Subscription(links) {
  return encodeBase64Utf8(links.join("\n"));
}

createVmessLink 接收的是依照欄位表整理好的分享物件，不會自動擷取複雜設定，也不會驗證節點參數。createBase64Subscription 接收分享連結陣列，並產生常見格式的訂閱本文；它不會建立可更新的訂閱網址，後者仍須由受控服務提供回應。

• 原生設定若有多台伺服器或多位使用者，必須明確選定要使用的組合。不要預設陣列中的所有內容都屬於同一筆連結。
• 單一 VMess 分享連結通常無法完整保留本機入站、DNS、路由、記錄層級與多出站策略。
• 若進階傳輸欄位沒有對應的分享格式規範，匯入時可能會遺失。若要完整移轉，請使用設定備份，並確認目標核心相容。

用戶端匯入：分開使用訂閱、剪貼簿與自訂設定

用戶端能辨識某種外層格式，不代表其核心支援其中所有協定與傳輸方式。v2rayN 是桌面用戶端；v2rayNG 使用 Xray 核心；v2flyNG 使用 V2Fly 核心。請先確認連線參數與核心功能相符，再選擇匯入方式。以下選單以常見的中文介面為參考，不同發行版本的名稱與位置可能有所不同。

v2rayN 常見的訂閱更新操作位於「訂閱分組」→「更新目前訂閱（不透過代理）」。此選項控制取得訂閱時是否經由代理，不會將節點的連線方式改成直連。若訂閱網站必須透過代理存取，請選擇相應的透過代理更新方式，並先確認目前的代理連線正常。

1. 更新失敗先檢查回應內容。網址過期、存取權杖失效或回傳網頁時，不應繼續轉換節點格式。請先檢查更新記錄與訂閱權限。
2. 匯入失敗先檢查結構。確認是否多複製了引號、缺少前綴，或誤將完整 JSON 當成分享連結。若中文備註出現亂碼，請檢查 UTF-8 編碼與解碼。
3. 連線失敗再檢查參數。節點已出現在清單中卻無法連線時，請核對 UUID、連接埠、WebSocket 路徑、Host、TLS 與 SNI，不要反覆重新進行 Base64 編碼。
4. 手動修改請另行儲存。更新訂閱可能會重建節點項目。臨時修改的節點適合複製到獨立分組，並記錄與訂閱原始值之間的差異。

常見問題：解碼成功，為什麼仍無法使用？