本文速览
适合第一次收到 vmess:// 或 vless:// 文本、但不确定该粘贴到哪里的用户。文章会拆开两种链接的字段,说明它们与 HTTP 订阅地址的边界,并给出 v2rayN、v2rayNG 的剪贴板和二维码导入步骤以及失败排查顺序。
分享链接和订阅链接不是同一种入口
vmess:// 与 vless:// 都是单节点分享链接。客户端解析一条链接后,通常只会新增一条服务器配置,其中包含地址、端口、用户标识、传输方式和安全参数。复制三条分享链接并批量导入,结果就是三条独立配置;这些配置不会因为原文本后来发生变化而自动更新。订阅链接通常是一个以
https:// 开头的网络地址。客户端访问该地址后,服务端返回一组节点记录,内容可能是 Base64 聚合文本,也可能是客户端能够识别的结构化数据。订阅分组保存的是“获取列表的地址”,所以用户可以执行手动更新或定时更新,新增、删除和参数调整也会随下一次拉取进入本地。单条分享链接
导入后生成一个本地节点,适合临时测试、单独迁移或核对某个协议配置。后续参数变化时,需要重新导入或手动修改。
适合:只收到一个 vmess:// 或 vless:// 地址
订阅链接
推荐一次拉取一组节点,并由订阅分组维护更新关系。桌面端和安卓端可以分别保存同一订阅地址。
适合:长期维护多个节点与多设备列表
| 判断项 | 分享链接 | 订阅链接 |
|---|---|---|
| 常见开头 | vmess://、vless:// |
https:// |
| 一次导入结果 | 一个节点对应一条链接 | 一个订阅分组包含多条节点 |
| 更新方式 | 重新导入或编辑配置 | 手动更新或按客户端设置自动更新 |
| 常用入口 | 从剪贴板导入、扫描二维码 | 订阅分组设置、订阅设置 |
vmess:// 与 vless:// 里面分别保存了什么
VMess 分享格式常见做法是把一段 JSON 编码后接在
vmess:// 后面。解码后的 v 通常为 2,add 是服务器地址,port 是远端端口,id 是 UUID,net 和 type 描述传输相关设置,tls、sni 等字段描述安全层。不同生成端可能省略空字段,但地址、端口和用户标识必须能形成有效出站配置。下面是用于解释字段的 VMess JSON。示例采用保留域名,不能直接建立连接;它的作用是展示客户端导入后会得到哪些设置项。
{
"v": "2",
"ps": "VMess WS 示例",
"add": "node.example.com",
"port": "443",
"id": "8f4c756b-3d92-4f9a-9f52-3e4b1d6a7280",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "node.example.com",
"path": "/gateway",
"tls": "tls",
"sni": "node.example.com"
}
VLESS 分享格式更接近标准 URI:用户标识位于
@ 前,服务器和端口位于其后,传输与安全设置写入查询参数,# 后面是显示名称。因为字段可读,排错时可以直接检查 security、type、flow、sni、pbk 和 sid 是否缺失。vless://[email protected]:443?encryption=none&security=reality&sni=www.example.com&fp=chrome&pbk=Yfg3cV9mR7wP2nK6aB4dL8sQ1xT5uH0jE9zN2pM6rA0&sid=6ba85179&type=tcp&flow=xtls-rprx-vision#VLESS%20REALITY%20示例
v=2
常见 VMess 分享格式版本
1 对 1
一条分享链接生成一个节点
10808
本文 SOCKS 本地端口示例
18 → 18
测试文本中 18 条 URI 的导入结果
结论:协议名只是第一层判断
导入成功但连接失败时,不要只核对 VMess 或 VLESS;应继续逐项比较端口、传输类型、TLS 或 REALITY、安全域名、路径和 flow。任何一项与服务端不一致,都可能导致握手失败。
在 v2rayN 中从剪贴板导入分享链接
以下操作以 v2rayN 7.15.4 的中文界面为复核样例。不同 7.x 版本可能调整菜单文字,但处理顺序相同:先完整复制分享文本,再让客户端扫描剪贴板中的受支持 URI。复制时不要额外加入引号,也不要把聊天软件显示的说明文字一起选中。
如果一次收到多条链接,可以让每条 URI 独占一行。v2rayN 的批量导入会逐行识别受支持的协议;普通说明、空行和不能解析的文本通常不会生成配置。导入完成后应立即核对新增数量,而不是直接开启系统代理。
- 启动 v2rayN,等待主窗口出现并确认内核组件已正常载入。
- 复制完整的
vmess://或vless://文本。批量导入时,每行放置一条链接。 - 打开「服务器」菜单,选择「从剪贴板导入批量 URL」。部分 7.x 界面也支持在服务器列表获得焦点后使用 Ctrl + V。
- 在服务器列表中找到新增记录,双击打开编辑窗口,检查地址、端口、UUID、传输方式与安全类型。
- 右键目标节点并设为活动服务器,再按使用场景选择「系统代理」或 TUN 模式。
- 进入「设置」→「参数设置」检查本地监听端口。本文测试配置使用 SOCKS
10808、HTTP10809;如果端口已被其他程序占用,应改为未占用端口并重新启动内核。
导入后先看字段,再做连通测试
VMess over WebSocket 配置应特别核对 Host 与 Path。例如服务端路径是
/gateway,客户端若变成 /,即使地址、端口和 UUID 都正确,也无法完成预期传输。VLESS REALITY 配置则要同时核对 security=reality、Server Name、Public Key、Short ID、Fingerprint 与 flow=xtls-rprx-vision。选择节点后可以打开 v2rayN 日志,观察失败发生在域名解析、TCP 建连还是握手阶段。出现端口占用时先处理本地监听;出现连接超时再检查远端地址与网络;出现握手类错误则回到节点编辑窗口比对安全参数。这样的顺序比反复删除并导入更容易定位问题。
在 v2rayNG 中用剪贴板或二维码导入
以下步骤以 v2rayNG 1.10.31 的常见界面为例。v2rayNG 使用 Xray 内核,可识别 VMess、VLESS 以及 VLESS REALITY 等配置。安卓系统可能限制后台运行,导入成功只代表配置已写入列表,是否持续连接还取决于应用运行状态和系统网络设置。
同一台设备上收到文本时,剪贴板导入步骤最少;二维码显示在另一块屏幕上时,扫描更方便。二维码本质上只是分享 URI 的图形编码,扫码后得到的字段与粘贴同一条文本完全相同,并不会把单节点链接变成订阅。
- 复制完整分享链接,打开 v2rayNG 主界面。
- 点击右上角新增按钮,选择「从剪贴板导入」。成功后,节点名称会出现在配置列表。
- 若链接以二维码展示,选择「扫描二维码」,授予相机权限后让二维码完整进入取景框。
- 点按新配置使其成为当前选中项,再打开编辑页面检查地址、端口、用户 ID、传输协议和安全选项。
- 点击主界面的连接按钮,确认系统建立本地代理连接。需要限定应用时,再进入「设置」中的分应用代理选项配置范围。
- 如需检查本地端口,进入侧边菜单的「设置」,查看本地 SOCKS 监听端口。本文示例设为
10808,手动配置其他应用时必须填写相同端口。
导入方案:按链接所在位置选择入口
链接在当前设备
- 长按复制完整 URI
- 选择「从剪贴板导入」
- 导入后核对节点名称和端口
二维码在另一块屏幕
- 选择「扫描二维码」
- 保持图像完整且清晰
- 扫码后检查 REALITY 或 TLS 字段
同一 URI 通过剪贴板和二维码导入,所得节点字段应当一致;若不一致,应检查二维码是否过期或文本是否被截断。
导入失败、能导入但不能连接怎么排查
排查应先区分“解析失败”和“连接失败”。解析失败表现为导入后列表没有新增记录,问题通常位于链接文本、编码或客户端支持范围;连接失败则表示配置已经生成,但运行日志显示超时、拒绝连接或握手异常。两类问题使用不同检查路径。
粘贴后提示未发现有效链接?
确认文本从
vmess:// 或 vless:// 开头连续复制到末尾。删除开头的项目符号、中文引号和结尾句号;批量文本改为每行一条 URI 后重新导入。VMess 能生成节点,但名称和地址是空的?
这通常说明 Base64 内容不完整或解码后的 JSON 结构损坏。重新复制原链接,并检查聊天工具是否在中间插入换行。不要手工补写未知的
add、port 或 id。VLESS REALITY 导入后一直握手失败?
依次核对安全类型 REALITY、Server Name、Public Key、Short ID、Fingerprint 和 flow。服务端使用 Vision 时,客户端 flow 通常需要与其保持一致。
节点显示已连接,但浏览器打不开网页?
桌面端检查 v2rayN 的系统代理状态,并确认浏览器没有固定使用另一个代理端口;安卓端确认 v2rayNG 连接状态仍在运行。随后查看日志是否有 DNS 或本地端口占用信息。
重复导入后出现多个同名节点?
分享链接没有订阅分组的更新关系,客户端通常会把再次导入视为新配置。先比较地址、端口和 UUID,确认重复后删除旧记录;长期使用多节点时改用订阅分组管理。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 导入数量为 0 | 协议头、换行、文本完整性 | 重新复制原始 URI |
| 配置存在但连接超时 | 远端地址、端口、当前网络 | 查看内核连接日志 |
| TLS 握手异常 | SNI、Host、系统时间 | 与配置来源逐项比对 |
| REALITY 握手异常 | pbk、sid、fp、flow | 重新导入完整链接 |
| 浏览器未走代理 | 系统代理状态、10808 与 10809 | 统一应用与客户端端口 |
还要检查设备时间。TLS 和 REALITY 握手依赖正常的时间环境,系统日期明显偏差时可能出现证书或握手错误。将日期、时区设为自动后重新启动客户端,再进行一次连接测试,可以排除本地时间造成的干扰。
什么时候应把单节点改成订阅管理
只测试一个节点时,分享链接最直接;节点数量增加后,逐条复制会带来重复记录和参数过期问题。尤其是地址、端口、传输路径或 REALITY 参数调整时,本地旧链接不会自行变化。此时应让配置提供方给出明确的订阅地址,再由客户端保存更新关系。
在 v2rayN 中,订阅入口通常位于「订阅分组」→「订阅分组设置」。新增分组后填写别名和订阅地址,保存,再执行「更新全部订阅」。在 v2rayNG 中进入「订阅设置」,新增地址并返回主界面更新订阅。不要把已经导入的几十条单节点配置误认为一个可更新分组。
- 临时验证一个 VMess 或 VLESS 节点:使用剪贴板导入。
- 从桌面端迁移一个节点到安卓端:用同一 URI 或二维码导入,并重新核对字段。
- 维护十几条经常变化的节点:使用订阅分组,避免逐条覆盖。
- 订阅中只有某一条节点异常:先检查该节点参数,不必立即删除整个订阅。
- 需要保留手工修改的配置:复制为独立节点并改名,避免下一次订阅更新覆盖分组内容。
结论:按是否需要更新关系来选择
单节点分享解决“把这一条配置导进去”,订阅解决“让这一组配置以后还能更新”。节点数量不是唯一标准,是否需要持续同步才是更稳定的判断依据。
分享前保留完整参数并控制传播范围
分享 URI 中通常包含用于连接的 UUID、服务器地址和传输参数,应按连接凭据管理。复制时保持内容完整,转发时确认接收对象和使用范围,不要公开发布仍在使用的链接。若链接来源已更新连接标识,应删除旧配置并导入新内容。
排查结束后,可以给节点名称补充协议、地区或用途,例如“VLESS REALITY 日常”或“VMess WS 测试”。名称只用于本地识别,不参与连接;真正决定连接结果的仍然是地址、端口、用户标识、传输层和安全参数。