v2rayN
首推Desktop 版采用新一代跨平台界面,适合首次安装或在不同桌面系统间保持相近的操作习惯。WPF 版保留经典 Windows 界面和熟悉的菜单布局,适合已有使用习惯的用户。两者都是完整客户端,选择一个即可,不需要把两个版本叠加安装。
安装包 · 系统与架构
先选择正在使用的系统,再按处理器架构与安装方式选择 v2rayN、v2rayNG 或 v2flyNG。
Desktop 版采用新一代跨平台界面,适合首次安装或在不同桌面系统间保持相近的操作习惯。WPF 版保留经典 Windows 界面和熟悉的菜单布局,适合已有使用习惯的用户。两者都是完整客户端,选择一个即可,不需要把两个版本叠加安装。
| 检查项 | 对照说明 |
|---|---|
| 系统类型 | 在「设置 → 系统 → 关于」确认系统为 64 位且处理器为 x64。本页两种包均为 x64。 |
| 安装格式 | 先完整解压 ZIP,再打开其中的安装程序;不要直接在压缩文件预览中启动。 |
| 运行环境 | 若启动时提示缺少运行时,记下提示中的版本与架构,按该版本要求补齐后重试。 |
从旧版迁移时,先保存配置,再退出托盘里的旧进程。窗口关闭并不总表示程序已退出;如果新界面报本地端口被占用,先检查旧实例和其他代理客户端是否仍在后台运行。先启动一个版本并验证配置,再决定是否移除旧版。
打开苹果菜单中的「关于本机」。如果看到「芯片」并标有 Apple 芯片,选 Apple Silicon;如果看到「处理器」并标有 Intel,选 Intel。按系统显示的芯片信息选包,比通过机型外观或购买年份判断更可靠。
| 检查项 | 对照说明 |
|---|---|
| 芯片 | Apple Silicon 对应 arm64,Intel 对应 x64。 |
| 系统版本 | 在「关于本机」记录系统版本;若系统提示应用需要更高版本,以该安装包的系统要求为准。 |
| 安装格式 | 打开 DMG,按窗口提示将应用复制到应用程序文件夹,再从该文件夹启动。 |
更新前退出正在运行的 v2rayN,再替换应用。来自磁盘映像和应用程序文件夹的两个副本容易混淆,替换后可从应用程序文件夹重新打开,并在客户端内查看版本。若使用单位管理的设备,遇到权限限制时应由设备管理员确认安装策略。
采用 Xray 内核。2015 年后推出的主流手机通常可优先选 arm64;如果设备系统没有提供 64 位应用运行环境,或无法确认架构,可以先核对机型规格,再选择通用版。
采用 V2Fly 内核。已有明确的 V2Fly 配置需求时可选择此客户端。切换客户端前先核对协议与传输字段是否受支持;同一份订阅能导入,不代表每条配置都能运行。
| 检查项 | 对照说明 |
|---|---|
| 处理器架构 | 支持 arm64-v8a 的系统可选专用包;通用包覆盖的架构更多,但仍受应用最低系统版本约束。 |
| 安装方式 | 在系统安装界面打开已下载的 APK;如有来源授权提示,先确认正在使用的浏览器或文件管理器。 |
| 连接权限 | 首次建立连接时,系统通常会请求 VPN 授权;设备上的其他 VPN 服务可能与其冲突。 |
如果覆盖安装时报签名冲突,先确认旧应用与新包的安装来源。不要把先卸载当成默认操作:卸载可能移除订阅和本地设置。保留可重新导入的配置后,再决定是否切换安装来源。
先看发行版使用哪种包格式,再核对 CPU 架构。Debian、Ubuntu 系通常选 DEB;使用 RPM 的发行版还要核对发行版本和依赖,不能仅凭扩展名判断兼容。此处 RPM 文件名中的 el10 是构建目标提示。
| 检查项 | 对照说明 |
|---|---|
| 处理器架构 | amd64 与 x86_64 在这里对应 x64;aarch64 对应 arm64。 |
| 运行环境 | v2rayN 是图形客户端,需在有桌面会话的环境中使用。 |
| 系统依赖 | 用发行版的软件安装工具打开本地包,查看依赖解析结果。遇到冲突时不要强制跳过依赖。 |
安装成功后,从桌面应用列表启动客户端。首次使用前可以先阅读桌面环境的代理设置:有些应用读取桌面代理,有些使用自己的网络配置。某个应用没有走代理,不一定意味着安装失败;先确认该应用读的是哪一套设置。
选包时有三个不同的问题。架构决定程序能否在当前系统上运行;包格式决定由哪种安装工具打开;界面版本决定客户端的交互布局。把这三项混为一谈,常会出现「系统也是 64 位,为什么不能装」的疑问。排查时从系统关于页面读出架构,再核对文件名里的架构和扩展名,最后才考虑界面版本。跨平台迁移时也按新设备重新选包,不直接把旧设备上的可执行文件复制过去。
先记下正在使用的客户端、界面分支和配置位置。有导出功能时,可将需要保留的条目导出到受控位置,并确认文件能够读取。订阅地址可能含有访问凭据,备份和排错截图应分开处理,不要把完整地址发到公开讨论区。重新安装后先检查原来的订阅分组与选用的连接是否恢复,再逐项调整路由或代理模式。这样即使遇到问题,也能分辨是旧配置未迁移,还是新版本的设置需要调整。
安装程序成功退出,只说明安装流程已经结束。先单独打开客户端,确认界面能保持运行;再导入已有配置,核对列表中是否出现预期条目;最后启动一个连接并在实际使用的应用中验证。首次排查时不要同时改订阅地址、路由规则和接管模式,否则即使连接恢复,也难以判断是哪项修改起了作用。具体操作可接着看配置导入教程。
选包与故障排查
卡片版本来自应用发布清单,文件名记录具体安装包,两者可能在不同时间更新。确认实际安装版本时,以客户端关于页面显示的版本为准。
同版本分支通常先备份配置,再按系统提示更新。切换界面版本、安装来源或配置目录时,先确认迁移方式,避免卸载时一并删除本地数据。
安装只准备客户端。还需要导入有效配置、选中连接,并按设备授权或启用所需的代理模式。可以先检查客户端日志,再判断问题出在配置、权限还是连接本身。
x64 和 arm64 都是 64 位,但对应不同指令集。先核对操作系统报告的架构,再检查系统版本和安装包格式是否匹配。
先确认浏览器是否已下载完成,再查看系统报错原文。架构不符、依赖缺失与设备管理策略需要分别处理,不建议为安装而关闭系统保护。