本文速览

先判断拿到的是单个节点参数,还是用于获取节点列表的订阅地址,再选择导入入口。本文适合首次配置 v2rayN、v2rayNG 的用户:读完可以区分两类链接,完成剪贴板与二维码导入,建立订阅分组,并按“下载内容、解析格式、连接节点”三个环节排查失败。

分享链接与订阅地址的区别

vmess:// 与 vless:// 通常是单个节点的分享格式,里面装着服务器地址、端口、用户标识及传输参数。导入时,客户端读取这些参数并生成本地节点记录;它不是先访问这个地址,再从网页下载配置。

订阅地址通常以 https:// 开头,指向提供节点列表的接口。客户端需要发起网络请求,拿到响应内容后再解析。订阅可以返回一个节点,也可以返回多个;节点数量不是区分分享链接与订阅地址的可靠标准。

比较项单条分享链接订阅地址
常见开头vmess://、vless://https://
内容来源链接本身携带节点参数请求远端接口获取列表
参数变化后通常需要重新导入或手动修改执行订阅更新,获取新内容
合适入口从剪贴板导入、扫描二维码订阅分组设置、更新订阅
敏感内容UUID 等连接凭据地址中的访问令牌及其可获取的节点

订阅分组维护

推荐

已有可信提供方给出的订阅时,将它保存到独立分组。节点地址、端口或列表变化后,通过更新订阅获取变化,不逐条重复粘贴。

适合:长期使用、多个节点、需要跟随服务端更新

单条链接导入

直接建立一条节点记录,便于核对服务器与传输字段。链接本身不提供持续更新能力,适合先验证一套配置是否可用。

适合:自建节点、临时测试、逐项核对参数

判断:看内容用途,不只看地址外观

拿到 HTTPS 地址时,先确认它是“订阅接口”而不是登录页或购买页面;拿到协议分享链接时,直接使用节点导入入口,不要把它填进订阅地址栏。

链接结构与需要保留的字段

常见 VMess 分享格式是 vmess:// 后接 Base64 编码的 JSON,解码后常见字段包括 add、port、id、net、host、path 与 tls。Base64 是编码,不是加密;这些分享字段也不等同于内核运行时 config.json 的完整结构。

VLESS 分享链接更接近 URI:用户标识位于 @ 前,后面是服务器与端口,查询参数描述传输和安全设置,# 后通常是节点备注。下面仅用于阅读结构,域名与 UUID 均为演示数据,不能用于连接。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=node.example.com&path=%2Fgateway&sni=node.example.com#Example-WS-TLS
443
示例中的服务端监听端口
36 字符
示例 UUID 长度,含连字符
1 条
该分享链接描述的节点记录

v2rayN:剪贴板与二维码导入

以下按常见中文界面说明,桌面版与经典界面的按钮位置可能不同。先确认当前复制的是完整的协议分享链接,而不是订阅网页的标题。导入节点只会写入配置列表,并不代表系统代理已经启用。

  1. 复制链接。选中从 vmess:// 或 vless:// 开始的整条文本。批量导入时建议每行一条,不夹杂编号、引号或说明文字。
  2. 从剪贴板导入。回到 v2rayN 主窗口,使用「服务器」→「从剪贴板导入批量 URL」;部分版本入口位于添加服务器菜单。也可在主窗口尝试 Ctrl+V,不要在搜索框或参数输入框中执行粘贴。
  3. 核对记录。查看新增节点的协议、地址、端口和备注;打开编辑窗口确认传输类型、TLS 与服务器名称没有缺失。导入成功但字段为空时,应重新检查原始链接。
  4. 设为活动服务器。选中需要测试的节点,通过右键菜单设为活动服务器,再根据使用场景设置系统代理或其他接管模式。先测试一个节点,避免同时改动路由与 DNS。

二维码只是文本的承载方式,不是另一种协议。桌面端可将二维码完整显示在屏幕上,再使用「服务器」→「扫描屏幕上的二维码」;不同版本也可能将入口放在添加菜单中。扫描前关闭遮挡窗口,保留二维码四周空白,必要时调整显示比例。

v2rayN:添加订阅与更新节点

订阅流程有两个独立动作:保存地址、获取内容。只填好订阅分组但未执行更新时,节点列表可能仍然为空。建议使用容易识别的分组名,例如“主用订阅”,不要把访问令牌写进备注。

  1. 打开「订阅分组」→「订阅分组设置」,新增分组,在备注中填写名称,在 URL 栏粘贴完整订阅地址,然后保存。
  2. 回到主窗口,选择对应分组,执行「订阅分组」→「更新当前订阅(不通过代理)」。菜单措辞随版本略有差异,重点是确认更新目标为刚保存的分组。
  3. 观察状态或日志中的下载与解析结果。若网络必须经过已有代理才能访问订阅接口,且当前已有可用节点,再尝试「更新当前订阅(通过代理)」。
  4. 更新后检查节点数量、分组归属与备注,选一条节点设为活动服务器。不要把“订阅更新成功”当作所有节点都能连接的证明。

