V2Ray 订阅链接导入教程：v2rayN 与 v2rayNG 添加订阅入口及 vmess/vless 分享格式说明

先区分订阅链接与单节点分享链接

先看链接开头。以 https:// 开头、访问后返回一批节点记录的地址，通常是订阅链接。以 vmess://、vless:// 或 trojan:// 开头的内容，通常只描述一个节点。两类内容使用不同入口，粘贴错位置是“保存成功但列表为空”的常见原因。

订阅地址相当于一个可重复请求的数据源。客户端保存的是地址、备注和更新选项，每次执行“更新订阅”时重新获取节点列表。单节点分享链接则直接携带服务器、端口、用户标识、传输方式和 TLS 参数，导入后不会自动跟随远端节点列表变化。

在 v2rayN 添加并更新订阅

以下路径以 v2rayN 7.x 桌面界面为例。先运行客户端，再打开主窗口。若菜单名称略有变化，仍按“订阅分组、添加地址、更新订阅”三层关系定位，不要把订阅地址粘贴到手动添加 VMess 服务器的窗口。

1. 打开分组

   在主界面进入「订阅分组」→「订阅分组设置」，点击「+」新建分组。分组名称可写成用途或提供方名称。

2. 粘贴地址

   把完整的 HTTPS 订阅地址粘贴到 URL 输入框。确认开头、结尾没有空格，再保存分组。

3. 核对内核

   进入「设置」→「参数设置」→「Core 类型」，包含 VLESS、XTLS 或 REALITY 的配置选择 Xray 内核。

4. 执行更新

   返回主界面，打开「订阅分组」并执行「更新全部订阅」。更新结束后查看状态栏中的新增、删除与失败数量。

5. 选择节点

   在服务器列表选中节点并设为活动服务器，再按实际需求开启系统代理。仅导入节点不会自动改变系统流量入口。

更新成功后，服务器列表会出现协议、别名、地址和端口。先按分组筛选，再选中一个节点执行延迟测试。延迟测试返回数值只说明测试目标可响应，不等于实际下载速度。若 50 个节点在约 2 至 5 秒内全部导入，但延迟列为空，应继续检查内核是否启动，而不是反复添加同一订阅。

v2rayN 常见本地端口包括 SOCKS 端口 10808。实际值以「设置」→「参数设置」中的本地监听项为准。浏览器或命令行工具采用手动代理时，协议类型和端口必须对应；把 HTTP 代理请求发到 SOCKS 端口会直接连接失败。

• 更新前先保存订阅分组，未保存的 URL 不会进入更新队列。
• 列表重复时先检查是否创建了两个相同 URL 的分组，不要逐条删除节点。
• 订阅更新完成后仍保留旧节点时，检查分组设置中的移除旧配置选项。
• 日志出现超时先测试订阅地址可达性，再决定是否通过当前代理更新。

在 v2rayNG 添加 Android 订阅

v2rayNG 的订阅入口位于分组管理，不在右下角的单节点导入菜单。以下路径以 v2rayNG 1.10.x 为例。导入前先把订阅地址复制到系统剪贴板，并确认复制的是 URL，不是网页中的套餐名称或到期时间。

1. 进入设置

   打开侧边菜单，进入「订阅分组设置」。点击右上角「+」，准备添加新的订阅来源。

2. 填写订阅

   在备注栏填写便于识别的名称，在 URL 栏粘贴完整订阅地址。需要时开启自动更新，再点击右上角保存。

3. 更新分组

   返回主界面，打开右上角菜单并选择「更新订阅」。等待底部提示显示更新完成，再查看配置数量。

4. 切换配置

   点选目标节点，使其成为当前配置。点击连接按钮后确认状态栏出现连接状态，再进行访问测试。

5. 查看日志

   连接失败时进入「日志」查看第一条错误。优先处理域名解析、连接超时、证书名称和端口拒绝问题。

