V2Ray 訂閱格式整理：Base64 訂閱、原生 JSON 設定與分享連結轉換

一、訂閱網址、回應內容與節點格式

「V2Ray 訂閱」並非所有用戶端都採用的統一檔案標準。一般所說的訂閱，通常是一個 HTTPS 網址，由用戶端向該網址發出請求，取得多個節點後存入訂閱群組。網址可能帶有存取權杖；能否匯入，取決於伺服器回傳的內容，以及用戶端支援的解析方式。

有些訂閱會直接回傳明文連結清單，有些則會依請求參數或用戶端識別資訊回傳不同格式。因此，「副檔名是 JSON」或「瀏覽器顯示一串亂碼」都不足以判斷是否相容。應檢查實際回應內容，而非只看網址名稱。若回傳登入頁面、到期提示或錯誤 JSON，重新編碼也無法產生有效節點。

二、Base64 訂閱與 VMess 的雙層包裝

常見的 Base64 訂閱製作流程是：以換行分隔多個分享連結，將整段 UTF-8 文字編碼為 Base64，再作為回應本文傳回。用戶端解開外層後，才會逐行解析各個節點。不能只在一段 Base64 文字前加上 vmess://，否則整份清單會被誤認為單一 VMess 節點。

1. 取得回應本文後，先排除 HTML 頁面、權限錯誤與空內容。
2. 若本文已是以協定前綴開頭、逐行排列的內容，直接視為明文連結清單處理。
3. 若本文是 Base64，請解碼外層，確認結果為可辨識的分享連結。
4. 逐行解析節點；遇到 vmess:// 時，再依其格式解碼內層負載。

常見的 VMess 分享格式，是在 vmess:// 後接上一段以 Base64 編碼的 JSON。這裡的 JSON 是分享格式欄位，並非 V2Fly 或 Xray 的完整設定。下方範例是 VMess 連結解碼後的物件；v 的值 2 代表分享格式的版本標記，不是核心版本。

{
  "v": "2",
  "ps": "教學節點",
  "add": "example.com",
  "port": "443",
  "id": "0f3a10d2-7f3b-4b58-a3f6-9a6fcbec8431",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.com",
  "path": "/ws",
  "tls": "tls",
  "sni": "example.com"
}

範例網域、UUID 與路徑僅用於說明結構，無法直接連線。aid: "0" 是現代 VMess AEAD 常見的設定，不應照搬舊教學將它改為 64。scy 是 VMess 內容加密選項，tls 則是傳輸安全選項，兩者不是同一個開關。不同產生工具對數字、字串與擴充欄位的處理方式仍可能不同。

• 外層解碼失敗：整份訂閱無法解碼，或解碼後不是節點清單。
• 內層解析失敗：清單可以展開，但其中某個 VMess 負載不是有效的 JSON。
• 字元編碼錯誤：中文備註出現亂碼，常見原因是直接將 UTF-8 位元組當成字元處理。

三、VLESS 連結的查詢參數與傳輸欄位

常見的 VLESS 分享連結接近一般 URI 格式：UUID 放在使用者資訊欄位，主機與連接埠放在位址部分，傳輸、安全性、路徑等則放在查詢參數中，備註位於 # 之後。下方是 VLESS + WebSocket + TLS 的教學連結，其中 %2Fws 解碼後為 /ws。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=example.com&path=%2Fws&sni=example.com#VLESS-WS-TLS

URI 參數中的特殊字元必須正確轉義。例如路徑包含 & 時，應編碼為 %26，否則會被解讀為下一個參數的分隔符號。IPv6 主機位址必須以方括號括住。備註含有中文時，使用百分比編碼更利於在不同用戶端間傳遞；只修改備註通常不影響連線，但修改路徑、SNI 或 Host 會影響實際交握。

四、為什麼原生 JSON 不能直接當成訂閱

原生設定是供核心執行使用，可包含多個入站與出站，以及 DNS、路由、日誌設定。以下 VMess 設定範例用來說明層級：本機 SOCKS 入站監聽 127.0.0.1:10808，遠端出站連線至 example.com:443。10808 是範例本機連接埠，不是訂閱網址的連接埠，也不是每個用戶端都固定使用的值。

{
  "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": "0f3a10d2-7f3b-4b58-a3f6-9a6fcbec8431",
                "alterId": 0,
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "example.com"
        },
        "wsSettings": {
          "path": "/ws",
          "headers": {
            "Host": "example.com"
          }
        }
      }
    }
  ]
}

