· 入门指南 · 约 9 分钟

vmess:// 与 vless:// 分享链接用法:单节点链接和订阅地址的区别

拆解分享链接的组成字段,说明它和订阅地址在导入方式与更新机制上的差异,以及在 v2rayN、v2rayNG 中分别如何导入。

本文速览

拿到一串链接后，先判断它保存的是单条连接参数，还是用于获取配置列表的远程地址。本文适合首次导入配置、迁移设备或排查订阅更新问题的用户：先识别 vmess://、vless:// 与 HTTPS 订阅，再核对关键字段，最后按客户端完成导入、启用和连接检查。

分享链接与订阅地址：保存参数，还是获取列表

vmess:// 与 vless:// 通常是单条配置的分享格式。客户端从链接中读取服务器地址、端口、身份信息和传输选项，再保存为本地配置。复制两行分享链接可以批量导入两条记录，但这仍不等于建立了可更新的订阅关系。

订阅地址通常是一个 HTTPS URL。客户端访问它，读取服务端返回的配置列表，然后解析和更新。地址中可能带有账号令牌；路径是否包含 sub、是否以某个文件后缀结尾，都不是可靠判断标准。普通网页地址和单个 JSON 文件地址也不一定是兼容的订阅入口。

订阅地址

推荐

用于持续维护的一组配置。后续通过更新操作重新获取列表；服务端更换地址、端口或增删配置后，客户端需要成功更新才能取得变化。

适合：服务提供方明确提供订阅入口，需要长期同步配置。

单条分享链接

保存导入时的参数快照。只要链接内容不变，重新导入通常也不会获得服务端后来修改的参数。

适合：临时测试、核对单条配置、迁移少量已知参数。

这里的推荐以“有可信订阅来源”为前提。订阅不是连接协议，也不保证其中每条配置可用。VMess、VLESS 是连接协议；订阅只是配置分发与更新方式，两者属于不同层次。

vmess://：先解码，再看地址、传输与 TLS

常见的 VMess 分享格式是 vmess:// 后接 Base64 编码的 JSON。Base64 只是编码，不会隐藏 UUID 等连接凭据。不同工具存在格式差异，不能把任意一段 Base64 文本都当成 VMess 配置。

下面展示常见分享内容解码后的结构。域名与 UUID 仅用于说明字段，不对应可连接服务；这些短键属于分享格式，不是可直接粘贴运行的完整内核配置。

{
  "v": "2",
  "ps": "示例 VMess",
  "add": "edge.example.org",
  "port": "443",
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "edge.example.org",
  "path": "/gateway",
  "tls": "tls",
  "sni": "edge.example.org"
}

解码后能读懂字段，不代表客户端支持全部组合。图形客户端负责解析分享格式和生成配置，内核负责执行连接。诊断时要同时核对客户端导入结果与当前内核支持范围。

vless://：查询参数决定传输与安全层

VLESS 分享链接常使用 URI 结构：UUID 位于 @ 之前，随后是服务器地址和端口，问号后是查询参数，井号后是备注。以下是 VLESS、WebSocket 与 TLS 的结构示例，同样不能用于实际连接。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.org&path=%2Fgateway&sni=edge.example.org#VLESS-WS-TLS
字段示例值核对重点
encryptionnone不表示 TLS 被关闭；它与外层安全设置不是同一个字段。
securitytls示例使用 TLS；不能只修改名称就将服务切换为 REALITY。
typews传输方式必须与服务端一致。
path%2FgatewayURI 解码后为 /gateway，避免被重复编码。
sniedge.example.orgTLS 握手使用的服务器名称，应按服务端要求填写。

若拿到的是 REALITY 配置，还需要按来源核对 pbk、sid、fp 等对应参数；是否使用 flow=xtls-rprx-vision 取决于服务端和传输组合。不能给上面的 WebSocket 示例直接添加 Vision 字段，便认为完成了协议升级。

结论：导入后先逐项核对，不先改协议

先对照地址、端口、UUID、传输、安全层这五组参数。只有确认来源参数完整、客户端支持对应组合后，才进入连接测试；随意切换 TLS、REALITY 或传输类型会引入新的不一致。

v2rayN 与 v2rayNG：按链接类型选择导入入口

以下使用常见中文菜单名称。不同版本可能调整按钮位置或措辞，定位时优先看“从剪贴板导入”“订阅分组设置”“更新订阅”等功能名。导入、选择配置、启动连接和启用代理是不同操作，不要以列表出现记录作为全部完成的依据。

