2026-07-28 · 入门指南 · 约 10 分钟

订阅链接怎么导入?v2rayN 与 v2rayNG 添加订阅步骤详解

分别说明 v2rayN 桌面端与 v2rayNG 安卓端的订阅入口、更新顺序和分组方法,并排查链接添加后没有节点、更新超时或配置无法识别的问题。

本文速览

适合已经取得订阅地址、但不确定应该粘贴到哪里或导入后看不到节点的用户。完成本文步骤后,可以在 v2rayN 与 v2rayNG 中建立独立订阅分组、主动更新配置,并根据返回内容、网络状态和内核支持范围定位常见异常。

先分清订阅链接与单节点链接

订阅链接是客户端定期访问的配置来源,通常表现为一条以 HTTPS 开头的长地址。客户端请求该地址后,服务端会返回多条 VMess、VLESS 等节点配置。以后节点地址、端口或传输参数发生变化时,只需更新订阅,不必逐条重新添加。

单节点链接则直接以 vmess://vless:// 开头,一条链接通常只描述一个节点。把单节点链接误填进“订阅地址”字段时,客户端可能提示更新失败,也可能得到空列表。遇到这种情况,应改用“从剪贴板导入”一类入口,而不是反复点击更新订阅。

订阅地址

常见开头
https://
返回内容
多条节点配置
更新方式
按分组重新请求
适用场景
长期维护节点列表

地址中的令牌通常用于识别订阅,不要在公开页面或截图中展示完整链接。

单节点 URI

常见开头
vmess:// 或 vless://
配置数量
通常一条
导入方式
剪贴板或扫描
更新方式
重新导入新链接

VMess 链接中的字段 v: 2 表示链接格式版本,不是客户端版本号。

一些订阅响应是经过 Base64 编码的文本,解码后每行是一条节点 URI;另一些响应直接返回客户端能够读取的结构化内容。正常情况下不需要手动解码,v2rayN 和 v2rayNG 会在更新时完成解析。浏览器打开链接看到连续字母、数字、斜杠和等号,不代表链接损坏。

在 v2rayN 桌面端添加订阅

v2rayN 使用订阅分组管理不同来源。每个分组可以保存名称、订阅地址和更新选项。建议先建立分组,再执行更新;仅保存地址不会自动保证节点已经写入主列表。

  1. 打开分组

    启动 v2rayN,在主窗口依次打开「订阅分组」→「订阅分组设置」。如果当前界面使用紧凑菜单,可先展开窗口顶部菜单。

  2. 新建分组

    点击分组设置窗口中的「+」,新建一行订阅记录。别名填写容易识别的名称,例如“办公网络备用”或“家庭线路”。

  3. 粘贴地址

    把完整 HTTPS 订阅链接填入地址字段。粘贴后检查开头、结尾和换行,确认没有把说明文字一并复制进去。

  4. 保存设置

    确认分组处于启用状态后保存。返回主窗口,打开「订阅分组」并执行「更新全部订阅」或选择刚建立的分组更新。

  5. 检查结果

    等待状态栏显示更新结果,然后查看服务器列表。选择一个节点并按 Enter 设为活动服务器,再按需要开启系统代理。

更新成功后,主列表通常会增加多行配置,协议、地址、端口和别名会分别显示。双击某行可以检查传输方式、TLS、SNI、路径等字段,但订阅管理的配置不建议随意手改,因为下一次更新可能用服务端内容覆盖本地修改。

如果订阅包含 VLESS、XTLS Vision 或 Reality 参数,而导入结果缺少对应字段,可先检查内核设置。常见检查路径是「设置」→「参数设置」→「Core 类型」,优先选用 Xray 内核处理这些配置。VMess、WebSocket 等基础配置也可由 Xray 内核读取。

在 v2rayNG 安卓端添加订阅

v2rayNG 的订阅分组与当前配置列表是两个层级:分组页面保存订阅来源,主页面显示更新后解析出的节点。只完成“添加分组”而没有执行“更新订阅”,返回主页面后仍可能看不到任何新配置。

  1. 进入设置

    打开 v2rayNG,展开主界面左上角菜单,进入「订阅分组设置」。不同界面宽度下入口位置可能略有变化,但名称仍包含“订阅分组”。

  2. 添加记录

    点击右上角「+」,在备注或别名栏填写分组名称,在 URL 栏粘贴完整订阅地址,并保持该记录启用。

  3. 保存返回

    点击确认或保存,返回主界面。此时只是保存了订阅来源,还需要执行一次网络更新。

  4. 更新订阅

    再次展开主菜单,点击「更新订阅」。等待底部提示完成,更新期间不要立即切换网络或关闭应用。

  5. 选择配置

    在主列表点击需要使用的节点,使其成为当前配置,再点击连接按钮。首次连接时按系统提示确认本地连接授权。

如果手机剪贴板中保存的是以 vmess://vless:// 开头的单节点链接,应使用主界面右上角「+」中的“从剪贴板导入”入口。导入完成后会直接增加一条配置,不需要建立订阅分组。

v2rayNG 默认会在设备本地建立代理入口,SOCKS 端口常见为 10808。这个端口用于本机应用与内核通信,不是订阅地址中的服务器端口。若手动修改过设置,应以「设置」中实际显示的本地端口为准。

按来源选择正确的导入方式

同一段配置可以通过订阅、单节点 URI 或二维码传递,但三种方式的维护成本不同。长期使用并且节点会调整时,订阅分组更容易保持同步;临时测试一条配置时,剪贴板导入更直接。

订阅分组

推荐

一次保存来源地址,后续通过更新操作同步节点增删和参数变化,适合同时维护多条配置。

适合:固定来源、长期使用、多个节点

