v2rayN
Windows · x64 · 7.24.1
v2rayN 桌面客户端与 Android 客户端入口
先选操作系统,再选界面版本或处理器架构。桌面平台使用 v2rayN;Android 优先查看 v2rayNG,已有 V2Fly 配置需求时再考虑 v2flyNG。
安装后查看订阅导入教程 →安装按钮对应具体文件。切换平台会更新页面地址中的锚点,便于保存与分享当前平台入口。
Windows · x64 · 7.24.1
| 检查项 | 选择依据 |
|---|---|
| 处理器与系统架构 | 本页两个入口均为 x64。可在系统设置的“系统类型”中确认,不要仅凭处理器品牌判断。 |
| 系统与运行环境 | 建议在仍受维护的 Windows 10 或 Windows 11 上使用;具体最低版本与运行环境以当前安装包提示为准。 |
| 文件与权限 | 先完整解压 ZIP,再运行其中的安装程序。普通配置与启用 TUN 的权限要求不同。 |
下载完成后,先把压缩文件解压到可正常写入的目录,再启动其中的安装程序。直接在压缩文件预览窗口中运行,可能使资源文件无法被正确读取。若安装程序提示缺少运行环境,应按提示确认所需组件,不要把缺少依赖与订阅连接失败混为一谈。
Desktop 与 WPF 是界面版本的区别,不是两套不同的订阅服务。已有配置的用户切换界面前,应先导出或备份服务器、订阅分组及自定义路由。不要同时启动两版并接管系统代理;否则端口占用和代理设置覆盖会让排查变得复杂。
首次打开后,先导入一个有效配置,再选择服务器并验证普通代理连接。此时不必急着启用 TUN。普通连接可以工作后,再按用途设置路由和 DNS,能够把安装问题、配置问题与系统流量接管问题分开处理。
macOS · 7.24.1
| 检查项 | 选择依据 |
|---|---|
| 芯片类型 | Apple Silicon 对应 arm64,Intel 对应 x64。通过“关于本机”确认芯片或处理器信息。 |
| 系统版本 | 确认当前 macOS 版本满足所选发布包的要求;旧系统应先核对兼容性再安装。 |
| 安装位置与授权 | 打开 DMG 后按窗口提示安装到应用程序目录;首次运行按系统提示确认应用来源与必要权限。 |
不要按购买年份猜芯片类型。同一年份可能存在不同架构的设备,“关于本机”给出的芯片信息才是直接依据。Apple Silicon 用户优先选择原生 arm64 包,Intel 用户选择 x64 包;架构选错时,应用可能无法打开,或需要额外的兼容环境。
打开磁盘映像后,按安装窗口的说明放置应用,再从应用程序目录启动。避免长期直接从已挂载的映像中运行,以免退出映像后找不到程序。若系统弹出来源或权限提示,应先核对下载文件与操作对象,再按系统界面完成授权,不建议用批量解除限制的方式处理。
客户端启动不等于系统代理已经生效。先导入配置、选中服务器,再查看当前代理模式。使用 TUN 前还需要确认相关权限与网络设置;如果普通代理已能工作而 TUN 无法接管流量,应把排查重点放在权限、路由与网络栈,而不是重新下载相同安装包。
Android · Xray 内核 · 2.2.6
Android · V2Fly 内核 · 1.10.31
适合已确认配置与 V2Fly 内核兼容、且设备支持 arm64 的用户。
v2flyNG_1.10.31-fdroid_arm64-v8a.apk| 检查项 | 选择依据 |
|---|---|
| 设备架构 | 优先核对 arm64 支持;处理器是 64 位,不一定代表设备系统开放了相应应用支持。 |
| 系统版本 | 具体最低 Android 版本以所选安装包的要求为准;通用版不等于可以兼容所有旧系统。 |
| 安装与连接授权 | 为打开安装包的应用按需授权安装权限;首次连接时确认系统 VPN 授权,同一时间只运行一个接管流量的客户端。 |
v2rayNG 与 v2flyNG 的选择主要取决于内核与配置需求,而不是安装包大小。v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核。两条内核分支的协议特性与字段支持并不完全相同,不能仅凭界面相似就判断一份配置在两款客户端中都能直接使用。
下载安装包后,通过系统文件管理器或下载列表打开文件,只为当前安装来源授予必要权限。若更新时提示签名冲突,不要立即卸载旧应用;先保存订阅与手动服务器配置,再确认原安装来源。卸载可能移除应用数据,重新安装并不会自动找回未备份的设置。
首次连接通常会弹出系统 VPN 授权窗口。确认后,客户端才能按其设置接管流量。若设备上另有同类连接正在运行,先停止它,再启动当前客户端。连接测试期间可暂时留意系统后台限制;测试通过后再调整后台运行策略,避免把休眠导致的中断误判为服务器故障。
Linux · 7.24.1
arm64 与 aarch64 在这里表示同类目标架构;amd64 与 x86_64 对应 x64,不表示只能使用某一家处理器。
| 检查项 | 选择依据 |
|---|---|
| 包管理体系 | 先区分 deb 与 rpm,再确认当前发行版能满足该包依赖。相同后缀不代表适配所有发行版。 |
| 处理器架构 | x64 选择 amd64 或 x86_64 包;arm64 选择 arm64 或 aarch64 包。 |
| 桌面与权限 | 此处为图形客户端,需要可用的桌面环境。安装由系统包管理器处理,启用 TUN 另需相应权限。 |
包格式只是第一层选择,发行版版本与依赖才决定能否安装。尤其 rpm 文件名带有构建环境标记时,应先阅读软件安装器的依赖提示,不要强行忽略缺失依赖。包管理器报告安装成功后,再从桌面应用菜单启动客户端,确认界面与内核能够正常加载。
如果设备采用 ARM 处理器,不能下载默认的 x64 入口。可从系统信息查看架构,再选择卡片下方的 arm64 包。容器、远程会话或兼容环境中的架构信息可能与实际桌面运行环境不同,应以客户端最终运行的系统为准。
桌面环境对系统代理设置的处理可能不同。先验证客户端本地代理入口,再确认应用是否读取系统代理;部分应用还需要单独配置。TUN 用于更广泛的流量接管,但同时涉及权限、路由和 DNS。普通代理尚未验证前,不宜同时修改多项系统网络设置。
先确认程序能正常打开,再处理连接配置。安装错误与网络错误属于不同阶段:程序尚未启动时,优先检查架构、依赖与安装权限;程序已经启动但无法连接时,再查看订阅、服务器参数和客户端日志。重新下载安装包通常不会修复一个失效的订阅地址。
导入订阅前,确认地址完整且来自有权使用的来源。复制时不要夹带空格或换行,也不要把管理页面地址当成订阅地址。订阅更新成功后,先选择一个服务器进行真实连接测试。列表中出现服务器只说明导入成功,不代表远端服务当前一定可用。
普通代理连接通过后,再设置分流规则、DNS 与 TUN。每次只修改一类设置,并记下原值。这样出现问题时能够回到上一个可用状态,而不是在多个改动之间猜测原因。自定义规则较多的用户,建议先保留一份简化配置作为对照。
备份不只包含订阅链接。手动添加的服务器、自定义出站、单独编辑的配置文件以及过滤规则,可能无法通过重新更新订阅恢复。保存这些内容后,记录当前可用的代理模式与端口设置。更新完成时先验证默认连接,再逐项恢复进阶功能,可减少兼容问题的定位范围。
需要排查时,记录操作发生在哪个阶段,并保留完整错误文本。日志与截图中可能包含订阅地址、身份参数和服务器信息,分享前应遮盖敏感内容。不要为了测试而公开整份配置,也不要把含访问凭据的链接贴入公开讨论。更多请求错误与订阅更新问题可在帮助中心继续查看。
首次安装可先选 Desktop 桌面版,它使用新一代跨平台界面。经典 WPF 版保留熟悉的 Windows 界面,是经典稳定版入口。两版都需要导入自己的连接配置。切换前先备份订阅、服务器与自定义规则,不要让两版同时接管系统代理。
2015 年后的主流手机通常可以先考虑 arm64,但最终应以设备系统实际支持的架构为准。通用版适合架构不明确或需要兼容其他受支持架构的情况,体积通常更大。若系统提示安装包不兼容,先确认架构与系统要求,不要反复安装同一个文件。
需要。客户端负责读取配置并建立连接,安装包不附带可用服务器。请准备有权使用的订阅链接或单个服务器参数,再按快速上手教程导入。订阅地址可能包含访问凭据,排查问题或分享截图时应遮盖完整地址和身份参数。
先记录系统版本、处理器架构、安装包名称和完整错误提示。Windows 检查是否已解压文件及是否存在运行环境提示;macOS 检查芯片与安装包是否对应;Android 检查安装授权和旧应用签名冲突;Linux 检查包格式与依赖是否适配发行版。不要直接关闭系统防护,也不要删除尚未备份的配置。
先保存订阅分组、手动添加的服务器、自定义路由、DNS 设置和自定义配置文件。退出客户端后再安装更新,不要在更新过程中同时运行另一个版本。更新完成后先验证普通代理连接,再逐项恢复 TUN 或自定义规则,便于定位兼容问题。
客户端卡片中的版本文字与安装包入口分别来自发布清单的不同字段,两者可能暂时不同步。下载前同时留意文件名与平台说明,安装后以客户端关于页面显示的版本为准。不要仅根据文件名数字推断协议兼容性,具体功能仍需结合客户端和内核的实际支持情况判断。