双端导入：先区分单条链接与远程订阅

桌面端：v2rayN
  • 单条链接：复制完整内容，在主窗口使用「服务器」→「从剪贴板导入批量 URL」；支持该快捷键的版本也可使用 Ctrl+V。
  • 订阅地址：进入「订阅分组」→「订阅分组设置」，新增分组并填写备注与 URL，保存后执行「更新订阅」。
  • 更新完成后选中目标配置，使用右键菜单「设为活动服务器」，再按实际需要设置系统代理。
安卓端：v2rayNG
  • 单条链接：复制完整内容，点击右上角「+」→「从剪贴板导入」。
  • 订阅地址：打开侧边菜单「订阅分组设置」，点击「+」新增备注与 URL，保存后回主界面执行「更新订阅」。
  • 选中目标配置，点击连接按钮；首次连接时按系统提示授权 VPN 连接，再查看连接状态与日志。

同一订阅可在两端分别添加，但更新计划、当前选中的配置和本地路由设置不会因此自动同步。

v2rayNG 使用 Xray 内核；v2flyNG 使用 v2fly 内核。相似的界面或相同的订阅来源，不代表两者支持完全相同的协议扩展。尤其涉及 VLESS 的特定安全与流控组合时，应按实际内核能力核对，不能仅根据链接能够被识别就判定可用。

  1. 导入前确认剪贴板中没有聊天说明、引号、换行插入或链接末尾的中文标点。
  2. 导入后打开编辑界面，核对服务器、端口、传输方式及 TLS 设置，而不是只看备注名称。
  3. 订阅更新后检查目标分组是否出现记录，再选择其中一条作为当前配置。
  4. 启动后用实际应用访问测试目标，并结合日志判断连接与路由情况。

订阅更新与端口检查：把两条链路分开

订阅更新走的是“客户端访问订阅服务器”这条链路；日常流量走的是“应用访问本地代理，再由内核连接远端服务器”这条链路。一条链路可用，不代表另一条也可用。订阅下载成功，只说明本次获取与解析完成，不等于列表中的所有服务器均可连接。

443
本文示例的远端 TLS 端口
10808
下方命令使用的本地 SOCKS 端口
127.0.0.1
本地回环监听地址

这些数字用于说明检查位置，不代表所有安装的默认值。远端端口来自配置提供方；本地端口以 v2rayN「设置」→「参数设置」中显示的监听设置为准。若本地 SOCKS 入站确实监听 127.0.0.1:10808，可在终端中使用以下命令显式指定代理。

curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://example.com/

这里的 socks5h 要求由代理侧处理目标域名解析；10 秒与 20 秒分别是本次命令的连接超时和总超时。命令失败时记录错误信息，不要只比较一次耗时。浏览器是否读取系统代理、终端是否显式指定代理，必须分别检查。

导入与更新常见问题

复制了 HTTPS 地址，为什么提示没有有效配置？

先确认复制的是订阅入口，而不是账号管理页面。把地址填进「订阅分组设置」的 URL 栏再执行更新；不要将远程地址当作单条 VMess 或 VLESS 链接处理。若仍失败，检查日志是否显示登录页、访问拒绝或不支持的内容格式，排查时不要公开令牌。

单条链接导入成功，为什么订阅更新没有变化？

单条链接保存的是本地快照，不会自动附带订阅来源。需要另外添加真正的订阅地址，并更新对应分组。不要把分享链接填入订阅 URL 栏，也不要期待修改备注后能获得新服务器参数。

订阅刷新后，手工改过的参数为什么恢复了？

订阅更新可能重新生成或覆盖分组内记录，具体取决于客户端版本与更新方式。需要长期保留手工调整时，将配置复制到独立的本地分组，再核对两份记录的来源，避免下次选中错误版本。

能把分享链接放进在线解码网站检查吗？

链接中可能含 UUID、订阅令牌及服务器信息，应优先在客户端编辑界面核对，或使用可信的本地离线工具。不要把完整链接、二维码或未遮盖的日志发到公开讨论区。若凭据已泄露，到提供方后台重置，再更新两端配置。

迁移设备前的最后核对

分享链接通常只携带连接参数，订阅通常只负责配置列表。系统代理、分应用规则、DNS、路由分流、本地入站端口与日志级别，不应被假定为一并迁移。两台设备导入同一来源后表现不同，先比较这些本地设置，再判断是否是远端服务问题。

v2rayN / v2rayNG 下载