CreamData

v2rayN 订阅转换怎么弄?按链接、格式与本地文件导入排查

更新于 2026-11-13 · creamdata.site

简答:先看内容类型:订阅 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 直接添加,不要粘贴订阅正文

  1. 打开订阅分组设置。

    在 v2rayN 中进入“订阅分组设置”,新建或编辑分组,在“可选地址(Url)”或同类地址字段中粘贴完整订阅 URL,填写备注后保存。不同版本的字段名称可能略有差异,以当前界面显示为准。

  2. 选择更新方式。

    保存后,在订阅分组菜单中选择“更新当前订阅 (不通过代理)”。如果设备直连无法访问订阅地址、但已经有可用代理,再尝试“更新当前订阅 (通过代理)”。官方界面资源同时列出了更新全部订阅的对应入口。查看官方中文界面文字

  3. 看日志分层判断。

    源码中的更新流程包含开始获取订阅、获取内容成功、开始解析、解析结果和更新结束等处理阶段;中文提示的具体措辞可能随版本调整。查看订阅更新处理源码 查看中文提示资源

最小示例:https://example.com/sub?token=REDACTED 是订阅 URL,应放入订阅分组设置;不要把下载后得到的整段 Base64 文本或多行节点正文粘回 URL 字段。

订阅 URL 往往包含令牌或账号凭据。不要把真实地址放入截图、公开聊天、工单或命令历史;示例中的域名、UUID、密码和 token 应替换为 REDACTED。

第二步:单节点、多行 URI 和 Base64 用剪贴板导入

  1. 单节点链接:复制完整的 vmess://、vless://、trojan://、ss:// 或当前版本支持的其他分享链接,在主界面使用“从剪贴板导入分享链接”。官方中文资源中存在该入口及导入成功提示。查看剪贴板导入入口
  2. 多行 URI:让每条链接独占一行,不要在前后添加说明文字。复制后一次性导入,导入数量以客户端提示为准。
  3. Base64 文本:如果内容是一长段字母、数字、加号、斜杠和等号组成的文本,先在本地保存并解码,不要仅凭文件后缀判断。解码后若出现多行 vmess://、vless:// 或其他可识别前缀,再复制解码结果,通过剪贴板导入。
  4. v2rayN 内部格式:官方订阅说明给出了以 v2rayn:// 开头的内部分享格式示例,用于表达协议标准链接未覆盖的部分配置字段。不要手动修改其中的编码内容;如果导入失败,应回到生成来源检查文本是否完整。查看内部分享格式说明

注意:Base64 解码后仍然是 HTML、登录提示、错误信息或空文本时,不要继续反复转换,应先核对原始订阅地址和返回内容。

第三步:完整 JSON、YAML 或本地文件,先判断是不是自定义配置

完整配置文件与节点分享链接不是同一层级。v2rayN 官方仓库的配置处理源码包含“从文件添加自定义服务器配置”的处理逻辑,因此当前版本可能提供“服务器 → 添加自定义配置服务器”一类入口;入口名称、可选文件类型和支持的内核应以实际界面为准。查看官方配置处理源码

  1. 先看文件用途:以 proxies: 开头的 YAML,可能是某类客户端配置;包含 outbounds 的 JSON,可能是某个内核的完整配置。不要只把 .yaml 改成 .txt 就认为格式已经转换。
  2. 尝试自定义配置入口:在 v2rayN 主界面查找“服务器”“添加自定义配置服务器”或相近名称,选择本地文件并选择对应类型。若当前版本没有该入口,或文件类型不在列表中,不要强行导入。
  3. 无法直接使用时再转换:从可信来源取得标准分享链接,或使用可信的本地转换程序,将配置整理为 v2rayN 可识别的协议链接,再走剪贴板导入。无法确认字段含义时,不要手工改写 UUID、端口、TLS、传输层和密钥。

本地文件检查:用文本编辑器确认文件不是网页错误页,编码优先检查为 UTF-8;观察是否存在 BOM、首行空行、不可见字符、异常引号或混乱换行。不同编辑器对 BOM 和换行的显示方式不同,这一步属于本地排查建议,不代表 v2rayN 对所有文件都提供相同的兼容承诺。

