先判断拿到的是单个节点参数,还是用于获取节点列表的订阅地址,再选择导入入口。本文适合首次配置 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
type=ws表示 WebSocket;path=%2Fgateway解码后是/gateway,路径必须与服务端一致。security=tls表示启用 TLS;sni是 TLS 握手使用的服务器名称,不能随意替换成其他域名。encryption=none是 VLESS 协议字段,不表示整个连接没有 TLS 保护。协议层与传输安全层应分开理解。- REALITY 节点还可能包含公钥、短标识与
flow等参数,需由支持这些字段的客户端和内核解析,不能套用上面的 TLS 示例。
v2rayN:剪贴板与二维码导入
以下按常见中文界面说明,桌面版与经典界面的按钮位置可能不同。先确认当前复制的是完整的协议分享链接,而不是订阅网页的标题。导入节点只会写入配置列表,并不代表系统代理已经启用。
- 复制链接。选中从
vmess://或vless://开始的整条文本。批量导入时建议每行一条,不夹杂编号、引号或说明文字。 - 从剪贴板导入。回到 v2rayN 主窗口,使用「服务器」→「从剪贴板导入批量 URL」;部分版本入口位于添加服务器菜单。也可在主窗口尝试
Ctrl+V,不要在搜索框或参数输入框中执行粘贴。 - 核对记录。查看新增节点的协议、地址、端口和备注;打开编辑窗口确认传输类型、TLS 与服务器名称没有缺失。导入成功但字段为空时,应重新检查原始链接。
- 设为活动服务器。选中需要测试的节点,通过右键菜单设为活动服务器,再根据使用场景设置系统代理或其他接管模式。先测试一个节点,避免同时改动路由与 DNS。
二维码只是文本的承载方式,不是另一种协议。桌面端可将二维码完整显示在屏幕上,再使用「服务器」→「扫描屏幕上的二维码」;不同版本也可能将入口放在添加菜单中。扫描前关闭遮挡窗口,保留二维码四周空白,必要时调整显示比例。
- 扫描结果以
vmess://或vless://开头:按节点分享链接导入。 - 扫描结果是 HTTPS 地址:确认用途后,将地址保存到订阅分组,不能仅凭扫码成功判断订阅已经更新。
- 扫描结果是网页地址或普通文字:向提供方索取真正的节点二维码或订阅地址,不要手工猜测参数。
v2rayN:添加订阅与更新节点
订阅流程有两个独立动作:保存地址、获取内容。只填好订阅分组但未执行更新时,节点列表可能仍然为空。建议使用容易识别的分组名,例如“主用订阅”,不要把访问令牌写进备注。
- 打开「订阅分组」→「订阅分组设置」,新增分组,在备注中填写名称,在 URL 栏粘贴完整订阅地址,然后保存。
- 回到主窗口,选择对应分组,执行「订阅分组」→「更新当前订阅(不通过代理)」。菜单措辞随版本略有差异,重点是确认更新目标为刚保存的分组。
- 观察状态或日志中的下载与解析结果。若网络必须经过已有代理才能访问订阅接口,且当前已有可用节点,再尝试「更新当前订阅(通过代理)」。
- 更新后检查节点数量、分组归属与备注,选一条节点设为活动服务器。不要把“订阅更新成功”当作所有节点都能连接的证明。
v2rayNG:手机导入与订阅分组
v2rayNG 的单条导入通常从主界面右上角「+」进入。首次启动连接时,Android 会要求确认 VPN 连接权限;这是连接阶段的系统授权,与节点是否成功导入是两件事。
- 剪贴板:复制完整分享链接,打开 v2rayNG,点击「+」→「从剪贴板导入」。返回列表检查新增记录,再选中需要使用的节点。
- 二维码:点击「+」→「扫描二维码」,按提示授予相机权限。二维码在另一块屏幕上时直接扫描;若当前版本提供图片识别入口,可选择本机保存的二维码图片。
- 订阅:打开侧边菜单中的「订阅分组设置」,点击新增,填写备注与订阅 URL 并保存。回到主界面,在右上角菜单执行「更新订阅」;若界面区分当前分组与全部分组,选择相应范围。
- 连接:确认列表出现节点后,选中一条并点击连接按钮,接受系统授权,再测试实际访问。手机省电策略可能影响后台运行,持续断连时应检查系统的电池与后台限制。
双端方案:分别保存同一订阅
桌面端:v2rayN
- 在订阅分组设置中保存地址。
- 更新后核对节点及传输字段。
- 根据桌面应用需求设置系统代理。
安卓端:v2rayNG
- 单独添加订阅并执行更新。
- 使用支持相应参数的 Xray 内核。
- 连接时确认系统 VPN 权限。
两端各自保存和更新配置,不会自动同步当前选中节点、路由或更新时刻;还需遵守订阅提供方的设备与并发限制。
导入失败与订阅为空怎么处理
排查时先判断错误发生在哪一层。剪贴板导入失败主要检查文本和解析支持;订阅更新失败要检查网络请求与响应;节点已经进入列表却无法使用,才继续检查服务端、传输参数、路由和 DNS。
粘贴后提示没有有效配置,是链接坏了吗?
先检查开头是否为完整的 vmess:// 或 vless://,去掉文本外层引号与聊天编号,但保留所有参数。如果复制的是 HTTPS 订阅地址,改用订阅分组入口。确认文本完整后仍不识别,再检查当前客户端是否支持链接中的传输与安全参数。
订阅更新超时,应该一直切换代理吗?
先检查本机网络与系统时间,再确认订阅地址没有过期或缺少令牌。直连无法访问时,只有在已有可用代理的前提下才尝试通过代理更新。没有可用节点时反复切换同一失败代理不会改善请求;应向提供方确认接口状态或可用入口。
提示更新成功,为什么一个节点也没有?
先取消搜索与分组筛选,检查当前显示的分组。若仍为空,确认接口返回的是客户端支持的节点订阅,而不是登录 HTML、验证页面或其他配置格式。HTTP 请求成功只说明收到了响应,不保证响应内含可解析节点。
同一个二维码在手机能导入,桌面为什么失败?
先区分“未识别二维码”和“识别后无法解析”。前者调整清晰度、显示尺寸与遮挡;后者检查两端客户端版本及参数支持。不要删除 security、flow 或公钥字段来强行导入,那会改变连接条件。
导入后有延迟数值,浏览器还是打不开?
确认所测节点就是当前活动节点,再检查系统代理或手机 VPN 是否正在运行。某些延迟测试只验证 TCP 建连,并不验证完整的协议握手与网页访问;应结合实际请求和运行日志判断,不要仅凭一个毫秒数认定配置可用。
订阅更新与凭据保管
分享链接、二维码和订阅 URL 都应按连接凭据保管。订阅地址中的长字符串常用于识别账户,二维码也可能直接包含 UUID。把二维码截图发到公开讨论区,并不会比公开链接更安全;诊断截图应遮住凭据、完整订阅地址及个人账户信息。
- 避免重复添加:同一条地址反复建立分组会让节点列表变得混乱。优先更新已有分组,删除重复项之前先确认其归属。
- 按需更新:初次添加、提供方通知调整线路或节点明显失效时执行更新。是否启用定时更新,取决于客户端提供的功能与服务方建议,不要短时间反复请求接口。
- 保持边界:订阅用于获取节点,不必然包含适用于本机的路由、DNS 和分应用设置。更换订阅后,这些本地策略仍需独立检查。
- 泄露后处理:如果地址被公开,在提供方账户页重置订阅令牌或相关凭据,再替换各设备保存的旧地址。仅删除聊天记录不能让已经复制出去的凭据失效。
完成配置后,保留一个清楚的检查顺序:确认导入类型,核对节点字段,选中活动节点,启用需要的流量接管方式,最后验证实际访问。这样可以把“地址放错入口”“订阅下载失败”和“节点连接失败”分开处理。
下载客户端与查看导入教程
桌面端查看 v2rayN,Android 查看 v2rayNG 与 v2flyNG。先按节点所需协议和内核选择客户端,再按教程完成导入与连接设置。