订阅链接格式详解:base64、原生 JSON 与分享链接的区别与互转

先判断拿到的是订阅地址、编码正文还是分享链接

base64 订阅正文如何还原与检查

1. 确认当前内容是服务端返回的正文，而不是仍以 https:// 开头的远程地址。
2. 去掉复制过程中引入的空格与首尾换行，不要删除正文内部可能存在的有效字符。
3. 将 URL-safe base64 的 - 与 _ 恢复为标准字符，并把长度补到 4 的整数倍。
4. 解码后检查每一行是否有明确协议头，节点名称是否出现乱码，端口是否处于 1 至 65535 范围。
5. 如果解码结果仍是一段 base64，再判断它是不是 VMess 分享链接内部的第二层编码，不要无条件重复解码。

const encoded = prompt("粘贴 base64 订阅正文").trim();
const normalized = encoded.replace(/-/g, "+").replace(/_/g, "/");
const padded = normalized.padEnd(
  Math.ceil(normalized.length / 4) * 4,
  "="
);
const bytes = Uint8Array.from(
  atob(padded),
  character => character.charCodeAt(0)
);
console.log(new TextDecoder().decode(bytes));

原生 JSON 配置包含哪些关键字段

字段路径	作用	检查重点
inbounds[].port	客户端在本机监听的代理端口	避免与其他程序占用的 10808、10809 等端口冲突
outbounds[].protocol	指定 VMess、VLESS 等出站协议	必须与服务器端协议一致
settings.vnext[].address	远程服务器域名或地址	不要附带协议头和路径
settings.vnext[].port	远程服务端口	HTTPS 类传输常见 443，但应以实际配置为准
streamSettings.network	指定 TCP、WebSocket 等传输方式	必须与路径、请求头等传输参数配套
streamSettings.security	描述 TLS 等传输安全层	启用 TLS 时同时检查服务器名称
routing.rules	按域名、IP 或入站标签执行分流	规则从上到下判断，先命中的规则生效

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "edge.example.net",
            "port": 443,
            "users": [
              {
                "id": "d342d11e-d424-4583-b36e-524ab1f0afa4",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "wsSettings": {
          "path": "/gateway"
        },
        "tlsSettings": {
          "serverName": "edge.example.net"
        }
      }
    }
  ]
}

• address 只放主机名，WebSocket 路径单独放在 wsSettings.path。
• VLESS 用户项中的 encryption 通常写为 none，传输层是否启用 TLS 由 streamSettings.security 决定。
• 本地 SOCKS 入站监听 127.0.0.1，表示只接受本机连接；局域网共享需要另外评估监听地址与访问控制。
• 完整配置还可能包含直连、阻断等多个出站，并通过 tag 与路由规则关联。

VMess 与 VLESS 分享链接的内部差异

vless://[email protected]:443?encryption=none&security=tls&sni=edge.example.net&type=ws&path=%2Fgateway#Example-WS

d342d11e-d424-4583-b36e-524ab1f0afa4

用户标识，导入时应完整保留字符与连字符。

edge.example.net:443

服务器地址与端口，端口前使用半角冒号。

security=tls

传输安全层参数，不代表协议字段本身发生变化。

type=ws

使用 WebSocket 传输，需要与服务器端配置一致。

path=%2Fgateway

经过 URL 编码的路径，解码后为 /gateway。

#Example-WS

客户端显示名称，不参与服务器认证。

三种格式如何互转而不丢失参数

1. 先备份原始内容，区分远程地址、响应正文和单节点链接。
2. 列出必须保留的字段：协议、服务器、端口、用户标识、传输、安全层、服务器名称、路径与备注。
3. 完成解码或结构转换后，逐项比较字段，不要只检查节点名称是否出现。
4. 先导入一个节点测试日志与连接，再批量处理其余节点。
5. 确认客户端中的订阅记录仍保存原始 https:// 地址，并执行一次手动更新。

在 v2rayN、v2rayNG 与 v2flyNG 中正确导入

• v2rayN：适合桌面端订阅分组、批量节点管理和自定义路由。导入后先更新订阅，再选择活动服务器，最后设置系统代理模式。
• v2rayNG：安卓端使用 Xray 内核，适合导入 VMess、VLESS 分享链接和远程订阅。更新后要确认当前选中的节点仍然存在。
• v2flyNG：安卓端使用 v2fly 内核，适合以 VMess 等兼容配置为主的使用环境。遇到扩展参数时，应先确认内核是否识别对应字段。

订阅维护与排障的固定顺序

1. 获取阶段：检查订阅域名、HTTPS 连接和返回状态，确认客户端实际收到了正文。
2. 解析阶段：判断正文属于 base64、JSON 还是分享链接列表，检查换行、补位和字符编码。
3. 导入阶段：核对客户端是否新增节点，节点数量与分组名称是否符合预期。
4. 连接阶段：检查地址、端口、用户标识、传输方式、安全层、服务器名称和路径。
5. 代理阶段：检查活动服务器、系统代理模式，以及 10808、10809 等本地端口是否正常监听。
6. 路由阶段：连接正常但特定域名行为异常时，再检查 routing.rules 的顺序与出站标签。