v2rayNG:手机导入与订阅分组

v2rayNG 的单条导入通常从主界面右上角「+」进入。首次启动连接时,Android 会要求确认 VPN 连接权限;这是连接阶段的系统授权,与节点是否成功导入是两件事。

  1. 剪贴板:复制完整分享链接,打开 v2rayNG,点击「+」→「从剪贴板导入」。返回列表检查新增记录,再选中需要使用的节点。
  2. 二维码:点击「+」→「扫描二维码」,按提示授予相机权限。二维码在另一块屏幕上时直接扫描;若当前版本提供图片识别入口,可选择本机保存的二维码图片。
  3. 订阅:打开侧边菜单中的「订阅分组设置」,点击新增,填写备注与订阅 URL 并保存。回到主界面,在右上角菜单执行「更新订阅」;若界面区分当前分组与全部分组,选择相应范围。
  4. 连接:确认列表出现节点后,选中一条并点击连接按钮,接受系统授权,再测试实际访问。手机省电策略可能影响后台运行,持续断连时应检查系统的电池与后台限制。

双端方案:分别保存同一订阅

桌面端:v2rayN
  • 在订阅分组设置中保存地址。
  • 更新后核对节点及传输字段。
  • 根据桌面应用需求设置系统代理。
安卓端:v2rayNG
  • 单独添加订阅并执行更新。
  • 使用支持相应参数的 Xray 内核。
  • 连接时确认系统 VPN 权限。

两端各自保存和更新配置,不会自动同步当前选中节点、路由或更新时刻;还需遵守订阅提供方的设备与并发限制。

导入失败与订阅为空怎么处理

排查时先判断错误发生在哪一层。剪贴板导入失败主要检查文本和解析支持;订阅更新失败要检查网络请求与响应;节点已经进入列表却无法使用,才继续检查服务端、传输参数、路由和 DNS。

粘贴后提示没有有效配置,是链接坏了吗?

先检查开头是否为完整的 vmess:// 或 vless://,去掉文本外层引号与聊天编号,但保留所有参数。如果复制的是 HTTPS 订阅地址,改用订阅分组入口。确认文本完整后仍不识别,再检查当前客户端是否支持链接中的传输与安全参数。

订阅更新超时,应该一直切换代理吗?

先检查本机网络与系统时间,再确认订阅地址没有过期或缺少令牌。直连无法访问时,只有在已有可用代理的前提下才尝试通过代理更新。没有可用节点时反复切换同一失败代理不会改善请求;应向提供方确认接口状态或可用入口。

提示更新成功,为什么一个节点也没有?

先取消搜索与分组筛选,检查当前显示的分组。若仍为空,确认接口返回的是客户端支持的节点订阅,而不是登录 HTML、验证页面或其他配置格式。HTTP 请求成功只说明收到了响应,不保证响应内含可解析节点。

同一个二维码在手机能导入,桌面为什么失败?

先区分“未识别二维码”和“识别后无法解析”。前者调整清晰度、显示尺寸与遮挡;后者检查两端客户端版本及参数支持。不要删除 security、flow 或公钥字段来强行导入,那会改变连接条件。

导入后有延迟数值,浏览器还是打不开?

确认所测节点就是当前活动节点,再检查系统代理或手机 VPN 是否正在运行。某些延迟测试只验证 TCP 建连,并不验证完整的协议握手与网页访问;应结合实际请求和运行日志判断,不要仅凭一个毫秒数认定配置可用。

订阅更新与凭据保管

分享链接、二维码和订阅 URL 都应按连接凭据保管。订阅地址中的长字符串常用于识别账户,二维码也可能直接包含 UUID。把二维码截图发到公开讨论区,并不会比公开链接更安全;诊断截图应遮住凭据、完整订阅地址及个人账户信息。

完成配置后,保留一个清楚的检查顺序:确认导入类型,核对节点字段,选中活动节点,启用需要的流量接管方式,最后验证实际访问。这样可以把“地址放错入口”“订阅下载失败”和“节点连接失败”分开处理。

下载客户端与查看导入教程

桌面端查看 v2rayN,Android 查看 v2rayNG 与 v2flyNG。先按节点所需协议和内核选择客户端,再按教程完成导入与连接设置。