v2rayN
桌面版采用新一代跨平台 UI,界面结构与 macOS、Linux 版本更接近,适合首次安装和希望使用新版交互的用户。经典 WPF 版采用 Windows 桌面界面,菜单路径更接近长期使用的传统版本,适合已经熟悉既有操作方式的用户。首次使用通常优先下载桌面版;如果现有工作流程依赖 WPF 界面,再选择经典版。
客户端下载与安装包选择
按操作系统与处理器架构选择安装包。桌面平台使用 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间选择。页面中的版本信息由同源版本清单更新,下载前仍需确认平台、架构和软件包格式。
平台安装包
切换平台后查看固定的客户端清单、主安装包、备选包和最低使用条件。每个标签只列出适用于该系统的图形客户端。
Windows x64
Windows 提供桌面版与经典 WPF 版。两者管理相同类型的订阅、服务器配置、路由规则和系统代理,主要差别在界面技术与操作习惯。
桌面版采用新一代跨平台 UI,界面结构与 macOS、Linux 版本更接近,适合首次安装和希望使用新版交互的用户。经典 WPF 版采用 Windows 桌面界面,菜单路径更接近长期使用的传统版本,适合已经熟悉既有操作方式的用户。首次使用通常优先下载桌面版;如果现有工作流程依赖 WPF 界面,再选择经典版。
| 项目 | 要求 | 选择说明 |
|---|---|---|
| 操作系统 | 受支持的 64 位 Windows 桌面系统 | 保持系统组件与运行环境处于可用状态。 |
| 处理器架构 | x64 | 本页 Windows 安装包面向常见 64 位 Intel 或 AMD 处理器。 |
| 安装方式 | 解压后运行安装程序 | 建议先完整解压压缩包,再启动其中的安装程序。 |
| 首次配置 | 订阅链接或单个服务器配置 | 安装完成后仍需导入有效配置,客户端不会自动生成服务器信息。 |
安装前关闭正在运行的旧版窗口,避免配置文件处于写入状态。完成安装后,可先打开“订阅分组”添加订阅地址,再执行订阅更新。导入成功后选择一个配置,按实际需求设置路由模式与系统代理。若程序能启动但浏览器没有按预期使用代理,应先检查系统代理开关,而不是反复重新安装。
macOS 桌面
macOS 安装包按芯片架构拆分。Apple M 系列芯片选择 arm64,Intel 处理器选择 x64。芯片类型必须与安装包一致。
v2rayN macOS 版使用与新版桌面客户端一致的配置管理逻辑,可维护订阅分组、节点配置、路由规则和日志。下载前打开系统菜单中的“关于本机”,查看“芯片”或“处理器”字段。显示 Apple M 系列名称时选择 Apple Silicon;显示 Intel 名称时选择 Intel。安装包架构选错时,常见表现是应用无法打开或系统提示架构不兼容。
| 项目 | 要求 | 选择说明 |
|---|---|---|
| 操作系统 | 受支持的 64 位 macOS | 建议先完成系统维护更新,再安装当前客户端。 |
| Apple 芯片 | arm64 | 关于本机显示 Apple M 系列时选择 Apple Silicon 包。 |
| Intel 芯片 | x64 | 关于本机显示 Intel 处理器时选择 Intel 包。 |
| 安装格式 | DMG | 打开磁盘映像并按系统界面完成应用安装。 |
首次打开后,系统可能要求确认网络相关权限。权限仅决定应用能否创建本地代理与调整对应系统设置,不会替代订阅导入。完成授权后,先添加订阅分组并执行更新,再选择配置和路由模式。若换装另一种芯片架构的设备,应重新下载匹配的新安装包,不要直接复制旧设备上的应用文件。
Android 移动端
Android 首选 v2rayNG;需要使用 v2fly 内核分支时可选择 v2flyNG。两款客户端均提供 arm64 和通用安装包。
v2rayNG 是 Android 平台的主要选择,适合导入订阅、扫描配置二维码、管理服务器列表和切换路由模式。2015 年后的主流手机通常采用 arm64 架构,优先下载 arm64 版可减少安装包体积。无法确认设备架构、设备型号较旧,或 arm64 包无法安装时,再选择通用版。
v2flyNG 面向需要 v2fly 内核分支的 Android 使用场景,配置管理方式与常见移动端客户端接近。是否选择它,主要取决于订阅中使用的协议与服务端配置是否更适合 v2fly 兼容路径。普通用户如果没有明确的内核要求,可先使用上方的 v2rayNG。
| 项目 | 要求 | 选择说明 |
|---|---|---|
| 处理器架构 | arm64 或通用架构包 | 2015 年后的主流设备通常先选 arm64。 |
| 安装格式 | APK | 使用系统安装界面打开下载完成的安装包。 |
| 客户端选择 | v2rayNG 或 v2flyNG | 默认选 v2rayNG;明确需要 v2fly 内核分支时选 v2flyNG。 |
| 首次连接 | 系统网络连接授权 | 启动连接时按系统提示确认客户端的本地网络连接请求。 |
完成安装后,可通过剪贴板导入订阅链接,或使用客户端提供的二维码扫描入口导入单个配置。导入后先更新订阅,再检查服务器列表是否出现有效条目。移动端的连接开关只代表本地网络通道已经建立,实际可用性还取决于配置参数、服务器状态、路由规则和 DNS 设置。若更新订阅时失败,应分别检查链接可访问性、当前网络和更新请求是否需要经过已有代理。
Linux 桌面
Linux 安装包按发行版软件包格式和处理器架构区分。Debian 系选择 deb,RHEL 系选择 rpm,并在 x64 与 arm64 之间匹配设备。
v2rayN Linux 版提供图形化订阅、服务器、路由和日志管理。Ubuntu、Debian 及其衍生发行版通常选择 deb;Fedora、Rocky Linux、AlmaLinux、RHEL 系发行版通常选择 rpm。常见桌面电脑使用 x64,采用 ARM 处理器的设备选择 arm64。先判断包格式,再判断架构,可以避免安装器报告软件包不兼容。
| 发行版或设备 | 安装包 | 架构选择 |
|---|---|---|
| Debian、Ubuntu 及衍生发行版 | deb | 普通 Intel 或 AMD 桌面选 x64,ARM 设备选 arm64。 |
| Fedora、Rocky Linux、AlmaLinux、RHEL 系 | rpm | x86_64 选 x64,aarch64 选 arm64。 |
| 桌面环境 | 可运行图形应用的桌面会话 | 精简服务器环境应先确认图形桌面与依赖是否具备。 |
| 网络设置 | 桌面系统代理或应用内代理 | 安装完成后按桌面环境确认系统代理是否实际生效。 |
可在终端执行 uname -m 查看架构:常见输出 x86_64 对应 x64,aarch64 对应 arm64。软件包管理器若报告依赖缺失,应先通过当前发行版的软件源补齐依赖,再重新执行安装。客户端启动后,导入订阅和选择配置的流程与其他桌面版本接近,但系统代理入口可能因桌面环境不同而变化。若应用内连接正常而浏览器未生效,应检查当前桌面环境的代理设置是否被正确写入。
安装后的配置路径
安装客户端只是准备步骤。订阅导入、配置选择、路由模式和系统代理共同决定应用是否按预期工作。
先依据操作系统选择平台标签,再核对芯片或处理器架构。Windows 本页提供 x64 安装包;macOS 按 Apple Silicon 与 Intel 区分;Android 按 arm64 与通用版区分;Linux 同时区分 deb、rpm、x64 和 arm64。不能只根据文件名中的版本号做选择。
桌面系统按安装程序或软件包管理器完成安装,Android 使用系统安装界面打开 APK。升级已有版本前先退出正在运行的客户端,避免配置文件仍被占用。安装完成后先确认客户端能够正常打开,再继续导入配置。
订阅链接适合集中维护多个服务器条目,单个分享链接或配置适合临时导入。粘贴订阅地址时应避免多余空格和换行,并确认链接仍在有效期内。执行订阅更新后,检查客户端列表中是否生成了可识别的配置条目。
选择一个配置后,再设置路由模式。日常使用通常从规则分流开始,只有明确需要时才调整为其他模式。桌面端还要确认系统代理状态;移动端首次连接时需要响应系统网络授权。修改路由或 DNS 后,应重新载入配置,确保旧设置不再继续生效。
客户端选择依据
三个名称对应不同平台与内核生态。选择时先看设备平台,再看协议兼容需求,不需要在同一设备上重复安装所有客户端。
v2rayN 覆盖 Windows、macOS 与 Linux,本页桌面平台均以它作为主要客户端。它提供订阅分组、服务器列表、路由规则、系统代理、日志和内核配置等图形化入口。Windows 用户还可在新一代桌面版与经典 WPF 版之间选择,macOS 和 Linux 则按芯片、架构与软件包格式选择对应安装包。
v2rayNG 适合 Android 日常配置管理,使用 Xray 内核处理相应协议与传输配置。它可导入订阅、分享链接和二维码,并通过系统网络连接机制接管需要代理的流量。对于没有特定内核分支要求的移动端用户,通常先选择 v2rayNG arm64 版。
v2flyNG 同样面向 Android,但采用 v2fly 内核分支。它更适合已经确认服务端配置、订阅格式或协议组合需要该分支的场景。客户端名称相近并不代表所有配置行为完全一致,切换客户端后应重新检查订阅解析结果、路由规则和 DNS 设置。
版本更新通常会带来界面调整、协议能力变化、运行环境更新或问题修复。升级前应记住当前订阅分组、路由模式和系统代理状态。桌面端如果需要迁移配置,先在旧版本中确认配置目录与导出功能,再在新版本中按客户端提供的导入路径恢复。不要在新旧客户端同时运行时修改同一份配置目录。
Android 从 v2rayNG 切换到 v2flyNG,或从 v2flyNG 切换回 v2rayNG 时,应把它视为客户端迁移,而不是简单覆盖安装。重新导入订阅后检查条目数量、协议字段、传输参数和路由规则。某个订阅能被导入,不代表其中每条配置都适用于当前内核分支。
下载相关问题
以下问题对应平台架构、软件包格式和首次配置中最常见的选择节点。
桌面版采用新一代跨平台界面,适合首次安装、希望使用新版操作结构,或需要与 macOS、Linux 版本保持相近体验的用户。经典 WPF 版基于 Windows 原生桌面技术,菜单路径更接近长期维护的传统版本,适合已经熟悉既有界面的用户。
两者都用于 Windows x64,并且都能完成订阅、配置、路由和系统代理管理。没有既有使用习惯时先选桌面版;现有流程依赖 WPF 菜单位置时再选经典版。
打开系统菜单中的“关于本机”,查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon arm64 版;显示 Intel 处理器时选择 Intel x64 版。架构选择错误通常会导致安装包无法启动,或系统直接报告应用与当前设备不兼容。
2015 年后的主流 Android 手机通常使用 arm64 架构,因此优先选择 arm64 版。该版本只包含对应架构所需的组件,安装包通常更精简。无法确认设备架构、设备较旧,或 arm64 版无法安装时,再改用通用版。
架构选择不会改变订阅内容和主要操作方式,只影响安装包能否与处理器匹配。已经成功安装 arm64 版时,不需要再安装通用版。
Debian、Ubuntu 及其衍生发行版通常选择 deb;Fedora、Rocky Linux、AlmaLinux、RHEL 系发行版通常选择 rpm。确定格式后,还需要检查处理器架构。终端中 uname -m 显示 x86_64 时选择 x64,显示 aarch64 时选择 arm64。
软件包格式与处理器架构是两个独立条件。即使选对 deb 或 rpm,架构错误仍会导致安装失败。
客户端只负责管理配置、路由和系统代理。首次启动后还需要导入有效的订阅链接或单个服务器配置,执行订阅更新,选择一个可用配置,并按使用场景启用系统代理或移动端网络连接。
如果客户端已经运行但应用没有按预期联网,依次检查订阅是否成功解析、当前配置是否可用、路由模式是否合适、系统代理是否生效以及 DNS 设置是否匹配。完整排查流程可前往问题诊断页面。