v2rayN 导入订阅可用剪贴板、二维码或订阅分组入口。粘贴进去的是地址还是配置,会影响后续处理:以 https 起头的内容先进入新增订阅流程,协议分享链接则进入配置导入流程。导入后要刷新订阅内容,还需使用订阅更新选项。

截至 2026-11-08,下文菜单文字与程序行为依据版本 7.25.6;剪贴板识别次序依据项目 Wiki。查阅原文可看界面功能说明。

三种入口,先看手里的内容

手里的内容可用入口要区分的结果
已复制的地址或分享内容「从剪贴板导入分享链接」程序识别内容后,决定新增订阅还是导入配置
屏幕或图片里的二维码「扫描屏幕上的二维码」或「扫描图片中的二维码」扫描入口分为屏幕和图片两项
需要保存并继续更新的订阅地址「订阅分组」「订阅分组设置」分组保存地址,也提供更新相关设置

剪贴板还支持 Ctrl+V。使用快捷键时,焦点要位于输入框之外;在输入框里粘贴文字,与触发导入是两回事。

二维码导入成功时,可看到「扫描导入分享链接成功」。剪贴板成功提示会给出导入配置的数量。判断处理结果时,应结合提示内容,区分新增订阅与新增配置。

粘贴后,程序按什么次序识别

剪贴板入口会读取系统剪贴板,既处理明文,也处理 BASE64 编码内容。解析会先尝试 BASE64,再尝试明文,并非只识别某一种协议链接。

次序尝试识别的内容对应处理
①以 https 起头的地址进入新增订阅流程
②符合协议标准的分享链接加入混合配置
③SIP008 内容加入 Shadowsocks 配置
④WireGuard 配置文本按 WireGuard 内容处理
⑤v2rayN 自身的分享格式按内部分享内容处理
⑥sing-box、v2ray 的多项自定义配置加入自定义配置
⑦sing-box、v2ray 的单项自定义配置加入自定义配置
⑧Clash、Hysteria 自定义配置继续尝试相应格式
⑨前面都未识别成功显示错误,提示检查分享链接

这张表解释了同样使用粘贴,为何结果可能不同。地址被识别为订阅后,后续还有获取与解析内容的过程;不能把粘贴地址和完成订阅更新视为同一步。

项目的订阅说明列有 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hy2、TUIC、WireGuard、Anytls。内容采用协议标准分享格式,或 v2rayN 自身格式。协议名称与内容格式需要分开看,只有名称并不能表达完整配置。

保存分组时,留意地址之间的关系

订阅分组可以填写地址,也有「更多地址」。后者使用逗号分隔,各地址的类型需要一致;填写更多地址后,订阅转换不会生效。

别名正则过滤的实现范围限于 v2rayN 订阅内容。分组还提供转换目标类型与 User Agent,不应把这些选项理解为所有内容都能互相转换。

截至 2026-11-08,7.25.6 已加入订阅更新用的自定义 HTTP 标头。自定义值会替代对应的默认请求头,作用范围覆盖该分组中的全部地址,也包含订阅转换服务。

保存使用 HTTP 的订阅地址时,程序会提醒协议不安全,但仍允许保存。能保存地址,不能用来判断后续能否获取或解析内容。

更新时,分别确认范围与路径

手动更新有两个选择维度:

选择维度可选范围
更新哪些订阅当前订阅、全部订阅
请求怎样发出通过代理、不通过代理

两组选择组合成四个更新入口。当前订阅与全部订阅决定处理范围,代理选项决定更新请求是否经过代理。

分组中还有「启用更新」和「自动更新间隔 (分钟)」。间隔的默认值、允许设置的最小值,官方没有说明。看到「未启用更新」相关提示时,应先核对该分组的更新开关。

用日志辨认更新到了哪一步

日志中的文字或信息对应阶段
「更新订阅开始」整轮更新启动
分组别名后出现开始获取内容的信息正在请求该分组的订阅内容
「获取订阅内容成功」获取阶段成功
开始解析、处理内容的信息进入内容识别与处理阶段
「更新订阅结束」整轮流程结束

获取成功只说明前面的获取阶段成功,还要继续看解析与导入结果。单独出现结束提示,也不能代替对中间日志的检查。

「未设置有效的订阅」涉及本次更新是否有有效对象;分组被标为未启用时,会跳过它。「无效的订阅内容」和「导入订阅内容失败」则需要结合前后日志阅读。各提示对应的具体失败原因,官方没有说明,不能只凭一句提示判断故障来源。

遇到其他提示可查常见报错与日志说明;需要处理客户端自身的升级,可看v2rayN 程序更新说明。

第三方整理,与项目方无关。