v2rayN 中文指南 v2rayN 中文指南
📚 文档导航

v2rayN 是什么,客户端与内核分别负责什么

v2rayN 是面向 Windows、Linux 和 macOS 的桌面客户端,提供图形界面,并支持调用不同内核。理解它的关键,是把客户端界面、实际启动的内核和配置文件分开看;它们有关联,但不能把其中一个的说明直接套给另外两个。

官方怎样界定这个客户端?

桌面端是它的使用范围

README 将 v2rayN 定位为桌面端软件,覆盖 Windows、Linux 和 macOS;手机端则指向 v2rayNG。看到相近的名称时,应先分清对应的设备范围。

图形界面之外还涉及核心文件

发布文件介绍写明,发布包包含部分 Core,其他 Core 需要另外准备。因此,客户端已经能够打开,与所需核心文件已经齐备,是两个需要分别核对的条件。

Xray、sing-box 和 mihomo 是什么关系?

三者属于支持列表中的不同分组

官方支持列表把 Xray core 列入 V2ray 系列,把 sing_box core 单独分组,把 mihomo core 列入 Clash 系列;它们都是 v2rayN 支持的核心对象。

启动哪一个,要看配置中的核心类型

Wiki 写明,启动 Core 时先检查当前配置文件里的 Core 类型;该项为空,才检查核心类型设置。理解这层顺序,有助于分清正在查看的配置与实际使用的核心。

不同核心也不是所有功能都能互换。界面资源中存在核心不支持某协议或网络类型的提示,不能仅凭客户端接受了一份配置,就认定任意核心都能处理它。

旧版说明与版本迁移该怎样区分?

早期说明不能直接当作当前要求

早期 README 曾列出 .NET Framework 运行环境,后来的 README 使用了不同的运行库说明。判断旧教程是否适用,需要同时看它对应的软件时期与当前发布文件介绍。

跨版本迁移有明确的适用范围

更新日志里写到 v7.0.0 可从 6.x 升级并迁移配置;出现兼容问题时,可重新取得 7.x 后复制配置。这条说明针对这两条版本线,不能扩展为所有历史版本的迁移承诺。

历史发布变化不等于永久限制

更新日志里写到 v7.0.0 曾移除 Windows x86 发布版本,而当前 README 的平台表又列为支持。阅读历史记录时,需要保留其时间语境,不能把当时的变化当成永久结论。

从零开始应先核对哪些系统条件?

先区分系统版本与处理器架构

发布文件介绍列出的系统要求包括 Windows 10+、macOS 13.6+,以及 Debian 12+、Ubuntu 22.04+、Fedora 36+、Redhat 9+。系统名称相同,并不代表版本条件已经满足。

README 另有处理器架构支持表,系统版本与架构是两项信息。开始准备客户端前,应分别核对自己的环境,避免只凭“支持这个系统”就结束判断。

再看界面实现与运行库说明

Windows 发布文件中并列提供 WPF 与 Avalonia 两种界面实现。它们说明的是界面技术差异,不能据此自行推导某一种更适合特定人群。

Faq 提到依赖 .NET 8,但当前 README 已不再列出运行库版本。运行库问题需要区分不同文档的表述范围,不能直接沿用旧 README 的要求。

官方没有写明的几件事

当前运行库与界面包的适用建议

对于当前 7.x 明确对应的 .NET 运行库版本,官方没有说明;对于普通包与 desktop 包分别适合哪些用户,官方没有说明。具体操作应以应用内界面为准。

更早版本的迁移与分支名称

对于 5.x 到 6.x 的配置迁移步骤、是否存在名为 classic 的经典版分支,以及 6.x 各小版本的完整界面差异,官方没有说明,不能据名称补出结论。

完整协议对照与更新入口位置

对于每种协议具体由哪个内核处理的完整对照,以及内核更新入口的菜单层级,官方没有说明。支持列表不能代替完整兼容表,操作位置应以应用内界面为准。

常见问题

v2rayN 和 Xray 是同一个软件吗?

两者在官方说明中承担不同角色:v2rayN 是客户端,Xray 是它支持的核心之一。核对问题时,应先分清涉及客户端还是核心。

发布包包含核心,就能忽略核心类型吗?

发布包只包含部分核心。启动时仍会判断配置里的核心类型,因此包含核心文件不等于任何配置都能交给同一个核心运行。

看到旧教程里的包名,还能直接照用吗?

旧版 README 中的包名与当前发布文件介绍已有区别。应按对应时期理解旧说明,再核对当前发布文件,避免把不同版本的准备方式混在一起。

第三方整理,与相关软件及服务的开发者无隶属关系。

参考来源

v2rayN 完整专题