剪贴板导入

直接解析一条 VMess 或 VLESS URI,操作步骤短,但来源内容变化后需要重新取得并导入链接。

适合:单节点测试、临时配置

扫描二维码

二维码通常承载单节点 URI,适合把已有配置转移到 v2rayNG;扫描前应确认二维码来自可信的配置来源。

适合:安卓端快速录入单条配置

不要根据链接长度判断它属于哪一种。VLESS URI 带有 SNI、指纹、Public Key、Short ID 和 Flow 参数时也会很长;订阅地址则可能只有域名、路径和一段较短令牌。最可靠的判断依据仍是链接开头以及提供方对该地址用途的说明。

订阅地址:
https://sub.example.com/client/token-demo

单节点地址:
vless://[email protected]:443?security=reality&type=tcp&flow=xtls-rprx-vision#demo

示例中的域名、用户标识和参数仅用于说明结构。实际导入时,VLESS 的用户标识、服务器地址、端口、SNI、Reality 公钥与 Short ID 必须彼此匹配;任意字段缺失都可能导致配置能显示却无法完成连接。

导入后节点列表为空怎么排查

“更新成功但列表为空”和“请求订阅失败”是两类问题。前者表示客户端可能收到了响应,但没有解析出受支持的节点;后者通常发生在建立连接、域名解析、TLS 握手或服务器响应阶段。先看提示文本,再决定检查方向。

  1. 重新复制完整地址:删除分组中的旧地址,从原始页面重新复制。检查地址前后是否存在空格、中文标点或换行,并确认没有只复制到省略显示的部分。
  2. 确认链接仍然有效:在正常联网环境下访问订阅地址。若返回明确的失效、未授权或访问次数限制提示,需要从订阅来源处理权限,客户端本地设置无法恢复失效令牌。
  3. 切换更新路径:当前网络无法直接访问订阅域名时,可先连接一条已经可用的配置,再启用“通过代理更新订阅”一类选项后重试。没有任何可用配置时,不要开启依赖代理的更新方式。
  4. 检查返回格式:如果访问后只得到网页登录页、验证页面或一段错误说明,客户端不会把这些内容解析成节点。订阅端点应直接返回配置数据。
  5. 确认协议支持:包含 VLESS、Reality 或 Vision 参数的订阅应使用 Xray 内核。v2rayNG 默认采用 Xray 内核;v2rayN 可在「设置」→「参数设置」→「Core 类型」中检查。
  6. 查看更新日志:重点区分超时、域名解析失败、证书错误、HTTP 状态异常和解析数量为零。不同错误对应不同处理方式,不要在没有日志依据时反复删除客户端数据。

如果更新提示新增数量为零,但原有节点仍在,可能只是服务端内容没有变化。部分客户端会保留原分组配置,而部分更新策略可能先清理再写入,因此更新前不要手动混用多个来源的同名节点,以免难以判断哪些记录属于当前分组。

还有一种常见情况是筛选条件隐藏了节点。例如主列表正在按分组、备注或协议筛选,新导入配置不符合当前条件,视觉上就像空列表。先清除搜索框和筛选状态,再查看总记录数。

设置分组名称与更新顺序

分组名称只保存在本地,不会改变服务端内容。名称应帮助区分来源和用途,不建议只写“订阅一”“订阅二”。当配置数量增加后,清晰命名能减少误删、误更新和选错节点的情况。

命名维度 示例 作用
使用环境 家庭网络 区分不同网络条件下使用的配置来源
用途 日常主用 快速识别默认选择的分组
有效周期 季度备用 提醒检查来源是否仍需保留
协议范围 VLESS Reality 便于检查内核和传输参数是否匹配

首次添加后应手动更新一次,以确认地址可访问并能解析节点。自动更新间隔适合处理日常变化,但不应设置得过短;频繁请求可能触发服务端访问限制,也会增加移动网络耗电。具体间隔以订阅来源给出的更新建议为准。

更新多个分组时,可以先更新备用来源,再更新当前主用来源。这样即使某个地址临时超时,列表中仍保留可用于联网和继续排查的配置。删除分组前先确认其中节点是否还承担当前连接。

订阅导入常见问题

下面几种现象覆盖了订阅添加阶段最常见的操作误区。排查时保留分组和错误提示,按网络请求、内容解析、节点连接的顺序处理,通常比删除后重装更容易找到原因。

保存订阅后为什么没有节点?

保存只会记录地址。v2rayN 还要执行「订阅分组」→「更新全部订阅」,v2rayNG 还要从主菜单点击「更新订阅」。完成后再清除列表筛选条件。

更新时一直提示超时怎么办?

先确认当前网络能解析订阅域名。已有可用节点时,可连接该节点并启用通过代理更新;没有可用节点时,先切换到能够直接访问订阅地址的网络。

链接在浏览器里是一长串字符?

这通常是 Base64 编码后的订阅正文。只要客户端更新时能解析出节点,就不需要手动解码或修改其中字符。浏览器显示方式不能单独判断订阅是否有效。

为什么导入了同名节点?

先检查是否把同一地址添加到了多个分组。删除重复分组后重新更新,并使用来源、用途或协议作为分组名称,避免只靠节点备注区分。

节点出现了但连接不上?

这表示订阅导入阶段已经完成。下一步检查当前节点是否被选中、系统时间是否准确、内核类型是否支持对应协议,并查看连接日志中的端口、TLS、SNI 或 Reality 参数报错。

订阅的作用是批量取得并维护配置,不负责自动判断每个节点在当前网络中是否可用。导入成功后仍需选择具体节点、启动连接,并根据实际用途设置系统代理与路由模式。

下载客户端 查看四个平台的安装入口