v2rayN
v2rayN 提供订阅分组、服务器筛选、系统代理、路由规则、TUN 模式与运行日志等常用功能。桌面版采用新一代跨平台界面,适合首次安装以及希望获得统一桌面体验的用户;经典 WPF 版保留传统 Windows 布局,菜单位置与旧版操作方式更接近。
按操作系统进入对应页面,选择 v2rayN、v2rayNG 或 v2flyNG。每个入口都标明了界面版本、处理器架构与适用场景,下载前不需要先理解复杂的协议参数。
切换平台不会离开当前页面,地址栏会同步记录所选平台,便于保存或分享对应入口。
Windows 客户端
两种安装包共享 v2rayN 的核心配置能力,但界面技术与操作布局不同。首次使用可优先选择桌面版;已有 WPF 使用习惯时,可以继续使用经典版本。
v2rayN 提供订阅分组、服务器筛选、系统代理、路由规则、TUN 模式与运行日志等常用功能。桌面版采用新一代跨平台界面,适合首次安装以及希望获得统一桌面体验的用户;经典 WPF 版保留传统 Windows 布局,菜单位置与旧版操作方式更接近。
| 项目 | 建议 | 说明 |
|---|---|---|
| 处理器架构 | x64 | 本页提供的两个 Windows 安装包均面向常见的 64 位桌面处理器。 |
| 安装权限 | 允许安装程序写入应用目录 | 若系统弹出权限确认,请核对程序名称后继续。 |
| 首次启动 | 先导入订阅,再选择服务器 | 仅安装客户端不会自动产生可用的服务器配置。 |
| 代理方式 | 先从系统代理开始 | 需要接管更多应用流量时,再阅读教程配置 TUN 模式。 |
macOS 客户端
macOS 安装包分为 Apple Silicon 与 Intel 两种架构。选对芯片版本可以避免安装阶段出现架构不匹配,也能让应用以对应处理器的原生方式运行。
macOS 版 v2rayN 使用与桌面版一致的主要功能结构,可管理多个订阅分组、切换服务器、应用路由规则并查看运行日志。两个下载入口的功能相同,区别仅在处理器架构,下载前先查看“关于本机”中的芯片信息。
| 项目 | 建议 | 说明 |
|---|---|---|
| 芯片类型 | Apple Silicon 或 Intel | 必须下载与“关于本机”所示芯片对应的安装包。 |
| 安装格式 | DMG | 打开磁盘映像后,按系统界面提示将应用放入应用程序目录。 |
| 系统权限 | 按需允许网络与代理设置 | 首次启用系统代理或 TUN 模式时,系统可能要求确认相关权限。 |
| 配置迁移 | 优先使用订阅链接 | 多设备需要保持服务器列表一致时,统一订阅比逐条录入更便于维护。 |
Android 客户端
Android 平台优先选择采用 Xray 内核的 v2rayNG;需要使用 v2fly 内核或延续对应配置习惯时,可以选择 v2flyNG。两款客户端都提供 arm64 与通用安装包。
v2rayNG 是 Android 平台常用的图形客户端,支持从剪贴板导入订阅、扫描二维码、切换服务器、更新订阅与管理分应用代理。对于 2015 年后的多数主流手机,可先下载体积更有针对性的 arm64 版;设备架构不明确时使用通用版。
v2flyNG 的界面操作与常见 Android 代理客户端相近,适合明确需要 v2fly 内核、已经使用对应配置,或希望在同一设备上保留另一套客户端配置的用户。若没有特定内核需求,优先使用上方的 v2rayNG 即可。
| 项目 | 建议 | 说明 |
|---|---|---|
| 客户端选择 | 优先 v2rayNG | 需要 v2fly 内核或保留独立配置时,再选择 v2flyNG。 |
| 处理器架构 | 主流手机优先 arm64 | 不确定架构或遇到不兼容提示时使用通用版。 |
| 安装权限 | 按系统提示授权当前来源 | 安装结束后可回到系统设置检查并收回临时安装权限。 |
| 连接授权 | 首次启动连接时确认 | 系统会显示网络连接授权窗口,确认后客户端才能建立本地连接服务。 |
Linux 客户端
Linux 版 v2rayN 提供 deb 与 rpm 两类安装包,并分别覆盖 x64 和 arm64 架构。先根据发行版确定包格式,再根据设备处理器确定架构。
Debian、Ubuntu 及其衍生发行版通常选择 deb;Fedora、Rocky Linux、AlmaLinux 等发行版通常选择 rpm。普通桌面电脑多数使用 x64,采用 ARM 处理器的开发板、小型主机或部分笔记本则需要 arm64 包。
| 发行版或环境 | 包格式 | 架构选择 |
|---|---|---|
| Debian、Ubuntu 及其衍生版 | deb | 桌面电脑通常选 x64,ARM 设备选 arm64。 |
| Fedora、Rocky Linux、AlmaLinux | rpm | 根据 uname -m 的结果选择对应架构。 |
| 桌面环境 | 图形会话 | v2rayN 是图形客户端,需要可用的桌面会话与系统托盘环境。 |
| 代理应用 | 系统设置或 TUN 模式 | 安装完成后仍需导入配置,并选择适合当前桌面环境的接管方式。 |
客户端安装只是第一步。按下面的顺序操作,可以把安装包选择、订阅导入与连接验证分开处理,遇到问题时也更容易定位具体环节。
Windows 重点选择桌面版或经典 WPF 版;macOS 根据芯片选择 Apple Silicon 或 Intel;Android 在 arm64 与通用版之间选择;Linux 则需要同时确认 deb 或 rpm,以及 x64 或 arm64。安装包无法打开时,首先回到这一层检查,不要先修改订阅或路由设置。
按照操作系统提供的安装界面完成部署。首次启动期间,系统可能询问网络连接、代理设置或后台运行权限,这些权限用于客户端建立本地代理服务和应用系统设置。只按当前需要开启,后续仍可以在系统设置中调整。
打开客户端的订阅管理入口,粘贴已有订阅地址并执行更新。若拿到的是单条 vmess://、vless:// 或 trojan:// 链接,则使用从剪贴板导入功能。Android 客户端还可以通过二维码录入单个配置。导入完成后先检查服务器列表是否出现条目。
从服务器列表中选中一个配置,再根据使用场景启用系统代理或 TUN 模式。普通浏览器与遵循系统代理设置的应用,可先从系统代理开始;需要覆盖更多应用流量时,再阅读高级用法中的 TUN、DNS 与路由章节,不建议在首次连接前同时改动多项设置。
连接后查看客户端日志,确认配置是否成功载入、端口是否正常监听,以及是否出现域名解析、认证或网络超时提示。页面无法访问并不一定代表客户端安装失败,订阅内容、服务器状态、系统代理和本地网络都可能影响结果,应按日志顺序逐项排查。
型号、内核和处理器架构属于不同层次。先解决平台与安装包兼容性,再考虑界面习惯和配置功能,选择过程会更清晰。
Windows、macOS 与 Linux 都提供 v2rayN。三个平台的安装格式不同,但订阅分组、服务器列表、路由设置与日志查看等核心思路相近。如果需要在多台桌面设备之间使用同一批服务器,可以为各设备导入相同订阅,再分别设置系统代理方式。
Windows 的 Desktop 与 WPF 是界面实现差异,不是协议能力的简单高低关系。新用户通常更适合 Desktop;已有固定操作流程、依赖传统菜单位置或正在参照经典界面教程时,WPF 会更顺手。
没有明确偏好时,优先使用 v2rayNG。它采用 Xray 内核,适合常见的订阅导入、分应用代理与路由配置。v2flyNG 使用 v2fly 内核,可以作为有对应配置需求时的备选。两款客户端的配置彼此独立,切换应用时需要在目标客户端中重新导入订阅。
客户端型号确定后,再选择 arm64 或通用安装包。arm64 面向主流 64 位 ARM 手机;通用版覆盖范围更广,适合无法读取设备架构信息的情况。安装失败提示架构不匹配时,更换同一客户端的另一种包即可。
Linux 的选择步骤比其他平台多一层:发行版决定 deb 或 rpm,处理器决定 x64 或 arm64。包格式选错时,系统的软件包管理器无法正常识别;架构选错时,安装或启动阶段会提示程序格式不匹配。
如果发行版属于 Debian 或 Ubuntu 系列,通常选择 deb;属于 Fedora 或企业 Linux 衍生系列时,通常选择 rpm。设备架构可以通过系统设置或 uname -m 查看,不需要根据设备外观判断。
更新客户端前,可以使用客户端提供的配置导出功能,或记录现有订阅地址、路由规则和 DNS 调整项。仅依赖订阅的用户通常只需保留订阅来源;手工维护多个单节点、自定义出站或复杂路由的用户,应额外保存对应配置。
更新后先确认订阅分组与服务器列表是否完整,再测试系统代理。不要在升级客户端的同时大范围改写路由和 DNS,否则连接异常时很难判断问题来自版本变化还是配置变化。
以下问题集中解释界面版本、处理器架构、包格式与首次连接。更多订阅、路由和故障排查内容可前往帮助中心。
首次安装可以优先选择桌面版,它采用新一代跨平台界面。已经熟悉传统 Windows 操作方式,或希望延续原有界面习惯时,可以选择经典 WPF 版。两者都属于 v2rayN,主要区别在界面技术与操作布局。
arm64 版面向主流 64 位 ARM 处理器,2015 年后的多数常用 Android 手机可先选择这一版本。无法确认处理器架构,或安装时出现架构不匹配提示时,再改用通用版。
打开系统菜单中的“关于本机”,查看芯片或处理器一栏。显示 Apple 芯片名称时选择 Apple Silicon 版,显示 Intel 处理器时选择 Intel 版。
Debian、Ubuntu 及其衍生发行版通常使用 deb;Fedora、Rocky Linux、AlmaLinux 等发行版通常使用 rpm。还需要根据设备处理器选择 x64 或 arm64 架构。
客户端安装完成后仍需要导入有效的订阅链接或单节点配置,选择服务器并启用合适的系统代理或 TUN 模式。客户端本身负责管理配置与连接,不会自动生成服务器信息。
订阅更新、路由规则、DNS 设置与连接日志等问题已按类别整理。
查看帮助中心