若拿到的是单条 vmess://、vless:// 或 trojan://，不要创建订阅分组。先复制完整分享链接，再使用主界面的「+」→「从剪贴板导入」。导入完成后打开配置详情，核对地址、端口、传输协议、TLS、SNI 和路径。

双端分组、更新与节点同步

桌面端和 Android 端可以保存同一条订阅地址，但两端不会直接互相传输本地配置。所谓同步，是两端分别请求同一个远端订阅源。远端新增或删除节点后，两端都要各自执行一次更新，列表才会一致。

分组应按来源或使用目的划分，不要按协议建立过多重复订阅。例如一个订阅同时包含 VMess 与 VLESS，保留在同一分组即可，客户端列表中的协议列已经能够区分类型。重复添加相同 URL 会让节点名称相同、来源不同，后续排查更新结果反而更困难。

自动更新不是实时推送。客户端通常在启动后或到达设定间隔时请求订阅，休眠、断网或后台限制会让计划任务延后。看到远端已经调整节点时，直接执行手动更新最明确。更新前记录当前节点名称，更新后若该节点被删除，应从新列表重新选择活动配置。

vmess、vless 与 trojan 分享格式

VMess 分享链接常见形式是 vmess:// 后跟一段 Base64 文本。解码后通常得到 JSON 对象，其中包含地址、端口、用户标识、传输网络、路径和 TLS 等字段。Base64 只负责文本表示，不代表加密，也不是判断节点是否可用的依据。

VLESS 与 Trojan 通常采用标准 URI 结构。服务器地址和端口位于主机部分，传输、安全层、SNI、指纹和 Flow 等参数放在问号后的查询字段中，井号后的文字是节点备注。复制时遗漏查询字段，可能出现地址正确但握手失败。

vless://[email protected]:443?type=tcp&security=reality&flow=xtls-rprx-vision&sni=www.example.com&fp=chrome&pbk=AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abc&sid=1a2b3c4d#VLESS-Reality

trojan://[email protected]:443?security=tls&type=tcp&sni=www.example.com#Trojan-TLS

上面的地址只用于展示字段位置。真实 VLESS 链接中的 UUID、Reality 公钥和 short id 必须由配置来源提供；Trojan 链接中的认证内容也必须完整。手工改动 security、type 或 flow 不会把一种服务端配置转换成另一种协议。

传统 Base64 订阅解码后通常是多行分享链接，每行对应一个节点。客户端先获取订阅正文，再解码并逐行识别协议。若正文是登录页面、错误提示或过期通知，即使 HTTP 请求成功，也会显示“识别到 0 个配置”。此时应检查订阅地址返回内容，而不是修改本地端口。

• vmess://：重点核对 id、add、port、net、host、path、tls 与 sni。
• vless://：重点核对 UUID、security、type、flow、sni、fp、pbk 与 sid。
• trojan://：重点核对认证内容、服务器地址、端口、security 与 sni。
• # 后的备注只影响显示名称，不参与连接认证。

订阅失败、节点为空与连接异常排查

排查时按“能否获取订阅、能否解析节点、内核能否启动、流量是否进入代理”四层处理。不要一开始就删除全部配置。先保留原分组和日志，错误发生在哪一层通常能从提示文字中直接判断。

日志出现 connection refused，通常表示目标地址可达但指定端口没有接受连接；出现超时则可能是网络路径、域名解析或远端服务不可达。TLS 名称错误应检查 SNI，Reality 握手错误应核对公钥、short id、指纹和 server name。不同错误不能用切换本地代理端口统一解决。

若 v2rayN 能导入而 v2rayNG 不能，先确认两端复制的是同一条完整 URL，再比较客户端版本和内核支持。包含较新 Xray 参数的 VLESS 配置应使用 v2rayNG 的 Xray 内核。若需要 V2Fly 内核处理兼容配置，可使用 v2flyNG，但 Reality 与 XTLS 相关参数仍应按内核能力选择，不要只改协议名称。