v2rayN 订阅转换怎么弄?按链接、格式与本地文件导入排查
简答:先看内容类型:订阅 URL 放进“订阅分组设置”,单节点或多行分享链接用“从剪贴板导入分享链接”,完整 JSON、YAML 或 Xray 配置文件则优先查看“添加自定义配置服务器”入口。Clash YAML、sing-box JSON 是否能直接作为订阅使用,不能只看扩展名判断;转换前先确认输入格式、目标格式和转换服务地址。
定义:v2rayN 订阅转换,是把订阅地址或配置内容整理成当前 v2rayN 能识别的协议分享链接、Base64 节点列表或内部分享格式,而不是简单修改文件后缀。
先看速查卡:粘进去没节点,通常是入口选错
如果你拿到的是一条以 http:// 或 https:// 开头的地址,先按订阅处理;如果内容以 vmess://、vless://、trojan://、ss:// 等开头,通常按分享链接处理;如果文件以 proxies:、outbounds 或其他配置字段开头,则不要直接放进订阅 URL 输入框。
| 手里拿到的内容 | 通常是否转换 | v2rayN 入口 | 先检查什么 |
|---|---|---|---|
| 订阅 URL | 通常不需要 | 订阅分组设置 → 更新当前订阅 | 地址是否完整、是否需要令牌或登录 |
| 单条分享链接 | 不需要 | 从剪贴板导入分享链接 | 协议前缀、端口和参数是否被截断 |
| 多行 URI | 通常不需要 | 从剪贴板导入分享链接 | 每行是否独占一条链接 |
| Base64 节点列表 | 通常不需要再次转换 | 本地解码后再从剪贴板导入 | 解码后是否出现可识别协议前缀 |
| v2rayN 内部分享格式 | 不需要 | 从剪贴板导入分享链接 | 是否以 v2rayn:// 开头 |
| 完整 JSON、YAML 或 Xray 配置 | 视文件用途而定 | 添加自定义配置服务器,或先转换后剪贴板导入 | 文件属于哪个内核和配置类型 |
| 网页、登录页或错误页 | 不能直接导入 | 回到原来源重新获取真实订阅 | 首行是否为 HTML、登录提示或错误对象 |
v2rayN 的订阅说明列出了 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hy2、TUIC、WireGuard 和 AnyTLS 等协议,并说明订阅内容可以是协议标准格式或 v2rayN 内部格式;具体可用范围仍需结合当前版本与内核核对。查看 v2rayN 订阅功能说明
本文是第三方使用指南,本站不是 v2rayN 的开发方或运营方。菜单名称和位置可能随版本变化,本文优先使用功能名称,不把某个版本的按钮位置写成固定路径。
第一步:订阅 URL 直接添加,不要粘贴订阅正文
- 打开订阅分组设置。
在 v2rayN 中进入“订阅分组设置”,新建或编辑分组,在“可选地址(Url)”或同类地址字段中粘贴完整订阅 URL,填写备注后保存。不同版本的字段名称可能略有差异,以当前界面显示为准。
- 选择更新方式。
保存后,在订阅分组菜单中选择“更新当前订阅 (不通过代理)”。如果设备直连无法访问订阅地址、但已经有可用代理,再尝试“更新当前订阅 (通过代理)”。官方界面资源同时列出了更新全部订阅的对应入口。查看官方中文界面文字
- 看日志分层判断。
源码中的更新流程包含开始获取订阅、获取内容成功、开始解析、解析结果和更新结束等处理阶段;中文提示的具体措辞可能随版本调整。查看订阅更新处理源码 查看中文提示资源
最小示例:https://example.com/sub?token=REDACTED 是订阅 URL,应放入订阅分组设置;不要把下载后得到的整段 Base64 文本或多行节点正文粘回 URL 字段。
订阅 URL 往往包含令牌或账号凭据。不要把真实地址放入截图、公开聊天、工单或命令历史;示例中的域名、UUID、密码和 token 应替换为 REDACTED。
第二步:单节点、多行 URI 和 Base64 用剪贴板导入
- 单节点链接:复制完整的
vmess://、vless://、trojan://、ss://或当前版本支持的其他分享链接,在主界面使用“从剪贴板导入分享链接”。官方中文资源中存在该入口及导入成功提示。查看剪贴板导入入口 - 多行 URI:让每条链接独占一行,不要在前后添加说明文字。复制后一次性导入,导入数量以客户端提示为准。
- Base64 文本:如果内容是一长段字母、数字、加号、斜杠和等号组成的文本,先在本地保存并解码,不要仅凭文件后缀判断。解码后若出现多行
vmess://、vless://或其他可识别前缀,再复制解码结果,通过剪贴板导入。 - v2rayN 内部格式:官方订阅说明给出了以
v2rayn://开头的内部分享格式示例,用于表达协议标准链接未覆盖的部分配置字段。不要手动修改其中的编码内容;如果导入失败,应回到生成来源检查文本是否完整。查看内部分享格式说明
注意:Base64 解码后仍然是 HTML、登录提示、错误信息或空文本时,不要继续反复转换,应先核对原始订阅地址和返回内容。
第三步:完整 JSON、YAML 或本地文件,先判断是不是自定义配置
完整配置文件与节点分享链接不是同一层级。v2rayN 官方仓库的配置处理源码包含“从文件添加自定义服务器配置”的处理逻辑,因此当前版本可能提供“服务器 → 添加自定义配置服务器”一类入口;入口名称、可选文件类型和支持的内核应以实际界面为准。查看官方配置处理源码
- 先看文件用途:以
proxies:开头的 YAML,可能是某类客户端配置;包含outbounds的 JSON,可能是某个内核的完整配置。不要只把.yaml改成.txt就认为格式已经转换。 - 尝试自定义配置入口:在 v2rayN 主界面查找“服务器”“添加自定义配置服务器”或相近名称,选择本地文件并选择对应类型。若当前版本没有该入口,或文件类型不在列表中,不要强行导入。
- 无法直接使用时再转换:从可信来源取得标准分享链接,或使用可信的本地转换程序,将配置整理为 v2rayN 可识别的协议链接,再走剪贴板导入。无法确认字段含义时,不要手工改写 UUID、端口、TLS、传输层和密钥。
本地文件检查:用文本编辑器确认文件不是网页错误页,编码优先检查为 UTF-8;观察是否存在 BOM、首行空行、不可见字符、异常引号或混乱换行。不同编辑器对 BOM 和换行的显示方式不同,这一步属于本地排查建议,不代表 v2rayN 对所有文件都提供相同的兼容承诺。
如果文件包含真实订阅令牌或节点凭据,不要上传到陌生在线转换站。使用“订阅分组”中的转换目标类型前,还要先核实转换服务地址由谁提供;因为源码显示,设置转换目标后,客户端会把原始订阅 URL 拼接到转换服务请求中。对该服务不信任时,不要启用,或改用自建、可信的本地转换方案。查看转换请求处理逻辑
需要转换时:按“输入→目标→输出”设置
- 输入:在订阅分组中填写真实订阅 URL,而不是把订阅正文放进 URL 栏。
- 目标:查看“订阅转换目标类型”或相近字段。该字段是否存在、有哪些选项,以当前版本界面为准。
- 服务:核对转换服务地址。v2rayN 源码显示,当转换目标不为空时,程序会根据配置的转换服务地址生成请求,并附加目标类型和配置参数;这意味着原始 URL 可能被发送给该转换服务。查看官方转换处理源码
- 输出:优先选择能够输出标准协议分享链接或 v2rayN 可解析内部格式的结果。若输出是另一种完整客户端配置,不要默认它能被订阅节点解析器直接接受。
- 更新:保存分组后更新当前订阅,分别观察下载、解析和导入结果。更新成功只说明内容被获取和处理,不等于节点已经可用,也不等于系统代理已经生效。
如果没有任何可用节点,通常先尝试“不通过代理”更新;只有设备直连无法访问订阅地址、同时已有可用代理时,再尝试“通过代理”更新。若两种方式都失败,应继续检查地址权限、HTTP 响应、正文内容和格式,而不是只重复切换按钮。
节点为空或更新失败:按六层顺序排查
- 地址完整性:检查 URL 是否被换行、中文引号、空格或复制截断;分享链接是否保留完整协议前缀。
- 网络请求:Windows PowerShell 可用脱敏地址执行
curl.exe -I -L "https://example.com/sub?token=REDACTED"。Linux 和 macOS 通常去掉.exe,使用curl -I -L。该命令只用于辅助查看响应头,curl 默认 User-Agent 可能与 v2rayN 当前设置不同,结果不能完全替代客户端行为。 - 下载正文:可用
curl.exe -L "https://example.com/sub?token=REDACTED" -o sub.txt下载到本地;Linux 和 macOS 使用curl -L。打开文件检查是否为空、是否为 HTML 登录页、JSON 错误对象或其他网页内容。HTTP 200 也可能返回错误页面。 - 编码与解码:确认 Base64 解码后出现有效协议前缀;检查 UTF-8、BOM、首行空行、不可见字符和换行是否异常。没有协议前缀时,可能是内容截断、编码层不对或输出格式不属于 v2rayN 订阅格式。
- 协议与内核:协议列表存在于官方订阅说明,但具体扩展字段仍需结合当前版本和使用的内核确认。遇到协议不识别时,核对客户端版本、内核类型和转换输出。
- 过滤与界面状态:如果日志显示获取和解析完成但列表为空,检查别名正则过滤、当前订阅分组、搜索框和其他筛选条件。过滤条件可能让已解析节点不显示,先清空筛选再判断。
日志阶段不要混淆:“获取订阅内容成功”表示下载阶段有结果;“解析成功”表示程序识别并处理了内容;节点出现在列表后,还要单独验证节点连接;系统代理生效则还需检查系统代理开关和应用是否遵循系统代理。不同版本的日志措辞可能变化,以当前版本界面为准。查看更新阶段源码 查看中文日志文案
三行结论:先识别格式,再选择入口
订阅 URL → 订阅分组设置 → 更新当前订阅。
单节点、多行 URI、Base64 解码后的链接或 v2rayn:// → 从剪贴板导入分享链接。
完整 JSON、YAML 或内核配置 → 先查看自定义配置入口;不支持时再转换,不要直接粘进 URL 框。
如果转换后仍然没有节点,按“地址→请求→正文→解码→协议兼容→过滤和当前分组”的顺序定位。该顺序能把“链接打不开”“下载到错误页”“解码失败”“协议不兼容”和“节点被筛选隐藏”区分开。
版本差异可通过项目 Release 页面核对,不要根据旧教程固定记忆按钮位置或当前版本号。查看 v2rayN Release 页面
常见问题
v2rayN 订阅转换是不是必须使用在线转换站?
不一定。原始订阅如果已经输出 v2rayN 能识别的标准协议格式或内部分享格式,通常可以直接添加订阅并更新。需要转换时,应先核实转换服务地址和数据发送方式;不信任第三方服务时,不要启用该转换目标,优先使用可信的本地或自建方案。
Clash YAML 可以直接导入 v2rayN 吗?
不能只凭文件后缀判断。先查看当前版本是否提供“添加自定义配置服务器”入口以及对应类型;如果没有匹配类型,再将内容转换为标准协议分享链接或 v2rayN 可识别格式后,通过剪贴板导入。
完整 JSON 配置应该放进订阅 URL 栏吗?
不应该。URL 栏用于填写可访问的订阅地址,完整 JSON 属于配置正文。先查看自定义配置入口;如果当前版本或文件类型不支持,再转换后导入。
Base64 订阅导入后节点为空怎么办?
先在本地解码,检查结果是否为 HTML、错误提示、空文件或被截断,并确认出现 vmess://、vless://、trojan:// 等协议前缀。随后清空别名过滤、搜索框和其他筛选,再核对协议与内核兼容性。
订阅 URL 能在浏览器打开,为什么 v2rayN 仍然更新失败?
浏览器打开可能得到登录页、重定向页面或错误页,不一定是订阅正文。可用脱敏后的 curl 检查响应头和下载文件;同时注意 curl 的 User-Agent 可能与 v2rayN 不同,因此只能辅助判断,不能完全替代客户端请求。
应该选择通过代理更新还是不通过代理更新?
没有可用节点时,通常先尝试不通过代理更新;设备直连无法访问订阅地址、但已有可用代理时,再尝试通过代理更新。两者都失败时,应继续检查 URL、权限、TLS、HTTP 响应和正文格式。