此處的 settings.vnext 存放 VMess 伺服器參數，streamSettings 則存放傳輸與安全性參數。VLESS 使用不同的協定設定結構，不能只把 protocol 從 vmess 改成 vless。Xray 與 V2Fly 的設定語法雖有共通之處，但擴充能力與欄位演進並不相同；JSON 語法正確，不代表目標核心一定能執行。

五、v2rayN、v2rayNG 與 v2flyNG 的匯入限制

用戶端負責解析訂閱與管理節點，核心則負責實際連線。v2rayN 是桌面用戶端，可依設定使用支援的核心；v2rayNG 是使用 Xray 核心的 Android 用戶端；v2flyNG 則是使用 V2Fly 核心的 Android 用戶端。三者都能解析 VMess 連結，不代表它們對所有 VLESS、REALITY 或完整 JSON 設定的支援度都相同。

以下步驟以 v2rayN 7.x 中文介面的常見選單為例；不同小版本的選單文字可能有所調整。先判斷手上的是訂閱網址還是節點文字，再選擇相應入口，比反覆嘗試同一個匯入按鈕更有效。

1. 辨識輸入內容

   HTTPS 訂閱網址請從訂閱群組匯入；以 vmess:// 或 vless:// 開頭的文字則使用節點匯入。包含 inbounds、outbounds 的 JSON，應先視為完整設定處理。

2. 新增訂閱

   在「訂閱群組」→「訂閱群組設定」中新增群組，填入名稱與訂閱網址。儲存後，從「訂閱群組」執行更新；依網路連線情況，選擇透過代理或不透過代理更新。

3. 匯入單一節點

   複製完整連結，在「伺服器」→「從剪貼簿匯入批次 URL」中匯入。多筆連結請逐行排列。v2rayNG 則可在主畫面點選「+」→「從剪貼簿匯入」進行相應操作。

4. 確認欄位

   開啟節點編輯視窗，核對伺服器、443 遠端連接埠、UUID、傳輸、路徑、Host 與 SNI。REALITY 節點還須確認公鑰、short ID、指紋與 Flow，不能只看節點名稱。

5. 測試連線

   選取節點並進行測試，再檢查日誌。若日誌顯示不支援的協定或欄位，請檢查核心；若出現位址、憑證或交握錯誤，則檢查節點設定。最後再啟用所需的系統代理或 TUN 模式。

六、格式轉換方案：保留更新功能或匯出快照

分享連結轉成 Base64 訂閱，本質上是「排列文字後再編碼」；Base64 訂閱轉成分享連結，則是「解碼後逐行拆分」。兩種轉換只會改變外層包裝，不會把 VMess 變成 VLESS，也不會自動補齊伺服器參數。訂閱提供者更換節點後，本機匯出的檔案不會同步更新。

本機編碼範例：先處理 UTF-8 位元組

以下是原生 JavaScript 的本機編碼與解碼函式，可用來了解一般 Base64 的處理方式。函式不會發出網路請求，也不會解析節點或產生原生設定。輸入內容應是已確認有效的連結清單；請勿將正式訂閱貼到陌生網站的主控台。

function encodeList(text) {
  const bytes = new TextEncoder().encode(text);
  const binary = Array.from(bytes, byte =>
    String.fromCharCode(byte)
  ).join("");
  return btoa(binary);
}

function decodeList(encoded) {
  let normalized = encoded.trim()
    .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);
}

• 編碼前請以換行連接各個節點，避免兩條 URI 緊貼在一起。
• 解碼函式支援常見的 URL 安全字元替換與缺少補位的情況；內容不合法時仍會擲回錯誤。
• 若解碼結果是單一 JSON 物件，請進一步判斷它是分享負載還是完整設定，不要直接當成節點清單匯入。
• 若要將本機文字轉成可更新的訂閱，還需要部署可供存取的服務並管理存取權限；單靠編碼不會產生訂閱網址。

七、格式轉換與訂閱匯入常見問題

最後依三個層次逐一檢查：先確認取得的回應內容，再確認用戶端能否解析，最後確認核心是否能連線。記錄用戶端版本、所選核心、節點傳輸類型與錯誤日誌，比一再嘗試 Base64 編碼更容易找出問題。若需要基礎設定說明，可繼續閱讀本站快速入門；協定與安全性欄位則可參考協定詳解。