如果文件包含真实订阅令牌或节点凭据,不要上传到陌生在线转换站。使用“订阅分组”中的转换目标类型前,还要先核实转换服务地址由谁提供;因为源码显示,设置转换目标后,客户端会把原始订阅 URL 拼接到转换服务请求中。对该服务不信任时,不要启用,或改用自建、可信的本地转换方案。查看转换请求处理逻辑

需要转换时:按“输入→目标→输出”设置

  1. 输入:在订阅分组中填写真实订阅 URL,而不是把订阅正文放进 URL 栏。
  2. 目标:查看“订阅转换目标类型”或相近字段。该字段是否存在、有哪些选项,以当前版本界面为准。
  3. 服务:核对转换服务地址。v2rayN 源码显示,当转换目标不为空时,程序会根据配置的转换服务地址生成请求,并附加目标类型和配置参数;这意味着原始 URL 可能被发送给该转换服务。查看官方转换处理源码
  4. 输出:优先选择能够输出标准协议分享链接或 v2rayN 可解析内部格式的结果。若输出是另一种完整客户端配置,不要默认它能被订阅节点解析器直接接受。
  5. 更新:保存分组后更新当前订阅,分别观察下载、解析和导入结果。更新成功只说明内容被获取和处理,不等于节点已经可用,也不等于系统代理已经生效。

如果没有任何可用节点,通常先尝试“不通过代理”更新;只有设备直连无法访问订阅地址、同时已有可用代理时,再尝试“通过代理”更新。若两种方式都失败,应继续检查地址权限、HTTP 响应、正文内容和格式,而不是只重复切换按钮。

节点为空或更新失败:按六层顺序排查

  1. 地址完整性:检查 URL 是否被换行、中文引号、空格或复制截断;分享链接是否保留完整协议前缀。
  2. 网络请求:Windows PowerShell 可用脱敏地址执行 curl.exe -I -L "https://example.com/sub?token=REDACTED"。Linux 和 macOS 通常去掉 .exe,使用 curl -I -L。该命令只用于辅助查看响应头,curl 默认 User-Agent 可能与 v2rayN 当前设置不同,结果不能完全替代客户端行为。
  3. 下载正文:可用 curl.exe -L "https://example.com/sub?token=REDACTED" -o sub.txt 下载到本地;Linux 和 macOS 使用 curl -L。打开文件检查是否为空、是否为 HTML 登录页、JSON 错误对象或其他网页内容。HTTP 200 也可能返回错误页面。
  4. 编码与解码:确认 Base64 解码后出现有效协议前缀;检查 UTF-8、BOM、首行空行、不可见字符和换行是否异常。没有协议前缀时,可能是内容截断、编码层不对或输出格式不属于 v2rayN 订阅格式。
  5. 协议与内核:协议列表存在于官方订阅说明,但具体扩展字段仍需结合当前版本和使用的内核确认。遇到协议不识别时,核对客户端版本、内核类型和转换输出。
  6. 过滤与界面状态:如果日志显示获取和解析完成但列表为空,检查别名正则过滤、当前订阅分组、搜索框和其他筛选条件。过滤条件可能让已解析节点不显示,先清空筛选再判断。

日志阶段不要混淆:“获取订阅内容成功”表示下载阶段有结果;“解析成功”表示程序识别并处理了内容;节点出现在列表后,还要单独验证节点连接;系统代理生效则还需检查系统代理开关和应用是否遵循系统代理。不同版本的日志措辞可能变化,以当前版本界面为准。查看更新阶段源码 查看中文日志文案

三行结论:先识别格式,再选择入口

订阅 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 响应和正文格式。

相关阅读

参考资料

  1. v2rayN 订阅功能说明|2dust/v2rayN 官方 Wiki
  2. v2rayN 部分界面功能说明|2dust/v2rayN 官方 Wiki
  3. SubscriptionHandler.cs|2dust/v2rayN 官方仓库源码
  4. ConfigHandler.cs|2dust/v2rayN 官方仓库源码
  5. v2rayN 中文界面与日志文案资源|2dust/v2rayN 官方仓库